clean-scripts

clean-scripts

A CLI tool to make scripts in package.json clean.

install

yarn global add clean-scripts

usage

create config file(named clean-scripts.config.js or something else) like:

module.exports = {
    build: "tsc",
    lint: "tslint index.ts"
}

run clean-scripts build, or clean-scripts lint

or clean-scripts build --config clean-scripts.config.js

features

string script

module.exports = {
    build: "tsc"
}

array script

• executed one by one with order
• used when later script depends on previous script's success

module.exports = {
    build: [
        "rimraf dist",
        "tsc"
    ]
}

Set or Object script

• executed collaterally without order
• used when the scripts are irrelated
• they are all started at first time, when they are all done, it's a success, otherwise exit current process

module.exports = {
    build: {
        js: `tsc`,
        css: `cleancss -o index.bundle.css index.css`
    }
}

nested script

module.exports = {
    build: [
        "rimraf dist",
        {
            js: `tsc`,
            css: [
                `lessc index.less > index.css`,
                `cleancss -o index.bundle.css index.css`
            ]
        }
    ]
}

custom function script

the type of the function should be (context: { [key: string]: any }, parameters: string[]) => Promise<void>

module.exports = {
    build: () => new Promise((resolve, reject) => {
        setTimeout(() => {
            resolve()
        }, 1000)
    }),
    test: async () => {
        // todo
    }
}

The context can be used to transfer data between different scripts.

module.exports = {
    build: [
        context => {
            context.foo = 'abc'
            return Promise.resolve()
        },
        context => {
            console.log(context.foo) // 'abc'
            return Promise.resolve()
        }
    ]
}

The parameters can be passed from CLI parameters

module.exports = {
    build: (context, parameters) => {
        console.log(parameters) // run `clean-scripts build foo bar`, got `["foo", "bar"]`
        return Promise.resolve()
    }
}

child script

module.exports = {
    build: [
        `rimraf dist/`,
        `tsc -p src/`
    ],
    lint: {
        ts: `tslint "src/**/*.ts"`,
        js: `standard "**/*.config.js"`
    }
}

• run clean-scripts build[0] to run rimraf dist/
• run clean-scripts lint.ts to run tslint "src/**/*.ts"

start service

const { Service } = require('clean-scripts')

module.exports = {
  build: [
    new Service('http-server -p 8000'),
    new Service('http-server', 'server2') // the child process can be accessed by `context.server2` later
  ]
}

All services will be killed(send SIGINT actually) after all scripts end, or any script errors.

start program

const { Program } = require('clean-scripts')

module.exports = {
  build: [
    new Program('http-server -p 8000', 10000) // the program will last at most 10 seconds, can be used to test the start process of a program
  ]
}

All programs will be killed(send SIGINT actually) after all scripts end, or any script errors.

tasks

const { Tasks } = require('clean-scripts')

module.exports = {
    build: new Tasks([
      {
        name: 'build a',
        script: 'yarn workspace a run build'
      },
      {
        name: 'test a',
        script: 'yarn workspace a run test',
        dependencies: [
          'build a'
        ]
      },
      {
        name: 'build b',
        script: 'yarn workspace b run build',
        dependencies: [
          'build a'
        ]
      },
      {
        name: 'test b',
        script: 'yarn workspace b run test',
        dependencies: [
          'build b'
        ]
      }
    ])
}

the 4 tasks will be execuated in following order:

1. build a
2. build b and test a
3. test b as soon as build b completed

This can be very useful and effective for complex or dynamic tasks.

short-hand methods

const { sleep, readableStreamEnd, execAsync, executeScriptAsync, checkGitStatus } = require('clean-scripts')

module.exports = {
  build: [
    () => sleep(5000), // sleep milliseconds
    async () => {
        const readable = getReadableStreamSomehow()
        readable.on('data', chunk => {
            console.log(`Received ${chunk.length} bytes of data.`)
        })
        await readableStreamEnd(readable) // wait readable stream ends
    },
    async () => {
        const { stdout } = await execAsync('git status -s') // promisified `childProcess.exec`
        if (stdout) {
            console.log(stdout)
            throw new Error(`generated files doesn't match.`)
        }
    },
    async () => {
        await executeScriptAsync([ // support string script, array script, child script, nested script and so on
            `rimraf dist/`,
            `tsc -p src/`
        ])
    },
    () => checkGitStatus() // check git status
  ]
}

Changelog

1.10.0 (2019-04-30)

• feat: more detailed time for tasks (b5bb6e8)
• feat: support tasks (7be60b4)
• chore: update dependencies (202dfc4) (5625474) (9f961d5) (35cfe50) (f74f6f3) (f280996) (65957a2) (6a58977) (95af15f) (666a229) (feeb1d5) (2dc81fb) (f52549b) (4ffb412) (0eddb55) (4f2d661) (7967815) (f649444) (2652242) (b311ae7) (4e8bc0c) (870a221) (0ab3393) (43c40d4) (922bf71) (2e34277) (7bcde22) (6386635) (d17ff7f) (310cbf2) (9d4469e) (3c268c0) (b100494) (bb368a3) (c805e58) (833b604) (e9e1c4f) (16cd1ab) (3377693) (fc93110) (3640f54) (2d35589) (f0fc30a) (6fd72de) (2d06a54) (ba473aa) (7cfd28e) (67c5947) (eec0343) (8325d0f) (b3d13d5)
• build: use type-coverage badge (a6d9458)
• chore: add type-coverage check (d88511e)