https://github.com/freakyali/freakykit.utils
https://github.com/freakyali/freakykit.utils
Last synced: 9 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/freakyali/freakykit.utils
- Owner: FreakyAli
- License: mit
- Created: 2025-09-15T12:32:18.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2025-09-17T13:29:22.000Z (10 months ago)
- Last Synced: 2025-09-17T13:29:26.009Z (10 months ago)
- Language: C#
- Size: 816 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FreakyKit.Utils
A robust and lightweight collection of C# extension methods designed to simplify common programming patterns and utility operations in .NET projects. This library includes extensions for arrays, collections, commands, dates, enumerables, exceptions, lists, numbers, objects, dependency injection, streams, strings, and tasks.
## Features
- Array Extensions: Multi-dimensional array traversal and element-wise actions.
- Collection Extensions: Simplified range add/remove operations for any collection.
- Command Extensions: Safe WPF `ICommand` pattern execution.
- DateTime Extensions: Weekday/weekend checks and workday calculations.
- Enumerable Extensions: Functional utilities like `WithIndex`, `DistinctBy`, safe list methods, shuffling, and more.
- Exception Extensions: Deep exception tracing to system logs.
- List Extensions: High-performance removal, insertion, and binary search.
- Number Extensions: Generic range checks for all number types.
- Object Extensions: Cloning, safe type conversions, JSON/XML utilities, and structural comparison.
- ServiceProvider Extension: Strongly-typed DI service fetching.
- Stream Extensions: Stream conversions and Base64 encoding/decoding.
- String Extensions: Text manipulations, Base64, reverse, currency, and validation utilities.
- Task Extensions: WhenAll with aggregate exceptions, safe result retrieval, and task timeout support.
## Installation
Add the compiled DLL to your project, or copy the relevant extension files into your solution.
```
dotnet add package FreakyKit.Utils
```
## Usage
Add a using directive to the `FreakyKit.Utils` namespace:
```
using FreakyKit.Utils;
// Array: Traverse a 2D array
matrix.ForEach((array, position) => Console.WriteLine(array.GetValue(position)));
// List: Remove items matching a predicate
myList.RemoveAll(x => x.IsObsolete);
// String: Validate email
bool isValid = "test@example.com".IsValidEmail();
// Enumerable: Enumerate with index
foreach (var (item, idx) in items.WithIndex()) { ... }
// Number: Check range
bool inRange = age.IsBetween(18, 65);
// DateTime: Find next workday
DateTime nextWorkday = today.NextWorkday();
// Task: Await with timeout
await task.TimeoutAfter(TimeSpan.FromSeconds(10));
```
For full API details, see the XML comments in each extension method.
## Documentation
- All extension classes are in the `FreakyKit.Utils` namespace.
- Methods use strong typing, safe defaults, and minimal dependencies.
- Most methods contain XML documentation accessible via IntelliSense.
I am also planning to either add the documentation here or to the wiki soon.
## Contributing
Contributions are welcome! Please submit issues and PRs for bug reports, new utilities, or improvements. All code must follow C# standard naming conventions and include XML documentation.
## License
This project is released under the MIT License.