
Security News
Maven Central Adds Sigstore Signature Validation
Maven Central now validates Sigstore signatures, making it easier for developers to verify the provenance of Java packages.
A structure for representing asynchronous actions with automatic resource handling.
The Task(a, b)
structure represents values that depend on time. This allows one
to model time-based effects explicitly, such that one can have full knowledge
of when they're dealing with delayed computations, latency, or anything that
can not be computed immediately.
A common use for this monad is to replace the usual Continuation-Passing Style form of programming, in order to be able to compose and sequence time-dependent effects using the generic and powerful monadic operations.
var Task = require('data.task')
var fs = require('fs')
// read : String -> Task(Error, Buffer)
function read(path) {
return new Task(function(reject, resolve) {
fs.readFile(path, function(error, data) {
if (error) reject(error)
else resolve(data)
})
})
}
// decode : Task(Error, Buffer) -> Task(Error, String)
function decode(task) {
return task.map(function(buffer) {
return buffer.toString('utf-8')
})
}
var intro = decode(read('intro.txt'))
var outro = decode(read('outro.txt'))
// You can use `.chain` to sequence two asynchronous actions, and
// `.map` to perform a synchronous computation with the eventual
// value of the Task.
var concatenated = intro.chain(function(a) {
return outro.map(function(b) {
return a + b
})
})
// But the implementation of Task is pure, which means that you'll
// never observe the effects by using `chain` or `map` or any other
// method. The Task just records the sequence of actions that you
// wish to observe, and defers the playing of that sequence of actions
// for your application's entry-point to call.
//
// To observe the effects, you have to call the `fork` method, which
// takes a callback for the rejection, and a callback for the success.
concatenated.fork(
function(error) { throw error }
, function(data) { console.log(data) }
)
The easiest way is to grab it from NPM. If you're running in a Browser environment, you can use Browserify
$ npm install data.task
If you're not using NPM, Download the latest release, and require
the data.task.umd.js
file:
var Task = require('data.task')
Download the latest release, and require the data.task.umd.js
file:
require(['data.task'], function(Task) {
( ... )
})
Download the latest release, and load the data.task.umd.js
file. The properties are exposed in the global Task
object:
<script src="/path/to/data.task.umd.js"></script>
If you want to compile this library from the source, you'll need Git, Make, Node.js, and run the following commands:
$ git clone git://github.com/folktale/data.task.git
$ cd data.task
$ npm install
$ make bundle
This will generate the dist/data.task.umd.js
file, which you can load in
any JavaScript environment.
You can read the documentation online or build it yourself:
$ git clone git://github.com/folktale/data.task.git
$ cd data.task
$ npm install
$ make documentation
This library assumes an ES5 environment, but can be easily supported in ES3 platforms by the use of shims. Just include es5-shim :)
Copyright (c) 2013-2015 Quildreen Motta.
Released under the MIT licence.
FAQs
A structure for representing asynchronous actions with automatic resource handling.
The npm package data.task receives a total of 3,992 weekly downloads. As such, data.task popularity was classified as popular.
We found that data.task demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Maven Central now validates Sigstore signatures, making it easier for developers to verify the provenance of Java packages.
Security News
CISOs are racing to adopt AI for cybersecurity, but hurdles in budgets and governance may leave some falling behind in the fight against cyber threats.
Research
Security News
Socket researchers uncovered a backdoored typosquat of BoltDB in the Go ecosystem, exploiting Go Module Proxy caching to persist undetected for years.