Merge pull request #98 from Tynab/develop

Develop

Author: Tynab

README.md

@@ -5,7 +5,7 @@
 [Home](Home) | 
 [Repository](https://github.com/tynab/YANLib) | 
 [Releases](https://github.com/tynab/YANLib/releases) | 
-[Package](https://www.nuget.org/packages/YANLib)
+[Package](https://www.nuget.org/packages/Tynab.YANLib)
 
 <sub>YANLib © 2023 - Documentation last updated: May 4, 2025</sub>
 

lib/YANLib/Footer.md

@@ -212,6 +212,7 @@ public Customer PrepareCustomerData(Customer customer)
 {
     // Create a copy and normalize the data
     var normalizedCustomer = customer.Copy();
+    
     normalizedCustomer.Name = normalizedCustomer.Name.CleanSpace().FormatName();
     normalizedCustomer.Email = normalizedCustomer.Email.Lower();
     normalizedCustomer.PhoneNumber = normalizedCustomer.PhoneNumber.FilterNumber();

lib/YANLib/Home.md

@@ -145,6 +145,7 @@ public object GetPropertyValue<T>(T obj, string propertyName)
 {
     var expression = YANExpression.PropertyExpression<T>("x", propertyName);
     var func = expression.Compile();
+
     return func(obj);
 }
 
@@ -164,6 +165,7 @@ Use with LINQ to create dynamic queries:
 public IQueryable<T> OrderBy<T>(IQueryable<T> source, string propertyName)
 {
     var expression = YANExpression.PropertyExpression<T>("x", propertyName);
+
     return source.OrderBy(expression);
 }
 
@@ -183,16 +185,19 @@ public object TryGetPropertyValue<T>(T obj, string propertyName)
     {
         var expression = YANExpression.PropertyExpression<T>("x", propertyName);
         var func = expression.Compile();
+
         return func(obj);
     }
     catch (ArgumentException ex) when (ex.Message.Contains("does not contain a property named"))
     {
         Console.WriteLine($"Property '{propertyName}' does not exist on type {typeof(T).Name}");
+
         return null;
     }
     catch (Exception ex)
     {
         Console.WriteLine($"Error accessing property: {ex.Message}");
+
         return null;
     }
 }
@@ -225,13 +230,15 @@ public static Action<T, TProperty> CreatePropertySetter<T, TProperty>(string pro
     var valueParameter = Expression.Parameter(typeof(TProperty), "value");
 
     var property = typeof(T).GetProperty(propertyName);
+
     if (property == null)
         throw new ArgumentException($"Type {typeof(T).Name} does not contain a property named {propertyName}");
 
     var propertyAccess = Expression.Property(parameter, property);
     var assign = Expression.Assign(propertyAccess, valueParameter);
 
     var lambda = Expression.Lambda<Action<T, TProperty>>(assign, parameter, valueParameter);
+    
     return lambda.Compile();
 }
 

lib/YANLib/YANExpression.md

@@ -260,6 +260,7 @@ public T SafeDeserialize<T>(string json) where T : class
     catch (Exception ex)
     {
         Console.WriteLine($"Error deserializing JSON: {ex.Message}");
+        
         return null;
     }
 }

lib/YANLib/YANJson.md

@@ -9,7 +9,21 @@
 		<Title>YANLib</Title>
 		<Authors>Yami An</Authors>
 		<Company>YAN</Company>
-		<Description>YANLib is an optimized .NET library that enhances data processing tasks. It offers various extension utilities to improve the handling of datetimes, numbers, text, passwords, JSON, and more. With a focus on large-scale data processing, YANLib provides efficient solutions for managing and manipulating data in .NET applications.</Description>
+		<Description>YANLib (YAMI AN NEPHILIM LIBRARY) is a comprehensive .NET utility library providing powerful extension methods that enhance developer productivity. Built on .NET 6.0 LTS, it offers high-performance utilities for JSON serialization, text manipulation, object validation, task coordination, mathematical operations, DateTime handling, and more.
+
+Key features:
+• YANJson: High-performance JSON serialization with robust error handling
+• YANText: String manipulation, validation, and transformation with null safety
+• YANObject: Object validation, property analysis, and deep copying
+• YANTask: Enhanced task coordination with conditional waiting and error handling
+• YANUnmanaged: Type parsing and conversion with built-in error handling
+• YANRandom: Random value generation for various types and collections
+• YANMath: Mathematical operations with null handling and type conversion
+• YANDateTime: Time zone conversion and date calculations
+• YANProcess: Process management utilities
+• YANExpression: Dynamic property access and expression tree utilities
+
+All components feature fluent APIs, robust null handling, collection support, and performance optimizations. YANLib simplifies common programming tasks while maintaining high performance, making it an essential toolkit for .NET developers.</Description>
 		<Copyright>Copyright ©  2023</Copyright>
 		<PackageIcon>icon.png</PackageIcon>
 		<PackageProjectUrl>https://github.com/Tynab</PackageProjectUrl>
@@ -18,15 +32,30 @@
 		<PackAsTool>False</PackAsTool>
 		<PackageReadmeFile>README.md</PackageReadmeFile>
 		<RepositoryType>git</RepositoryType>
-		<PackageReleaseNotes>
-			Update
-			- DateTime
-			- Enumerable
-		</PackageReleaseNotes>
+		<PackageReleaseNotes>## YANLib 8.0.0 - Complete Rebuild for .NET 8
+
+### Breaking Changes
+- Complete rebuild targeting .NET 8
+- All previous extensions are now obsolete
+- New namespace structure and API design
+- Not backward compatible with previous versions
+
+### New Features
+- Rebuilt components with modern architecture: YANJson, YANUnmanaged, YANRandom, YANTask, YANText, YANObject, YANProcess, YANMath, YANDateTime, YANExpression
+- Consistent null handling and collection operations
+- Enhanced generic type support
+- Thread-safety improvements
+
+### Performance
+- Significant performance improvements across all components
+- Reduced memory allocations
+- Optimized algorithms and caching strategies
+
+See full documentation at: https://github.com/Tynab/YANLib/wiki</PackageReleaseNotes>
 		<PackageLicenseExpression>MIT</PackageLicenseExpression>
 		<PackageRequireLicenseAcceptance>False</PackageRequireLicenseAcceptance>
 		<PackageId>Tynab.YANLib</PackageId>
-		<Version>4.0.1</Version>
+		<Version>8.0.0</Version>
 		<LangVersion>preview</LangVersion>
 		<ProduceReferenceAssembly>True</ProduceReferenceAssembly>
 		<IsPackable>true</IsPackable>

lib/YANLib/YANLib.csproj

@@ -23,6 +23,7 @@ await YANProcess.KillAllProcessesByNames("chrome", "firefox", "edge");
 
 // Kill processes from a collection of names
 List<string> processesToKill = ["notepad", "calc", "mspaint"];
+
 await processesToKill.KillAllProcessesByNames();
 ```
 
@@ -58,6 +59,7 @@ await YANProcess.KillAllProcessesByNames("chrome", "firefox", "edge", "opera");
 
 // Terminate processes from a collection
 List<string> backgroundProcesses = ["svhost", "wininit", "lsass"];
+
 await backgroundProcesses.KillAllProcessesByNames();
 ```
 
@@ -135,6 +137,7 @@ public class SystemManager
     {
         // Terminate processes that might be consuming too many resources
         List<string> resourceHungryProcesses = GetResourceIntensiveProcesses();
+        
         await resourceHungryProcesses.KillAllProcessesByNames();
     }
 

lib/YANLib/YANProcess.md

@@ -281,6 +281,7 @@ public class PerformanceTester
         var result = data.Select(x => Math.Pow(x, 2)).Sum();
 
         stopwatch.Stop();
+
         return stopwatch.Elapsed;
     }
 }
@@ -294,6 +295,7 @@ public class PasswordGenerator
     public string GenerateRandomPassword(int length)
     {
         var random = new Random();
+        
         return new string(Enumerable.Range(0, length)
             .Select(_ => random.NextChar())
             .ToArray());

lib/YANLib/YANRandom.md

@@ -99,7 +99,9 @@ public async Task<string> FindFirstValidUrl(IEnumerable<string> potentialUrls)
         try
         {
             using var client = new HttpClient();
+
             var response = await client.GetAsync(url);
+
             return new { Url = url, IsValid = response.IsSuccessStatusCode };
         }
         catch
@@ -109,6 +111,7 @@ public async Task<string> FindFirstValidUrl(IEnumerable<string> potentialUrls)
     });
 
     var result = await tasks.WaitAnyWithCondition(r => r.IsValid);
+
     return result?.Url ?? string.Empty;
 }
 ```
@@ -122,6 +125,7 @@ public async Task<int> ProcessDataWithFilter(IEnumerable<string> dataFiles)
     {
         var data = await File.ReadAllTextAsync(file);
         var processedValue = ProcessData(data);
+
         return processedValue;
     });
 
@@ -145,6 +149,7 @@ public async Task<T> ExecuteWithTimeoutAndFallback<T>(
     TimeSpan timeout)
 {
     var cts = new CancellationTokenSource();
+    
     cts.CancelAfter(timeout);
 
     try

lib/YANLib/YANTask.md

@@ -126,15 +126,18 @@ Work safely with nullable characters:
 ```csharp
 // Null checking
 char? nullChar = null;
+
 nullChar.IsNullEmpty(); // Returns true
 
 // Character type checking with null safety
 char? c = 'a';
+
 c.IsAlphabetic(); // Returns true
 nullChar.IsAlphabetic(); // Returns false
 
 // Case conversion with null safety
 char? upper = 'A';
+
 upper.Lower(); // Returns 'a'
 nullChar.Lower(); // Returns null
 ```