@code-engine/cli

CodeEngine CLI

This is the command-line interface for CodeEngine. It exports the CodeEngineCLI class, which runs CodeEngine as instructed by the command-line arguments and environment variables.

NOTE: This is an internal library that is only intended to be used by CodeEngine. Using it outside of CodeEngine is discouraged. Use the code-engine npm package instead.

CodeEngineCLI class

This is the programmatic interface to the CodeEngine CLI.

import CodeEngineCLI from "@code-engine/cli";

// Create a new CodeEngineCLI instance
let cli = new CodeEngineCLI();

// Run it with some command-line arguments
await cli.main(["--debug", "my-generator"]);

CodeEngineCLI constructor

The constructor accepts an optional Config object.

import CodeEngineCLI from "@code-engine/cli";

// Create a new CodeEngineCLI instance with a custom config
let cli = new CodeEngine({
  process: {
    ...process,
    stdout: new WriteStream(),
    stderr: new WriteStream(),
  }
});

Config setting	Type	Default	Description
process	Process object	process (Node.js global)	A custom Process object to use instead of the Node.js global process object. This allows you to completely control all inputs and outputs.

CodeEngineCLI.log(message)

Writes a message to the stdout stream.

• message: The string to write to stdout

import CodeEngineCLI from "@code-engine/cli";

let cli = new CodeEngineCLI();

cli.log("Hello, world");

CodeEngineCLI.error(message)

Writes a message to the stderr stream.

• message: The string to write to stderr

import CodeEngineCLI from "@code-engine/cli";

let cli = new CodeEngineCLI();

cli.error("Something went wrong");

CodeEngineCLI.crash(error)

Immediately terminates the CLI with the given error.

• error: An Error object

NOTE: This method calls process.exit() internally. By default this will terminate the entire Node.js process. You can override this behavior by providing your own process object in the constructor and implementing the exit() method however you choose.

import CodeEngineCLI from "@code-engine/cli";

let cli = new CodeEngineCLI();

cli.crash(new SyntaxError("Something went wrong"));

CodeEngineCLI.awaitExit()

Waits for the CLI to exit. This function returns a Promise that only resolves when the "exit" event is emitted.

NOTE: This method calls process.on("exit") internally. By default this will wait for the Node.js process to exit. You can override this behavior by providing your own process object in the constructor and implementing the on() method however you choose.

import CodeEngineCLI from "@code-engine/cli";

let cli = new CodeEngineCLI();

await cli.awaitExit();

Contributing

Contributions, enhancements, and bug-fixes are welcome! File an issue on GitHub and submit a pull request.

Building

To build the project locally on your computer:

1. Clone this repo
   git clone https://github.com/CodeEngineOrg/code-engine-cli.git

2. Install dependencies
   npm install

3. Build the code
   npm run build

4. Run the tests
   npm test

License

@code-engine/cli is 100% free and open-source, under the MIT license. Use it however you want.

Big Thanks To

Thanks to these awesome companies for their support of Open Source developers ❤