generic-subshell/README.md

Allows you to run all commands as subshells and collect all exit codes

# Generic-Subshell

Run a dynamic number of bash commands in parallel, collect all exit codes.


### This project essentially has two interfaces.

1. You can interact with the shell script directly. Using NPM, install this project.* Then reference the script with:
./node_modules/generic-subshell/lib/run.sh. Or just copy and paste the script in your project and make it your own :)

2. There is a Node.js interface - pass the Node.js interface an array of commands, and this library will return with
a reference to the child process.

```js

import * as gs from 'generic-subshell';  // using es5 it's: const gs = require('generic-subshell');

const commands = [
  'echo "foo"', 
  'echo "baz"', 
  'echo "bar"'
  ];

const k = gs.run(commands);  // returns a child process

k.once('exit', function(code){
    // if code is 0, all subshells exited with code 0
    // if code is 1, at least one subshell exited with an non-zero code
});

```

# Installation:

```bash
npm install generic-subshell --save

```