Skip to content

Latest commit

 

History

History
71 lines (46 loc) · 2.66 KB

README.md

File metadata and controls

71 lines (46 loc) · 2.66 KB

Observable event generator

This project is a .NET 5 source generator which produces IObservable<T> for events contained within a object including all base classes.

Installation

NuGet Packages

Make sure your project is using the newer PackageReference inside your CSPROJ. The older style is buggy and should be moved away from regardless. See here for discussions how to upgrade.

Install the following packages to start using Observable Events.

Name Platform NuGet
ReactiveMarbles.ObservableEvents.SourceGenerator Core - Libary CoreBadge

What does it do?

ObservableEvents generator will convert events within an assembly and create observable wrappers for them.

It is based on pharmacist Pharmacist and uses .NET Source Generator technology.

Installation

Include the following in your .csproj file

<PackageReference Include="ReactiveMarbles.ObservableEvents.SourceGenerator" Version="1.0.2" PrivateAssets="all" />

The PrivateAssets will prevent the ObservableEvents source generator from being inherited by other projects.

How to use

Instance Based

It injects a class for instance based events into your source code which will expose a extension method called Events().

You need to include the namespace ReactiveMarbles.ObservableEvents to access to the extension method.

You can then use this to get IObservable<T> instances from your events.

using ReactiveMarbles.ObservableEvents;

public void MyClass : INotifyPropertyChanged
{
  // Assumes this belong in a class with a event called PropertyChanged.
  public void RunEvents()
  {
      this.Events().PropertyChanged.Subscribe(x => Console.WriteLine($"The {x} property has changed"));
  }

  public event PropertyChangedEventHandler PropertyChanged;
}

Static Events

You must use include a attribute GenerateStaticEventObservables on the assembly level for a particular class. This will generate a class RxEvents in the same namespace as the specified class.

[assembly: GenerateStaticEventObservablesAttribute(typeof(StaticTest))]

    public static class StaticTest
    {
        public static event EventHandler? TestChanged;
    }