Contains methods to safely spawn and manage various file system processes. It differs from the standard node.js child_process (https://nodejs.org/docs/v0.11.13/api/child_process.html#child_process_child_process) module in that it intercepts and handles many common errors that might occur when invoking child processes that could cause an application to crash. Most commonly, errors such as ENOENT and EACCESS. This enables an application to be both cleaner and more robust.

Open a file. Pass your callback to fire when it is safe to open the process

Returns whether or not we are running on a windows machine

Get locale code - eg: en-AU, fr-FR, zh-CN etc.

Given the localeCode, return the language code.

Given the localeCode, return the country code.

Has spawn sync. Returns true if the child_process spawnSync method exists, otherwise false

Has exec sync. Returns true if the child_process execSync method exists, otherwise false

Is the path to a file object an executable? Synchronised version of isExecutable

Is the path to a file object an executable? Boolean result returned as the isExecutable parameter of the passed callback.

Syncronised version of safeps.spawn. Will not return until the child process has fully closed. Results can be returned from the method call or via a passed callback. Even if a callback is passed to spawnSync, the method will still be syncronised with the child process and the callback will only return after the child process has closed.

Simple usage example:

var safeps = require('safeps'); var command = ['npm', 'install', 'jade', '--save'];

//a lot of the time you won't need the opts argument var opts = { cwd: __dirname //this is actually pointless in a real application };

var result = safeps.spawnSync(command, opts);

console.log(result.error); console.log(result.status); console.log(result.signal); console.log("I've finished...");

Wrapper around node's spawn command for a cleaner, more robust and powerful API. Launches a new process with the given command. Command line arguments are part of the command parameter (unlike the node.js spawn). Command can be an array of command line arguments or a command line string. Opts allows additional options to be sent to the spawning action.

Simple usage example:

var safeps = require('safeps');

var command = ['npm', 'install','jade','--save'];

//a lot of the time you won't need the opts argument var opts = { cwd: __dirname //this is actually pointless in a real application } function myCallback(error, stdout, stderr, status, signal){ console.log(error); console.log(status); console.log(signal); console.log("I've finished..."); } safeps.spawn(command, opts, myCallback);

Spawn multiple processes in the one method call. Launches new processes with the given array of commands. Each item in the commands array represents a command parameter sent to the safeps.spawn method, so each item can be a command line string or an array of command line inputs. It is also possible to pass a single command string and in this case calling spawnMultiple will be effectively the same as calling safeps.spawn.

Syncronised version of safeps.exec. Runs a command in a shell and buffers the output. Will not return until the child process has fully closed. Results can be returned from the method call or via a passed callback. Even if a callback is passed to execSync, the method will still be syncronised with the child process and the callback will only return after the child process has closed. Note: Stdout and stderr should be Buffers but they are strings unless encoding:null for now, nothing we should do, besides wait for joyent to reply https://github.com/joyent/node/issues/5833#issuecomment-82189525.

Wrapper around node's exec command for a cleaner, more robust and powerful API. Runs a command in a shell and buffers the output. Note: Stdout and stderr should be Buffers but they are strings unless encoding:null for now, nothing we should do, besides wait for joyent to reply https://github.com/joyent/node/issues/5833#issuecomment-82189525.

Exec multiple processes in the one method call. Launches new processes with the given array of commands. Each item in the commands array represents a command parameter sent to the safeps.exec method, so each item can be a command line string or an array of command line inputs. It is also possible to pass a single command string and in this case calling execMultiple will be effectively the same as calling safeps.exec.

Get the system's environment paths.

Given an executable name, search and find its actual path. Will search the standard file paths defined by the environment to see if the executable is in any of those paths.

Get home path. Returns the user's home directory. Based upon home function from: https://github.com/isaacs/osenv

Path to the evironment's temporary directory. Based upon tmpdir function from: https://github.com/isaacs/osenv

Path to the evironment's GIT directory. As 'git' is not always available in the environment path, we should check common path locations and if we find one that works, then we should use it.

Path to the evironment's Node directory. As 'node' is not always available in the environment path, we should check common path locations and if we find one that works, then we should use it

Path to the evironment's NPM directory. As 'npm' is not always available in the environment path, we should check common path locations and if we find one that works, then we should use it

Initialize a git Repository. Requires internet access.

Pull from a git repository if it already exists on the file system else initialize new Git repository. Requires internet access.

Init Node Modules with cross platform support supports linux, heroku, osx, windows

Spawn Node Modules with cross platform support supports linux, heroku, osx, windows spawnNodeModule(name:string, args:array, opts:object, next:function) Better than https://github.com/mafintosh/npm-execspawn as it uses safeps