View on GitHub

RxFree

An ultra-lightweight Rx source-only nuget to avoid depending on the full System.Reactive for IObservable producers

Icon RxFree

Reactive extensions for C# libraries as an ultra-lightweight source-only alternative to the full System.Reactive for IObservable<T> producers.

100% dependency-free (source-based) support for library authors exposing IObservable<T> leveraging Subject<T>, CompositeDisposable, IObservable<T>.Subscribe extension method overloads, IObservable<T>.Select/Where/OfType LINQ operators, and others.

Version Downloads License Build

Usage

All of the documentation and samples for Subject<T> and the provided extension methods (i.e. Subscribe overloads) that are officially available for System.Reactive apply to this project as well, since the implementations are heavily based on it (taking them to the bare essentials for source-only inclusion, with Subject<T> being pretty much exactly the same). For example: Using Subjects.

using System;

var subject = new Subject<string>();

subject.Subscribe(x => Console.WriteLine($"Got raw value {x}"));

subject.Where(x => int.TryParse(x, out _))
    .Select(x => int.Parse(x))
    .Subscribe(x => Console.WriteLine($"Got number {x} (squared is {x * x})"));

subject.Where(x => bool.TryParse(x, out var value) && value)
    .Subscribe(x => Console.WriteLine($"Got a boolean True"));

while (Console.ReadLine() is var line && !string.IsNullOrEmpty(line))
    subject.OnNext(line);

Why

For the most part, a producer needs the Subject<T> (read more about using subjects) and maybe the ObservableExtensions that provide Subscribe overloads to provide lambdas instead of an IObserver<T>. Taking the somewhat large and heavy dependency on the full System.Reactive to consume just the basics a reusable library needs is overkill in most cases.

In addition to Subject<T>, typical activities of a producer are to handle disposables and potentially filter/query/convert other observables they consume themselves. So the following simple features are provided:

This is what this project provides at the moment, in source form, in your project, as internal classes for your own implementation usage, with no external dependencies. They are not even visible in the project since NuGet provides them automatically to the compiler, embedded into your own assembly, and which you can fully debug as any other code in your project.

Dogfooding

CI Version Build

We also produce CI packages from branches and pull requests so you can dogfood builds as quickly as they are produced.

The CI feed is https://pkg.kzu.io/index.json.

The versioning scheme for packages is:

Sponsors

sponsored clariusclarius

get mentioned here too!