v8.2.0

Author: Tynab

README.md

@@ -36,16 +36,19 @@
 ## 📥 Installation
 
 ### Package Manager
+
 ```
 PM> NuGet\Install-Package Tynab.YANLib
 ```
 
 ### .NET CLI
+
 ```
 dotnet add package Tynab.YANLib
 ```
 
 ### Package Reference
+
 ```xml
 <PackageReference Include="Tynab.YANLib" Version="x.x.x" />
 ```
@@ -80,7 +83,6 @@ A comprehensive utility library for object operations and validations, offering
 - Collection operations
 - Object manipulation (copy, time zone conversion)
 
-
 ```csharp
 // Null checking
 object? obj = null;
@@ -107,7 +109,6 @@ A powerful utility library for parsing and converting objects to unmanaged types
 - Collection parsing with robust error handling
 - Format support for date/time and culture-specific parsing
 
-
 ```csharp
 // Parse string to int
 object input = "123";
@@ -133,7 +134,6 @@ A versatile utility library for converting collections of objects to strongly-ty
 - Immutable collection support
 - Type parsing during conversion
 
-
 ```csharp
 // Convert collection of objects to array of integers
 IEnumerable<object?> input = ["1", "2", "3"];
@@ -161,7 +161,6 @@ A comprehensive utility library for text manipulation, character operations, and
 - Collection text operations
 - Nullable character support
 
-
 ```csharp
 // Case conversion
 string text = "hello world";
@@ -191,7 +190,6 @@ A comprehensive utility library for JSON serialization and deserialization, supp
 - Default formatting with camel case property naming
 - Error handling for serialization/deserialization errors
 
-
 ```csharp
 // Serialize an object to a JSON string
 var person = new Person { Id = 1, Name = "John Doe" };
@@ -219,7 +217,6 @@ A comprehensive utility library for mathematical operations, providing extension
 - Trigonometric functions (Sin, Cos, Tan, Asin, Acos, Atan)
 - Logarithmic and exponential functions
 
-
 ```csharp
 // Statistical functions
 double min = YANMath.Min(5.2, 3.1, 7.8, 2.4); // Returns 2.4
@@ -244,7 +241,6 @@ A comprehensive utility library for DateTime operations, offering methods for we
 - Collection operations
 - Generic type support
 
-
 ```csharp
 // Get week number for a specific date
 var date = new DateTime(2023, 6, 15);
@@ -271,7 +267,6 @@ A comprehensive utility library for generating random values of various types, s
 - Collection operations for generating random collections
 - Type flexibility with generic support
 
-
 ```csharp
 // Generate random values of various types
 int randomInt = YANRandom.GenerateRandom<int>(); // Random int
@@ -296,7 +291,6 @@ A specialized utility library that extends the Task Parallel Library (TPL), prov
 - Error handling with exception safety
 - Cancellation support
 
-
 ```csharp
 // Wait for any task that returns a value greater than 5
 var tasks = new[]
@@ -327,7 +321,6 @@ A specialized utility library for managing system processes, focusing on process
 - Asynchronous operations
 - Process cleanup with automatic resource disposal
 
-
 ```csharp
 // Kill all instances of a process with a specific name
 await "notepad".KillAllProcessesByName();
@@ -339,6 +332,7 @@ var processNames = new List<string?>
     "calc",
     "mspaint"
 };
+
 await processNames.KillAllProcessesByNames();
 ```
 
@@ -353,7 +347,6 @@ A specialized utility library for creating and manipulating strongly-typed expre
 - Value type handling with automatic boxing
 - Expression caching for better performance
 
-
 ```csharp
 // Create a property expression for accessing the Name property on a Person object
 var expression = YANExpression.PropertyExpression<Person>("p", "Name");
@@ -364,6 +357,7 @@ var person = new Person { Name = "John", Age = 30 };
 string name = (string)func(person); // Returns "John"
 ```
 
+
 ## 📊 Performance Benchmarks
 
 YANLib is designed with performance in mind. The library uses various optimizations to ensure high performance:
@@ -373,14 +367,15 @@ YANLib is designed with performance in mind. The library uses various optimizati
 - Parallel processing for large collections where appropriate
 - Optimized algorithms for common operations
 
-
 ### JSON Performance
 
 YANJson is built on System.Text.Json, which offers significantly better performance compared to Newtonsoft.Json, especially for large datasets.
 
-`<div align="center">
+<div align="center">
   <img src='https://raw.githubusercontent.com/Tynab/YANLib/refs/heads/main/pic/1.jpg' alt="JSON Performance Comparison">
-</div>`System.Text.Json is designed to provide better performance and security compared to other JSON libraries. It supports advanced features like parallel parsing and support for new data types such as Span and Utf8JsonReader, enabling faster data processing and reduced memory usage.
+</div>
+
+System.Text.Json is designed to provide better performance and security compared to other JSON libraries. It supports advanced features like parallel parsing and support for new data types such as Span and Utf8JsonReader, enabling faster data processing and reduced memory usage.
 
 Based on performance benchmark tests conducted in different environments and scenarios, System.Text.Json is generally considered to have the best performance among these libraries. According to performance tests, the results show that System.Text.Json has significantly faster JSON-to-.NET object and vice versa conversion times compared to Newtonsoft.Json, especially in cases with large data.
 
@@ -402,9 +397,12 @@ However, using these options can affect performance. YANJson provides optimized
 For the most recent performance benchmarks, visit:
 [https://yanlib.yamiannephilim.com/api/json/yan-vs-standards?quantity=10000&hideSystem=true](https://yanlib.yamiannephilim.com/api/json/yan-vs-standards?quantity=10000&hideSystem=true)
 
-`<div align="center">
+<div align="center">
   <img src='https://raw.githubusercontent.com/Tynab/YANLib/refs/heads/main/pic/0.jpg' alt="YAN vs Standards Performance">
-</div>`## 💻 Code Examples
+</div>
+
+
+## 💻 Code Examples
 
 ### Data Processing Pipeline
 
@@ -512,6 +510,7 @@ public double CalculateStatistics(IEnumerable<double> values)
 }
 ```
 
+
 ## 🏗️ Project Architecture
 
 YANLib is based on .NET 8.0 (LTS) and consists of the following main components:
@@ -530,7 +529,6 @@ YANLib is based on .NET 8.0 (LTS) and consists of the following main components:
 - Process
 - Expression
 
-
 ### Project Structure
 
 ```plaintext

lib/YANLib/Footer.md

@@ -7,7 +7,7 @@
 [Releases](https://github.com/tynab/YANLib/releases) | 
 [Package](https://www.nuget.org/packages/Tynab.YANLib)
 
-<sub>YANLib © 2023 - Documentation last updated: May 4, 2025</sub>
+<sub>YANLib © 2023 - Documentation last updated: May 12, 2025</sub>
 
 <sub>Licensed under the [MIT License](https://github.com/tynab/YANLib/blob/main/LICENSE)</sub>
 

lib/YANLib/Home.md

@@ -2,10 +2,12 @@
 
 Welcome to the YANLib documentation! YANLib is a comprehensive .NET utility library that provides a wide range of extension methods and helper classes to simplify common programming tasks and enhance developer productivity.
 
+
 ## Overview
 
 YANLib offers a collection of specialized components, each focusing on a specific area of functionality. The library is designed with a consistent API, robust error handling, and support for both nullable and non-nullable types. All components are implemented as extension methods, allowing for a fluent and intuitive coding experience.
 
+
 ## Key Components
 
 ### [YANObject](YANObject)
@@ -193,6 +195,7 @@ var processNames = new List<string?>
     "calc",
     "mspaint"
 };
+
 await processNames.KillAllProcessesByNames();
 ```
 
@@ -252,6 +255,7 @@ using YANLib;
 
 Now you can start using any of the extension methods provided by the library.
 
+
 ## Examples
 
 ### Data Processing Pipeline
@@ -355,6 +359,7 @@ public double CalculateStatistics(IEnumerable<double> values)
 }
 ```
 
+
 ## Contributing
 
 Contributions to YANLib are welcome! Please feel free to submit issues, feature requests, or pull requests to help improve the library.

lib/YANLib/YANDateTime.md

@@ -1,9 +1,11 @@
 ### YANDateTime - DateTime Operations Utility Library
 
+
 ## Overview
 
 `YANDateTime` is a comprehensive utility library that provides extension methods for working with DateTime objects in C# applications. It offers a wide range of date and time operations for both single DateTime values and collections, with support for generic types and null-safe operations.
 
+
 ## Features
 
 The library is organized into several functional categories:
@@ -21,7 +23,6 @@ The library is organized into several functional categories:
 - **Parallel Processing**: Automatic parallel processing for large collections (1000+ elements)
 - **Null Handling**: Graceful handling of null values in collections
 
-
 ### Type Flexibility
 
 - **Generic Support**: Process objects of any type that can be converted to DateTime
@@ -118,6 +119,7 @@ var dates = new DateTime?[]
     new DateTime(2023, 6, 15),
     new DateTime(2023, 12, 31)
 };
+
 var weekNumbers = dates.GetWeekOfYears<int>()?.ToArray(); // Returns [1, 24, 53]
 
 // Handle null values in collections
@@ -127,6 +129,7 @@ var datesWithNull = new DateTime?[]
     null,
     new DateTime(2023, 12, 31)
 };
+
 var weeksWithNull = datesWithNull.GetWeekOfYears<int>()?.ToArray(); // Returns [1, 0, 53]
 
 // Change time zone for a list of dates (modifies the list in-place)
@@ -136,6 +139,7 @@ var dateList = new List<DateTime>
     new(2023, 6, 15, 12, 0, 0),
     new(2023, 12, 31, 14, 0, 0)
 };
+
 dateList.ChangeTimeZone(0, 2); // Modifies list to [2023-1-1 12:00, 2023-6-15 14:00, 2023-12-31 16:00]
 
 // Change time zone for an enumerable (returns a new collection)
@@ -145,6 +149,7 @@ var dateArray = new DateTime[]
     new(2023, 6, 15, 12, 0, 0),
     new(2023, 12, 31, 14, 0, 0)
 };
+
 var convertedDates = dateArray.ChangeTimeZones(0, 3)?.ToArray(); // Returns new collection with converted dates
 
 // Process collections of objects that can be converted to DateTime
@@ -154,6 +159,7 @@ var objectDates = new object?[]
     "2023-06-15",
     1672444800000 // Unix timestamp
 };
+
 var objectWeeks = objectDates.GetWeekOfYears<int>()?.ToArray(); // Returns [1, 24, ...]
 
 // Process non-generic collections
@@ -182,6 +188,7 @@ var mixedObjects = new List<object?>
     "2023-06-15 12:00:00",
     new DateTime(2023, 12, 31, 14, 0, 0)
 };
+
 mixedObjects.ChangeTimeZone(0, 2); // Modifies list with converted DateTime objects
 
 // Process large collections with automatic parallel processing
@@ -197,9 +204,11 @@ var mixedValidInvalid = new object?[]
     "not a date",
     null
 };
+
 var safeResults = mixedValidInvalid.GetWeekOfYears<int?>()?.ToArray(); // Returns [1, null, null]
 ```
 
+
 ## Performance Considerations
 
 - **Parallel Processing**: For collections with more than 1000 elements, the library automatically uses parallel processing for better performance
@@ -215,10 +224,12 @@ var safeResults = mixedValidInvalid.GetWeekOfYears<int?>()?.ToArray(); // Return
 - **Generic Type Support**: Methods use generic type parameters to support various return types
 - **Null Safety**: All methods are designed to be null-safe, handling null inputs gracefully
 - **Partial Classes**: Uses partial classes to organize functionality by category:
+
     - Core functionality (YANDateTime.cs)
     - Collection operations (YANDateTime.Collection.cs)
     - Generic operations (YANDateTime.Generic.cs)
     - Nullable operations (YANDateTime.Nullable.cs)
+
 - **Internal Implementation**: Core implementation details are separated from the public API for better maintainability
 
 

lib/YANLib/YANEnumerable.md

@@ -1,9 +1,11 @@
 ### YANEnumerable - Collection Conversion Utility Library
 
+
 ## Overview
 
 `YANEnumerable` is a versatile utility library that provides extension methods for converting collections of objects to strongly-typed collections in C# applications. It offers a comprehensive set of methods for transforming generic and non-generic collections into arrays, lists, hash sets, dictionaries, lookups, and immutable collections of specific types.
 
+
 ## Features
 
 The library is organized into several functional categories:
@@ -15,14 +17,12 @@ The library is organized into several functional categories:
 - **HashSet Conversion**: Create strongly-typed hash sets from collections
 - **Type Parsing**: Automatically parse elements to the specified type during conversion
 
-
 ### Dictionary and Lookup Conversion
 
 - **Dictionary Creation**: Convert collections to dictionaries with typed keys and values
 - **Lookup Creation**: Transform collections into lookups with typed keys and elements
 - **Key/Value Selection**: Extract and convert keys and values from source elements
 
-
 ### Immutable Collection Support
 
 - **Immutable Arrays**: Convert collections to immutable arrays
@@ -32,7 +32,6 @@ The library is organized into several functional categories:
 - **Immutable Stacks/Queues**: Transform collections into immutable stacks or queues
 - **Immutable Sorted Collections**: Create immutable sorted sets and dictionaries
 
-
 ### Collection Source Support
 
 - **Generic Collections**: Convert from `IEnumerable<object?>` sources