123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311 |
- var debug = require('debug')('nodemon');
- var path = require('path');
- var monitor = require('./monitor');
- var cli = require('./cli');
- var version = require('./version');
- var util = require('util');
- var utils = require('./utils');
- var bus = utils.bus;
- var help = require('./help');
- var config = require('./config');
- var spawn = require('./spawn');
- const defaults = require('./config/defaults')
- var eventHandlers = {};
- // this is fairly dirty, but theoretically sound since it's part of the
- // stable module API
- config.required = utils.isRequired;
- function nodemon(settings) {
- bus.emit('boot');
- nodemon.reset();
- // allow the cli string as the argument to nodemon, and allow for
- // `node nodemon -V app.js` or just `-V app.js`
- if (typeof settings === 'string') {
- settings = settings.trim();
- if (settings.indexOf('node') !== 0) {
- if (settings.indexOf('nodemon') !== 0) {
- settings = 'nodemon ' + settings;
- }
- settings = 'node ' + settings;
- }
- settings = cli.parse(settings);
- }
- // set the debug flag as early as possible to get all the detailed logging
- if (settings.verbose) {
- utils.debug = true;
- }
- if (settings.help) {
- if (process.stdout.isTTY) {
- process.stdout._handle.setBlocking(true); // nodejs/node#6456
- }
- console.log(help(settings.help));
- if (!config.required) {
- process.exit(0);
- }
- }
- if (settings.version) {
- version().then(function (v) {
- console.log(v);
- if (!config.required) {
- process.exit(0);
- }
- });
- return;
- }
- // nodemon tools like grunt-nodemon. This affects where
- // the script is being run from, and will affect where
- // nodemon looks for the nodemon.json files
- if (settings.cwd) {
- // this is protection to make sure we haven't dont the chdir already...
- // say like in cli/parse.js (which is where we do this once already!)
- if (process.cwd() !== path.resolve(config.system.cwd, settings.cwd)) {
- process.chdir(settings.cwd);
- }
- }
- const cwd = process.cwd();
- config.load(settings, function (config) {
- if (!config.options.dump && !config.options.execOptions.script &&
- config.options.execOptions.exec === 'node') {
- if (!config.required) {
- console.log(help('usage'));
- process.exit();
- }
- return;
- }
- // before we print anything, update the colour setting on logging
- utils.colours = config.options.colours;
- // always echo out the current version
- utils.log.info(version.pinned);
- const cwd = process.cwd();
- if (config.options.cwd) {
- utils.log.detail('process root: ' + cwd);
- }
- config.loaded.map(file => file.replace(cwd, '.')).forEach(file => {
- utils.log.detail('reading config ' + file);
- });
- if (config.options.stdin && config.options.restartable) {
- // allow nodemon to restart when the use types 'rs\n'
- process.stdin.resume();
- process.stdin.setEncoding('utf8');
- process.stdin.on('data', data => {
- const str = data.toString().trim().toLowerCase();
- // if the keys entered match the restartable value, then restart!
- if (str === config.options.restartable) {
- bus.emit('restart');
- } else if (data.charCodeAt(0) === 12) { // ctrl+l
- console.clear();
- }
- });
- } else if (config.options.stdin) {
- // so let's make sure we don't eat the key presses
- // but also, since we're wrapping, watch out for
- // special keys, like ctrl+c x 2 or '.exit' or ctrl+d or ctrl+l
- var ctrlC = false;
- var buffer = '';
- process.stdin.on('data', function (data) {
- data = data.toString();
- buffer += data;
- const chr = data.charCodeAt(0);
- // if restartable, echo back
- if (chr === 3) {
- if (ctrlC) {
- process.exit(0);
- }
- ctrlC = true;
- return;
- } else if (buffer === '.exit' || chr === 4) { // ctrl+d
- process.exit();
- } else if (chr === 13 || chr === 10) { // enter / carriage return
- buffer = '';
- } else if (chr === 12) { // ctrl+l
- console.clear();
- buffer = '';
- }
- ctrlC = false;
- });
- if (process.stdin.setRawMode) {
- process.stdin.setRawMode(true);
- }
- }
- if (config.options.restartable) {
- utils.log.info('to restart at any time, enter `' +
- config.options.restartable + '`');
- }
- if (!config.required) {
- const restartSignal = config.options.signal === 'SIGUSR2' ? 'SIGHUP' : 'SIGUSR2';
- process.on(restartSignal, nodemon.restart);
- utils.bus.on('error', () => {
- utils.log.fail((new Error().stack));
- });
- utils.log.detail((config.options.restartable ? 'or ' : '') + 'send ' +
- restartSignal + ' to ' + process.pid + ' to restart');
- }
- const ignoring = config.options.monitor.map(function (rule) {
- if (rule.slice(0, 1) !== '!') {
- return false;
- }
- rule = rule.slice(1);
- // don't notify of default ignores
- if (defaults.ignoreRoot.indexOf(rule) !== -1) {
- return false;
- return rule.slice(3).slice(0, -3);
- }
- if (rule.startsWith(cwd)) {
- return rule.replace(cwd, '.');
- }
- return rule;
- }).filter(Boolean).join(' ');
- if (ignoring) utils.log.detail('ignoring: ' + ignoring);
- utils.log.info('watching path(s): ' + config.options.monitor.map(function (rule) {
- if (rule.slice(0, 1) !== '!') {
- try {
- rule = path.relative(process.cwd(), rule);
- } catch (e) {}
- return rule;
- }
- return false;
- }).filter(Boolean).join(' '));
- utils.log.info('watching extensions: ' + (config.options.execOptions.ext || '(all)'));
- if (config.options.dump) {
- utils.log._log('log', '--------------');
- utils.log._log('log', 'node: ' + process.version);
- utils.log._log('log', 'nodemon: ' + version.pinned);
- utils.log._log('log', 'command: ' + process.argv.join(' '));
- utils.log._log('log', 'cwd: ' + cwd);
- utils.log._log('log', ['OS:', process.platform, process.arch].join(' '));
- utils.log._log('log', '--------------');
- utils.log._log('log', util.inspect(config, { depth: null }));
- utils.log._log('log', '--------------');
- if (!config.required) {
- process.exit();
- }
- return;
- }
- config.run = true;
- if (config.options.stdout === false) {
- nodemon.on('start', function () {
- nodemon.stdout = bus.stdout;
- nodemon.stderr = bus.stderr;
- bus.emit('readable');
- });
- }
- if (config.options.events && Object.keys(config.options.events).length) {
- Object.keys(config.options.events).forEach(function (key) {
- utils.log.detail('bind ' + key + ' -> `' +
- config.options.events[key] + '`');
- nodemon.on(key, function () {
- if (config.options && config.options.events) {
- spawn(config.options.events[key], config,
- [].slice.apply(arguments));
- }
- });
- });
- }
- monitor.run(config.options);
- });
- return nodemon;
- }
- nodemon.restart = function () {
- utils.log.status('restarting child process');
- bus.emit('restart');
- return nodemon;
- };
- nodemon.addListener = nodemon.on = function (event, handler) {
- if (!eventHandlers[event]) { eventHandlers[event] = []; }
- eventHandlers[event].push(handler);
- bus.on(event, handler);
- return nodemon;
- };
- nodemon.once = function (event, handler) {
- if (!eventHandlers[event]) { eventHandlers[event] = []; }
- eventHandlers[event].push(handler);
- bus.once(event, function () {
- debug('bus.once(%s)', event);
- eventHandlers[event].splice(eventHandlers[event].indexOf(handler), 1);
- handler.apply(this, arguments);
- });
- return nodemon;
- };
- nodemon.emit = function () {
- bus.emit.apply(bus, [].slice.call(arguments));
- return nodemon;
- };
- nodemon.removeAllListeners = function (event) {
- // unbind only the `nodemon.on` event handlers
- Object.keys(eventHandlers).filter(function (e) {
- return event ? e === event : true;
- }).forEach(function (event) {
- eventHandlers[event].forEach(function (handler) {
- bus.removeListener(event, handler);
- eventHandlers[event].splice(eventHandlers[event].indexOf(handler), 1);
- });
- });
- return nodemon;
- };
- nodemon.reset = function (done) {
- bus.emit('reset', done);
- };
- bus.on('reset', function (done) {
- debug('reset');
- nodemon.removeAllListeners();
- monitor.run.kill(true, function () {
- utils.reset();
- config.reset();
- config.run = false;
- if (done) {
- done();
- }
- });
- });
- // expose the full config
- nodemon.config = config;
- module.exports = nodemon;
|