DMNSN.Core 10.0.1-dev.4

DMNSN.Core

A comprehensive .NET 8 shared library providing essential utilities, extension methods, and configuration helpers for modern .NET applications.

📑 Table of Contents

• Features
• Installation
• Quick Start
• API Reference
  • Extension Methods
  • Configuration
  • Logging Settings
  • Format Enums
• Examples
• Testing
• Contributing
• Support
• License
• Authors

✨ Features

🛠️ Extension Methods

• String Conversion: Parse objects to strings with fallback defaults
• String Manipulation: Trim strings to specific lengths and extract substrings from the end
• Boolean Parsing: Parse various string representations as boolean values (case-insensitive)
• Enum Utilities: Extract descriptions and custom attributes from enum values
• Exception Handling: Enhanced exception message and stack trace extraction with inner exception support

⚙️ Configuration Utilities

• Configuration Keys: Predefined constants for common configuration sections
• Configuration Files: Standardized file name constants
• Logging Settings: Comprehensive logging configuration with console and file output options

📆 Format Definitions

• Date Formats: Predefined date format patterns
• Time Formats: Various time representation formats
• DateTime Formats: Combined date and time format patterns

✅ Test Coverage

• Comprehensive Unit Tests: 82+ tests covering all functionality
• Edge Case Testing: Thorough testing of null values, empty strings, and boundary conditions
• Integration Testing: Tests for method chaining and combined operations

📦 Installation

Package Manager

Install-Package DMNSN.Core

.NET CLI

dotnet add package DMNSN.Core

PackageReference

<PackageReference Include="DMNSN.Core" Version="8.0.0" />

🚀 Quick Start

Add the using statement to access extension methods:

using DMNSN.Core.Extensions;
using DMNSN.Core.Settings;
using DMNSN.Core.Constraints;

Basic Usage

// String conversion with fallback
object value = null;
string result = value.ParseString("default"); // Returns "default"

// Boolean parsing (case-insensitive)
bool isTrue = "YES".ParseBoolean(); // Returns true
bool isFalse = "random".ParseBoolean(); // Returns false

// String manipulation
string text = "Hello World";
string trimmed = text.TrimLength(5); // Returns "Hello"
string lastPart = text.ReverseSubstring(5); // Returns "World"

// Enum descriptions
MyEnum value = MyEnum.SomeValue;
string description = value.Description();

📚 API Reference

Extension Methods

ConvertExtension (String Operations)

ParseString(object, string)

Converts any object to its string representation with a fallback default value.

public static string ParseString(this object ob, string defaultValue = "")

Examples:

int number = 42;
string result = number.ParseString(); // "42"

object nullValue = null;
string fallback = nullValue.ParseString("N/A"); // "N/A"

TrimLength(string, int)

Trims a string to the specified maximum length.

public static string TrimLength(this string s, int maxLength)

Examples:

string longText = "Hello World";
string short = longText.TrimLength(5); // "Hello"

ReverseSubstring(string, int)

Returns a substring containing the specified number of characters from the end.

public static string ReverseSubstring(this string s, int count = 1)

Examples:

string text = "Programming";
string last4 = text.ReverseSubstring(4); // "ming"
string lastChar = text.ReverseSubstring(); // "g"

ConvertExtension (Boolean Operations)

ParseBoolean(string)

Parses various string representations as boolean values (case-insensitive).

public static bool ParseBoolean(this string s)

True Values: "true", "yes", "y", "1" (case-insensitive)
False Values: Everything else, including null, empty, or whitespace

Examples:

"TRUE".ParseBoolean();    // true
"yes".ParseBoolean();     // true
"Y".ParseBoolean();       // true
"1".ParseBoolean();       // true
"false".ParseBoolean();   // false
"no".ParseBoolean();      // false
"anything".ParseBoolean(); // false

EnumExtension

Description(Enum)

Retrieves the description from a DescriptionAttribute applied to an enum value.

public static string? Description(this Enum value)

GetAttribute<TAttribute>(Enum)

Retrieves a custom attribute from an enum field.

public static TAttribute? GetAttribute<TAttribute>(this Enum value) where TAttribute : Attribute

ExceptionExtension

GetMessage(Exception, bool, string)

Retrieves exception messages including inner exceptions.

public static string GetMessage(this Exception ex, bool getInner = true, string inSeparator = " ===>>> Inner Exception ===>>> ")

GetStackTrace(Exception, bool, string)

Retrieves stack traces including