RulesEvaluator 1.0.4

dotnet add package RulesEvaluator --version 1.0.4
NuGet\Install-Package RulesEvaluator -Version 1.0.4
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="RulesEvaluator" Version="1.0.4" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add RulesEvaluator --version 1.0.4
#r "nuget: RulesEvaluator, 1.0.4"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install RulesEvaluator as a Cake Addin
#addin nuget:?package=RulesEvaluator&version=1.0.4

// Install RulesEvaluator as a Cake Tool
#tool nuget:?package=RulesEvaluator&version=1.0.4

RulesEvaluator

Overview

RulesEvaluator is a .NET package designed to provide a flexible and expressive way to evaluate sets of rules on custom data models. It enables you to define complex rule sets using a JSON-based syntax and then evaluate those rules against instances of your custom classes.

Installation

To use RulesEvaluator in your .NET project, you can install the package via NuGet Package Manager Console or the Package Manager UI:

Install-Package RulesEvaluator

Getting Started

Rule Operators

Rule operators define the comparison or logic applied when evaluating rules. The following rule operators are supported:

  • And: Logical AND operator.
  • Or: Logical OR operator.
  • Not: Logical NOT operator.

Rule Conditions

RulesEvaluator supports various conditions that you can use to define the logic for rule evaluation. The available conditions are represented by the Conditions enum:

  • IsNull: Checks if the field is null.
  • EqualTo: Checks if the field is equal to the specified value.
  • GreaterThan: Checks if the field is greater than the specified value.
  • LessThan: Checks if the field is less than the specified value.
  • GreaterThanEqual: Checks if the field is greater than or equal to the specified value.
  • LessThanEqual: Checks if the field is less than or equal to the specified value.
  • In: Checks if the field's value is in a specified list of values.
  • Contains: Checks if the field contains the specified value.
  • StartsWith: Checks if the field starts with the specified value.
  • EndsWith: Checks if the field ends with the specified value.

You can use these conditions to create expressive and precise rule sets tailored to your specific requirements.

Define Rules

Rules are defined using a JSON syntax that represents the logical conditions to be evaluated. You can use various logical operators like "And," "Or," and "Not" to create complex rule structures. Each rule consists of a field, a condition, and a value.

Example RuleSet JSON:

{
    "And": [
        {
            "Field": "Field",
            "Condition": "GreaterThan",
            "Value": 6
        },
        {
            "And": [
                {
                    "Field": "Field2",
                    "Condition": "EqualTo",
                    "Value": 6
                },
                {
                    "Field": "Field3",
                    "Condition": "LessThan",
                    "Value": 9
                }
            ]
        }
    ]
}

Type Parameters

Create or use an existing class that represents the data structure you want to evaluate the rules against.

public class CustomClass
{
    public int Field { get; set; }
    
    public int Field2 { get; set; }
    
    public int Field3 { get; set; }
}

Evaluate Rules

Use the RulesEvaluator to deserialize the rule set, create an instance of your class, and then evaluate the rules against the instance.

using Newtonsoft.Json;
using RulesEvaluator.Evaluators;
using RulesEvaluator.Models;

var jsonRuleSet = //... (as shown in the example above)

var rule = JsonConvert.DeserializeObject<Rule>(jsonRuleSet)!;
var rulesEvaluator = new RulesEvaluator<CustomClass>();

var customInstance = new CustomClass { Field = 7, Field2 = 6, Field3 = 7 };
var result = rulesEvaluator.Evaluate(rule, customInstance);

Console.WriteLine(result.ToString());

The result will indicate whether the provided instance satisfies the defined rules.

Example Output

The result of the evaluation will be a boolean indicating whether the provided instance satisfies the rules. You can customize the output based on your needs.

Contributions

Contributions are welcome! If you encounter any issues, have feature requests, or want to contribute to the project, please feel free to submit a pull request or open an issue.

License

This project is licensed under the MIT License - see the LICENSE for details.


Feel free to customize this readme to fit your project structure and additional features. Add more details about customization, advanced configurations, and anything else that might be relevant for users of your RulesEvaluator package.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net6.0

    • No dependencies.
  • net7.0

    • No dependencies.
  • net8.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.4 211 11/26/2023
1.0.3 96 11/26/2023
1.0.2 96 11/26/2023
1.0.1 88 11/26/2023
1.0.0 99 11/26/2023