FlowLogicEngine 1.0.0

FlowLogicEngine

A flexible and lightweight logic flow engine for .NET 8, designed for IoT and automation scenarios.

Features

• ✅ Simple rule syntax: name:condition=>action
• ✅ Support for complex conditions with logical operators (&&, ||)
• ✅ Support for comparison operators (>, <, >=, <=, ==, !=)
• ✅ Variable substitution in actions
• ✅ Extensible architecture (custom parsers, validators, handlers)
• ✅ Rule priority support
• ✅ Enable/disable rules dynamically
• ✅ Event-driven error handling
• ✅ Async support
• ✅ Multi-targeting: Supports .NET Standard 2.0, 2.1, .NET 6.0, 8.0, 9.0, and 10.0
• ✅ Wide compatibility: Works with .NET Framework 4.6.1+, .NET Core 2.0+, .NET 5+, Xamarin, Unity

Compatibility

See COMPATIBILITY.md for detailed compatibility information.

Installation

dotnet add package FlowLogicEngine

Quick Start

Basic Usage

using FlowLogicEngine;
using FlowLogicEngine.Core;

// Create logic flow processor with default configuration
var processor = new LogicFlowBuilder()
    .UseDefaults()
    .Build();

// Add rules
processor.AddLogicRule(new LogicRule("HighTemp", "temperature > 30", "SendAlert(Temperature too high: {temperature}°C)"));
processor.AddLogicRule(new LogicRule("LowBattery", "battery < 20", "LogWarning(Battery low: {battery}%)"));

// Create context data
var context = new ContextData();
context.AddFact("temperature", 35);
context.AddFact("battery", 15);

// Execute rules
processor.ExecuteLogicRules(context);

Output:

🚨 [ALERT] Temperature too high: 35°C
⚠️  [WARNING] Battery low: 15%

Load Rules from String

var rulesString = @"
HighTemperature:temperature > 30=>SendAlert(Temperature too high)
LowHumidity:humidity < 40=>SendNotification(Humidity too low)
NormalOperation:temperature <= 30 && humidity >= 40=>LogInfo(System normal)
";

var processor = new LogicFlowBuilder()
    .WithRuleLoader(new StringLogicRuleLoader(rulesString))
    .Build();

var context = new ContextData();
context.AddFact("temperature", 35);
context.AddFact("humidity", 38);

processor.ExecuteLogicRules(context);

Load Rules from File

var processor = new LogicFlowBuilder()
    .WithRuleLoader(new FileLogicRuleLoader("rules.txt"))
    .Build();

Rule Syntax

Basic Format

RuleName:condition=>action

Examples

Simple comparison:

HighTemp:temperature > 30=>SendAlert(Too hot)

Logical AND:

Comfortable:temperature >= 20 && temperature <= 26=>LogInfo(Comfortable)

Logical OR:

Alert:temperature > 35 || humidity < 20=>SendAlert(Critical condition)

Variable substitution:

Status:battery < 20=>SendNotification(Battery at {battery}%)

Supported Actions

• SendAlert(message) - Send alert
• SendNotification(message) - Send notification
• LogWarning(message) - Log warning
• LogInfo(message) - Log information
• LogError(message) - Log error

Advanced Usage

Custom Action Handler

public class MyActionHandler : DefaultActionHandler
{
    protected override void SendAlert(string message)
    {
        // Send to your alert system
        MyAlertSystem.Send(message);
    }
}

var processor = new LogicFlowBuilder()
    .WithActionHandler(new MyActionHandler())
    .Build();

Rule Priority

var rule1 = new LogicRule("Rule1", "value > 10", "LogInfo(Rule1)");
rule1.Priority = 1;

var rule2 = new LogicRule("Rule2", "value > 5", "LogInfo(Rule2)");
rule2.Priority = 2;

processor.AddLogicRule(rule1);
processor.AddLogicRule(rule2);
// Rule1 executes before Rule2

Error Handling

var processor = new LogicFlowBuilder().Build();

processor.RuleExecutionError += (sender, e) =>
{
    Console.WriteLine($"Error in rule {e.Rule.Name}: {e.Exception.Message}");
};

processor.RuleParseError += (sender, e) =>
{
    Console.WriteLine($"Parse error: {e.RuleString} - {e.Exception.Message}");
};

Use Cases

• IoT device monitoring and automation
• Business rule processing
• Event-driven workflows
• Alert and notification systems
• Data validation and transformation

Code of Conduct

This project has adopted the Contributor Covenant Code of Conduct. For more information see the Code of Conduct FAQ.

License

MIT License - see LICENSE.txt for details

Contributing

Contributions are welcome! Please read our Contributing Guide for details on how to get started.

Ways to Contribute

• Report bugs and request features
• Submit pull requests
• Improve documentation
• Share your use cases and examples