údržba
This commit is contained in:
		
							
								
								
									
										6
									
								
								CyLukTs/lukan/node_modules/assert-plus/AUTHORS
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										6
									
								
								CyLukTs/lukan/node_modules/assert-plus/AUTHORS
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,6 @@
 | 
			
		||||
Dave Eddy <dave@daveeddy.com>
 | 
			
		||||
Fred Kuo <fred.kuo@joyent.com>
 | 
			
		||||
Lars-Magnus Skog <ralphtheninja@riseup.net>
 | 
			
		||||
Mark Cavage <mcavage@gmail.com>
 | 
			
		||||
Patrick Mooney <pmooney@pfmooney.com>
 | 
			
		||||
Rob Gulewich <robert.gulewich@joyent.com>
 | 
			
		||||
							
								
								
									
										14
									
								
								CyLukTs/lukan/node_modules/assert-plus/CHANGES.md
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										14
									
								
								CyLukTs/lukan/node_modules/assert-plus/CHANGES.md
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,14 @@
 | 
			
		||||
# assert-plus Changelog
 | 
			
		||||
 | 
			
		||||
## 1.0.0
 | 
			
		||||
 | 
			
		||||
- *BREAKING* assert.number (and derivatives) now accept Infinity as valid input
 | 
			
		||||
- Add assert.finite check.  Previous assert.number callers should use this if
 | 
			
		||||
  they expect Infinity inputs to throw.
 | 
			
		||||
 | 
			
		||||
## 0.2.0
 | 
			
		||||
 | 
			
		||||
- Fix `assert.object(null)` so it throws
 | 
			
		||||
- Fix optional/arrayOf exports for non-type-of asserts
 | 
			
		||||
- Add optiona/arrayOf exports for Stream/Date/Regex/uuid
 | 
			
		||||
- Add basic unit test coverage
 | 
			
		||||
							
								
								
									
										162
									
								
								CyLukTs/lukan/node_modules/assert-plus/README.md
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										162
									
								
								CyLukTs/lukan/node_modules/assert-plus/README.md
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,162 @@
 | 
			
		||||
# assert-plus
 | 
			
		||||
 | 
			
		||||
This library is a super small wrapper over node's assert module that has two
 | 
			
		||||
things: (1) the ability to disable assertions with the environment variable
 | 
			
		||||
NODE\_NDEBUG, and (2) some API wrappers for argument testing.  Like
 | 
			
		||||
`assert.string(myArg, 'myArg')`.  As a simple example, most of my code looks
 | 
			
		||||
like this:
 | 
			
		||||
 | 
			
		||||
```javascript
 | 
			
		||||
    var assert = require('assert-plus');
 | 
			
		||||
 | 
			
		||||
    function fooAccount(options, callback) {
 | 
			
		||||
        assert.object(options, 'options');
 | 
			
		||||
        assert.number(options.id, 'options.id');
 | 
			
		||||
        assert.bool(options.isManager, 'options.isManager');
 | 
			
		||||
        assert.string(options.name, 'options.name');
 | 
			
		||||
        assert.arrayOfString(options.email, 'options.email');
 | 
			
		||||
        assert.func(callback, 'callback');
 | 
			
		||||
 | 
			
		||||
        // Do stuff
 | 
			
		||||
        callback(null, {});
 | 
			
		||||
    }
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
# API
 | 
			
		||||
 | 
			
		||||
All methods that *aren't* part of node's core assert API are simply assumed to
 | 
			
		||||
take an argument, and then a string 'name' that's not a message; `AssertionError`
 | 
			
		||||
will be thrown if the assertion fails with a message like:
 | 
			
		||||
 | 
			
		||||
    AssertionError: foo (string) is required
 | 
			
		||||
    at test (/home/mark/work/foo/foo.js:3:9)
 | 
			
		||||
    at Object.<anonymous> (/home/mark/work/foo/foo.js:15:1)
 | 
			
		||||
    at Module._compile (module.js:446:26)
 | 
			
		||||
    at Object..js (module.js:464:10)
 | 
			
		||||
    at Module.load (module.js:353:31)
 | 
			
		||||
    at Function._load (module.js:311:12)
 | 
			
		||||
    at Array.0 (module.js:484:10)
 | 
			
		||||
    at EventEmitter._tickCallback (node.js:190:38)
 | 
			
		||||
 | 
			
		||||
from:
 | 
			
		||||
 | 
			
		||||
```javascript
 | 
			
		||||
    function test(foo) {
 | 
			
		||||
        assert.string(foo, 'foo');
 | 
			
		||||
    }
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
There you go.  You can check that arrays are of a homogeneous type with `Arrayof$Type`:
 | 
			
		||||
 | 
			
		||||
```javascript
 | 
			
		||||
    function test(foo) {
 | 
			
		||||
        assert.arrayOfString(foo, 'foo');
 | 
			
		||||
    }
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
You can assert IFF an argument is not `undefined` (i.e., an optional arg):
 | 
			
		||||
 | 
			
		||||
```javascript
 | 
			
		||||
    assert.optionalString(foo, 'foo');
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Lastly, you can opt-out of assertion checking altogether by setting the
 | 
			
		||||
environment variable `NODE_NDEBUG=1`.  This is pseudo-useful if you have
 | 
			
		||||
lots of assertions, and don't want to pay `typeof ()` taxes to v8 in
 | 
			
		||||
production.  Be advised:  The standard functions re-exported from `assert` are
 | 
			
		||||
also disabled in assert-plus if NDEBUG is specified.  Using them directly from
 | 
			
		||||
the `assert` module avoids this behavior.
 | 
			
		||||
 | 
			
		||||
The complete list of APIs is:
 | 
			
		||||
 | 
			
		||||
* assert.array
 | 
			
		||||
* assert.bool
 | 
			
		||||
* assert.buffer
 | 
			
		||||
* assert.func
 | 
			
		||||
* assert.number
 | 
			
		||||
* assert.finite
 | 
			
		||||
* assert.object
 | 
			
		||||
* assert.string
 | 
			
		||||
* assert.stream
 | 
			
		||||
* assert.date
 | 
			
		||||
* assert.regexp
 | 
			
		||||
* assert.uuid
 | 
			
		||||
* assert.arrayOfArray
 | 
			
		||||
* assert.arrayOfBool
 | 
			
		||||
* assert.arrayOfBuffer
 | 
			
		||||
* assert.arrayOfFunc
 | 
			
		||||
* assert.arrayOfNumber
 | 
			
		||||
* assert.arrayOfFinite
 | 
			
		||||
* assert.arrayOfObject
 | 
			
		||||
* assert.arrayOfString
 | 
			
		||||
* assert.arrayOfStream
 | 
			
		||||
* assert.arrayOfDate
 | 
			
		||||
* assert.arrayOfRegexp
 | 
			
		||||
* assert.arrayOfUuid
 | 
			
		||||
* assert.optionalArray
 | 
			
		||||
* assert.optionalBool
 | 
			
		||||
* assert.optionalBuffer
 | 
			
		||||
* assert.optionalFunc
 | 
			
		||||
* assert.optionalNumber
 | 
			
		||||
* assert.optionalFinite
 | 
			
		||||
* assert.optionalObject
 | 
			
		||||
* assert.optionalString
 | 
			
		||||
* assert.optionalStream
 | 
			
		||||
* assert.optionalDate
 | 
			
		||||
* assert.optionalRegexp
 | 
			
		||||
* assert.optionalUuid
 | 
			
		||||
* assert.optionalArrayOfArray
 | 
			
		||||
* assert.optionalArrayOfBool
 | 
			
		||||
* assert.optionalArrayOfBuffer
 | 
			
		||||
* assert.optionalArrayOfFunc
 | 
			
		||||
* assert.optionalArrayOfNumber
 | 
			
		||||
* assert.optionalArrayOfFinite
 | 
			
		||||
* assert.optionalArrayOfObject
 | 
			
		||||
* assert.optionalArrayOfString
 | 
			
		||||
* assert.optionalArrayOfStream
 | 
			
		||||
* assert.optionalArrayOfDate
 | 
			
		||||
* assert.optionalArrayOfRegexp
 | 
			
		||||
* assert.optionalArrayOfUuid
 | 
			
		||||
* assert.AssertionError
 | 
			
		||||
* assert.fail
 | 
			
		||||
* assert.ok
 | 
			
		||||
* assert.equal
 | 
			
		||||
* assert.notEqual
 | 
			
		||||
* assert.deepEqual
 | 
			
		||||
* assert.notDeepEqual
 | 
			
		||||
* assert.strictEqual
 | 
			
		||||
* assert.notStrictEqual
 | 
			
		||||
* assert.throws
 | 
			
		||||
* assert.doesNotThrow
 | 
			
		||||
* assert.ifError
 | 
			
		||||
 | 
			
		||||
# Installation
 | 
			
		||||
 | 
			
		||||
    npm install assert-plus
 | 
			
		||||
 | 
			
		||||
## License
 | 
			
		||||
 | 
			
		||||
The MIT License (MIT)
 | 
			
		||||
Copyright (c) 2012 Mark Cavage
 | 
			
		||||
 | 
			
		||||
Permission is hereby granted, free of charge, to any person obtaining a copy of
 | 
			
		||||
this software and associated documentation files (the "Software"), to deal in
 | 
			
		||||
the Software without restriction, including without limitation the rights to
 | 
			
		||||
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
 | 
			
		||||
the Software, and to permit persons to whom the Software is furnished to do so,
 | 
			
		||||
subject to the following conditions:
 | 
			
		||||
 | 
			
		||||
The above copyright notice and this permission notice shall be included in all
 | 
			
		||||
copies or substantial portions of the Software.
 | 
			
		||||
 | 
			
		||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 | 
			
		||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 | 
			
		||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 | 
			
		||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 | 
			
		||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 | 
			
		||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 | 
			
		||||
SOFTWARE.
 | 
			
		||||
 | 
			
		||||
## Bugs
 | 
			
		||||
 | 
			
		||||
See <https://github.com/mcavage/node-assert-plus/issues>.
 | 
			
		||||
							
								
								
									
										211
									
								
								CyLukTs/lukan/node_modules/assert-plus/assert.js
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										211
									
								
								CyLukTs/lukan/node_modules/assert-plus/assert.js
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,211 @@
 | 
			
		||||
// Copyright (c) 2012, Mark Cavage. All rights reserved.
 | 
			
		||||
// Copyright 2015 Joyent, Inc.
 | 
			
		||||
 | 
			
		||||
var assert = require('assert');
 | 
			
		||||
var Stream = require('stream').Stream;
 | 
			
		||||
var util = require('util');
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
///--- Globals
 | 
			
		||||
 | 
			
		||||
/* JSSTYLED */
 | 
			
		||||
var UUID_REGEXP = /^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$/;
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
///--- Internal
 | 
			
		||||
 | 
			
		||||
function _capitalize(str) {
 | 
			
		||||
    return (str.charAt(0).toUpperCase() + str.slice(1));
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
function _toss(name, expected, oper, arg, actual) {
 | 
			
		||||
    throw new assert.AssertionError({
 | 
			
		||||
        message: util.format('%s (%s) is required', name, expected),
 | 
			
		||||
        actual: (actual === undefined) ? typeof (arg) : actual(arg),
 | 
			
		||||
        expected: expected,
 | 
			
		||||
        operator: oper || '===',
 | 
			
		||||
        stackStartFunction: _toss.caller
 | 
			
		||||
    });
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
function _getClass(arg) {
 | 
			
		||||
    return (Object.prototype.toString.call(arg).slice(8, -1));
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
function noop() {
 | 
			
		||||
    // Why even bother with asserts?
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
///--- Exports
 | 
			
		||||
 | 
			
		||||
var types = {
 | 
			
		||||
    bool: {
 | 
			
		||||
        check: function (arg) { return typeof (arg) === 'boolean'; }
 | 
			
		||||
    },
 | 
			
		||||
    func: {
 | 
			
		||||
        check: function (arg) { return typeof (arg) === 'function'; }
 | 
			
		||||
    },
 | 
			
		||||
    string: {
 | 
			
		||||
        check: function (arg) { return typeof (arg) === 'string'; }
 | 
			
		||||
    },
 | 
			
		||||
    object: {
 | 
			
		||||
        check: function (arg) {
 | 
			
		||||
            return typeof (arg) === 'object' && arg !== null;
 | 
			
		||||
        }
 | 
			
		||||
    },
 | 
			
		||||
    number: {
 | 
			
		||||
        check: function (arg) {
 | 
			
		||||
            return typeof (arg) === 'number' && !isNaN(arg);
 | 
			
		||||
        }
 | 
			
		||||
    },
 | 
			
		||||
    finite: {
 | 
			
		||||
        check: function (arg) {
 | 
			
		||||
            return typeof (arg) === 'number' && !isNaN(arg) && isFinite(arg);
 | 
			
		||||
        }
 | 
			
		||||
    },
 | 
			
		||||
    buffer: {
 | 
			
		||||
        check: function (arg) { return Buffer.isBuffer(arg); },
 | 
			
		||||
        operator: 'Buffer.isBuffer'
 | 
			
		||||
    },
 | 
			
		||||
    array: {
 | 
			
		||||
        check: function (arg) { return Array.isArray(arg); },
 | 
			
		||||
        operator: 'Array.isArray'
 | 
			
		||||
    },
 | 
			
		||||
    stream: {
 | 
			
		||||
        check: function (arg) { return arg instanceof Stream; },
 | 
			
		||||
        operator: 'instanceof',
 | 
			
		||||
        actual: _getClass
 | 
			
		||||
    },
 | 
			
		||||
    date: {
 | 
			
		||||
        check: function (arg) { return arg instanceof Date; },
 | 
			
		||||
        operator: 'instanceof',
 | 
			
		||||
        actual: _getClass
 | 
			
		||||
    },
 | 
			
		||||
    regexp: {
 | 
			
		||||
        check: function (arg) { return arg instanceof RegExp; },
 | 
			
		||||
        operator: 'instanceof',
 | 
			
		||||
        actual: _getClass
 | 
			
		||||
    },
 | 
			
		||||
    uuid: {
 | 
			
		||||
        check: function (arg) {
 | 
			
		||||
            return typeof (arg) === 'string' && UUID_REGEXP.test(arg);
 | 
			
		||||
        },
 | 
			
		||||
        operator: 'isUUID'
 | 
			
		||||
    }
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
function _setExports(ndebug) {
 | 
			
		||||
    var keys = Object.keys(types);
 | 
			
		||||
    var out;
 | 
			
		||||
 | 
			
		||||
    /* re-export standard assert */
 | 
			
		||||
    if (process.env.NODE_NDEBUG) {
 | 
			
		||||
        out = noop;
 | 
			
		||||
    } else {
 | 
			
		||||
        out = function (arg, msg) {
 | 
			
		||||
            if (!arg) {
 | 
			
		||||
                _toss(msg, 'true', arg);
 | 
			
		||||
            }
 | 
			
		||||
        };
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    /* standard checks */
 | 
			
		||||
    keys.forEach(function (k) {
 | 
			
		||||
        if (ndebug) {
 | 
			
		||||
            out[k] = noop;
 | 
			
		||||
            return;
 | 
			
		||||
        }
 | 
			
		||||
        var type = types[k];
 | 
			
		||||
        out[k] = function (arg, msg) {
 | 
			
		||||
            if (!type.check(arg)) {
 | 
			
		||||
                _toss(msg, k, type.operator, arg, type.actual);
 | 
			
		||||
            }
 | 
			
		||||
        };
 | 
			
		||||
    });
 | 
			
		||||
 | 
			
		||||
    /* optional checks */
 | 
			
		||||
    keys.forEach(function (k) {
 | 
			
		||||
        var name = 'optional' + _capitalize(k);
 | 
			
		||||
        if (ndebug) {
 | 
			
		||||
            out[name] = noop;
 | 
			
		||||
            return;
 | 
			
		||||
        }
 | 
			
		||||
        var type = types[k];
 | 
			
		||||
        out[name] = function (arg, msg) {
 | 
			
		||||
            if (arg === undefined || arg === null) {
 | 
			
		||||
                return;
 | 
			
		||||
            }
 | 
			
		||||
            if (!type.check(arg)) {
 | 
			
		||||
                _toss(msg, k, type.operator, arg, type.actual);
 | 
			
		||||
            }
 | 
			
		||||
        };
 | 
			
		||||
    });
 | 
			
		||||
 | 
			
		||||
    /* arrayOf checks */
 | 
			
		||||
    keys.forEach(function (k) {
 | 
			
		||||
        var name = 'arrayOf' + _capitalize(k);
 | 
			
		||||
        if (ndebug) {
 | 
			
		||||
            out[name] = noop;
 | 
			
		||||
            return;
 | 
			
		||||
        }
 | 
			
		||||
        var type = types[k];
 | 
			
		||||
        var expected = '[' + k + ']';
 | 
			
		||||
        out[name] = function (arg, msg) {
 | 
			
		||||
            if (!Array.isArray(arg)) {
 | 
			
		||||
                _toss(msg, expected, type.operator, arg, type.actual);
 | 
			
		||||
            }
 | 
			
		||||
            var i;
 | 
			
		||||
            for (i = 0; i < arg.length; i++) {
 | 
			
		||||
                if (!type.check(arg[i])) {
 | 
			
		||||
                    _toss(msg, expected, type.operator, arg, type.actual);
 | 
			
		||||
                }
 | 
			
		||||
            }
 | 
			
		||||
        };
 | 
			
		||||
    });
 | 
			
		||||
 | 
			
		||||
    /* optionalArrayOf checks */
 | 
			
		||||
    keys.forEach(function (k) {
 | 
			
		||||
        var name = 'optionalArrayOf' + _capitalize(k);
 | 
			
		||||
        if (ndebug) {
 | 
			
		||||
            out[name] = noop;
 | 
			
		||||
            return;
 | 
			
		||||
        }
 | 
			
		||||
        var type = types[k];
 | 
			
		||||
        var expected = '[' + k + ']';
 | 
			
		||||
        out[name] = function (arg, msg) {
 | 
			
		||||
            if (arg === undefined || arg === null) {
 | 
			
		||||
                return;
 | 
			
		||||
            }
 | 
			
		||||
            if (!Array.isArray(arg)) {
 | 
			
		||||
                _toss(msg, expected, type.operator, arg, type.actual);
 | 
			
		||||
            }
 | 
			
		||||
            var i;
 | 
			
		||||
            for (i = 0; i < arg.length; i++) {
 | 
			
		||||
                if (!type.check(arg[i])) {
 | 
			
		||||
                    _toss(msg, expected, type.operator, arg, type.actual);
 | 
			
		||||
                }
 | 
			
		||||
            }
 | 
			
		||||
        };
 | 
			
		||||
    });
 | 
			
		||||
 | 
			
		||||
    /* re-export built-in assertions */
 | 
			
		||||
    Object.keys(assert).forEach(function (k) {
 | 
			
		||||
        if (k === 'AssertionError') {
 | 
			
		||||
            out[k] = assert[k];
 | 
			
		||||
            return;
 | 
			
		||||
        }
 | 
			
		||||
        if (ndebug) {
 | 
			
		||||
            out[k] = noop;
 | 
			
		||||
            return;
 | 
			
		||||
        }
 | 
			
		||||
        out[k] = assert[k];
 | 
			
		||||
    });
 | 
			
		||||
 | 
			
		||||
    /* export ourselves (for unit tests _only_) */
 | 
			
		||||
    out._setExports = _setExports;
 | 
			
		||||
 | 
			
		||||
    return out;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
module.exports = _setExports(process.env.NODE_NDEBUG);
 | 
			
		||||
							
								
								
									
										23
									
								
								CyLukTs/lukan/node_modules/assert-plus/package.json
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										23
									
								
								CyLukTs/lukan/node_modules/assert-plus/package.json
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,23 @@
 | 
			
		||||
{
 | 
			
		||||
  "author": "Mark Cavage <mcavage@gmail.com>",
 | 
			
		||||
  "name": "assert-plus",
 | 
			
		||||
  "description": "Extra assertions on top of node's assert module",
 | 
			
		||||
  "version": "1.0.0",
 | 
			
		||||
  "license": "MIT",
 | 
			
		||||
  "main": "./assert.js",
 | 
			
		||||
  "devDependencies": {
 | 
			
		||||
    "tape": "4.2.2",
 | 
			
		||||
    "faucet": "0.0.1"
 | 
			
		||||
  },
 | 
			
		||||
  "optionalDependencies": {},
 | 
			
		||||
  "scripts": {
 | 
			
		||||
    "test": "./node_modules/.bin/tape tests/*.js | ./node_modules/.bin/faucet"
 | 
			
		||||
  },
 | 
			
		||||
  "repository": {
 | 
			
		||||
    "type": "git",
 | 
			
		||||
    "url": "https://github.com/mcavage/node-assert-plus.git"
 | 
			
		||||
  },
 | 
			
		||||
  "engines": {
 | 
			
		||||
    "node": ">=0.8"
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
		Reference in New Issue
	
	Block a user