Comparing version 2.0.4 to 3.0.0
// Prepare | ||
var each = require("./"); | ||
var arr = ["first", "second", "third"]; | ||
var obj = {a:"first", b:"second", c:"third"}; | ||
var iterator = function(value,key){ | ||
console.log({value:value, key:key}); | ||
if ( value === "second" ) { | ||
console.log("break"); | ||
return false; | ||
const eachr = require('./') | ||
const arr = ['first', 'second', 'third'] | ||
const obj = {a: 'first', b: 'second', c: 'third'} | ||
const map = new Map([['a', 'first'], ['b', 'second'], ['c', 'third']]) | ||
function iterator (value, key) { | ||
console.log({value: value, key: key}) | ||
if ( value === 'second' ) { | ||
console.log('break') | ||
return false | ||
} | ||
}; | ||
} | ||
// Cycle Array | ||
each(arr, iterator); | ||
// {"value":"first", "key":0} | ||
// {"value":"second", "key":1} | ||
eachr(arr, iterator) | ||
// {'value': 'first', 'key': 0} | ||
// {'value': 'second', 'key': 1} | ||
// break | ||
// Cycle Object | ||
each(obj, iterator); | ||
// {"value":"first", "key":"a"} | ||
// {"value":"second", "key":"b"} | ||
// break | ||
eachr(obj, iterator) | ||
// {'value': 'first', 'key': 'a'} | ||
// {'value': 'second', 'key': 'b'} | ||
// break | ||
// Cycle Map | ||
eachr(map, iterator) | ||
// {'value': 'first', 'key': 'a'} | ||
// {'value': 'second', 'key': 'b'} | ||
// break |
501
HISTORY.md
@@ -1,3 +0,8 @@ | ||
## History | ||
# History | ||
## v3.0.0 September 21, 2015 | ||
- Added support for maps | ||
- Specifically only support arrays, plain objects, and maps | ||
- Converted from CoffeeScript to ES6+ | ||
## v2.0.4 March 11, 2015 | ||
@@ -16,494 +21,2 @@ - Updated dependencies | ||
## v2.0.0 March 29, 2013 | ||
- Split from bal-util | ||
## v1.16.14 March 27, 2013 | ||
- Killed explicit browser support, use [Browserify](http://browserify.org/) instead | ||
- Removed the `out` directory from git | ||
- Now compiled with the coffee-script bare option | ||
## v1.16.13 March 23, 2013 | ||
- `balUtilEvents` changes: | ||
- `EventEmitterEnhanced` changes: | ||
- Now works with `once` calls in node 0.10.0 | ||
- Closes [bevry/docpad#462](https://github.com/bevry/docpad/issues/462) | ||
- Changed `emitSync` to be an alias to `emitSerial` and `emitAsync` to be an alias to `emitParallel` | ||
- Added new `getListenerGroup` function | ||
- `balUtilFlow` changes: | ||
- `fireWithOptionalCallback` can now take the method as an array of `[fireMethod,introspectMethod]` useful for pesly binds | ||
## v1.16.12 March 18, 2013 | ||
- `balUtilFlow` changes: | ||
- `Groups::run` signature changed from no arguments to a single `mode` argument | ||
## v1.16.11 March 10, 2013 | ||
- `balUtilModules` changes: | ||
- Fixed `getCountryCode` and `getLanguageCode` failing when there is no locale code | ||
## v1.16.10 March 8, 2013 | ||
- `balUtilModules` changes: | ||
- Fixed `requireFresh` regression, added test | ||
## v1.16.9 March 8, 2013 | ||
- `balUtilModules` changes: | ||
- Added `getLocaleCode` | ||
- Added `getCountryCode` | ||
- Added `getLanguageCode` | ||
## v1.16.8 February 16, 2013 | ||
- `balUtilModules` changes: | ||
- `spawnMultiple`, `execMultiple`: now accept a `tasksMode` option that can be `serial` (default) or `parallel` | ||
## v1.16.7 February 12, 2013 | ||
- `balUtilPaths` changes: | ||
- `readPath`: do not prefer gzip, but still support it for decoding, as the zlib library is buggy | ||
## v1.16.6 February 12, 2013 | ||
- `balUtilPaths` changes: | ||
- `readPath`: add support for gzip decoding for node 0.6 and higher | ||
## v1.16.5 February 6, 2013 | ||
- More [browserify](http://browserify.org/) support | ||
## v1.16.4 February 6, 2013 | ||
- [Browserify](http://browserify.org/) support | ||
## v1.16.3 February 5, 2013 | ||
- Node v0.4 support | ||
- `balUtilPaths` changes: | ||
- Removed deprecated `console.log`s when errors occur (they are now sent to the callback) | ||
- Fixed `determineExecPath` when executable requires the environment configuration | ||
- `balUtilTypes` changes: | ||
- `isEmptyObject` now works for empty values (e.g. `null`) | ||
- `balUtilFlow` changes: | ||
- Added `clone` | ||
- Added `deepClone` | ||
- `setDeep` and `getDeep` now handle `undefined` values correctly | ||
## v1.16.2 February 1, 2013 | ||
- `balUtilPaths` changes: | ||
- Added timeout support to `readPath` | ||
- `balUtilFlow` changes: | ||
- Added `setDeep` | ||
- Added `getDeep` | ||
## v1.16.1 January 25, 2013 | ||
- `balUtilFlow` changes: | ||
- Added `safeShallowExtendPlainObjects` | ||
- Added `safeDeepExtendPlainObjects` | ||
## v1.16.0 January 24, 2013 | ||
- Node v0.9 compatability | ||
- `balUtilModules` changes: | ||
- Added `getEnvironmentPaths` | ||
- Added `getStandardExecPaths(execName)` | ||
- `exec` now supports the `output` option | ||
- `determineExecPath` now resolves the possible paths and checks for their existance | ||
- This avoids Node v0.9's ENOENT crash when executing a path that doesn't exit | ||
- `getExecPath` will now try for `.exe` paths as well when running on windows if an extension hasn't already been defined | ||
- `getGitPath`, `getNodePath`, `getNpmPath` will now also check the environment paths | ||
- `balUtilFlow` changes: | ||
- Added `createSnore` | ||
- Added `suffixArray` | ||
- `flow` now accepts the signatures `({object,actions,action,args,tasks,next})`, `(object, action, args, next)` and `(actions,args,next)` | ||
- `Group` changes: | ||
- `mode` can now be either `parallel` or `serial`, rather than `async` and `sync` | ||
- `async()` is now `parallel()` (aliased for b/c) | ||
- `sync()` is now `serial()` (aliased for b/c) | ||
- `balUtilTypes` changes: | ||
- Added `isEmptyObject` | ||
## v1.15.4 January 8, 2013 | ||
- `balUtilPaths` changes: | ||
- Renamed `testIgnorePatterns` to `isIgnoredPath` | ||
- Added aliases for b/c compatibility | ||
- Added new `ignorePaths` option | ||
## v1.15.3 December 24, 2012 | ||
- `balUtilModules` changes: | ||
- Added `requireFresh` | ||
## v1.15.2 December 16, 2012 | ||
- `balUtilPaths` changes: | ||
- Fixed `scandir` not inheriting ignore patterns when recursing | ||
## v1.15.1 December 15, 2012 | ||
- `balUtilPaths` changes: | ||
- Fixed `testIgnorePatterns` when `ignoreCommonPatterns` is set to `true` | ||
## v1.15.0 December 15, 2012 | ||
- `balUtilPaths` changes: | ||
- Added `testIgnorePatterns` | ||
- Renamed `ignorePatterns` to `ignoreCommonPatterns`, and added new `ignoreCustomPatterns` | ||
- Affects `scandir` options | ||
- Added emac cache files to `ignoreCommonPatterns` | ||
## v1.14.1 December 14, 2012 | ||
- `balUtilModules` changes: | ||
- Added `getExecPath` that will fetch an executable path based on the paths within the environment `PATH` variable | ||
- Rebuilt with CoffeeScript 1.4.x | ||
## v1.14.0 November 23, 2012 | ||
- `balUtilPaths` changes: | ||
- `readPath` will now follow url redirects | ||
## v1.13.13 October 26, 2012 | ||
- `balUtilPaths` changes: | ||
- Files that start with `~` are now correctly ignored in `commonIgnorePatterns` | ||
## v1.13.12 October 22, 2012 | ||
- `balUtilFlow` changes: | ||
- `extend` is now an alias of `shallowExtendPlainObjects` as they were exactly the same | ||
- `balUtilHTML` changes: | ||
- `replaceElement` and `replaceElementAsync` changes: | ||
- now accept arguments in object form as well | ||
- accept a `removeIndentation` argument that defaults to `true` | ||
## v1.13.11 October 22, 2012 | ||
- `balUtilPaths` changes: | ||
- `ensurePath` now returns `err` and `exists` instead of just `err` | ||
- `balUtilModules` changes: | ||
- `initGitRepo` will now default `remote` to `origin` and `branch` to `master` | ||
- Added `initOrPullGitRepo` | ||
## v1.13.10 October 7, 2012 | ||
- `balUtilPaths` changes: | ||
- Added `shallowExtendPlainObjects` | ||
## v1.13.9 October 7, 2012 | ||
- `balUtilPaths` changes: | ||
- VIM swap files now added to `commonIgnorePatterns` | ||
- Thanks to [Sean Fridman](https://github.com/sfrdmn) for [pull request #4](https://github.com/balupton/bal-util/pull/4) | ||
## v1.13.8 October 2, 2012 | ||
- `balUtilModules` changes: | ||
- Added `openProcess` and `closeProcess`, and using them in `spawn` and `exec`, used to prevent `EMFILE` errors when there are too many open processes | ||
- Max number of open processes is configurable via the `NODE_MAX_OPEN_PROCESSES` environment variable | ||
` balUtilPaths` changes: | ||
- Max number of open files is now configurable via the`NODE_MAX_OPEN_FILES` environment variable | ||
## v1.13.7 September 24, 2012 | ||
- `balUtilPaths` changes: | ||
- Added `textExtensions` and `binaryExtensions` | ||
- The environment variables `TEXT_EXTENSIONS` and `BINARY_EXTENSIONS` will append to these arrays | ||
- Added `isText` and `isTextSync` | ||
## v1.13.6 September 18, 2012 | ||
- `balUtilPaths` changes: | ||
- Improved `getEncoding`/`getEncodingSync` detection | ||
- Will now scan start, middle and end, instead of just middle | ||
## v1.13.5 September 13, 2012 | ||
- `balUtilPaths` changes: | ||
- Added `getEncoding` and `getEncodingSync` | ||
## v1.13.4 August 28, 2012 | ||
- `balUtilModules` changes: | ||
- Failing to retrieve the path on `getGitPath`, `getNodePath` and `getNpmPath` will now result in an error | ||
## v1.13.3 August 28, 2012 | ||
- `balUtilModules` changes: | ||
- Fixed `exec` and `execMultiple` | ||
- Added `gitCommands`, `nodeCommands` and `npmCommands` | ||
- Dropped node v0.4 support, min required version now 0.6 | ||
## v1.13.2 August 16, 2012 | ||
- Repackaged | ||
## v1.13.1 August 16, 2012 | ||
- `balUtilHTML` changes: | ||
- Fixed `replaceElement` from mixing up elements that start with our desired selector, instead of being only our desired selector | ||
## v1.13.0 August 3, 2012 | ||
- `balUtilModules` changes: | ||
- Added `determineExecPath`, `getNpmPath`, `getTmpPath`, `nodeCommand` and `gitCommand` | ||
- `initNodeModules` and `initGitRepo` will now get the determined path of the executable if a path isn't passed | ||
- Re-added markdown files to npm distribution as they are required for the npm website | ||
## v1.12.5 July 18, 2012 | ||
- `balUtilTypes` changes: | ||
- Better checks for `isString` and `isNumber` under some environments | ||
- `balUtilFlow` changes: | ||
- Removed ambigious `clone` function, use `dereference` or `extend` or `deepExtendPlainObjects` instead | ||
## v1.12.4 July 12, 2012 | ||
- `balUtilTypes` changes: | ||
- `isObject` now also checks truthyness to avoid `null` and `undefined` from being objects | ||
- `isPlainObject` got so good, it can't get better | ||
- `balUtilFlow` changes: | ||
- added `deepExtendPlainObjects` | ||
## v1.12.3 July 12, 2012 | ||
- `balUtilModules` changes: | ||
- `npmCommand` will now only prefix with the nodePath if the npmPath exists | ||
- `npmCommand` and `initNodeModules` now use async fs calls instead of sync calls | ||
## v1.12.2 July 12, 2012 | ||
- `balUtilFlow` changes: | ||
- Added `dereference` | ||
## v1.12.1 July 10, 2012 | ||
- `balUtilModules` changes: | ||
- Added `stdin` option to `spawn` | ||
## v1.12.0 July 7, 2012 | ||
- Rejigged `balUtilTypes` and now top level | ||
- Other components now make use of this instead of inline `typeof` and `instanceof` checks | ||
- `balUtilFlow` changes: | ||
- `isArray` and `toString` moved to `balUtilTypes` | ||
## v1.11.2 July 7, 2012 | ||
- `balUtilFlow` changes: | ||
- Added `clone` | ||
- `balUtilModules` changes: | ||
- Fixed exists warning on `initNodeModules` | ||
- `balUtilPaths` changes: | ||
- Added `scanlist` | ||
- `scandir` changes: | ||
- If `readFiles` is `true`, then we will return the contents into the list entries as well as the tree entries (we weren't doing this for lists before) | ||
## v1.11.1 July 4, 2012 | ||
- `balUtilFlow` changes: | ||
- `Group` changes: | ||
- Cleaned up the context handling code | ||
- `Block` changes: | ||
- Block constructor as well as `createSubBlock` arguments is now a single `opts` object, acceping the options `name`, `fn`, `parentBlock` and the new `complete` | ||
- Fixed bug introduced in v1.11.0 causing blocks to complete instantly (instead of once their tasks are finished) | ||
## v1.11.0 July 1, 2012 | ||
- Added `balUtilHTML`: | ||
- `getAttribute(attributes,attribute)` | ||
- `detectIndentation(source)` | ||
- `removeIndentation(source)` | ||
- `replaceElement(source, elementNameMatcher, replaceElementCallback)` | ||
- `replaceElementAsync(source, elementNameMatcher, replaceElementCallback, next)` | ||
- `balUtilFlow` changes: | ||
- `wait(delay,fn)` introduced as an alternative to `setTimeout` | ||
- `Group` changes: | ||
- `push` and `pushAndRun` signatures are now `([context], task)` | ||
- `context` is optional, and what we should bind to this | ||
- it saves us having to often wrap our task pushing into for each scopes | ||
- task completion callbacks are now optional, if not specified a task will be completed as soon as it finishes executing | ||
- `balUtilEvents`, `balUtilModules` changes: | ||
- Now make use of the `balUtilFlow.push|pushAndRun` new `context` argument to simplify some loops | ||
## v1.10.3 June 26, 2012 | ||
- `balUtilModules` changes: | ||
- `initNodeModules` will now install modules from cache, unless `force` is true | ||
## v1.10.2 June 26, 2012 | ||
- `balUtilModules` changes: | ||
- `initNodeModules` will now never install modules from cache | ||
## v1.10.1 June 26, 2012 | ||
- `balUtilModules` changes: | ||
- Fixed `npmCommand` under some situations | ||
## v1.10.0 June 26, 2012 | ||
- `balUtilModules` changes: | ||
- Added `spawnMultiple`, `execMultiple`, `gitGitPath`, `getNodePath`, and `npmCommand` | ||
- `spawn` and `exec` are now only for single commands, use the new `spawnMultiple` and `execMultiple` for multiple commands instead | ||
- error exit code is now anything that isnt `0` | ||
## v1.9.4 June 22, 2012 | ||
- Fixed a problem with large asynchronous groups | ||
## v1.9.3 June 22, 2012 | ||
- `balUtilFlow` changes: | ||
- Added `extractOptsAndCallback` and `extend` | ||
## v1.9.2 June 21, 2012 | ||
- `balUtilFlow` changes: | ||
- Added `fireWithOptionalCallback`, updated groups and emitters to use this | ||
## v1.9.1 June 21, 2012 | ||
- `balUtilModules` changes: | ||
- `initNodeModules` now supports `output` option | ||
## v1.9.0 June 21, 2012 | ||
- `balUtilEvents` changes: | ||
- `EventEmitterEnhanced` changes: | ||
- `emitSync` and `emitAsync` changes: | ||
- The next callback is now optional, if it is not detected then we will automatically mark the listener as completed once we have executed it (in other words, if it doesn't have a next callback, then we treat it as a synchronous listener) | ||
## v1.8.8 June 19, 2012 | ||
- Fixed a problem with large synchronous groups | ||
## v1.8.7 June 19, 2012 | ||
- Defaulted `dependencies` to an empty object, to hopefully fix [npm issue #2540](https://github.com/isaacs/npm/pull/2540) | ||
## v1.8.6 June 19, 2012 | ||
- `balUtilEvents` changes: | ||
- Split `emitSync` and `emitAsync` out of `EventSystem` and into new `EventEmitterEnhanced` that `EventSystem` extends | ||
## v1.8.5 June 11, 2012 | ||
- Made next callbacks necessary by default | ||
## v1.8.4 June 11, 2012 | ||
- `balUtilModule` changes: | ||
- `spawn` | ||
- will now return results in the order of `err`, `stdout`, `stderr`, `code`, `signal` | ||
- now splits string commands using `/ /` | ||
- `balUtilFlow` changes: | ||
- `Group` will now only return error as an array if we have more than one error | ||
- Updated for Joe v1.0.0 | ||
## v1.8.3 June 9, 2012 | ||
- `balUtilCompare` changes: | ||
- `packageCompare` will now fail gracefully if it receives malformed json | ||
## v1.8.2 June 9, 2012 | ||
- Removed request dependency, we now use the native http/https modules | ||
## v1.8.1 June 9, 2012 | ||
- Restructured directories | ||
- Removed generated docs, use the wiki instead | ||
- Moved tests from Mocha to [Joe](https://github.com/bevry/joe) | ||
- Travis now tests against node v0.7 | ||
- `balUtilPaths` changes: | ||
- Added `exists` and `existsSync` to normalize node's 0.6 to 0.8 api differences | ||
- Made [request](https://github.com/mikeal/request) an optional dependency | ||
## v1.8.0 June 9, 2012 | ||
- Added expiremental `balUtilFlow.Block` | ||
- Possibly some undocumented `balUtilFlow.Group` changes | ||
## v1.7.0 June 4, 2012 | ||
- `balUtilFlow` changes: | ||
- `Group` changes: | ||
- Constructor now supports `next` and `mode` arguments in any order | ||
- `clear()` now clears everything | ||
- Added `hasTasks()` | ||
- Group completion callback's first argument (the error argument) is now an array of errors (or null if no errors) | ||
- Added `breakOnError` option (defaults to `true`) | ||
- Added `autoClear` option to clear once all tasks have run (defualts to `false`) | ||
## v1.6.5 May 30, 2012 | ||
- `balUtilFlow` changes: | ||
- `Group` changes: | ||
- Reverted the change made in v1.6.4 where errors in callbacks still increment the complete count | ||
- Instead, you should be using the `hasExited()` instead of `hasCompleted()` which is used to find out if everything passed successfully | ||
## v1.6.4 May 30, 2012 | ||
- `balUtilFlow` changes: | ||
- Added `flow({object,action,[args],[tasks],next})` to simplify calling a series of functions of an object | ||
- `Group` changes: | ||
- If complete callback is called with an error, it'll still increment the complete count (it didn't before) | ||
- Added `hasExited()` | ||
- `balUtilPaths` changes: | ||
- `writeFile` will now call `ensurePath` before writing the file | ||
## v1.6.3 May 22, 2012 | ||
- `balUtilPaths` changes: | ||
- Fixed a problem introduced with v1.6.0 with `isDirectory` not opening the file before closing it | ||
- If the number of open files becomes a negative number, we will now throw an error | ||
- Decreased the max amount of allowed open files from `500` to `100` | ||
- Increased the wait time for opening a file from `50` to `100` | ||
- This is now customisable through the global `waitingToOpenFileDelay` | ||
## v1.6.2 May 13, 2012 | ||
- Added support for `balUtilFlow` and `balUtilTypes` to be used inside web browsers | ||
## v1.6.1 May 4, 2012 | ||
- `balUtilPaths` changes: | ||
- Fixed `initNodeModules` | ||
## v1.6.0 May 4, 2012 | ||
- We now pre-compile our coffee-script | ||
- `balUtilPaths` changes: | ||
- Added `readFile`, `writeFile`, `mkdir`, `stat`, `readdir`, `unlink`, `rmdir` | ||
- Renamed `rmdir` to `rmdirDeep` | ||
- `balUtilModules` changes: | ||
- Removed `initGitSubmodules`, `gitPull` | ||
- Added `initGitRepo` | ||
- Rewrote `initNodeModules` | ||
## v1.5.0 April 18, 2012 | ||
- `balUtilPaths` changes: | ||
- `scan` was removed, not sure what it was used for | ||
- `isDirectory` now returns the `fileStat` argument to the callback | ||
- `scandir` changes: | ||
- `ignorePatterns` option when set to true now uses the new `balUtilPaths.commonIgnorePatterns` property | ||
- fixed error throwing when passed an invalid path | ||
- now supports a new `stat` option | ||
- will return the `fileStat` argument to the `fileAction` and `dirAction` callbacks | ||
- `ignorePatterns` and `ignoreHiddenFiles` will now correctly be passed to child scandir calls | ||
- `cpdir` and `rpdir` now uses `path.join` and support `ignoreHiddenFiles` and `ignorePatterns` | ||
- `writetree` now uses `path.join` | ||
## v1.4.3 April 14, 2012 | ||
- CoffeeScript dependency is now bundled | ||
- Fixed incorrect octal `0700` should have been `700` | ||
## v1.4.2 April 5, 2012 | ||
- Fixed a failing test due to the `bal-util.npm` to `bal-util` rename | ||
- Improvements to `balUtilModules.spawn` | ||
- will only return an error if the exit code was `1` | ||
- will also contain the `code` and `signal` with the results | ||
- `results[x][0]` is now the stderr string, rather than an error object | ||
## v1.4.1 April 5, 2012 | ||
- Added `spawn` to `balUtilModules` | ||
- Added `ignoreHiddenFiles` option to `balUtilPaths.scandir` | ||
## v1.4.0 April 2, 2012 | ||
- Renamed `balUtilGroups` to `balUtilFlow` | ||
- Added `toString`, `isArray` and `each` to `balUtilFlow` | ||
- Added `rpdir`, `empty`, and `isPathOlderThan` to `balUtilPaths` | ||
## v1.3.0 February 26, 2012 | ||
- Added `openFile` and `closeFile` to open and close files safely (always stays below the maximum number of allowed open files) | ||
- Updated all path utilities to use `openFile` and `closeFile` | ||
- Added npm scripts | ||
## v1.2.0 February 14, 2012 | ||
- Removed single and multi modes from `exec`, now always returns the same consistent `callback(err,results)` instead | ||
## v1.1.0 February 6, 2012 | ||
- Modularized | ||
- Added [docco](http://jashkenas.github.com/docco/) docs | ||
## v1.0 February 5, 2012 | ||
- Moved unit tests to [Mocha](http://visionmedia.github.com/mocha/) | ||
- Offers more flexible unit testing | ||
- Offers better guarantees that tests actually ran, and that they actually ran correctly | ||
- Added `readPath` and `scantree` | ||
- Added `readFiles` option to `scandir` | ||
- `scandir` now supports arguments in object format | ||
- Removed `parallel` | ||
- Tasks inside groups now are passed `next` as there only argument | ||
- Removed `resolvePath`, `expandPath` and `expandPaths`, they were essentially the same as `path.resolve` | ||
- Most functions will now chain | ||
- `comparePackage` now supports comparing two local, or two remote packages | ||
- Added `gitPull` | ||
## v0.9 January 18, 2012 | ||
- Added `exec`, `initNodeModules`, `initGitSubmodules`, `EventSystem.when` | ||
- Added support for no callbacks | ||
## v0.8 November 2, 2011 | ||
- Considerable improvements to `scandir`, `cpdir` and `rmdir` | ||
- Note, passing `false` as the file or dir actions will now skip all of that type. Pass `null` if you do not want that. | ||
- `dirAction` is now fired before we read the directories children, if you want it to fire after then in the next callback, pass a callback in the 3rd argument. See `rmdir` for an example of this. | ||
- Fixed npm web to url warnings | ||
## v0.7 October 3, 2011 | ||
- Added `versionCompare` and `packageCompare` functions | ||
- Added `request` dependency | ||
## v0.6 September 14, 2011 | ||
- Updated `util.Group` to support `async` and `sync` grouping | ||
## v0.4 June 2, 2011 | ||
- Added util.type for testing the type of a variable | ||
- Added util.expandPath and util.expandPaths | ||
## v0.3 June 1, 2011 | ||
- Added util.Group class for your async needs :) | ||
## v0.2 May 20, 2011 | ||
- Added some tests with expresso | ||
- util.scandir now returns err,list,tree | ||
- Added util.writetree | ||
## v0.1 May 18, 2011 | ||
- Initial commit | ||
- Split from [bal-util](https://github.com/balupton/bal-util) |
@@ -1,23 +0,23 @@ | ||
<!-- LICENSEFILE/ --> | ||
# License | ||
<h1>License</h1> | ||
Unless stated otherwise all works are: | ||
- Copyright © Bevry Pty Ltd <us@bevry.me> (http://bevry.me) | ||
<ul><li>Copyright © <a href="http://bevry.me">Bevry Pty Ltd</a></li></ul> | ||
and licensed under: | ||
- The incredibly [permissive](http://en.wikipedia.org/wiki/Permissive_free_software_licence) [MIT License](http://opensource.org/licenses/mit-license.php) | ||
<ul><li><a href="http://spdx.org/licenses/MIT.html">MIT License</a></li></ul> | ||
## MIT License | ||
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: | ||
<h2>MIT License</h2> | ||
<pre> | ||
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. | ||
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. | ||
</pre> | ||
<!-- /LICENSEFILE --> | ||
{ | ||
"name": "eachr", | ||
"version": "2.0.4", | ||
"description": "Give eachr an array or object, and the iterator, in return eachr will give the iterator the value and key of each item, and will stop if the iterator returned false.", | ||
"version": "3.0.0", | ||
"description": "Give eachr an item to iterate (array, object or map) and an iterator, then in return eachr gives iterator the value and key of each item, and will stop if the iterator returned false.", | ||
"homepage": "https://github.com/bevry/eachr", | ||
"license": "MIT", | ||
"keywords": [ | ||
"flow", | ||
"each", | ||
"cycle" | ||
"cycle", | ||
"forEach", | ||
"map", | ||
"object", | ||
"array" | ||
], | ||
"author": "Bevry Pty Ltd <us@bevry.me> (http://bevry.me)", | ||
"license": { | ||
"type": "MIT" | ||
}, | ||
"browsers": true, | ||
"badges": { | ||
"travis": true, | ||
"npm": true, | ||
"npmdownloads": true, | ||
"david": true, | ||
"daviddev": true, | ||
"gratipay": "bevry", | ||
"flattr": "344188/balupton-on-Flattr", | ||
"paypal": "QB8GQPZAH84N6", | ||
"bitcoin": "https://coinbase.com/checkouts/9ef59f5479eec1d97d63382c9ebcb93a", | ||
"wishlist": "http://amzn.com/w/2F8TXKSNAFG4V" | ||
"list": [ | ||
"travisci", | ||
"npmversion", | ||
"npmdownloads", | ||
"daviddm", | ||
"daviddmdev", | ||
"---", | ||
"slackin", | ||
"patreon", | ||
"gratipay", | ||
"flattr", | ||
"paypal", | ||
"bitcoin", | ||
"wishlist" | ||
], | ||
"config": { | ||
"patreonUsername": "bevry", | ||
"gratipayUsername": "bevry", | ||
"flattrCode": "344188/balupton-on-Flattr", | ||
"paypalButtonID": "QB8GQPZAH84N6", | ||
"bitcoinURL": "https://bevry.me/bitcoin", | ||
"wishlistURL": "https://bevry.me/wishlist", | ||
"slackinURL": "https://slack.bevry.me" | ||
} | ||
}, | ||
"author": "Bevry Pty Ltd <us@bevry.me> (http://bevry.me)", | ||
"maintainers": [ | ||
"Benjamin Lupton <b@lupton.cc> (https://github.com/balupton)" | ||
"Benjamin Lupton <b@lupton.cc> (http://balupton.com)" | ||
], | ||
"contributors": [ | ||
"Benjamin Lupton <b@lupton.cc> (https://github.com/balupton)", | ||
"sfrdmn (https://github.com/sfrdmn)" | ||
"Benjamin Lupton <b@lupton.cc> (http://balupton.com)", | ||
"Sean Fridman <fridman@mail.sfsu.edu> (www.seanfridman.com)", | ||
"Rob Loach <robloach@gmail.com> (http://robloach.net)" | ||
], | ||
@@ -46,21 +62,34 @@ "bugs": { | ||
"dependencies": { | ||
"typechecker": "^2.0.8" | ||
"esnextguardian": "^1.1.0", | ||
"typechecker": "^4.0.0" | ||
}, | ||
"devDependencies": { | ||
"coffee-script": "^1.9.1", | ||
"assert-helpers": "^4.0.1", | ||
"babel": "^5.8.23", | ||
"babel-eslint": "^4.1.3", | ||
"eslint": "^1.5.0", | ||
"joe": "^1.6.0", | ||
"joe-reporter-console": "^1.2.1", | ||
"chai": "^2.1.1", | ||
"projectz": "^0.5.0" | ||
"projectz": "^1.0.6" | ||
}, | ||
"directories": { | ||
"lib": "./out/lib" | ||
"main": "./esnextguardian.js", | ||
"browser": "./es5/lib/eachr.js", | ||
"jspm": { | ||
"main": "./esnext/lib/eachr.js" | ||
}, | ||
"scripts": { | ||
"test": "node ./out/test/eachr-test.js" | ||
"clean": "node --harmony nakefile.js clean", | ||
"setup": "node --harmony nakefile.js setup", | ||
"compile": "node --harmony nakefile.js compile", | ||
"watch": "node --harmony nakefile.js watch", | ||
"verify": "node --harmony nakefile.js verify", | ||
"meta": "node --harmony nakefile.js meta", | ||
"prepare": "node --harmony nakefile.js prepare", | ||
"release": "node --harmony nakefile.js release", | ||
"test": "node --harmony ./es5/test/eachr-test.js" | ||
}, | ||
"main": "./out/lib/eachr.js", | ||
"cakeConfiguration": { | ||
"COFFEE_SRC_PATH": "src" | ||
"nakeConfiguration": { | ||
"BABEL_SRC_PATH": "esnext", | ||
"ESLINT_SRC_PATH": "esnext" | ||
} | ||
} |
135
README.md
<!-- TITLE/ --> | ||
# Eachr | ||
<h1>eachr</h1> | ||
<!-- /TITLE --> | ||
<!-- BADGES/ --> | ||
[![Build Status](https://img.shields.io/travis/bevry/eachr/master.svg)](http://travis-ci.org/bevry/eachr "Check this project's build status on TravisCI") | ||
[![NPM version](https://img.shields.io/npm/v/eachr.svg)](https://npmjs.org/package/eachr "View this project on NPM") | ||
[![NPM downloads](https://img.shields.io/npm/dm/eachr.svg)](https://npmjs.org/package/eachr "View this project on NPM") | ||
[![Dependency Status](https://img.shields.io/david/bevry/eachr.svg)](https://david-dm.org/bevry/eachr) | ||
[![Dev Dependency Status](https://img.shields.io/david/dev/bevry/eachr.svg)](https://david-dm.org/bevry/eachr#info=devDependencies)<br/> | ||
[![Gratipay donate button](https://img.shields.io/gratipay/bevry.svg)](https://www.gratipay.com/bevry/ "Donate weekly to this project using Gratipay") | ||
[![Flattr donate button](https://img.shields.io/badge/flattr-donate-yellow.svg)](http://flattr.com/thing/344188/balupton-on-Flattr "Donate monthly to this project using Flattr") | ||
[![PayPayl donate button](https://img.shields.io/badge/paypal-donate-yellow.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QB8GQPZAH84N6 "Donate once-off to this project using Paypal") | ||
[![BitCoin donate button](https://img.shields.io/badge/bitcoin-donate-yellow.svg)](https://coinbase.com/checkouts/9ef59f5479eec1d97d63382c9ebcb93a "Donate once-off to this project using BitCoin") | ||
[![Wishlist browse button](https://img.shields.io/badge/wishlist-donate-yellow.svg)](http://amzn.com/w/2F8TXKSNAFG4V "Buy an item on our wishlist for us") | ||
<span class="badge-travisci"><a href="http://travis-ci.org/bevry/eachr" title="Check this project's build status on TravisCI"><img src="https://img.shields.io/travis/bevry/eachr/master.svg" alt="Travis CI Build Status" /></a></span> | ||
<span class="badge-npmversion"><a href="https://npmjs.org/package/eachr" title="View this project on NPM"><img src="https://img.shields.io/npm/v/eachr.svg" alt="NPM version" /></a></span> | ||
<span class="badge-npmdownloads"><a href="https://npmjs.org/package/eachr" title="View this project on NPM"><img src="https://img.shields.io/npm/dm/eachr.svg" alt="NPM downloads" /></a></span> | ||
<span class="badge-daviddm"><a href="https://david-dm.org/bevry/eachr" title="View the status of this project's dependencies on DavidDM"><img src="https://img.shields.io/david/bevry/eachr.svg" alt="Dependency Status" /></a></span> | ||
<span class="badge-daviddmdev"><a href="https://david-dm.org/bevry/eachr#info=devDependencies" title="View the status of this project's development dependencies on DavidDM"><img src="https://img.shields.io/david/dev/bevry/eachr.svg" alt="Dev Dependency Status" /></a></span> | ||
<br class="badge-separator" /> | ||
<span class="badge-slackin"><a href="https://slack.bevry.me" title="Join this project's slack community"><img src="https://slack.bevry.me/badge.svg" alt="Slack community badge" /></a></span> | ||
<span class="badge-patreon"><a href="http://patreon.com/bevry" title="Donate to this project using Patreon"><img src="https://img.shields.io/badge/patreon-donate-yellow.svg" alt="Patreon donate button" /></a></span> | ||
<span class="badge-gratipay"><a href="https://www.gratipay.com/bevry" title="Donate weekly to this project using Gratipay"><img src="https://img.shields.io/badge/gratipay-donate-yellow.svg" alt="Gratipay donate button" /></a></span> | ||
<span class="badge-flattr"><a href="http://flattr.com/thing/344188/balupton-on-Flattr" title="Donate to this project using Flattr"><img src="https://img.shields.io/badge/flattr-donate-yellow.svg" alt="Flattr donate button" /></a></span> | ||
<span class="badge-paypal"><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QB8GQPZAH84N6" title="Donate to this project using Paypal"><img src="https://img.shields.io/badge/paypal-donate-yellow.svg" alt="PayPal donate button" /></a></span> | ||
<span class="badge-bitcoin"><a href="https://bevry.me/bitcoin" title="Donate once-off to this project using Bitcoin"><img src="https://img.shields.io/badge/bitcoin-donate-yellow.svg" alt="Bitcoin donate button" /></a></span> | ||
<span class="badge-wishlist"><a href="https://bevry.me/wishlist" title="Buy an item on our wishlist for us"><img src="https://img.shields.io/badge/wishlist-donate-yellow.svg" alt="Wishlist browse button" /></a></span> | ||
@@ -25,3 +29,3 @@ <!-- /BADGES --> | ||
Give eachr an array or object, and the iterator, in return eachr will give the iterator the value and key of each item, and will stop if the iterator returned false. | ||
Give eachr an item to iterate (array, object or map) and an iterator, then in return eachr gives iterator the value and key of each item, and will stop if the iterator returned false. | ||
@@ -33,16 +37,16 @@ <!-- /DESCRIPTION --> | ||
## Install | ||
<h2>Install</h2> | ||
### [NPM](http://npmjs.org/) | ||
- Use: `require('eachr')` | ||
- Install: `npm install --save eachr` | ||
<a href="https://npmjs.com" title="npm is a package manager for javascript"><h3>NPM</h3></a><ul> | ||
<li>Install: <code>npm install --save eachr</code></li> | ||
<li>Use: <code>require('eachr')</code></li></ul> | ||
### [Browserify](http://browserify.org/) | ||
- Use: `require('eachr')` | ||
- Install: `npm install --save eachr` | ||
- CDN URL: `//wzrd.in/bundle/eachr@2.0.4` | ||
<a href="http://browserify.org" title="Browserify lets you require('modules') in the browser by bundling up all of your dependencies"><h3>Browserify</h3></a><ul> | ||
<li>Install: <code>npm install --save eachr</code></li> | ||
<li>Use: <code>require('eachr')</code></li> | ||
<li>CDN URL: <code>//wzrd.in/bundle/eachr@3.0.0</code></li></ul> | ||
### [Ender](http://enderjs.com) | ||
- Use: `require('eachr')` | ||
- Install: `ender add eachr` | ||
<a href="http://enderjs.com" title="Ender is a full featured package manager for your browser"><h3>Ender</h3></a><ul> | ||
<li>Install: <code>ender add eachr</code></li> | ||
<li>Use: <code>require('eachr')</code></li></ul> | ||
@@ -54,26 +58,36 @@ <!-- /INSTALL --> | ||
Eachr accepts an array, object, or map. The iterator is bound to the list, and receives three arguments: the value, key, and list. | ||
``` javascript | ||
// Prepare | ||
var each = require("eachr"); | ||
var arr = ["first", "second", "third"]; | ||
var obj = {a:"first", b:"second", c:"third"}; | ||
var iterator = function(value,key){ | ||
console.log({value:value, key:key}); | ||
if ( value === "second" ) { | ||
console.log("break"); | ||
return false; | ||
const eachr = require('eachr') | ||
const arr = ['first', 'second', 'third'] | ||
const obj = {a: 'first', b: 'second', c: 'third'} | ||
const map = new Map([['a', 'first'], ['b', 'second'], ['c', 'third']]) | ||
function iterator (value, key) { | ||
console.log({value: value, key: key}) | ||
if ( value === 'second' ) { | ||
console.log('break') | ||
return false | ||
} | ||
}; | ||
} | ||
// Cycle Array | ||
each(arr, iterator); | ||
// {"value":"first", "key":0} | ||
// {"value":"second", "key":1} | ||
eachr(arr, iterator) | ||
// {'value': 'first', 'key': 0} | ||
// {'value': 'second', 'key': 1} | ||
// break | ||
// Cycle Object | ||
each(obj, iterator); | ||
// {"value":"first", "key":"a"} | ||
// {"value":"second", "key":"b"} | ||
eachr(obj, iterator) | ||
// {'value': 'first', 'key': 'a'} | ||
// {'value': 'second', 'key': 'b'} | ||
// break | ||
// Cycle Map | ||
eachr(map, iterator) | ||
// {'value': 'first', 'key': 'a'} | ||
// {'value': 'second', 'key': 'b'} | ||
// break | ||
``` | ||
@@ -83,5 +97,6 @@ | ||
## History | ||
[Discover the change history by heading on over to the `HISTORY.md` file.](https://github.com/bevry/eachr/blob/master/HISTORY.md#files) | ||
<h2>History</h2> | ||
<a href="https://github.com/bevry/eachr/blob/master/HISTORY.md#files">Discover the release history by heading on over to the <code>HISTORY.md</code> file.</a> | ||
<!-- /HISTORY --> | ||
@@ -92,5 +107,5 @@ | ||
## Contribute | ||
<h2>Contribute</h2> | ||
[Discover how you can contribute by heading on over to the `CONTRIBUTING.md` file.](https://github.com/bevry/eachr/blob/master/CONTRIBUTING.md#files) | ||
<a href="https://github.com/bevry/eachr/blob/master/CONTRIBUTING.md#files">Discover how you can contribute by heading on over to the <code>CONTRIBUTING.md</code> file.</a> | ||
@@ -102,28 +117,30 @@ <!-- /CONTRIBUTE --> | ||
## Backers | ||
<h2>Backers</h2> | ||
### Maintainers | ||
<h3>Maintainers</h3> | ||
These amazing people are maintaining this project: | ||
- Benjamin Lupton <b@lupton.cc> (https://github.com/balupton) | ||
<ul><li><a href="http://balupton.com">Benjamin Lupton</a> — <a href="https://github.com/bevry/eachr/commits?author=balupton" title="View the GitHub contributions of Benjamin Lupton on repository bevry/eachr">view contributions</a></li></ul> | ||
### Sponsors | ||
<h3>Sponsors</h3> | ||
No sponsors yet! Will you be the first? | ||
[![Gratipay donate button](https://img.shields.io/gratipay/bevry.svg)](https://www.gratipay.com/bevry/ "Donate weekly to this project using Gratipay") | ||
[![Flattr donate button](https://img.shields.io/badge/flattr-donate-yellow.svg)](http://flattr.com/thing/344188/balupton-on-Flattr "Donate monthly to this project using Flattr") | ||
[![PayPayl donate button](https://img.shields.io/badge/paypal-donate-yellow.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QB8GQPZAH84N6 "Donate once-off to this project using Paypal") | ||
[![BitCoin donate button](https://img.shields.io/badge/bitcoin-donate-yellow.svg)](https://coinbase.com/checkouts/9ef59f5479eec1d97d63382c9ebcb93a "Donate once-off to this project using BitCoin") | ||
[![Wishlist browse button](https://img.shields.io/badge/wishlist-donate-yellow.svg)](http://amzn.com/w/2F8TXKSNAFG4V "Buy an item on our wishlist for us") | ||
<span class="badge-patreon"><a href="http://patreon.com/bevry" title="Donate to this project using Patreon"><img src="https://img.shields.io/badge/patreon-donate-yellow.svg" alt="Patreon donate button" /></a></span> | ||
<span class="badge-gratipay"><a href="https://www.gratipay.com/bevry" title="Donate weekly to this project using Gratipay"><img src="https://img.shields.io/badge/gratipay-donate-yellow.svg" alt="Gratipay donate button" /></a></span> | ||
<span class="badge-flattr"><a href="http://flattr.com/thing/344188/balupton-on-Flattr" title="Donate to this project using Flattr"><img src="https://img.shields.io/badge/flattr-donate-yellow.svg" alt="Flattr donate button" /></a></span> | ||
<span class="badge-paypal"><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QB8GQPZAH84N6" title="Donate to this project using Paypal"><img src="https://img.shields.io/badge/paypal-donate-yellow.svg" alt="PayPal donate button" /></a></span> | ||
<span class="badge-bitcoin"><a href="https://bevry.me/bitcoin" title="Donate once-off to this project using Bitcoin"><img src="https://img.shields.io/badge/bitcoin-donate-yellow.svg" alt="Bitcoin donate button" /></a></span> | ||
<span class="badge-wishlist"><a href="https://bevry.me/wishlist" title="Buy an item on our wishlist for us"><img src="https://img.shields.io/badge/wishlist-donate-yellow.svg" alt="Wishlist browse button" /></a></span> | ||
### Contributors | ||
<h3>Contributors</h3> | ||
These amazing people have contributed code to this project: | ||
- [Benjamin Lupton](https://github.com/balupton) <b@lupton.cc> — [view contributions](https://github.com/bevry/eachr/commits?author=balupton) | ||
- [sfrdmn](https://github.com/sfrdmn) — [view contributions](https://github.com/bevry/eachr/commits?author=sfrdmn) | ||
<ul><li><a href="http://balupton.com">Benjamin Lupton</a> — <a href="https://github.com/bevry/eachr/commits?author=balupton" title="View the GitHub contributions of Benjamin Lupton on repository bevry/eachr">view contributions</a></li> | ||
<li><a href="www.seanfridman.com">Sean Fridman</a> — <a href="https://github.com/bevry/eachr/commits?author=sfrdmn" title="View the GitHub contributions of Sean Fridman on repository bevry/eachr">view contributions</a></li> | ||
<li><a href="http://robloach.net">Rob Loach</a> — <a href="https://github.com/bevry/eachr/commits?author=RobLoach" title="View the GitHub contributions of Rob Loach on repository bevry/eachr">view contributions</a></li></ul> | ||
[Become a contributor!](https://github.com/bevry/eachr/blob/master/CONTRIBUTING.md#files) | ||
<a href="https://github.com/bevry/eachr/blob/master/CONTRIBUTING.md#files">Discover how you can contribute by heading on over to the <code>CONTRIBUTING.md</code> file.</a> | ||
@@ -135,14 +152,12 @@ <!-- /BACKERS --> | ||
## License | ||
<h2>License</h2> | ||
Unless stated otherwise all works are: | ||
- Copyright © Bevry Pty Ltd <us@bevry.me> (http://bevry.me) | ||
<ul><li>Copyright © <a href="http://bevry.me">Bevry Pty Ltd</a></li></ul> | ||
and licensed under: | ||
- The incredibly [permissive](http://en.wikipedia.org/wiki/Permissive_free_software_licence) [MIT License](http://opensource.org/licenses/mit-license.php) | ||
<ul><li><a href="http://spdx.org/licenses/MIT.html">MIT License</a></li></ul> | ||
<!-- /LICENSE --> | ||
Sorry, the diff of this file is not supported yet
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
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
9
116
157
16832
2
7
1
+ Addedesnextguardian@^1.1.0
+ Addededitions@2.3.1(transitive)
+ Addederrlop@2.2.0(transitive)
+ Addedesnextguardian@1.2.1(transitive)
+ Addedsemver@6.3.1(transitive)
+ Addedtypechecker@4.11.0(transitive)
- Removedtypechecker@2.1.0(transitive)
Updatedtypechecker@^4.0.0