Home

Awesome

Reaxive

Build Status Coverage Status hex.pm version Inline docs

Reaxive is a reactive event handling library, inspired by Elm (http://elm-lang.org) and Reactive Extensions. It implements the kind of asynchronous collections José Valim talked about in his keynotes on ElixirConf2014 and ElixirConfEU 2015.

Usage

Preparations

To use Reaxive you have to add it to your Mix dependencies

	deps: [
		{:reaxive, "~> 0.1.0"}
	]

and add the reaxive and the logger application to your required applications

applications: [:kernel, :reaxive, :logger]

Using Reaxive

Now you can use Reaxive. All the combinators are defined in the module Reaxive.Rx (see http://hexdocs.pm/reaxive/). Basically, they follow the naming scheme from other reactive frameworks, such as Reactive Extensions (.NET), RxScala or RxJS. Hence the wonderful marble diagrams of RX (see e.g. http://rxmarbles.com/) can be used to understand the combinators' semantics.

	alias Reaxive.Rx
	1..100
	|> Rx.generate
	|> Rx.map(&(&+1))
	|> Rx.filter(&Integer.is_odd/1)
	|> Rx.as_text
	|> Rx.sum

The combinators are building a pipeline for event processing spawing new processes on-demand. Adhering to the protocol should be sufficient that these processes are automatically stopped again. This is extremely important, since otherwise we get a process leak in our system which will eat up all system resources.

The protocols, which lay the foundation for Reaxive, can also be found at http://hexdocs.pm/reaxive/ .

Future Development Steps

Important tasks for the future are:

History

The v0.1.0 series supports Elixir 1.1.0 and later.

In the v0.0.3 series, we introduce cancellable generators. We also implement José Valim's async operator to break a synchronous pipeline into asynchronuous pieces

Subjects are a re-implementation of Rx.Impl. Major ideas:

The first code version (v0.0.1) has conceptual problems which showed up during testing. As any observable lives in its own process, we have maxium of concurrency. This results in pushing events from the front while later transformations are not properly setup. Due to this, some of the first events may be swallowed and disappear, so the tests fail because not all events are piped through the entire sequence of transformation.

The code v0.0.2 series is a major rework that implements ideas of

and also inspired by Clojure's transducers introduced by Rich Hickey

Contributing

Please use the GitHub issue tracker for

License

Reaxive is provided under the Apache 2.0 License.