rx 0.8.0

Reactive Extensions for D Programming Language.


To use this package, put the following dependency into your project's dependencies section:

dub.json
dub.sdl

Reactive Extensions for D Programming Language

Dub version MIT License Build Status

Overview

This is a library like Rx.NET for asynchronous or event based programs, based on the concept of OutputRange.

The operators' name is based on std.algorithm and ReactiveX.

Example
import rx;
import std.conv : to;
import std.range : iota, put;

void main()
{
    // create own source of int
    auto subject = new SubjectObject!int;

    // define result array
    string[] result;

    // define pipeline and subscribe
    // sequence: source -> filter by even -> map to string -> join to result
    auto disposable = subject.filter!(n => n % 2 == 0).map!(o => to!string(o))
        .doSubscribe!(text => result ~= text);

    // set unsubscribe on exit
    // it is not necessary in this simple example,
    // but in many cases you should call dispose to prevent memory leaks.
    scope (exit)
        disposable.dispose();

    // put values to source. 
    put(subject, iota(10));

    // result is like this
    assert(result == ["0", "2", "4", "6", "8"]);
}

And more examples or Documents

Usage

Setting dependencies in dub.json

{
    ...
    "dependencies": {
        "rx": "~>0.8.0"
    }
}

or dub.sdl

dependency "rx" version="~>0.8.0"

Concepts

Basic interfaces

All operators are written using template and struct for optimization. this example is a binary interface like std.range.interfaces.

//module rx.disposable
interface Disposable
{
    void dispose();
}

//module rx.observer
interface Observer(E) : OutputRange!E
{
    //void put(E obj); //inherits from OutputRange!E
    void completed();
    void failure(Exception e);
}

//module rx.observable
interface Observable(E)
{
    alias ElementType = E;
    Disposable subscribe(Observer!E observer);
}

Supported Compilers

Supported compilers are dmd and ldc that latest 3 versions.

License

This library is under the MIT License. Some code is borrowed from Rx.NET.

Contributing

Issue and PullRequest are welcome! :smiley:

Refer to CONTRIBUTING.md for details.

Future work

  • generic observable factory
  • create, start, timer, interval
  • more subjects
  • publish, replay
  • more algorithms
  • window, zip
  • more test
  • more documents
Authors:
  • lempiji
Dependencies:
none
Versions:
0.8.0 2018-Mar-25
0.7.4 2018-Mar-21
0.7.3 2018-Feb-24
0.7.2 2017-Nov-12
0.7.1 2017-Nov-11
Show all 22 versions
Download Stats:
  • 0 downloads today

  • 1 downloads this week

  • 58 downloads this month

  • 4790 downloads total

Score:
2.7
Short URL:
rx.dub.pm