@comet/dev-process-manager

@comet/dev-process-manager

dev-process-manager is a Node.js process manager for local development environments that need multiple processes. It can be easily integrated into existing Node.js projects.

Installation

$ npm install @comet/dev-process-manager

Recommended Alias:

alias dpm="npm exec -- dev-pm"

Usage

Add dev-pm.config.js file to the project root. This file defines all available scripts, which should be started by dev-process-manager.

dev-pm.config.js

module.exports = {
    scripts: [
        {
             name: "api",
             script: "npm run start",
             group: ["foo", "bar"], //to access a group of scripts in all commands using @groupname
             waitOn: [
                "packages/foo/lib/index.d.ts", //wait until package is built
                "tcp:5432"  //wait until database is started (tcp:$POSTGRESQL_PORT is also supported)
             ]
        },
        ...
    ],
};

Commands

Start

Start one or all processes. The script-name argument can also be multiple names, "all" or a @group.

$ npx dev-pm start [options] [script-name or @group]

Options: --follow Follow logs after starting script (script will not be stopped when stopping this process)

Stop

Stop running processes

$ npx dev-pm stop [script-name or @group]

Restart

Restart a previously started processes

$ npx dev-pm restart [options] [script-name or @group]

Options: --follow Follow logs after starting script (script will not be stopped when stopping this process)

Status

Lists running processes

$ npx dev-pm status [options] [script-name or @group]

Options: --interval [seconds] Keep status open and refresh periodically at specified interval

Logs

Prints logs of either a specific process or all running processes in real time.

$ npx dev-pm logs [script-name or @group]

Start Daemon

Starts the dev-pm daemon, usually done automatically by other commands.

$ npx dev-pm start-daemon

Shutdown

Stop all running processes and shutdown dev-pm

$ npx dev-pm shutdown

Development

Use in existing project with

npx ts-node ~/ws/dev-process-manager/src/index.ts

Changelog

2.7.0

Minor Changes

• 0e94d06: Don't inject .env file as real environment variables for child processes

  This can cause problems when the child process has a custom .env loading mechanism (e.g., additional files such as .env.secrets), but dev-pm sets environment variables which overrule the values loaded by the child process.

• ee3ebf8: Watch dev-pm.config.js and update in running daemon

  This allows modifications without having to shutdown the deamon.

  • processes are not restarted if the script command changes
  • processes are stopped if the script is removed
  • processes are not started if a new script is added
  • identifier for updates is the name of a script