Skip to content
This repository has been archived by the owner on Feb 20, 2020. It is now read-only.
/ ency Public archive

Enhanced concurrency primitives for Javascript.

Notifications You must be signed in to change notification settings

alidcast/ency

Repository files navigation

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