@donkeylabs/server 0.2.9 → 0.2.11

package/examples/starter/node_modules/shelljs.exec/LICENSE.md

@@ -0,0 +1,24 @@
+ISC License
+Full name
+ISC License
+
+Short identifier
+ISC
+
+Other web pages for this license
+http://www.isc.org/software/license
+http://www.opensource.org/licenses/ISC
+Notes
+None
+
+Text
+ISC License:
+Copyright (c) 2004-2010 by Internet Systems Consortium, Inc. ("ISC")
+Copyright (c) 1995-2003 by Internet Software Consortium
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+Standard License Header
+There is no standard license header for the license

package/examples/starter/node_modules/shelljs.exec/README.md

@@ -0,0 +1,115 @@
+# shelljs.exec
+
+<br>[![Linux Build](https://img.shields.io/travis/danday74/shelljs.exec/master.svg?label=linux)](https://travis-ci.org/danday74/shelljs.exec)
+[![Windows Build](https://img.shields.io/appveyor/ci/danday74/shelljs-exec/master.svg?label=windows)](https://ci.appveyor.com/project/danday74/shelljs-exec)
+[![Coverage Status](https://coveralls.io/repos/github/danday74/shelljs.exec/badge.svg)](https://coveralls.io/github/danday74/shelljs.exec)
+<br>[![npm](https://img.shields.io/npm/v/shelljs.exec.svg)](https://www.npmjs.com/package/shelljs.exec)
+[![Dependencies Status](https://david-dm.org/danday74/shelljs.exec/status.svg)](https://david-dm.org/danday74/shelljs.exec)
+[![npm](https://img.shields.io/npm/dm/shelljs.exec.svg)](https://www.npmjs.com/package/shelljs.exec)
+[![node](https://img.shields.io/node/v/shelljs.exec.svg)](https://www.npmjs.com/package/shelljs.exec)
+
+**Replacement for shelljs' slow exec method - benchmarked 20x faster**
+
+
+
+<br>
+
+## Introduction
+
+[shelljs](https://www.npmjs.com/package/shelljs) is **FAST** &nbsp;![FAST](images/fast.png "FAST")&nbsp; but its exec method is **SLOW** &nbsp;![SLOW](images/slow.png "SLOW")
+
+- [x] Use this module instead of shelljs' exec method for speeds [20x faster](#benchmarks)
+
+- [x] Continue to use shelljs' other methods as they are lightning fast (e.g. shelljs.echo shelljs.which shelljs.cat etc)
+
+This module offers a shelljs.exec like interface and is a zero-dependency module
+
+
+
+<br>
+
+## Usage
+
+```npm install --save shelljs.exec```
+
+This module takes 2 arguments, the command to execute and an [options object](#options-object)
+
+```javascript 1.5
+var exec = require('shelljs.exec')
+var cmdObj = exec('echo hello', {silent: true})
+```
+
+Continuing from the code above, the resulting JSON looks like:
+
+```javascript 1.5
+var assert = require('assert')
+assert.deepEqual(cmdObj, {
+  error: null,
+  stdout: 'hello\n',
+  stderr: '',
+  code: 0,
+  ok: true
+})
+```
+
+
+
+<br>
+
+## Options object
+
+Available options:
+
+* `encoding`: Defaults to 'utf8'
+
+* `silent`: Do not echo any output to console, defaults to false
+
+* and any option available to Node.js' [child_process.execSync](https://nodejs.org/api/child_process.html#child_process_child_process_execsync_command_options)
+
+When the `stdio` option of child_process.execSync is provided, it overrides `silent`
+
+
+
+<br>
+
+## Benchmarks
+
+[Logs for benchmarks are here](https://travis-ci.org/danday74/shelljs.exec) and [specs are here](test/benchmarks/benchmarks.spec.js)
+
+Generally speaking, on Linux shelljs.exec (this module) is 20x faster and on Windows 5x faster than shelljs' exec method.
+
+However, shelljs supported commands, where available, are much faster than both. Use this module where no equivalent shelljs supported command is available.
+
+These tables compare average command execution times based on 1000 test runs:
+
+##### Linux (Travis CI) Node v6
+
+![Linux benchmarks](images/linux.png "Linux (Travis CI) Node v6")
+
+##### Windows (GIT bash) Node v6.10.0
+
+![Windows benchmarks](images/windows.png "Windows (GIT bash) Node v6.10.0")
+
+
+
+<br>
+
+## Limitations
+
+* No support for chaining (unlike shelljs)
+
+* Synchronous execution only (but feel free to wrap with a callback or promise)
+
+
+
+<br>
+
+## Author says
+
+But as the days of Noah were, so also will the coming of the Son of Man be. For as in the days before the flood, they were eating and drinking, marrying and giving in marriage, until the day that Noah entered the ark, and did not know until the flood came and took them all away, so also will the coming of the Son of Man be.
+
+[Matthew 24:37-39](https://www.biblegateway.com/passage/?search=Matthew+24%3A37-39&version=NKJV)
+
+
+
+<br><br><br><br><br>

package/examples/starter/node_modules/shelljs.exec/appveyor.yml

@@ -0,0 +1,17 @@
+environment:
+  matrix:
+    - nodejs_version: '8'
+    - nodejs_version: '6'
+    - nodejs_version: '4'
+    - nodejs_version: '4.0.0'
+
+install:
+  - ps: Install-Product node $env:nodejs_version
+  - npm install
+
+test_script:
+  - node --version
+  - npm --version
+  - npm test
+
+build: off

package/examples/starter/node_modules/shelljs.exec/benchmark-results-raw.txt

@@ -0,0 +1,74 @@
+Linux (Travis CI)
+Node v6
+------------------
+
+COMMAND = echo hello
+AVERAGE TIMES FOR 1000 RUNS
+shelljs.exec (from shelljs) ----->  103.45ms  (2489.63%)  24.9 times slower than shelljs.exec (this module)
+shelljs.exec (this module) ------>  4.16ms  (100%)
+shelljs.echo -------------------->  0.17ms  (4.10%)  24.4 times faster than shelljs.exec (this module)
+
+COMMAND = which git
+AVERAGE TIMES FOR 1000 RUNS
+shelljs.exec (from shelljs) ----->  169.85ms  (225.18%)  2.3 times slower than shelljs.exec (this module)
+shelljs.exec (this module) ------>  75.43ms  (100%)
+shelljs.which ------------------->  0.90ms  (1.20%)  83.5 times faster than shelljs.exec (this module)
+
+COMMAND = cat file1 file2
+AVERAGE TIMES FOR 1000 RUNS
+shelljs.exec (from shelljs) ----->  105.03ms  (2648.61%)  26.5 times slower than shelljs.exec (this module)
+shelljs.exec (this module) ------>  3.97ms  (100%)
+shelljs.cat --------------------->  0.59ms  (14.90%)  6.7 times faster than shelljs.exec (this module)
+
+COMMAND = printf hello
+AVERAGE TIMES FOR 1000 RUNS
+shelljs.exec (from shelljs) ----->  97.84ms  (3084.72%)  30.8 times slower than shelljs.exec (this module)
+shelljs.exec (this module) ------>  3.17ms  (100%)
+
+COMMAND = whoami
+AVERAGE TIMES FOR 1000 RUNS
+shelljs.exec (from shelljs) ----->  110.14ms  (2490.19%)  24.9 times slower than shelljs.exec (this module)
+shelljs.exec (this module) ------>  4.42ms  (100%)
+
+COMMAND = git rev-parse --is-inside-work-tree
+AVERAGE TIMES FOR 1000 RUNS
+shelljs.exec (from shelljs) ----->  100.61ms  (2063.79%)  20.6 times slower than shelljs.exec (this module)
+shelljs.exec (this module) ------>  4.88ms  (100%)
+
+
+Windows (GIT bash)
+Node v6.10.0
+------------------
+
+COMMAND = echo hello
+AVERAGE TIMES FOR 1000 RUNS
+shelljs.exec (from shelljs) ----->  188.52ms  (1211.70%)  12.1 times slower than shelljs.exec (this module)
+shelljs.exec (this module) ------>  15.56ms  (100%)
+shelljs.echo -------------------->  0.43ms  (2.78%)  35.9 times faster than shelljs.exec (this module)
+
+COMMAND = which git
+AVERAGE TIMES FOR 1000 RUNS
+shelljs.exec (from shelljs) ----->  332.20ms  (202.11%)  2.0 times slower than shelljs.exec (this module)
+shelljs.exec (this module) ------>  164.37ms  (100%)
+shelljs.which ------------------->  1.19ms  (0.72%)  138.6 times faster than shelljs.exec (this module)
+
+COMMAND = cat file1 file2
+AVERAGE TIMES FOR 1000 RUNS
+shelljs.exec (from shelljs) ----->  217.73ms  (531.37%)  5.3 times slower than shelljs.exec (this module)
+shelljs.exec (this module) ------>  40.97ms  (100%)
+shelljs.cat --------------------->  0.77ms  (1.88%)  53.3 times faster than shelljs.exec (this module)
+
+COMMAND = printf hello
+AVERAGE TIMES FOR 1000 RUNS
+shelljs.exec (from shelljs) ----->  235.87ms  (541.56%)  5.4 times slower than shelljs.exec (this module)
+shelljs.exec (this module) ------>  43.55ms  (100%)
+
+COMMAND = whoami
+AVERAGE TIMES FOR 1000 RUNS
+shelljs.exec (from shelljs) ----->  247.77ms  (547.43%)  5.5 times slower than shelljs.exec (this module)
+shelljs.exec (this module) ------>  45.26ms  (100%)
+
+COMMAND = git rev-parse --is-inside-work-tree
+AVERAGE TIMES FOR 1000 RUNS
+shelljs.exec (from shelljs) ----->  231.35ms  (532.92%)  5.3 times slower than shelljs.exec (this module)
+shelljs.exec (this module) ------>  43.41ms  (100%)

package/examples/starter/node_modules/shelljs.exec/index.js

@@ -0,0 +1,35 @@
+'use strict'
+
+var cp = require('child_process')
+var normaliseOptions = require('./js/normaliseOptions')
+
+function shelljsExec(command, options) {
+
+  options = normaliseOptions(options)
+
+  var error, stdout, stderr, code, ok
+
+  try {
+    error = null
+    stdout = cp.execSync(command, options)
+    stderr = ''
+    code = 0
+    ok = true
+  } catch (e) {
+    error = e
+    stdout = e.stdout
+    stderr = e.stderr
+    code = e.status || /* istanbul ignore next */ 1
+    ok = false
+  }
+
+  return {
+    error: error,
+    stdout: stdout,
+    stderr: stderr,
+    code: code,
+    ok: ok
+  }
+}
+
+module.exports = shelljsExec

package/examples/starter/node_modules/shelljs.exec/js/normaliseOptions/defaultOptions.js

@@ -0,0 +1,6 @@
+'use strict'
+
+module.exports = Object.freeze({
+  encoding: 'utf8',
+  silent: false
+})

package/examples/starter/node_modules/shelljs.exec/js/normaliseOptions/index.js

@@ -0,0 +1,34 @@
+'use strict'
+
+function isObject(obj) {
+  return obj !== null && typeof obj === 'object' && !Array.isArray(obj)
+}
+
+function toBoolean(bool) {
+  if (bool === 'false') bool = false
+  return !!bool
+}
+
+function normaliseOptions(options) {
+
+  var DEFAULTS = require('./defaultOptions')
+
+  if (!isObject(options)) {
+    options = {}
+  } else {
+
+    if (typeof options.silent !== 'undefined') {
+      options.silent = toBoolean(options.silent)
+    }
+  }
+
+  options = Object.assign({}, DEFAULTS, options)
+
+  if (options.silent && typeof options.stdio === 'undefined') {
+    options.stdio = 'pipe'
+  }
+
+  return options
+}
+
+module.exports = normaliseOptions

package/examples/starter/node_modules/shelljs.exec/js/normaliseOptions/index.spec.js

@@ -0,0 +1,68 @@
+'use strict'
+
+var imp = require('../../test/_js/testImports')
+var normaliseOptions = require('./index')
+
+describe('normaliseOptions', function() {
+
+  var actual, expected
+
+  beforeEach(function() {
+    actual = undefined
+    expected = Object.assign({}, imp.DEFAULTS)
+  })
+
+  it('options is undefined', function() {
+    actual = normaliseOptions()
+    imp.expect(actual).to.eql(expected)
+  })
+
+  it('options is not an object', function() {
+    actual = normaliseOptions(9)
+    imp.expect(actual).to.eql(expected)
+  })
+
+  it('options is an empty object', function() {
+    actual = normaliseOptions({})
+    imp.expect(actual).to.eql(expected)
+  })
+
+  it('silent is a boolean', function() {
+    expected.silent = true
+    expected.stdio = 'pipe'
+    actual = normaliseOptions({silent: true})
+    imp.expect(actual).to.eql(expected)
+  })
+
+  it('silent is not a boolean', function() {
+    actual = normaliseOptions({silent: 'false'})
+    imp.expect(actual).to.eql(expected)
+  })
+
+  it('stdio undefined when - silent off, stdio undefined', function() {
+    expected.silent = false
+    actual = normaliseOptions({silent: expected.silent})
+    imp.expect(actual).to.eql(expected)
+  })
+
+  it('stdio respected when - silent off, stdio defined', function() {
+    expected.silent = false
+    expected.stdio = 'woteva'
+    actual = normaliseOptions({silent: expected.silent, stdio: expected.stdio})
+    imp.expect(actual).to.eql(expected)
+  })
+
+  it('stdio piped when - silent on, stdio undefined', function() {
+    expected.silent = true
+    expected.stdio = 'pipe'
+    actual = normaliseOptions({silent: expected.silent})
+    imp.expect(actual).to.eql(expected)
+  })
+
+  it('stdio respected when - silent on, stdio defined', function() {
+    expected.silent = true
+    expected.stdio = 'woteva'
+    actual = normaliseOptions({silent: expected.silent, stdio: expected.stdio})
+    imp.expect(actual).to.eql(expected)
+  })
+})

package/examples/starter/node_modules/shelljs.exec/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "shelljs.exec",
+  "version": "1.1.8",
+  "description": "Replacement for shelljs' slow exec method - benchmarked 20x faster",
+  "author": "Daniel Lewis BSc (Hons)",
+  "license": "ISC",
+  "main": "index.js",
+  "scripts": {
+    "test": "./node_modules/.bin/istanbul cover -x \"**/*.spec.js\" ./node_modules/mocha/bin/_mocha",
+    "enforcer": "./node_modules/.bin/istanbul check-coverage --statement 100 --branch 100 --function 100 --line 100",
+    "build": "npm-run-all test enforcer",
+    "prepush": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/danday74/shelljs.exec.git"
+  },
+  "bugs": {
+    "url": "https://github.com/danday74/shelljs.exec/issues"
+  },
+  "homepage": "https://github.com/danday74/shelljs.exec#readme",
+  "keywords": [
+    "shelljs exec",
+    "shelljs.exec",
+    "shelljs-exec",
+    "shell",
+    "shelljs",
+    "shell js",
+    "shell.js",
+    "shell-js",
+    "child_process",
+    "child_process.exec",
+    "child_process.execSync",
+    "exec sync",
+    "exec.sync",
+    "exec-sync",
+    "bash",
+    "unix"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "chai": "^4.1.2",
+    "chalk": "^2.1.0",
+    "coveralls": "2.11.16",
+    "eslint": "^4.8.0",
+    "husky": "^0.14.3",
+    "istanbul": "^0.4.5",
+    "mocha": "^4.0.0",
+    "npm-run-all": "^4.1.1",
+    "performance-now": "^2.1.0",
+    "shelljs": "^0.7.8",
+    "sinon": "^4.0.1",
+    "sinon-chai": "^2.14.0"
+  },
+  "engines": {
+    "node": ">= 4.0.0"
+  }
+}

package/examples/starter/node_modules/shelljs.exec/test/_js/testImports.js

@@ -0,0 +1,37 @@
+'use strict'
+
+// expect sinon
+
+var chai = require('chai')
+var sinon = require('sinon')
+var sinonChai = require('sinon-chai')
+var expect = chai.expect
+chai.use(sinonChai)
+
+// others
+
+var cp = require('child_process')
+var EOL = require('os').EOL
+
+// custom
+
+var DEFAULTS = require('../../js/normaliseOptions/defaultOptions')
+
+function range(num) {
+  var range = []
+  for (var i = 0; i < num; i++) {
+    range.push(i)
+  }
+  return range
+}
+
+var testImports = {
+  expect: expect,
+  sinon: sinon,
+  cp: cp,
+  EOL: EOL,
+  DEFAULTS: DEFAULTS,
+  range: range
+}
+
+module.exports = testImports