A generic, macro-based, stackless coroutine builder for Clojure and ClojureScript.

Coroutines are syntactic constructs allowing to suspend a computation and resume it later from the point it was suspended. They provide a basis for solutions to various categories of problems. In particular, this strategy has shown notable expressivity improvements in asynchronous programming, sequence generation and data processing.

This library aims to capture the essence of the inversion-of-control mechanism at work in those solutions. Because applications of this programming style are various and still in active exploration, this library is intentionaly low-level and agnostic wrt concurrency. It provides no execution model, exposing bare unsynchronized mutable objects.

The reason for this choice is that coroutine-based programming is inherently imperative, and providing thread-safe imperative constructs requires to make opinionated choices impacting performance. cloroutine aims to be a simple and generic tool and thus delegates these choices to third-party library designers.

This library exposes a single namespace holding a single macro : cloroutine.core/cr

The following guides show how to leverage the cr macro to implement clojure-flavored versions of various syntactic constructs involving suspendable processes.

1. Generators as lazy sequences
2. Future-based asynchronous processes, aka async/await
3. Transducers revisited
4. Delimited continuations
5. Monads