sporadic
Composable Concurrency Abstractions for JavaScript.
Example
#!/usr/bin/env node
(async () => {
const sporadic = require('sporadic')
const channel = await sporadic.channels.open()
const wasReceivedPromise = sporadic.channels.send(channel, "Hello, World!")
const messagePromise = sporadic.channels.receive(channel)
const promises = [ wasReceivedPromise, messagePromise ]
const [ wasReceived, message ] = await Promise.all(promises)
console.log(wasReceived) // ==> true
console.log(message) // ==> Hello, World!
})()
Installation
Through UNPKG (for browsers):
<script src="https://unpkg.com/sporadic/dist/index.js"></script>
Through NPM:
$ npm install sporadic
To install the development snapshot, use npm link. For example, on this cloned repository:
$ npm link .
And then, on your project:
$ npm link sporadic
Stable releases are tags in the branch release. The master branch here is only to track the next releases, please don't rely too much on that branch. All the hard work is made on the development branch.
Documentation
For every submodule within this sporadic library, there's an API documentation available at the directory docs/ under the filename SUBMODULE.md, where SUBMODULE stands for the submodule provided with this library (yes, I know the redundancy
- sporadic.streams, an abstraction for reactive streams made of multiple publishers and multiple subscribers. The subscription process is implicit, the reference for the stream object is all that is needed.
- sporadic.channels, an abstraction for synchronous queues made of many producers and consumers. This concurrent data type is a bare minimal tool for pipelines of chained producers and consumers.
- sporadic.coroutines, an abstraction for suspendable subroutines. Such abstraction also behaves as a task/promise whenever we wait for the final coroutine result (but keep in mind that coroutines can "loop" forever). It's kinda like the JavaScript generators, with the sole difference of being asynchronous instead synchronous calls (and thus, allowing us to mix asynchronous I/O with that).
Remarks
PRs & Issues are always welcome
| 661/1000 
839 Dec 21, 2022
283 Sep 22, 2022
86 Dec 16, 2022
25 Dec 1, 2022
19 Apr 8, 2022
3 May 18, 2022
4 May 3, 2022
14 Jan 3, 2023
10.4k Dec 31, 2022
6.7k Jan 4, 2023
59 Nov 21, 2022
16 Sep 25, 2022
2 Feb 7, 2022
2 Jun 16, 2022
5 Oct 25, 2022
6.3k Jan 9, 2023
1.2k Dec 29, 2022
10.1k Jan 3, 2023
2.3k Dec 18, 2022
2.1k Jan 2, 2023