ContosoPackage 1.0.0

ContosoPackage

A comprehensive utility library providing common helper functions and extensions for .NET applications.

Features

• String Extensions: Enhanced string manipulation and validation methods
• DateTime Helpers: Convenient date and time calculation utilities
• Collection Extensions: Powerful collection manipulation and querying methods

Installation

Install the package via NuGet Package Manager:

Install-Package ContosoPackage

Or via .NET CLI:

dotnet add package ContosoPackage

Usage

String Extensions

using ContosoPackage.Utilities;

string text = "hello world";
string titleCase = text.ToTitleCase(); // "Hello World"

string email = "user@example.com";
bool isValid = email.IsValidEmail(); // true

string longText = "This is a very long text that needs to be truncated";
string truncated = longText.Truncate(20); // "This is a very lo..."

DateTime Helpers

using ContosoPackage.Utilities;

DateTime today = DateTime.Today;
DateTime startOfWeek = DateTimeHelpers.GetStartOfWeek(today);
DateTime endOfWeek = DateTimeHelpers.GetEndOfWeek(today);

DateTime birthDate = new DateTime(1990, 5, 15);
int age = DateTimeHelpers.CalculateAge(birthDate);

bool isWeekend = DateTimeHelpers.IsWeekend(DateTime.Today);

Collection Extensions

using ContosoPackage.Utilities;

var numbers = new[] { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 };
var chunks = numbers.Chunk(3); // [[1,2,3], [4,5,6], [7,8,9], [10]]

var items = new List<string> { "apple", "banana", "cherry" };
bool isEmpty = items.IsNullOrEmpty(); // false

var randomItem = items.Random(); // Returns a random item from the list

API Reference

StringExtensions

• ToTitleCase() - Converts string to title case
• IsValidEmail() - Validates email format
• Truncate(int maxLength) - Truncates string with ellipsis

DateTimeHelpers

• GetStartOfWeek(DateTime date) - Gets Monday of the week
• GetEndOfWeek(DateTime date) - Gets Sunday of the week
• CalculateAge(DateTime birthDate, DateTime? asOfDate = null) - Calculates age
• IsWeekend(DateTime date) - Checks if date is weekend

CollectionExtensions

• Chunk<T>(int chunkSize) - Splits collection into chunks
• IsNullOrEmpty<T>() - Checks if collection is null or empty
• Random<T>() - Returns random element from collection

Requirements

• .NET 6.0 or later

License

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

Contributing

We welcome contributions! Please feel free to submit a Pull Request.

Support

If you encounter any issues or have questions, please open an issue on GitHub.

Contoso Corporation - Building better software tools for developers worldwide.