Arka.Framework.Utilities.OutService 1.0.0

ArkaSoftware.Framework.Utilities.OutServices

ArkaSoftware.Framework.Utilities.OutServices is a multi-purpose library that provides a collection of tools, extensions, and utilities for .NET developers. These tools are designed to simplify working with dates, numbers, strings, and generating unique identifiers.

Features

1. DateTime Utilities

• PersianDateTimeUtils: Utilities for working with Persian (Jalali) calendar dates.
• PersianCulture: Support for Persian culture in applications.
• PersianYear, PersianMonth, PersianDay: Manage Persian calendar dates with year, month, and day details.
• FriendlyPersianDateUtils: Provide user-friendly Persian date representations.
• TimeConstants: Constants related to time values.

2. Extensions

• DateTimeExtensions: Extend capabilities for working with DateTime and DateTimeOffset.
• StringExtensions: Provide methods to simplify string operations.
• EnumExtensions: Utilities for working with enumerations (Enums).
• LINQExtensions: Enhance LINQ queries with additional functionalities.
• TypeExtensions: Utilities for managing types.

3. ID Generators

• IdGenerator: Generate unique identifiers.
• SnowflakeIdGenerator: Generate unique IDs using the Snowflake algorithm.

4. Other Utilities

• RegexUtils: Tools for working with regular expressions.
• UnicodeConstants: Constants related to Unicode operations.

Installation

You can install this library from NuGet using the following command:

Install-Package Arks.Framework.Utilities.OutServices

Or with .NET CLI:

dotnet add package Arks.Framework.Utilities.OutServices

Usage

Here are examples of how to use various parts of this library:

Example: Using PersianDateTimeUtils

using Arks.Framework.Utilities.OutServices.DateTimes;

var persianDate = PersianDateTimeUtils.GetPersianDate(DateTime.Now);
Console.WriteLine($"Today in Persian: {persianDate}");

Example: Using StringExtensions

using Arks.Framework.Utilities.OutServices.Extensions;

string input = "   Hello World   ";
string trimmed = input.ApplyCorrectYeKe();
Console.WriteLine(trimmed); // Output: "Hello World"

Example: Using IdGenerator

using Arks.Framework.Utilities.OutServices.Generator;

var uniqueId = IdGenerator.Generate();
Console.WriteLine($"Generated ID: {uniqueId}");

Example: Using DateTimeExtensions

using Arks.Framework.Utilities.OutServices.Extensions;

var now = DateTime.UtcNow;
var iranTime = now.ToIranTimeZoneDateTime();
Console.WriteLine($"Iran Local Time: {iranTime}");

Example: Using EnumExtensions

using Arks.Framework.Utilities.OutServices.Extensions;

public enum SampleEnum
{
    [Description("This is a sample value")]
    SampleValue
}

var description = SampleEnum.SampleValue.GetEnumDescription();
Console.WriteLine(description); // Output: "This is a sample value"

Contribution

We welcome contributions! To report issues, suggest features, or contribute to the development, please visit the GitHub repository.

About the Developer

This library was developed by Saeid Rajabi, a seasoned software engineer with over 13 years of experience in programming and software development, delivering professional tools for .NET developers.

License

This project is licensed under the MIT License. For more details, refer to the LICENSE file.