Dubratz.DarkOrange.Core 5.3.0.55

Dubratz.DarkOrange.Core

A utility library providing tools and helpers for Windows applications and general .NET development.

Features

String Utilities (DubString)

• Wildcard pattern matching with support for both standard (*, ?) and SQL LIKE (%, _) operators
• Base64 encoding/decoding with configurable lengths
• String comparison and manipulation tools
• Case-sensitive and case-insensitive matching

Date & Time Operations (DubDateAndTime)

• Time span calculations and conversions
• Human-readable time formatting
• Support for seconds, minutes, hours, days, and weeks
• Configurable abbreviations and formatting

File & Directory Utilities

• DubFile: Advanced file reading/writing with event-driven architecture
• DubDirectoriesAndFiles: Directory and file management helpers
• DubMetaFile: File metadata extraction and manipulation
• DubAppLock: Application-level file locking mechanisms

System Information (DubOSInfo)

• Operating system detection and information
• Friendly OS name resolution
• System environment queries

Variable Replacement (DubVariablesReplace)

• Dynamic variable expansion with %variable% syntax
• Built-in system variables:
  • User and machine identity (%IdUser%, %IdMachine%)
  • Common directories (%DirAppData%, %DirTemp%, etc.)
  • Date/time formatting (%DateCompact%, %DateNormal%, etc.)
  • Application info (%IdApplication%, %DirAppStartup%)
• Custom variable support
• Nested variable expansion with circular reference protection
• Environment variable expansion

Other Utilities

• DubNumeric: Numeric operations and conversions
• DubBitsToBytes: Bit/byte conversion utilities
• DubAssemblyInformation: Assembly metadata extraction
• DubExceptions: Custom exception handling

Installation

Install via NuGet Package Manager:

dotnet add package Dubratz.DarkOrange.Core

Or via Package Manager Console:

Install-Package Dubratz.DarkOrange.Core

Quick Start

String Pattern Matching

using Dubratz.DarkOrange.Core;

var dubString = new DubString("HelloWorld.txt");
dubString.IgnoreCase = true;

// Standard wildcards
bool matches = dubString.IsLike("*.txt"); // true

// SQL LIKE operators
bool sqlMatch = dubString.IsLike("%World%", DubString.WildcardOperators.SqlLike); // true

Variable Replacement

using Dubratz.DarkOrange.Core;

var replacer = new DubVariablesReplace();
string result = replacer.Convert("%IdUser%_%DateCompact%.log");
// Output: "JohnDoe_20240115.log"

// With custom variables
var customVars = new List<DubReplaceKey>
{
    new("AppName", "MyApp"),
    new("Version", "1.0.0")
};
string path = DubVariablesReplace.Convert("%AppName%_v%Version%", customVars);
// Output: "MyApp_v1.0.0"

Date & Time Formatting

using Dubratz.DarkOrange.Core;

var duration = new DubDateAndTime(TimeSpan.FromSeconds(3665));
duration.AbbreviateSuffix = true;
string formatted = duration.ToString();
// Output: "1h 1m 5s"

Requirements

• .NET 9.0 or later
• Windows (some features are Windows-specific)

Dependencies

• MetadataExtractor (v2.8.1)
• Microsoft.Win32.Registry (v5.0.0)
• SharpSfv (v2.0.0)
• System.Data.HashFunction.Core (v2.0.0)
• System.Data.HashFunction.xxHash (v2.0.0)

Contributing

This is a core utility library maintained by Dubratz.net. For issues or feature requests, please contact the maintainers.

License

This project is licensed under the MIT License - see the LICENSE.txt file for details.

Copyright © 2026 Dubratz.net

Version History

5.3.0

• DubFile updated to .NET 9.0 features and performance improvements
• Added framerate to dubmetafile

Company: Dubratz.net