Flynk.Common.Utils 6.2.2

Flynk.Common.Utils

A comprehensive utility library for .NET applications providing essential functionality for pagination, collections, validation, string manipulation, logging, and more.

📦 Quick Installation

Install-Package Flynk.Common.Utils

Or via .NET CLI:

dotnet add package Flynk.Common.Utils

🚀 Core Features

• 📄 Pagination - PagedList<T> with robust metadata tracking
• 🔒 Thread-Safe Collections - Thread-safe list implementations with reader/writer locks
• ✅ Validation - Comprehensive validators for common scenarios (GUID, URL, IP, etc.)
• 🔤 String Utilities - Advanced manipulation, encoding, and formatting utilities
• 📝 Logging - Flexible logging framework with multiple severity levels
• 🏭 Factory Pattern - Generic factory with singleton support
• 📊 Data Structures - Observable collections, trees, and specialized structures
• 🌍 Internationalization - Country and phone number utilities with region support

💡 Quick Examples

Pagination

var pageSize = 20;
var pagedList = new PagedList<Product>(
    skip: 0,
    take: pageSize,
    items: allItems.Take(pageSize).ToList(),
    totalItems: allItems.Count
);

Console.WriteLine($"Page {pagedList.CurrentPage} of {pagedList.TotalPages}");

Validation

bool isValidGuid = Validator.Guids.IsGuid("550e8400-e29b-41d4-a716-446655440000");
bool isValidUrl = Validator.Urls.IsUrl("https://www.example.com");
bool isValidIp = Validator.IpAddresses.IsIpAddress("192.168.1.1");

String Utilities

string code = "ABC123DEF".ToSpacedCode("-"); // "ABC-123-DEF"
string encoded = Strings.ToCrockfordBase32(123456789);

Phone Numbers

bool isMobile = Phone.IsMobile("+1-555-0123", "US");
string digits = Phone.GetDigits("+1 (555) 123-4567"); // "15551234567"

🏗️ Architecture

Built on proven design patterns:

• Factory Pattern - Generic factory with singleton support
• Observer Pattern - Observable collections with event notifications
• Thread Safety - Safe concurrent access throughout

📚 Documentation

Full API documentation available:

• IntelliSense in Visual Studio / VS Code
• XML documentation comments in source
• NuGet Package Page

🧪 Quality Assurance

• ✅ 140+ comprehensive unit tests
• ✅ Full test coverage for core components
• ✅ Concurrency testing for thread-safe collections
• ✅ Cross-platform validation

📄 License

Freeware - Distributed under the Flynk Pty Ltd Freeware License Agreement.

Key Terms:

• ✅ Free to use
• ✅ Free to distribute
• ❌ No modifications or derivative works
• ❌ No commercial redistribution

See the license file for complete terms.

👥 Support

Developed and maintained by Flynk Pty Ltd and the Flynk Developers team.

© Flynk Pty Ltd. All rights reserved.