egg developer tool, extends @artus-cli/artus-cli.

npm i egg-bin --save-dev

Add egg-bin to package.json scripts:

{
  "scripts": {
    "dev": "egg-bin dev",
    "test-local": "egg-bin test",
    "test": "npm run lint -- --fix && npm run test-local",
    "cov": "egg-bin cov",
    "lint": "eslint .",
    "ci": "npm run lint && npm run cov"
  }
}

All the commands support these specific options:

• --inspect
• --inspect-brk
• --typescript / --ts enable typescript support. Auto detect from package.json's pkg.egg.typescript, or pkg.dependencies.typescript/pkg.devDependencies.typescript.
• --base / --baseDir application's root path, default to process.cwd().
• --require will add to execArgv, support multiple. Also support read from package.json's pkg.egg.require
• --dry-run / -d whether dry-run the test command, just show the command

egg-bin [command] --inspect
egg-bin [command] --inspect-brk
egg-bin [command] --typescript
egg-bin [command] --base /foo/bar

Start dev cluster on local env, it will start a master, an agent and a worker.

egg-bin dev

• --framework egg web framework root path.
• --port server port, default to 7001.
• --workers worker process number, default to 1 worker at local mode.
• --sticky start a sticky cluster server, default to false.

Create .vscode/launch.json file:

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Egg Debug",
      "runtimeExecutable": "npm",
      "runtimeArgs": [
        "run",
        "dev",
        "--",
        "--inspect-brk"
      ],
      "console": "integratedTerminal",
      "restart": true,
      "protocol": "auto",
      "port": 9229,
      "autoAttachChildProcesses": true
    },
    {
      "type": "node",
      "request": "launch",
      "name": "Egg Test",
      "runtimeExecutable": "npm",
      "runtimeArgs": [
        "run",
        "test-local",
        "--",
        "--inspect-brk"
      ],
      "protocol": "auto",
      "port": 9229,
      "autoAttachChildProcesses": true
    }
  ]
}

Using mocha to run test.

egg-bin test [...files] [options]

• files is optional, default to test/**/*.test.ts
• test/fixtures, test/node_modules is always exclude.

If test/.setup.ts file exists, it will be auto require as the first test file.

test
  ├── .setup.ts
  └── foo.test.ts

You can pass any mocha argv.

• --timeout milliseconds, default to 60000
• --changed / -c only test changed test files(test files means files that match ${pwd}/test/**/*.test.(js|ts))
• --parallel enable mocha parallel mode, default to false.
• --auto-agent auto start agent in mocha master agent.
• --jobs number of jobs to run in parallel, default to os.cpus().length - 1.
• --mochawesome enable mochawesome reporter, default to true.

Environment is also support, will use it if options not provide.

You can set TESTS env to set the tests directory, it support glob grammar.

TESTS=test/a.test.ts egg-bin test

And the reporter can set by the TEST_REPORTER env, default is spec.

TEST_REPORTER=doc egg-bin test

The test timeout can set by TEST_TIMEOUT env, default is 60000 ms.

TEST_TIMEOUT=2000 egg-bin test

Using mocha and [c8] to run code coverage, it support all test params above.

Coverage reporter will output text-summary, json and lcov.

You can pass any mocha argv.

• -x add dir ignore coverage, support multiple argv
• --prerequire prerequire files for coverage instrument, you can use this options if load files slowly when call mm.app or mm.cluster
• --typescript / --ts enable typescript support. If true, will auto add .ts extension and ignore typings and d.ts.
• --c8 c8 instruments passthrough. you can use this to overwrite egg-bin's default c8 instruments and add additional ones.

  • egg-bin have some default instruments passed to c8 like -r and --temp-directory
  • egg-bin cov --c8="-r teamcity -r text" --c8-report=true

• also support all test params above.

You can set COV_EXCLUDES env to add dir ignore coverage.

COV_EXCLUDES="app/plugins/c*,app/autocreate/**" egg-bin cov

See https://artus-cli.github.io

MIT

fengmk2	atian25	popomore	whxaxes	semantic-release-bot	dead-horse
killagu	hyj1991	mansonchor	ngot	waitingsong	onlylovermb
snyk-bot	BiosSun	luckydrq	stormslowly	snapre	ZYSzys
angleshe	ahungrynoob	yinseny	okoala

This project follows the git-contributor spec, auto updated at Wed Jan 18 2023 00:01:48 GMT+0800.