Execute shell command forwarding all stdio. 

tsertkov

exec-sh

  "description": "Execute shell command forwarding all stdio.",

    "test": "npm run lint && npm run cover-test",

    "cover-test": "istanbul cover --dir artifacts/coverage _mocha -- --reporter spec",

    "lint": "standard --verbose **/*.js",

    "dev": "mocha --reporter spec --watch",

    "jsdoc": "jsdoc --private --destination artifacts/jsdoc lib/"

    "url": "git@github.com:tsertkov/exec-sh.git"

  "author": "Aleksandr Tsertkov <tsertkov@gmail.com>",

    "url": "https://github.com/tsertkov/exec-sh/blob/master/LICENSE"

    "url": "https://github.com/tsertkov/exec-sh/issues"

[![NPM](https://nodei.co/npm/exec-sh.png)](https://nodei.co/npm/exec-sh/)

[![NPM Downloads](https://img.shields.io/npm/dm/exec-sh.svg)](https://www.npmjs.com/package/exec-sh)

[![Build Status](https://travis-ci.org/tsertkov/exec-sh.svg?branch=master)](https://travis-ci.org/tsertkov/exec-sh)

[![Coverage Status](https://img.shields.io/coveralls/tsertkov/exec-sh.svg)](https://coveralls.io/r/tsertkov/exec-sh?branch=master)

[![David Status](https://david-dm.org/tsertkov/exec-sh.png)](https://david-dm.org/tsertkov/exec-sh)

> Execute shell command forwarding all stdio streams.

exec-sh is a wrapper for [`child_process.spawn`](http://nodejs.org/api/child_process.html#child_process_child_process_spawn_command_args_options) with some improvements:

- Fowrards all stdio streams to current terminal (by default):

  - `execsh("echo -n Say: && read i && echo Said:$i")`

- stdout and stderr are passed to callback when available

execSh("echo hello exec-sh && bash", { cwd: "/home" }, function(err){

    console.log("Exit code: ", err.code);

# Terminal output: interactive bash session

execSh("echo lorem && bash", { cwd: "/home" }, function(err){

  var child = execSh(["bash -c id", "echo lorem >&2"], true,

var execShPromise = require("exec-sh").promise;

    out = await execShPromise('pwd', true);

    return console.log('Stderr: ', e.stderr);

    return console.log('Stdout: ', e.stdout);

  console.log('out: ', out.stdout, out.stderr);

### `execSh(command, [options], [callback])`

- `command {String|Array}` - The command to run, or array of commands

- `[options] {Object|TRUE}` - Options object passed directly to [`child_process.spawn`](http://nodejs.org/api/child_process.html#child_process_child_process_spawn_command_args_options), when `TRUE` then `{ stdio: null }` used

- `[callback] {Function}` - `callback(err, stdout, stderr)`

 - `err {Error|NULL}` - Error object. Has `code` property containing last command exit code when available

 - `stdout {String|NULL}` - aggregated stdout or `NULL` if not available

 - `stderr {String|NULL}` - aggregated stderr or `NULL` if not available

Returns [ChildProcess](http://nodejs.org/api/child_process.html#child_process_class_childprocess) object.

Complete API Documentation including private and public methods is generated from source code by JSDoc tool and is [available here](https://s3.eu-central-1.amazonaws.com/tsertkov-artifacts/exec-sh/master/jsdoc/index.html).

Code coverage report for all files is [available here](https://s3.eu-central-1.amazonaws.com/tsertkov-artifacts/exec-sh/master/coverage/lcov-report/index.html).

		{
		"name": "exec-sh",
		"version": "0.3.0",
		"version": "0.3.1",
		"description": "Execute shell command forwarding all stdio.",
		@@ -5,0 +5,0 @@ "main": "lib/exec-sh.js",

		@@ -81,5 +81,7 @@ # exec-sh
		} catch (e) {
		return console.log('Error: ', e);
		return console.log('Stderr: ', e.stderr);
		return console.log('Stdout: ', e.stdout);
		console.log('Error: ', e);
		console.log('Stderr: ', e.stderr);
		console.log('Stdout: ', e.stdout);

		return e;
		}
		@@ -86,0 +88,0 @@

Improved metrics

Worsened metrics