ldqk/Masuit.Tools
Masuit.Tools
Masuit.Tools is a comprehensive static utility library for .NET and ASP.NET Core development. It provides a broad collection of reusable helper methods and infrastructure components that cover common programming tasks without requiring dependency injection or instance management. The library is organized as flat utility classes, making its functionality directly accessible from anywhere in a project.
The toolkit distinguishes itself through a wide range of integrated capabilities that go beyond typical utility libraries. It includes a multithreaded range-request file downloader with pause and resume support, a perceptual hash engine for comparing image similarity, and a Snowflake-based distributed ID generator for creating unique, ordered identifiers. The library also offers zero-width character steganography for hiding text within ordinary strings, an expression tree composition engine for building dynamic LINQ queries, and an attribute-driven service registration system that automatically scans assemblies and registers classes in the ASP.NET Core dependency injection container.
Beyond these differentiators, the library covers a broad surface of everyday development needs. It provides utilities for file compression and decompression across multiple archive formats, IP address resolution with geographic lookup, JSON serialization with multiple alias binding per property, and request body binding that accepts data from query strings, forms, or JSON interchangeably. The toolkit also includes data validation for common formats, collection manipulation with safe operations and duplicate removal, date and time calculations including Chinese lunar calendar conversion, and text comparison with diff and patch generation. Additional capabilities span cryptography with symmetric and asymmetric encryption, CAPTCHA image generation, HTML sanitization for XSS prevention, malware scanning via Windows Defender, and system monitoring for real-time hardware metrics.
The library is distributed as a NuGet package and integrates directly into .NET projects, with documentation covering its static utility classes and ASP.NET Core integration helpers.
Features
- Static Utility Libraries - Providing a comprehensive set of static utility classes for common C# development tasks like encryption, reflection, file compression, and image processing.
- Static Class Utilities - Organizes hundreds of standalone static methods into flat utility classes with no instance state or dependency injection requirements.
- Compression and Archiving - Ships utilities for compressing and decompressing files in ZIP, 7z, and tar formats.
- Encryption and Hashing - Computes MD5, SHA, CRC, AES, DES, and RSA digests or ciphertexts from plaintext strings using optional salts or keys.
- Collection Manipulators - Ships utilities for safe collection manipulation including add, remove, insert, and reorder operations.
- Predicate Composers - Ships a dynamic expression tree composition engine for building LINQ predicates with AND/OR logic.
- Distributed ID Generators - Creates unique, short, URL-friendly identifiers suitable for distributed systems without a central coordinator.
- Snowflake ID Generators - Generates unique, ordered, short identifiers using a configurable Snowflake algorithm with machine ID and timestamp components.
- Cloud File Downloads - Splits a remote file into chunks and downloads them concurrently, supporting pause and resume.
- Multi-threaded Downloading - Downloads a remote file faster by splitting it into segments and fetching them concurrently, with pause and resume support.
- Common Utility Libraries - An all-purpose toolkit for .NET developers offering static helper classes for encryption, reflection, file compression, image processing, and data validation.
- Data Compression and Decompression - Ships utilities for compressing and decompressing files using 7-Zip with ASP.NET Core DI support.
- Static Encryption Utilities - Provides static methods for symmetric and asymmetric encryption and decryption of strings and byte arrays.
- Attribute-Driven Service Registrations - Scans assemblies for classes marked with a custom attribute and registers them in the dependency injection container.
- Common Format Validators - Ships validators for common data formats including email, phone, URL, IP, and Chinese ID card numbers.
- Automatic Service Registrations - Scans assemblies at startup for classes decorated with a custom attribute and automatically registers them in the ASP.NET Core DI container.
- Automatic Dependency Registrations - Scans assemblies for classes marked with ServiceInject and registers them in the DI container.
- Static Helper Collections - A library of reusable static methods covering common tasks like string manipulation, date calculations, and collection operations.
- Development Helpers - Accelerating web application development with helpers for model binding, dependency injection, file serving, and request handling in ASP.NET Core.
- Calendars And Dates - Ships a utility for converting Gregorian dates to Chinese lunar calendar with zodiac and stem-branch year.
- File Compression - Creates and extracts ZIP archives from files and directories using built-in compression utilities.
- Lunar Calendar Services - Converts between Gregorian and Chinese lunar calendar dates and retrieves lunar day information.
- Chinese Calendar Converters - Converts Gregorian dates to Chinese lunar calendar with heavenly stems, earthly branches, and solar terms.
- Date and Time Libraries - Ships utilities for calculating week numbers, timestamps, and period intervals including lunar calendar.
- LINQ Expression Translators - Combines, extends, or conditionally applies expression trees for flexible query filtering.
- Dynamic Predicate Composers - Builds and combines LINQ expression predicates dynamically using AND/OR logic and conditional application at runtime.
- MIME Type Detection - Identifies a file's true extension, MIME type, and text encoding from its binary signature.
- Tree Builders & Traversers - Converts flat collections into hierarchical trees and retrieves ancestors, descendants, depth, and paths.
- Perceptual Image Deduplication - Compares images by computing difference, average, DCT, or median hash fingerprints and returning a similarity score.
- Date and Time Utilities - Ships utilities for calculating week numbers, timestamps, and period intervals for any date.
- File Compression Utilities - Supports creating and extracting ZIP, 7z, and tar archives from files and directories with built-in compression.
- Range Request File Servings - Delivers file content over HTTP with ETag, Last-Modified, and range-request headers for resumable downloads.
- Image Cropping Tools - Scales or crops image files to specified dimensions while preserving aspect ratio.
- Image Processing - Generates thumbnails, converts to grayscale, crops, resizes, mirrors, and adjusts brightness.
- .NET Image Processing Libraries - Offers common image operations including resizing, cropping, grayscale conversion, watermarking, and thumbnail generation.
- Perceptual Similarity Scoring - Computes perceptual hashes (difference, average, DCT, median) and returns similarity scores.
- Byte-Range Requesting - Splits remote file downloads into parallel byte-range chunks with pause, resume, and progress reporting support.
- Resumable Downloads - Supports byte-range requests and conditional headers for resumable and multi-threaded file downloads.
- File Compression and Decompression - Handling file operations including compression, decompression, multi-threaded downloads, resume support, and stream copying with hashing.
- Reflection-Based Property Accessors - Provides runtime interfaces for inspecting and manipulating object properties dynamically.
- Attribute-Based Property Validators - Ships attribute-based validation for model properties covering email, phone, and password complexity.
- C# Development Tools - Comprehensive utility library for common C# operations.
