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;