first commit

install/secu/make/node_modules/cmd-promise/.npmignore

@@ -0,0 +1,6 @@
+
+node_modules/
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+$RECYCLE.BIN/

install/secu/make/node_modules/cmd-promise/README.md

@@ -0,0 +1,164 @@
+
+# CMD Promise
+
+Node command line interface with a simple Promise based API.
+
+[![JavaScript Style Guide](https://img.shields.io/badge/code%20style-standard-brightgreen.svg)](http://standardjs.com/)
+[![Version](https://img.shields.io/npm/v/cmd-promise.svg)](https://www.npmjs.com/package/cmd-promise)
+[![Downloads](https://img.shields.io/npm/dt/cmd-promise.svg)](https://www.npmjs.com/package/cmd-promise)
+
+Inspired by [node-cmd](https://github.com/RIAEvangelist/node-cmd).
+
+## Features
+
+- Simple Promise based API.
+- Single or multiple commands in one call.
+- Passes the [`exec()`](https://nodejs.org/api/child_process.html#child_process_child_process_exec_command_options_callback) node options through.
+- Returns an `object` containing both `stdout` and `stderr`.
+- Optionally return the [child process](https://nodejs.org/api/child_process.html#child_process_class_childprocess) instead of the output.
+- Zero dependencies.
+
+## Requirments
+
+Uses native node promises (including `Promise.all` with generic iterables) so requires at least node version 4.0.0. See [http://node.green/](http://node.green/#ES2015-built-ins-Promise).
+
+## Install
+
+`npm install cmd-promise`
+
+## Examples
+
+### Single command
+
+```js
+const cmd = require('cmd-promise')
+
+cmd(`node -v`).then(out => {
+  console.log('out =', out)
+}).catch(err => {
+  console.log('err =', err)
+})
+
+// out = { stdout: 'v4.2.2\r\n', stderr: '' }
+```
+
+### Multiple commands
+
+```js
+const cmd = require('cmd-promise')
+
+const commands = `
+  node -v
+  npm -v
+`
+
+cmd(commands).then(out => {
+  console.log('out =', out)
+}).catch(err => {
+  console.log('err =', err)
+})
+
+// out = [ { stdout: 'v4.2.2\r\n', stderr: '' }, { stdout: '4.4.1\n', stderr: '' } ]
+// out[0].stdout = v4.2.2
+```
+
+### More involved example
+
+```js
+const semver = require('semver') // https://github.com/npm/node-semver
+const cmd = require('cmd-promise')
+
+const commands = `
+  npm view npm version
+  npm -v
+`
+
+cmd(commands).then(out => {
+  return {
+    npm: out[0].stdout.replace(/\n/g, ''),
+    me: out[1].stdout.replace(/\n/g, '')
+  }
+}).then(versions => {
+  if (semver.lt(versions.me, versions.npm)) {
+    console.log(`My npm version is out of date (npm install npm@latest -g).`)
+  } else {
+    console.log(`My npm version is up to date! :-)`)
+  }
+}).catch(err => {
+  console.log('err =', err)
+})
+```
+
+### Return the child process instead
+
+```js
+const cmd = require('../cmd-promise')
+
+const options = { returnProcess: true }
+
+cmd(`node -v`, options).then(childProcess => {
+  console.log('pid =', childProcess.pid)
+  childProcess.stdout.on('data', stdout => {
+    console.log('stdout =', stdout)
+  })
+  childProcess.stderr.on('data', stderr => {
+    console.log('stderr =', stderr)
+  })
+}).catch(err => {
+  console.log('err =', err)
+})
+```
+
+### Pass exec() options
+
+Pass [`child_process.exec()`](https://nodejs.org/api/child_process.html#child_process_child_process_exec_command_options_callback) options as defined in the node docs.
+
+```js
+const cmd = require('../cmd-promise')
+
+const execOptions = { timeout: 1000 }
+
+cmd(`node -v`, {}, execOptions).then(out => {
+  console.log('out =', out)
+}).catch(err => {
+  console.log('err =', err)
+})
+```
+
+## API
+
+`cmd(commands [,options] [,execOptions]) -> Promise`
+
+- **commands** (string) Single or multiple line string of commands to execute.
+- **options** (object)
+  - `returnProcess` (boolean) Return the child process instead of waiting on and returning the outcome. Default is `false`.
+- **execOptions** (object) Options as passed to the  [`exec()`](https://nodejs.org/api/child_process.html#child_process_child_process_exec_command_options_callback) method of the [child_process](https://nodejs.org/api/child_process.html) node module.
+
+Returns a Promise.
+
+For **single** commands the promises return value is an `object` containing `stdout` and `stderr` properties. If `options.returnProcess` is set to `true` the return value is the [child process](https://nodejs.org/api/child_process.html#child_process_class_childprocess) instead.
+
+```js
+const cmd = require('cmd-promise')
+
+cmd(`node -v`).then(out => {
+  console.log('out.stdout =', out.stdout) // v4.2.2
+  console.log('out.stderr =', out.stderr)
+})
+```
+
+For **multiple line** command calls the promises return value is an array of `object`'s containing `stdout` and `stderr` properties. If `options.returnProcess` is set to `true` the return value is an array of [child processes](https://nodejs.org/api/child_process.html#child_process_class_childprocess) instead.
+
+```js
+const cmd = require('cmd-promise')
+
+const commands = `
+  node -v
+  npm -v
+`
+
+cmd(commands).then(out => {
+  console.log('out[0] =', out[0]) // result from 'node -v'
+  console.log('out[1] =', out[1]) // result from 'npm -v'
+})
+```

install/secu/make/node_modules/cmd-promise/cmd-promise.js

@@ -0,0 +1,88 @@
+
+const exec = require('child_process').exec
+
+/**
+ * does the given object have the given property
+ * @param  {object} obj  object to check.
+ * @param  {string} prop property to check for.
+ * @return Boolean
+ */
+function hasProp (obj, prop) {
+  return obj.hasOwnProperty(prop)
+}
+
+/**
+ * is this a string please sir?
+ * @param  {string} str string (or is it?) to check.
+ * @return Boolean
+ */
+function isString (str) {
+  return (typeof str === 'string' || str instanceof String)
+}
+
+/**
+ * wrapper for child_process.exec()
+ * @param  {string} command     command line command to run.
+ * @param  {object} options     cmd-promise options.
+ * @param  {object} execOptions exec() options object as outlined in the node docs.
+ * @return Promise
+ */
+function runCommand (command, options, execOptions) {
+  // defaults
+  if (!options) { options = {} }
+  if (!execOptions) { execOptions = {} }
+
+  // resolve to the child process?
+  const returnProcess = hasProp(options, 'returnProcess') ? options.returnProcess : false
+
+  return new Promise((resolve, reject) => {
+    if (returnProcess) {
+      // resolve to the child process, don't wait for the output
+      resolve(exec(command, execOptions))
+    } else {
+      // resolve to the output, using the callback
+      exec(command, execOptions, (error, stdout, stderr) => {
+        if (error) { return reject(error) }
+        resolve({ stdout, stderr })
+      })
+    }
+  })
+}
+
+/**
+ * run one or many commands
+ * @param  {string} commands command line command(s) string to run.
+ * @param  {object} options  options object as outlined in the node docs.
+ * @return Promise
+ */
+function cmdPromise (commands, options, execOptions) {
+  // make sure the command is a string
+  if (!isString(commands)) {
+    return Promise.reject(new Error('Command not a string.'))
+  }
+
+  // do we have multiple lines?
+  if (commands.indexOf('\n') > -1) {
+    // split by new lines
+    const arrSplit = commands.split(/\n/g)
+
+    // remove empty array elements
+    const arrFiltered = arrSplit.filter(ele => ele.length)
+
+    // trim each array element
+    const arrTrimmed = arrFiltered.map(ele => ele.trim())
+
+    // array of command promises
+    const arrOut = arrTrimmed.map(command => {
+      return runCommand(command, options, execOptions)
+    })
+
+    // multiple lines, return an array of outs
+    return Promise.all(arrOut)
+  } else {
+    // one line, run it
+    return runCommand(commands, options, execOptions)
+  }
+}
+
+module.exports = cmdPromise

install/secu/make/node_modules/cmd-promise/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "cmd-promise",
+  "version": "1.2.0",
+  "description": "Node command line interface with a simple Promise based API.",
+  "main": "cmd-promise.js",
+  "scripts": {
+    "test": ""
+  },
+  "author": {
+    "name": "Stephen Last",
+    "email": "stephen.last@gmail.com"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "semver": "^5.3.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stephen-last/cmd-promise.git"
+  }
+}

install/secu/make/node_modules/cmd-promise/test/my-npm-version.js

@@ -0,0 +1,25 @@
+
+const semver = require('semver')
+const cmd = require('../cmd-promise')
+
+console.log('cmd-promise: More involved example.')
+
+const commands = `
+  npm view npm version
+  npm -v
+`
+
+cmd(commands).then(out => {
+  return {
+    npm: out[0].stdout.replace(/\n/g, ''),
+    me: out[1].stdout.replace(/\n/g, '')
+  }
+}).then(versions => {
+  if (semver.lt(versions.me, versions.npm)) {
+    console.log(`My npm version is out of date (npm install npm@latest -g).`)
+  } else {
+    console.log(`My npm version is up to date! :-)`)
+  }
+}).catch(err => {
+  console.log('err =', err)
+})

install/secu/make/node_modules/cmd-promise/test/process.js

@@ -0,0 +1,18 @@
+
+const cmd = require('../cmd-promise')
+
+console.log('cmd-promise: Return child process instead of output.')
+
+const options = { returnProcess: true }
+
+cmd(`node -v`, options).then(childProcess => {
+  console.log('pid =', childProcess.pid)
+  childProcess.stdout.on('data', stdout => {
+    console.log('stdout =', stdout)
+  })
+  childProcess.stderr.on('data', stderr => {
+    console.log('stderr =', stderr)
+  })
+}).catch(err => {
+  console.log('err =', err)
+})

install/secu/make/node_modules/cmd-promise/test/simple.js

@@ -0,0 +1,17 @@
+
+const cmd = require('../cmd-promise')
+
+console.log('cmd-promise: One or multiple commands.')
+
+// const single = `node -v`
+
+const multiple = `
+  node -v
+  npm -v
+`
+
+cmd(multiple).then(out => {
+  console.log('out =', out)
+}).catch(err => {
+  console.log('err =', err)
+})