run things to eternity.
JavaScript
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
lib
.gitignore
LICENSE
README.md
package.json

README.md

#eternal

run things to eternity. It shouldn't matter what those runnable things happen to be.

##Installation

$ [sudo] npm install eternal -g

##Options

--help, -h - show help
--version, -v - show version
--debug, -d - show verbose debugging output

##Commands:

####start [script]

Start a script. Usage: eternal start thing.js

If a service is already running with the same key (or filename without a key specified), the running service will be stopped and the new one started.

#####Options

--exec, -e - specify an executable.
Can be either absolute/relative path or a command found in $PATH
Defaults to node

--max, -m - specify max number of restarts. Set to 0 for infinite restarts
Defaults to 0

--log - Explicit path to logfile for this service's stdout/stderr. Defaults to ~/.eternal/.log

--key - identifier to use for the service. This identifier will be used in logs and commands. (recommended)

#####Examples:

Start a node app that will restart forever:
eternal start app.js -n 0

Start a ruby script:
eternal start script.rb -e ruby

Start a script with an identifier:
eternal start script.js --key stage_app

####stop [file]

Stop a script. Usage: eternal stop thing.js

If a key was specified in eternal start command, it should be used instead of filename.

#####Examples:

eternal stop app.js

eternal stop stage_app

####stopall

Stop all eternal services [for current user]. Usage: eternal stopall

####restart [file]

Restart a script. Usage: eternal restart thing.js

If a key was specified in eternal start command, it should be used instead of filename.

#####Examples:

eternal restart app.js

eternal restart stage_app

####restartall

Restart all currently monitored services. Usage: eternal restartall

####list

List all currently monitored services. Usage: eternal list

#####Options

--json - output JSON instead of pretty-printing

#TODO v0.1.0:

output modes -- pretty print, JSON

basic tests

Options:

  • --color, --nocolor - for better pretty-printing

  • --watch: watch files for changes and restart, with options as to which files are watched