Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/snowyu/promise-sequence.js
Sequnence execution promise.
https://github.com/snowyu/promise-sequence.js
asynchronous pipeline promise sequence
Last synced: 8 days ago
JSON representation
Sequnence execution promise.
- Host: GitHub
- URL: https://github.com/snowyu/promise-sequence.js
- Owner: snowyu
- License: mit
- Created: 2015-07-30T15:48:44.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-04-23T04:22:35.000Z (7 months ago)
- Last Synced: 2024-04-24T05:07:20.218Z (7 months ago)
- Topics: asynchronous, pipeline, promise, sequence
- Language: CoffeeScript
- Homepage:
- Size: 145 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE-MIT
Awesome Lists containing this project
README
### Promise Sequence [](https://npmjs.org/package/promise-sequence)
[](http://travis-ci.org/snowyu/promise-sequence.js)
[](https://codeclimate.com/github/snowyu/promise-sequence.js)
[](https://codeclimate.com/github/snowyu/promise-sequence.js/coverage)
[](https://npmjs.org/package/promise-sequence)
[](https://npmjs.org/package/promise-sequence)
Promise Sequence execution tasks.
## API
### sequence(tasks[, args][, self])
```js
var sequence = require('promise-sequence');
var resultsPromise = sequence(arrayOfTasks);
```
Run an array of tasks in sequence, without overlap. Each task will be called with the arguments passed to when.sequence(), and each may return a promise or a value.
When all tasks have completed, the returned promise will resolve to an array containing the result of each task at the corresponding array position. The returned promise will reject when any task throws or returns a rejection.
### pipeline(tasks[, args][, self])
```js
var pipeline = require('promise-sequence/lib/pipeline');
var resultsPromise = pipeline(arrayOfTasks);
```
Run an array of tasks in sequence, without overlap, similarly to `sequence`. The first task (e.g. arrayOfTasks[0]) will be called with the arguments passed to when.pipeline(), and each subsequence task will be called with the result of the previous task.
Again, each may return a promise or a value. When a task returns a promise, the fully resolved value will be passed to the next task.
When all tasks have completed, the returned promise will resolve to the result of the last task. The returned promise will reject when any task throws or returns a rejection.
### any(list, task)
```js
var any = require('promise-sequence/lib/any');
var fs = require('fs');
var readFile = Promise.promisify(fs.readFile, fs);
var readFileAndIgnoreError = function (aFile, aOptions) {
return readFile(aFile,aOptions).catch(function(){});
}
any(['./config.yml', './config.json'], readFileAndIgnoreError).then(function(result){
console.log(result);
});
```
like the bluebird.any, but it is sequence execution.
need `Promise.reduce`(patch already included).
### some(list, total, task)
```js
var some = require('promise-sequence/lib/some');
var fs = require('fs');
var readFile = Promise.promisify(fs.readFile, fs);
var readFileAndIgnoreError = function (aFile, aOptions) {
return readFile(aFile,aOptions).catch(function(){});
}
some(['./config.yml', './config.json'], 1, readFileAndIgnoreError).then(function(result){
console.log(result); //it's an array.
});
```
like the bluebird.some, but it is sequence execution.
need `Promise.reduce`(patch already included).
### Promise.reduce(iteratable, reducer, initialValue): Promise
* reducer: `function( accumulator, any item, int index, int length): Promise|T`
Given an Iterable(arrays are Iterable), or a promise of an Iterable, which produces promises (or a mix of promises and values), iterate over all the values in the Iterable into an array and reduce the array to a value using the given reducer function.
If the reducer function returns a promise, then the result of the promise is awaited, before continuing with next iteration. If any promise in the array is rejected or a promise returned by the reducer function is rejected, the result is rejected as well.
Read given files sequentially while summing their contents as an integer. Each file contains just the text 10.
need `Array.from`(patch already included).
```js
Promise.reduce(["file1.txt", "file2.txt", "file3.txt"], function(total, fileName) {
return fs.readFileAsync(fileName, "utf8").then(function(contents) {
return total + parseInt(contents, 10);
});
}, 0).then(function(total) {
//Total is 30
});
```
### Polyfill helpers
* `Array.from`: require('promise-sequence/lib/polyfill-array-from')
* `Promise.reduce`: require('promise-sequence/lib/polyfill-reduce')
* `Promise.prototype.finally`: require('promise-sequence/lib/polyfill-finally')
## usage
## License
MIT