ReactGraph

ReactGraph is a library to make change propagation easy in .NET.

3 years after

Logo ReactGraph

ReactGraph is a library to make change propagation easy in .NET. It allows you to define formulas targeting properties and when any value used in that formula is changed it will be re-evaluated.

What makes ReactGraph useful is that it does not blindly react to changes, when any property changes it will perform a breadth-first topological sort to ensure each property is only recalculated once.

It is basically excel formulas in .net, except better.

ReactGraph was built because of pain building complex forms with many fields calculating defaults based on other fields changing common in larger line of business applications. This library has not been used in production yet and we are putting it out there to see if people like the idea/implementation.

Feedback welcome!

A simple example - mortgage calculator

Our sample app includes a mortgage calculator which allows you to edit both payment amount and the loan length. Doing this can be problematic normally because it is cyclic in nature, because ReactGraph understands this it can break it apart.

This is our UI we want to make work
README

Then we simply declare our formulas.

var mortgageEngine = new DependencyEngine();
mortgageEngine
    .Assign(() => Mortgage.Payments)
    .From(() => MortgageCalculations.CalculatePayments(
            Mortgage.Amount,
            Mortgage.InterestRate,
            Mortgage.LoanLength,
            Mortgage.PaymentFrequency),
            ex => { });

mortgageEngine
    .Assign(() => Mortgage.LoanLength)
    .From(() => MortgageCalculations.CalculateLength(
            Mortgage.Amount,
            Mortgage.Payments,
            Mortgage.InterestRate,
            Mortgage.PaymentFrequency),
            ex => { });

If I change the payment amount then I see the impact on the length of the loan
README1

We can then visualise the dependencies between the different fields and how they are related (using the ReactGraph.Visualisation library .ToDotFormat() extension method):
README3

We can also turn off formulas so we can just see the dependencies between fields with the following code:

mortgageEngine.ToDotFormat(options: new VisualisationOptions
        {
            ShowFormulas = false,
            ShowRoot = false
        });

README4

GraphViz Online Viewers

Currently ReactGraph just outputs graphs in DOT format. You need to use an online viewer to then visualise the graph.

http://graphviz-dev.appspot.com/
http://stamm-wilbrandt.de/GraphvizFiddle/
http://sandbox.kidstrythisathome.com/erdos/

Other resources

[http://weareadaptive.com/blog/2014/11/16/released-reactgraph-library/](Introduction Blog Post)

Icon

Network by Murali Krishna from The Noun Project


Top Contributors

JakeGinnivan odeheurles ghuntley raybooysen

Releases

-   0.1.0+171 zip tar