utility - npm Package Compare versions
Comparing version 1.2.0 to 1.2.1
| 1.2.1 / 2014-11-14 | ||
| ================== | ||
| * setImmediate support argmuents | ||
| 1.2.0 / 2014-09-14 | ||
@@ -3,0 +8,0 @@ ================== |
@@ -14,543 +14,14 @@ /*! | ||
| var crypto = require('crypto'); | ||
| var copy = require('copy-to'); | ||
| /** | ||
| * A empty function. | ||
| * | ||
| * @return {Function} | ||
| * @public | ||
| */ | ||
| exports.noop = function noop() {}; | ||
| function sortObject(o) { | ||
| if (!o || Array.isArray(o) || typeof o !== 'object') { | ||
| return o; | ||
| } | ||
| var keys = Object.keys(o); | ||
| keys.sort(); | ||
| var values = []; | ||
| for (var i = 0; i < keys.length; i++) { | ||
| var k = keys[i]; | ||
| values.push([k, sortObject(o[k])]); | ||
| } | ||
| return values; | ||
| } | ||
| /** | ||
| * hash | ||
| * | ||
| * @param {String} method hash method, e.g.: 'md5', 'sha1' | ||
| * @param {String|Buffer} s | ||
| * @param {String} [format] output string format, could be 'hex' or 'base64'. default is 'hex'. | ||
| * @return {String} md5 hash string | ||
| * @public | ||
| */ | ||
| exports.hash = function hash(method, s, format) { | ||
| var sum = crypto.createHash(method); | ||
| var isBuffer = Buffer.isBuffer(s); | ||
| if (!isBuffer && typeof s === 'object') { | ||
| s = JSON.stringify(sortObject(s)); | ||
| } | ||
| sum.update(s, isBuffer ? 'binary' : 'utf8'); | ||
| return sum.digest(format || 'hex'); | ||
| }; | ||
| /** | ||
| * md5 hash | ||
| * | ||
| * @param {String|Buffer} s | ||
| * @param {String} [format] output string format, could be 'hex' or 'base64'. default is 'hex'. | ||
| * @return {String} md5 hash string | ||
| * @public | ||
| */ | ||
| exports.md5 = function md5(s, format) { | ||
| return exports.hash('md5', s, format); | ||
| }; | ||
| /** | ||
| * sha1 hash | ||
| * | ||
| * @param {String|Buffer} s | ||
| * @param {String} [format] output string format, could be 'hex' or 'base64'. default is 'hex'. | ||
| * @return {String} sha1 hash string | ||
| * @public | ||
| */ | ||
| exports.sha1 = function sha1(s, format) { | ||
| return exports.hash('sha1', s, format); | ||
| }; | ||
| /** | ||
| * HMAC algorithm. | ||
| * | ||
| * Equal bash: | ||
| * | ||
| * ```bash | ||
| * $ echo -n "$data" | openssl dgst -binary -$algorithm -hmac "$key" | openssl $encoding | ||
| * ``` | ||
| * | ||
| * @param {String} algorithm, dependent on the available algorithms supported by the version of OpenSSL on the platform. | ||
| * Examples are 'sha1', 'md5', 'sha256', 'sha512', etc. | ||
| * On recent releases, `openssl list-message-digest-algorithms` will display the available digest algorithms. | ||
| * @param {String} key, the hmac key to be used. | ||
| * @param {String|Buffer} data, content string. | ||
| * @param {String} [encoding='base64'] | ||
| * @return {String} digest string. | ||
| */ | ||
| exports.hmac = function hmac(algorithm, key, data, encoding) { | ||
| encoding = encoding || 'base64'; | ||
| var hmac = crypto.createHmac(algorithm, key); | ||
| hmac.update(data, Buffer.isBuffer(data) ? 'binary' : 'utf8'); | ||
| return hmac.digest(encoding); | ||
| }; | ||
| /** | ||
| * Base64 encode string. | ||
| * | ||
| * @param {String|Buffer} s | ||
| * @param {Boolean} [urlsafe=false] Encode string s using a URL-safe alphabet, | ||
| * which substitutes - instead of + and _ instead of / in the standard Base64 alphabet. | ||
| * @return {String} base64 encode format string. | ||
| */ | ||
| exports.base64encode = function base64encode(s, urlsafe) { | ||
| if (!Buffer.isBuffer(s)) { | ||
| s = new Buffer(s); | ||
| } | ||
| var encode = s.toString('base64'); | ||
| if (urlsafe) { | ||
| encode = encode.replace(/\+/g, '-').replace(/\//g, '_'); | ||
| } | ||
| return encode; | ||
| }; | ||
| /** | ||
| * Base64 string decode. | ||
| * | ||
| * @param {String} encode, base64 encoding string. | ||
| * @param {Boolean} [urlsafe=false] Decode string s using a URL-safe alphabet, | ||
| * which substitutes - instead of + and _ instead of / in the standard Base64 alphabet. | ||
| * @return {String} plain text. | ||
| */ | ||
| exports.base64decode = function base64decode(encode, urlsafe) { | ||
| if (urlsafe) { | ||
| encode = encode.replace(/\-/g, '+').replace(/_/g, '/'); | ||
| } | ||
| encode = new Buffer(encode, 'base64'); | ||
| return encode.toString(); | ||
| }; | ||
| /** | ||
| * Escape the given string of `html`. | ||
| * | ||
| * @param {String} html | ||
| * @return {String} | ||
| * @public | ||
| */ | ||
| exports.escape = function escape(html) { | ||
| return String(html) | ||
| .replace(/&(?!\w+;)/g, '&') | ||
| .replace(/</g, '<') | ||
| .replace(/>/g, '>') | ||
| .replace(/"/g, '"'); | ||
| }; | ||
| /** | ||
| * Array random slice with items count. | ||
| * @param {Array} arr | ||
| * @param {Number} num, number of sub items. | ||
| * @return {Array} | ||
| */ | ||
| exports.randomSlice = function randomSlice(arr, num) { | ||
| if (!num || num >= arr.length) { | ||
| return arr.slice(); | ||
| } | ||
| var index = Math.floor(Math.random() * arr.length); | ||
| var a = []; | ||
| for (var i = 0, j = index; i < num; i++) { | ||
| a.push(arr[j++]); | ||
| if (j === arr.length) { | ||
| j = 0; | ||
| } | ||
| } | ||
| return a; | ||
| }; | ||
| /** | ||
| * Safe encodeURIComponent, won't throw any error. | ||
| * If `encodeURIComponent` error happen, just return the original value. | ||
| * | ||
| * @param {String} text | ||
| * @return {String} URL encode string. | ||
| */ | ||
| exports.encodeURIComponent = function encodeURIComponent_(text) { | ||
| try { | ||
| return encodeURIComponent(text); | ||
| } catch (e) { | ||
| return text; | ||
| } | ||
| }; | ||
| /** | ||
| * Safe decodeURIComponent, won't throw any error. | ||
| * If `decodeURIComponent` error happen, just return the original value. | ||
| * | ||
| * @param {String} encodeText | ||
| * @return {String} URL decode original string. | ||
| */ | ||
| exports.decodeURIComponent = function decodeURIComponent_(encodeText) { | ||
| try { | ||
| return decodeURIComponent(encodeText); | ||
| } catch (e) { | ||
| return encodeText; | ||
| } | ||
| }; | ||
| var MONTHS = [ | ||
| 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec' | ||
| ]; | ||
| // only set once. | ||
| var TIMEZONE = ' '; | ||
| var _hourOffset = parseInt(-(new Date().getTimezoneOffset()) / 60, 10); | ||
| if (_hourOffset >= 0) { | ||
| TIMEZONE += '+'; | ||
| } else { | ||
| TIMEZONE += '-'; | ||
| } | ||
| _hourOffset = Math.abs(_hourOffset); | ||
| if (_hourOffset < 10) { | ||
| _hourOffset = '0' + _hourOffset; | ||
| } | ||
| TIMEZONE += _hourOffset + '00'; | ||
| /** | ||
| * Access log format date. format: `moment().format('DD/MMM/YYYY:HH:mm:ss ZZ')` | ||
| * | ||
| * @return {String} | ||
| */ | ||
| exports.accessLogDate = function (d) { | ||
| // 16/Apr/2013:16:40:09 +0800 | ||
| d = d || new Date(); | ||
| var date = d.getDate(); | ||
| if (date < 10) { | ||
| date = '0' + date; | ||
| } | ||
| var hours = d.getHours(); | ||
| if (hours < 10) { | ||
| hours = '0' + hours; | ||
| } | ||
| var mintues = d.getMinutes(); | ||
| if (mintues < 10) { | ||
| mintues = '0' + mintues; | ||
| } | ||
| var seconds = d.getSeconds(); | ||
| if (seconds < 10) { | ||
| seconds = '0' + seconds; | ||
| } | ||
| return date + '/' + MONTHS[d.getMonth()] + '/' + d.getFullYear() + | ||
| ':' + hours + ':' + mintues + ':' + seconds + TIMEZONE; | ||
| }; | ||
| /** | ||
| * Normal log format date. format: `moment().format('YYYY-MM-DD HH:mm:ss.SSS')` | ||
| * | ||
| * @return {String} | ||
| */ | ||
| exports.logDate = exports.YYYYMMDDHHmmssSSS = function (d, msSep) { | ||
| if (typeof d === 'string') { | ||
| // logDate(msSep) | ||
| msSep = d; | ||
| d = new Date(); | ||
| } else { | ||
| // logDate(d, msSep) | ||
| d = d || new Date(); | ||
| } | ||
| var date = d.getDate(); | ||
| if (date < 10) { | ||
| date = '0' + date; | ||
| } | ||
| var month = d.getMonth() + 1; | ||
| if (month < 10) { | ||
| month = '0' + month; | ||
| } | ||
| var hours = d.getHours(); | ||
| if (hours < 10) { | ||
| hours = '0' + hours; | ||
| } | ||
| var mintues = d.getMinutes(); | ||
| if (mintues < 10) { | ||
| mintues = '0' + mintues; | ||
| } | ||
| var seconds = d.getSeconds(); | ||
| if (seconds < 10) { | ||
| seconds = '0' + seconds; | ||
| } | ||
| var milliseconds = d.getMilliseconds(); | ||
| if (milliseconds < 10) { | ||
| milliseconds = '00' + milliseconds; | ||
| } else if (milliseconds < 100) { | ||
| milliseconds = '0' + milliseconds; | ||
| } | ||
| return d.getFullYear() + '-' + month + '-' + date + ' ' + | ||
| hours + ':' + mintues + ':' + seconds + (msSep || '.') + milliseconds; | ||
| }; | ||
| /** | ||
| * `moment().format('YYYY-MM-DD HH:mm:ss')` format date string. | ||
| * | ||
| * @return {String} | ||
| */ | ||
| exports.YYYYMMDDHHmmss = function (d, options) { | ||
| d = d || new Date(); | ||
| var dateSep = '-'; | ||
| var timeSep = ':'; | ||
| if (options) { | ||
| if (options.dateSep) { | ||
| dateSep = options.dateSep; | ||
| } | ||
| if (options.timeSep) { | ||
| timeSep = options.timeSep; | ||
| } | ||
| } | ||
| var date = d.getDate(); | ||
| if (date < 10) { | ||
| date = '0' + date; | ||
| } | ||
| var month = d.getMonth() + 1; | ||
| if (month < 10) { | ||
| month = '0' + month; | ||
| } | ||
| var hours = d.getHours(); | ||
| if (hours < 10) { | ||
| hours = '0' + hours; | ||
| } | ||
| var mintues = d.getMinutes(); | ||
| if (mintues < 10) { | ||
| mintues = '0' + mintues; | ||
| } | ||
| var seconds = d.getSeconds(); | ||
| if (seconds < 10) { | ||
| seconds = '0' + seconds; | ||
| } | ||
| return d.getFullYear() + dateSep + month + dateSep + date + ' ' + | ||
| hours + timeSep + mintues + timeSep + seconds; | ||
| }; | ||
| /** | ||
| * `moment().format('YYYY-MM-DD')` format date string. | ||
| * | ||
| * @return {String} | ||
| */ | ||
| exports.YYYYMMDD = function YYYYMMDD(d, sep) { | ||
| if (typeof d === 'string') { | ||
| // YYYYMMDD(sep) | ||
| sep = d; | ||
| d = new Date(); | ||
| } else { | ||
| // YYYYMMDD(d, sep) | ||
| d = d || new Date(); | ||
| if (typeof sep !== 'string') { | ||
| sep = '-'; | ||
| } | ||
| } | ||
| var date = d.getDate(); | ||
| if (date < 10) { | ||
| date = '0' + date; | ||
| } | ||
| var month = d.getMonth() + 1; | ||
| if (month < 10) { | ||
| month = '0' + month; | ||
| } | ||
| return d.getFullYear() + sep + month + sep + date; | ||
| }; | ||
| /** | ||
| * return datetime struct. | ||
| * | ||
| * @return {Object} date | ||
| * - {Number} YYYYMMDD, 20130401 | ||
| * - {Number} H, 0, 1, 9, 12, 23 | ||
| */ | ||
| exports.datestruct = function (now) { | ||
| now = now || new Date(); | ||
| return { | ||
| YYYYMMDD: now.getFullYear() * 10000 + (now.getMonth() + 1) * 100 + now.getDate(), | ||
| H: now.getHours() | ||
| }; | ||
| }; | ||
| /** | ||
| * Get a function parameter's names. | ||
| * | ||
| * @param {Function} func | ||
| * @param {Boolean} [useCache], default is true | ||
| * @return {Array} names | ||
| */ | ||
| exports.getParamNames = function getParamNames(func, cache) { | ||
| cache = cache !== false; | ||
| if (cache && func.__cache_names) { | ||
| return func.__cache_names; | ||
| } | ||
| var str = func.toString(); | ||
| var names = str.slice(str.indexOf('(') + 1, str.indexOf(')')).match(/([^\s,]+)/g) || []; | ||
| func.__cache_names = names; | ||
| return names; | ||
| }; | ||
| // http://www.2ality.com/2013/10/safe-integers.html | ||
| // http://es6.ruanyifeng.com/#docs/number | ||
| exports.MAX_SAFE_INTEGER = Number.MAX_SAFE_INTEGER || Math.pow(2, 53) - 1; | ||
| exports.MIN_SAFE_INTEGER = -exports.MAX_SAFE_INTEGER; | ||
| var MAX_SAFE_INTEGER_STR = exports.MAX_SAFE_INTEGER_STR = String(exports.MAX_SAFE_INTEGER); | ||
| var MAX_SAFE_INTEGER_STR_LENGTH = MAX_SAFE_INTEGER_STR.length; | ||
| /** | ||
| * Detect a number string can safe convert to Javascript Number. | ||
| * | ||
| * @param {String} s number format string, like `"123"`, `"-1000123123123123123123"` | ||
| * @return {Boolean} | ||
| */ | ||
| exports.isSafeNumberString = function isSafeNumberString(s) { | ||
| if (s[0] === '-') { | ||
| s = s.substring(1); | ||
| } | ||
| if (s.length < MAX_SAFE_INTEGER_STR_LENGTH || | ||
| (s.length === MAX_SAFE_INTEGER_STR_LENGTH && s <= MAX_SAFE_INTEGER_STR)) { | ||
| return true; | ||
| } | ||
| return false; | ||
| }; | ||
| /** | ||
| * Convert string to Number if string in safe Number scope. | ||
| * | ||
| * @param {String} s number format string. | ||
| * @return {Number|String} success will return Number, otherise return the original string. | ||
| */ | ||
| exports.toSafeNumber = function toSafeNumber(s) { | ||
| if (typeof s === 'number') { | ||
| return s; | ||
| } | ||
| return exports.isSafeNumberString(s) ? Number(s) : s; | ||
| }; | ||
| /** | ||
| * Get Unix's timestamp in seconds. | ||
| * @return {Number} | ||
| */ | ||
| exports.timestamp = function timestamp(t) { | ||
| if (t) { | ||
| var v = t; | ||
| if (typeof v === 'string') { | ||
| v = Number(v); | ||
| } | ||
| if (String(t).length === 10) { | ||
| v *= 1000; | ||
| } | ||
| return new Date(v); | ||
| } | ||
| return Math.round(Date.now() / 1000); | ||
| }; | ||
| var _setImmediate = typeof setImmediate === 'function' ? setImmediate : process.nextTick; | ||
| exports.setImmediate = function (callback) { | ||
| _setImmediate(callback); | ||
| }; | ||
| exports.randomString = function randomString(length, charSet) { | ||
| var result = []; | ||
| length = length || 16; | ||
| charSet = charSet || 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789'; | ||
| while (length--) { | ||
| result.push(charSet[Math.floor(Math.random() * charSet.length)]); | ||
| } | ||
| return result.join(''); | ||
| }; | ||
| exports.has = function has(obj, prop) { | ||
| return Object.prototype.hasOwnProperty.call(obj, prop); | ||
| }; | ||
| /** | ||
| * generate a real map object, no constructor, no __proto__ | ||
| * @param {Object} [obj], init object, optional | ||
| * @return {Object} | ||
| */ | ||
| exports.map = function map(obj) { | ||
| var map = Object.create(null); | ||
| if (!obj) { | ||
| return map; | ||
| } | ||
| for (var key in obj) { | ||
| map[key] = obj[key]; | ||
| } | ||
| return map; | ||
| }; | ||
| /** | ||
| * split string to array | ||
| * @param {String} str | ||
| * @param {String} [sep] default is ',' | ||
| * @return {Array} | ||
| */ | ||
| exports.split = function split(str, sep) { | ||
| str = str || ''; | ||
| sep = sep || ','; | ||
| var items = str.split(sep); | ||
| var needs = []; | ||
| for (var i = 0; i < items.length; i++) { | ||
| var s = items[i].trim(); | ||
| if (s.length > 0) { | ||
| needs.push(s); | ||
| } | ||
| } | ||
| return needs; | ||
| }; | ||
| // always optimized | ||
| exports.splitAlwaysOptimized = function splitAlwaysOptimized() { | ||
| var str = ''; | ||
| var sep = ','; | ||
| if (arguments.length === 1) { | ||
| str = arguments[0] || ''; | ||
| } else if (arguments.length === 2) { | ||
| str = arguments[0] || ''; | ||
| sep = arguments[1] || ','; | ||
| } | ||
| var items = str.split(sep); | ||
| var needs = []; | ||
| for (var i = 0; i < items.length; i++) { | ||
| var s = items[i].trim(); | ||
| if (s.length > 0) { | ||
| needs.push(s); | ||
| } | ||
| } | ||
| return needs; | ||
| }; | ||
| /** | ||
| * optimize try catch | ||
| * @param {Function} fn | ||
| * @return {Object} | ||
| * - {Error} error | ||
| * - {Mix} value | ||
| */ | ||
| exports.try = function (fn) { | ||
| var res = { | ||
| error: undefined, | ||
| value: undefined | ||
| }; | ||
| try { | ||
| res.value = fn(); | ||
| } catch (err) { | ||
| res.error = err instanceof Error | ||
| ? err | ||
| : new Error(err); | ||
| } | ||
| return res; | ||
| }; | ||
| copy(require('./function')) | ||
| .and(require('./polyfill')) | ||
| .and(require('./optimize')) | ||
| .and(require('./crypto')) | ||
| .and(require('./number')) | ||
| .and(require('./string')) | ||
| .and(require('./array')) | ||
| .and(require('./date')) | ||
| .and(require('./map')) | ||
| .and(require('./web')) | ||
| .to(module.exports); |
| { | ||
| "name": "utility", | ||
| "version": "1.2.0", | ||
| "version": "1.2.1", | ||
| "description": "A collection of useful utilities.", | ||
@@ -11,3 +11,3 @@ "main": "index.js", | ||
| "jshint": "jshint .", | ||
| "autod": "autod -w --prefix '~' -e benchmark && npm run cnpm", | ||
| "autod": "autod -w --prefix '~' -e benchmark", | ||
| "cnpm": "npm install --registry=https://registry.npm.taobao.org", | ||
@@ -18,3 +18,3 @@ "contributors": "contributors -f plain -o AUTHORS", | ||
| "dependencies": { | ||
| "copy-to": "~2.0.1" | ||
| }, | ||
@@ -28,7 +28,7 @@ "devDependencies": { | ||
| "jshint": "*", | ||
| "mm": "~0.2.1", | ||
| "mm": "~1.0.1", | ||
| "mocha": "*", | ||
| "moment": "~2.8.2", | ||
| "moment": "~2.8.3", | ||
| "optimized": "~1.2.0", | ||
| "should": "~4.0.4" | ||
| "should": "~4.1.0" | ||
| }, | ||
@@ -35,0 +35,0 @@ "homepage": "https://github.com/node-modules/utility", |
@@ -8,16 +8,13 @@ utility | ||
| [![Gittip][gittip-image]][gittip-url] | ||
| [![David deps][david-image]][david-url] | ||
| [![node version][node-image]][node-url] | ||
| [![npm download][download-image]][download-url] | ||
| [npm-image]: https://img.shields.io/npm/v/utility.svg?style=flat | ||
| [npm-image]: https://img.shields.io/npm/v/utility.svg?style=flat-square | ||
| [npm-url]: https://npmjs.org/package/utility | ||
| [travis-image]: https://img.shields.io/travis/node-modules/utility.svg?style=flat | ||
| [travis-image]: https://img.shields.io/travis/node-modules/utility.svg?style=flat-square | ||
| [travis-url]: https://travis-ci.org/node-modules/utility | ||
| [coveralls-image]: https://img.shields.io/coveralls/node-modules/utility.svg?style=flat | ||
| [coveralls-image]: https://img.shields.io/coveralls/node-modules/utility.svg?style=flat-square | ||
| [coveralls-url]: https://coveralls.io/r/node-modules/utility?branch=master | ||
| [gittip-image]: https://img.shields.io/gittip/fengmk2.svg?style=flat | ||
| [gittip-image]: https://img.shields.io/gittip/fengmk2.svg?style=flat-square | ||
| [gittip-url]: https://www.gittip.com/fengmk2/ | ||
| [david-image]: https://img.shields.io/david/node-modules/utility.svg?style=flat | ||
| [david-url]: https://david-dm.org/node-modules/utility | ||
| [node-image]: https://img.shields.io/badge/node.js-%3E=_0.10-green.svg?style=flat-square | ||
@@ -24,0 +21,0 @@ [node-url]: http://nodejs.org/download/ |
Sorry, the diff of this file is not supported yet
New alerts
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
Major refactor
Supply chain riskPackage has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.
Found 1 instance in 1 package
Fixed alerts
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
Improved metrics
- Number of package files
- increased by6.25%
17
Worsened metrics
- Total package byte prevSize
- decreased by-38.52%
27337
- Dependency count
- increased byInfinity%
1
- Lines of code
- decreased by-39.6%
604
- Number of lines in readme file
- decreased by-1.2%
247
- Number of medium supply chain risk alerts
- increased byInfinity%
1
Dependency changes
+ Addedcopy-to@~2.0.1
+ Addedcopy-to@2.0.1(transitive)