Enhanced concurrency primitives for Javascript.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src added keepLatest modifier Nov 30, 2017
test/unit added keepLatest modifier and removed unused e2e tests Nov 30, 2017
.babelrc setup rollup with babel runtime and added operation property to task Apr 17, 2017
.eslintrc.js created starter project Apr 12, 2017
.gitignore created starter project Apr 12, 2017
.npmignore setup rollup with babel runtime and added operation property to task Apr 17, 2017
README.md
circle.yml created starter project Apr 12, 2017
package-lock.json
package.json upgraded package Nov 30, 2017
rollup.config.js setup rollup with babel runtime and added operation property to task Apr 17, 2017
webpack.config.js added keepLatest modifier Nov 30, 2017

README.md

Ency

Enhanced concurrency primitives for Javascript. Gain complete control and transparency over the execution of concurrent and asynchronous operations, with almost no code.

Libraries

This repository hosts the core Ency library. If you want to use Ency's concurrency primitives you have the following options:

Environment Library
Plain JavaScript Ency (this repo)
Vue Vuency

Why Ency?

Ency helps you manage complex, event-driven operations with minimal code.

The two main benefits are:

  • Implicit state: Operations have their state baked in, so that you don't have to manually set and update flags (i.e. isRunning) yourself, to handle common UI interactions.

  • Flow control: The scheduling and cancellation of operation instances is baked in, so you can easily manage the flow of repeat requests, as well as manually cancel an operation at any moment.

The additional benefits:

  • Callback subscriptions: Subscribe to callbacks that are fired based on the stage or result of the operation, e.g. beforeStart or onCancel. This semantically separates the handling of corner cases from the core logic, which makes your code easier to reason about.

  • Bind data: Bind specific parameters or options to the nth call of the instance, e.g. using nth(1, { keepRunning: true }), so that you can simulate an infinite loop without overpowering the main thread.

  • Async helpers: Common async utilities, such as timeout helpers, that are automatically cleanup when the operation is over, which ensures that UI interactions flow with minimal latency.

If that isn't enough, Ency's API strikes a nice balance between declarative and imperative styles of programming, which makes complex code simple and fun to write.

Documentation

The Ency documentation is a nuxt.js and nuxtent generated static site with interactive examples.

License

MIT