README.md

native-exec

Module that provides access to POSIX exec* functions.

Inspired by: https://github.com/jprichardson/node-kexec

Installation

requires a C++ compiler installed, most probably.

npm i native-exec

Usage

Replace the current process with another one:

var exec = require('native-exec');

exec('ls'); // => the process is replaced with ls, which runs and exits

Replace the current process with another one and replace process' env:

var exec = require('native-exec');

exec('ls', {
  newEnvKey: newEnvValue,
}); // => the process is replaced with ls -lsa, which runs and exits

Replace the current process with another one, replace process' env and provide arguments:

var exec = require('native-exec');

exec('ls', {
  newEnvKey: newEnvValue,
}, '-lsa'); // => the process is replaced with ls, which runs and exits

Use case

If you want to have a bootstrap script written in NodeJS you can use this module to replace the bootstrap process with the process that you actually intend to run specifying env and arguments.

LICENSE

MIT