Object Analysis Toolkit (OAT) is a rules driven metaprogramming engine for arbitrary C# objects.
OAT is available as a library on NuGet as Microsoft.CST.OAT.
To enable using C# scripts in rules you also need Microsoft.CST.OAT.Scripting.
OAT Blazor is an experimental WebAssembly app that runs in your browser and allows you to Author Rules and test them in a Sandbox using Objects instantiated from your provided Assembly.
Documentation for usage is on the Wiki.
Documentation for the API is available on GitHub Pages
- Rules contain a object Target, an int Severity, a string boolean Expression and a List of Clauses which are applied to the targeted object.
- Clauses perform a specified Operation on a specified Field of the Target. The Field can be any property or subproperty or field of the object. For example,
SomeFieldOfTarget.SomeObject.SomeProperty. - Clauses can also Capture the result of their operation, to be returned with the applied Rule.
- The Operation set can be expanded with delegates.
- The object types supported by existing operations can also be expanded with delegates.
The basic usage of OAT is applying rules to targets using the Analyze function.
object target;
IEnumerable<Rule> rules;
var analyzer = new Analyzer();
var rulesWhichApply = analyzer.Analyze(rules,target);OAT also supports capturing and returning results of clauses.
object target;
IEnumerable<Rule> rules;
var analyzer = new Analyzer();
var res = analyzer.GetCaptures(rules, target);A full walkthrough including creating a custom operation and validating your custom operation rules and capturing Clause values is available on the wiki.
Detailed information on how to author rules is available on on the wiki.
Documentation for implementing each delegate is available on the wiki.
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.