Oakrey.ValueSystem.Generators 1.0.0

Oakrey.ValueSystem.Generators

Overview

The Oakrey.ValueSystem.Generators library provides a versatile and extensible framework for generating dynamic values in .NET applications. It includes a variety of generators based on time, queries, and custom logic, making it ideal for applications requiring dynamic data generation.

Features

DateTime-Based Generators

• HourGenerator: Generates the current hour or a time-adjusted hour.
• MinuteGenerator: Generates the current minute or a time-adjusted minute.
• SecondGenerator: Generates the current second or a time-adjusted second.

Query-Increment-Based Generators

• AutoIncrementGenerator: Generates values incremented by a specified step, with support for min/max boundaries.
• FunctionAutoIncrementGenerator: Combines auto-increment logic with custom mathematical expressions.
• OverflowGenerator: Generates incremented values with overflow handling for cyclic ranges.

Tick-Based Generators

• FunctionGenerator: Generates values based on a custom mathematical function and elapsed time.
• LapTimerGenerator: Measures and generates lap times in seconds.
• RandomGenerator: Generates random values within a specified range.
• StopWatchGenerator: Acts as a stopwatch, generating elapsed time in seconds.
• TimeBasedGenerator: Generates values based on elapsed time and custom logic.

Core Features

• GeneratorBase: A base class providing common functionality for all generators, including value peeking and accuracy control.
• Support for numeric, string, and time-based value outputs.
• Extensible design for creating custom generators.

Developer-Friendly

• Clean and intuitive API design.
• Comprehensive error handling with custom exceptions.
• Detailed documentation and examples for quick onboarding.

Installation

You can install the package via NuGet Package Manager, Package Manager Console or the .NET CLI.

NuGet Package Manager

1. Open your project in Visual Studio.
2. Navigate to Tools > NuGet Package Manager > Manage NuGet Packages for Solution....
3. Search for Oakrey.ValueSystem.Generators and click Install.

.NET CLI

Run the following command in your terminal:

dotnet add package Oakrey.ValueSystem.Generators

Package Manager Console

Run the following command in your Package Manager Console:

Install-Package Oakrey.ValueSystem.Generators

Requirements

• .NET 8 or higher

Project Information

• Author: Oakrey
• Company: Oakrey
• License: MIT
• Repository: Git Repository
• Project URL: Project Website

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests to improve the package.

License

This project is licensed under the MIT License. See the LICENSE file for details.