using KBA.CoreUtilities.Utilities;
// By ISO2 code
var country = CountryUtils.GetCountryByIso2("SN");
Console.WriteLine($"{country.Name} - Capital: {country.Capital}"); // Sénégal - Capital: Dakar
// By ISO3 code
var usa = CountryUtils.GetCountryByIso3("USA");
// By phone code
var france = CountryUtils.GetCountryByPhoneCode("33");
// By currency code
var countries = CountryUtils.GetCountriesByCurrency("XOF");
foreach (var c in countries)
{
Console.WriteLine(c.Name); // Burkina Faso, Bénin, Côte d'Ivoire, etc.
}
// By name
var morocco = CountryUtils.GetCountryByName("Maroc");
Regional Queries
// Check if country is in UEMOA (West African Economic and Monetary Union)
bool isUemoa = CountryUtils.IsInUEMOA("SN"); // true
// Check if country is in CEMAC (Central African Economic and Monetary Community)
bool isCemac = CountryUtils.IsInCEMAC("CM"); // true
// Get all countries in a region
var westAfricanCountries = CountryUtils.GetCountriesByRegion("Afrique de l'Ouest");
// Language checks
bool isFrancophone = CountryUtils.IsFrancophone("SN"); // true
bool isAnglophone = CountryUtils.IsAnglophone("NG"); // true
Currency and Formatting
// Get currency code
string currency = CountryUtils.GetCurrencyFromIso2("FR"); // EUR
// Format currency
decimal amount = 1000.50m;
string formatted = CountryUtils.FormatCurrency(amount, "FR"); // 1 000,50 €
// Format date
DateTime date = DateTime.Now;
string formattedDate = CountryUtils.FormatDate(date, "FR"); // French date format
// Get time zone
string timezone = CountryUtils.GetTimeZone("SN"); // UTC+0
📱 Phone Utilities
Validate Phone Numbers
using KBA.CoreUtilities.Utilities;
// Validate phone number
bool isValid = PhoneUtils.IsValidPhoneNumber("+221771234567", "SN"); // true
// Validate mobile number (checks if it's a mobile line)
bool isMobile = PhoneUtils.IsValidMobileNumber("771234567", "SN"); // true
// Validate international format
bool isInternational = PhoneUtils.IsValidInternationalPhone("+221771234567"); // true
Format Phone Numbers
// Format for display
string formatted = PhoneUtils.FormatPhoneNumber("771234567", "SN");
Console.WriteLine(formatted); // +221 77 123 45 67
// Format international
string international = PhoneUtils.FormatInternational("771234567", "SN");
Console.WriteLine(international); // +221771234567
// Format national
string national = PhoneUtils.FormatNational("771234567", "SN");
Console.WriteLine(national); // 77 123 45 67
// Format E.164 (for APIs)
string e164 = PhoneUtils.FormatE164("771234567", "SN");
Console.WriteLine(e164); // +221771234567
Parse and Extract
// Parse phone number
var phoneInfo = PhoneUtils.ParsePhoneNumber("+221771234567");
Console.WriteLine($"Country: {phoneInfo.CountryCode}"); // SN
Console.WriteLine($"Number: {phoneInfo.NationalNumber}"); // 771234567
// Extract country code
string countryCode = PhoneUtils.GetCountryCodeFromPhone("+221771234567"); // SN
// Get phone code for country
string phoneCode = PhoneUtils.GetPhoneCodeForCountry("SN"); // 221
📲 QR Code Utilities
EMV Payment QR Codes (Worldwide Support)
using KBA.CoreUtilities.Utilities;
// Generate EMV QR code for Senegal (XOF)
var paymentData = EmvPaymentData.CreateForCountry(
merchantName: "Boutique Dakar",
merchantCity: "Dakar",
amount: 5000m,
countryCode: "SN",
currencyCode: "952" // XOF
);
byte[] qrCodeBytes = QrCodeUtils.GenerateEmvPaymentQrCodeImage(paymentData);
File.WriteAllBytes("payment_qr.png", qrCodeBytes);
// Generate for any country - Examples:
// USA (USD)
var usPayment = EmvPaymentData.CreateForCountry("Shop NY", "New York", 50.00m, "US", "840");
// France (EUR)
var euPayment = EmvPaymentData.CreateForCountry("Boutique Paris", "Paris", 25.00m, "FR", "978");
// Nigeria (NGN)
var ngPayment = EmvPaymentData.CreateForCountry("Shop Lagos", "Lagos", 10000m, "NG", "566");
// Morocco (MAD)
var maPayment = EmvPaymentData.CreateForCountry("Marché Casablanca", "Casablanca", 200m, "MA", "504");
// Read QR code from image
string content = QrCodeUtils.ReadQrCodeFromFile("qr_code.png");
Console.WriteLine(content);
// Read from byte array
byte[] qrBytes = File.ReadAllBytes("qr_code.png");
string decodedText = QrCodeUtils.ReadQrCode(qrBytes);
// Parse EMV QR code
string emvQrData = "000201010211..."; // EMV QR code data
var parsed = QrCodeUtils.ParseEmvPaymentQrCode(emvQrData);
Console.WriteLine($"Merchant: {parsed.MerchantName}");
Console.WriteLine($"Amount: {parsed.Amount}");
Console.WriteLine($"Currency: {QrCodeUtils.GetCurrencyDescription(parsed.CurrencyCode)}");
Currency Description (All World Currencies)
// Get description for any currency (ISO 4217)
string xof = QrCodeUtils.GetCurrencyDescription("952"); // West African CFA Franc (XOF)
string usd = QrCodeUtils.GetCurrencyDescription("840"); // US Dollar (USD)
string eur = QrCodeUtils.GetCurrencyDescription("978"); // Euro (EUR)
string ngn = QrCodeUtils.GetCurrencyDescription("566"); // Nigerian Naira (NGN)
string mad = QrCodeUtils.GetCurrencyDescription("504"); // Moroccan Dirham (MAD)
string cny = QrCodeUtils.GetCurrencyDescription("156"); // Chinese Yuan (CNY)
string jpy = QrCodeUtils.GetCurrencyDescription("392"); // Japanese Yen (JPY)
🕒 DateTime Utilities
Formatting
using KBA.CoreUtilities.Utilities;
DateTime now = DateTime.Now;
// ISO 8601 format
string iso = DateTimeUtils.ToIso8601(now); // 2024-10-27T19:12:00Z
// Unix timestamp
long timestamp = DateTimeUtils.ToUnixTimestamp(now);
DateTime fromTimestamp = DateTimeUtils.FromUnixTimestamp(timestamp);
// Relative time
string relative = DateTimeUtils.ToRelativeTime(DateTime.Now.AddHours(-2)); // 2 hours ago
string future = DateTimeUtils.ToRelativeTime(DateTime.Now.AddDays(3)); // in 3 days
// Locale-aware formatting
string shortDate = DateTimeUtils.ToShortDate(now); // 27/10/2024 (depends on culture)
string longDate = DateTimeUtils.ToLongDate(now); // Sunday, October 27, 2024
Date Calculations
// Add business days (skip weekends)
DateTime result = DateTimeUtils.AddBusinessDays(DateTime.Today, 5);
// Get business days between dates
int businessDays = DateTimeUtils.GetBusinessDaysDifference(startDate, endDate);
// Start and end of periods
DateTime startOfDay = DateTimeUtils.StartOfDay(DateTime.Now);
DateTime endOfDay = DateTimeUtils.EndOfDay(DateTime.Now);
DateTime startOfWeek = DateTimeUtils.StartOfWeek(DateTime.Now);
DateTime endOfMonth = DateTimeUtils.EndOfMonth(DateTime.Now);
DateTime startOfYear = DateTimeUtils.StartOfYear(DateTime.Now);
DateTime endOfQuarter = DateTimeUtils.EndOfQuarter(DateTime.Now);
// Age calculation
int age = DateTimeUtils.GetAge(new DateTime(1990, 5, 15)); // Calculate age from birthdate
// Days in month
int daysInCurrentMonth = DateTimeUtils.GetDaysInCurrentMonth();
// Common date ranges
var today = DateTimeUtils.GetTodayRange();
var yesterday = DateTimeUtils.GetYesterdayRange();
var thisWeek = DateTimeUtils.GetThisWeekRange();
var lastWeek = DateTimeUtils.GetLastWeekRange();
var thisMonth = DateTimeUtils.GetThisMonthRange();
var lastMonth = DateTimeUtils.GetLastMonthRange();
var thisYear = DateTimeUtils.GetThisYearRange();
var last30Days = DateTimeUtils.GetLastNDaysRange(30);
var next7Days = DateTimeUtils.GetNextNDaysRange(7);
// Usage example
var (start, end) = DateTimeUtils.GetThisMonthRange();
Console.WriteLine($"This month: {start:d} to {end:d}");
// Convert between time zones
TimeZoneInfo parisZone = DateTimeUtils.GetTimeZoneById("Europe/Paris");
TimeZoneInfo nyZone = DateTimeUtils.GetTimeZoneById("America/New_York");
DateTime parisTime = DateTime.Now;
DateTime nyTime = DateTimeUtils.ConvertTimeZone(parisTime, parisZone, nyZone);
// Convert to UTC
DateTime utc = DateTimeUtils.ToUtc(DateTime.Now);
// Convert from UTC
DateTime local = DateTimeUtils.FromUtc(DateTime.UtcNow);
// Get all time zones
var allZones = DateTimeUtils.GetAllTimeZones();
📄 Serialization Utilities
JSON Serialization
using KBA.CoreUtilities.Utilities;
// Simple serialization
var person = new Person { Name = "John", Age = 30 };
string json = SerializationUtils.ToJson(person);
// Compact JSON (no indentation)
string compact = SerializationUtils.ToCompactJson(person);
// Deserialization
Person deserializedPerson = SerializationUtils.FromJson<Person>(json);
// Deep clone
Person clone = SerializationUtils.DeepClone(person);
JSON File Operations
// Save to file
SerializationUtils.ToJsonFile(person, "person.json");
// Load from file
Person loadedPerson = SerializationUtils.FromJsonFile<Person>("person.json");
// Async operations
await SerializationUtils.ToJsonFileAsync(person, "person.json");
Person asyncLoaded = await SerializationUtils.FromJsonFileAsync<Person>("person.json");
// Serialize to XML
string xml = SerializationUtils.ToXml(person);
// Deserialize from XML
Person personFromXml = SerializationUtils.FromXml<Person>(xml);
// XML file operations
SerializationUtils.ToXmlFile(person, "person.xml");
Person loadedFromXml = SerializationUtils.FromXmlFile<Person>("person.xml");
// XML stream operations
using (var stream = File.OpenWrite("output.xml"))
{
SerializationUtils.ToXmlStream(person, stream);
}
Advanced XML Operations
// Validate XML
bool isValidXml = SerializationUtils.IsValidXml(xmlString);
// Minify XML
string minifiedXml = SerializationUtils.MinifyXml(xmlString);
// Format XML
string formattedXml = SerializationUtils.FormatXml(xmlString);
// Convert between JSON and XML
string xml = SerializationUtils.JsonToXml(jsonString, "root");
string json = SerializationUtils.XmlToJson(xmlString);
// Validate XML against schema
bool isValidAgainstSchema = SerializationUtils.ValidateXmlAgainstSchema(xml, xsdSchema);
Performance & Optimization
// Create optimized options for high-performance scenarios
var optimizedOptions = SerializationUtils.CreateOptimizedJsonOptions();
string fastJson = SerializationUtils.ToJson(largeObject, optimizedOptions);
// Stream large JSON arrays (memory-efficient)
foreach (var item in SerializationUtils.StreamJsonArray<Person>("large_array.json"))
{
// Process each item without loading entire file into memory
Console.WriteLine(item.Name);
}
// Batch operations
var people = new List<Person> { person1, person2, person3 };
await SerializationUtils.BatchSerializeToJsonAsync(people, "people.json");
List<Person> loadedPeople = await SerializationUtils.BatchDeserializeFromJsonAsync<Person>("people.json");
🌐 API Utilities
REST API Consumption
using KBA.CoreUtilities.Utilities;
// GET request
var user = await ApiUtils.GetJsonAsync<User>("https://api.example.com/users/1");
// POST request
var newUser = new User { Name = "John", Email = "john@example.com" };
var response = await ApiUtils.PostJsonAsync<User, ApiResponse>(
"https://api.example.com/users",
newUser
);
// PUT request
var updatedUser = await ApiUtils.PutJsonAsync<User, User>(
"https://api.example.com/users/1",
user
);
// DELETE request
var result = await ApiUtils.DeleteStringAsync("https://api.example.com/users/1");
Authentication
// Bearer token authentication
var client = ApiUtils.CreateAuthenticatedHttpClient("your_bearer_token");
var data = await ApiUtils.GetJsonAsync<Data>("https://api.example.com/data", client);
// Basic authentication
var basicClient = ApiUtils.CreateBasicAuthHttpClient("username", "password");
// Custom headers
var headers = new Dictionary<string, string>
{
["X-API-Key"] = "your_api_key",
["X-Custom-Header"] = "value"
};
var customClient = ApiUtils.CreateHttpClient(headers);
using KBA.CoreUtilities.Utilities;
// Truncate string
string text = "This is a long text that needs to be truncated";
string truncated = StringUtils.Truncate(text, 20); // "This is a long te..."
// Remove accents/diacritics
string withAccents = "Hôtel à Paris près de l'Élysée";
string normalized = StringUtils.RemoveAccents(withAccents); // "Hotel a Paris pres de l'Elysee"
// Generate slug
string slug = StringUtils.GenerateSlug("Hello World! This is a Test"); // "hello-world-this-is-a-test"
// Capitalize
string capitalized = StringUtils.Capitalize("hello world"); // "Hello world"
// Title case
string title = StringUtils.ToTitleCase("hello world"); // "Hello World"
// Camel case
string camel = StringUtils.ToCamelCase("hello-world-test"); // "helloWorldTest"
// Pascal case
string pascal = StringUtils.ToPascalCase("hello-world-test"); // "HelloWorldTest"
// Snake case
string snake = StringUtils.ToSnakeCase("HelloWorldTest"); // "hello_world_test"
// Kebab case
string kebab = StringUtils.ToKebabCase("HelloWorldTest"); // "hello-world-test"
// Compare two files byte by byte
bool areEqual = FileUtils.AreFilesEqual("file1.txt", "file2.txt");
Console.WriteLine($"Files are equal: {areEqual}");
🔍 Reflection Utilities
Property Operations
using KBA.CoreUtilities.Utilities;
// Get property value dynamically
var email = ReflectionUtils.GetPropertyValue(user, "Email");
// Set property value
ReflectionUtils.SetPropertyValue(user, "Status", "Active");
// Get properties with specific attribute
var props = ReflectionUtils.GetPropertiesWithAttribute<RequiredAttribute>(typeof(User));
Method Invocation
// Invoke method dynamically
var result = ReflectionUtils.InvokeMethod(service, "ProcessOrder", orderId, userId);
// Invoke static method
var config = ReflectionUtils.InvokeStaticMethod(typeof(AppConfig), "Load");
// Invoke generic method
var data = ReflectionUtils.InvokeGenericMethod(
repository,
"GetById",
new[] { typeof(User) },
userId);
Type Inspection
// Check if type implements interface
bool implements = ReflectionUtils.ImplementsInterface<IService>(typeof(MyService));
// Get all types implementing interface
var services = ReflectionUtils.GetTypesImplementingInterface<IPlugin>(assembly);
// Check if nullable
bool isNullable = ReflectionUtils.IsNullable(typeof(int?)); // true
Object Mapping
// Map object to another type
var userDto = ReflectionUtils.MapTo<User, UserDto>(user);
// Deep copy
var clone = ReflectionUtils.DeepCopy(originalObject);
Instance Creation
// Create instance with parameters
var service = ReflectionUtils.CreateInstance<MyService>(dependency1, dependency2);
// Create instance of type
var instance = ReflectionUtils.CreateInstance(type, args);
⚡ Performance Utilities
Execution Time Measurement
using KBA.CoreUtilities.Utilities;
// Measure execution time
var elapsed = PerformanceUtils.Measure(() => {
// Heavy operation
ProcessData();
});
Console.WriteLine($"Took {elapsed.TotalMilliseconds}ms");
// Measure with result
var (result, time) = PerformanceUtils.Measure(() => ComputeValue());
Async Measurements
// Measure async operations
var elapsed = await PerformanceUtils.MeasureAsync(async () => {
await FetchDataAsync();
});
// Measure async with result
var (data, time) = await PerformanceUtils.MeasureAsync(async () => {
return await LoadDataAsync();
});
Profiling
// Profile with using statement
using (PerformanceUtils.Profile("Database Query", (name, elapsed) => {
Logger.LogInformation($"{name} completed in {elapsed.TotalMilliseconds}ms");
}))
{
var data = database.Query();
}
Memory Monitoring
// Get current memory usage
var memoryBytes = PerformanceUtils.GetMemoryUsage();
var memoryFormatted = PerformanceUtils.GetMemoryUsageFormatted(); // "125.5 MB"
// Measure memory used by operation
var (result, memUsed) = PerformanceUtils.MeasureMemory(() => {
return LoadLargeDataSet();
});
Console.WriteLine($"Used {PerformanceUtils.FormatBytes(memUsed)}");
In-Memory Caching
// Get or add to cache with expiration
var users = PerformanceUtils.GetOrAdd(
"all_users",
() => database.GetAllUsers(),
expiration: TimeSpan.FromMinutes(5));
// Async cache
var data = await PerformanceUtils.GetOrAddAsync(
"api_data",
async () => await apiClient.FetchDataAsync(),
expiration: TimeSpan.FromMinutes(10));
// Direct cache operations
PerformanceUtils.SetCache("key", value, TimeSpan.FromHours(1));
var cached = PerformanceUtils.GetFromCache<MyType>("key");
PerformanceUtils.RemoveFromCache("key");
PerformanceUtils.ClearCache();
Rate Limiting
// Check if rate limited
if (PerformanceUtils.IsRateLimited("api_call", maxCalls: 100, TimeSpan.FromMinutes(1)))
{
throw new TooManyRequestsException();
}
// Process request
ProcessApiCall();
using KBA.CoreUtilities.Extensions;
// Add timeout to task
var result = await LongRunningTask()
.WithTimeout(TimeSpan.FromSeconds(30));
// With cancellation token
var data = await FetchDataAsync()
.WithTimeout(TimeSpan.FromSeconds(10), cancellationToken);
Retry with Exponential Backoff
// Retry on failure
var result = await (() => UnreliableOperationAsync())
.Retry(
maxRetries: 3,
initialDelay: TimeSpan.FromSeconds(1),
backoffMultiplier: 2.0);
// Sync retry
(() => UnreliableOperation()).Retry(maxRetries: 5);
Exception Handling
// Handle exceptions gracefully
var result = await RiskyOperationAsync()
.HandleException(ex => {
Logger.LogError(ex, "Operation failed");
return defaultValue;
});
// Return default on error
var data = await FetchDataAsync().OrDefault(new DataObject());
Fire and Forget
// Execute without waiting
SendEmailAsync(user).FireAndForget(onException: ex => {
Logger.LogError(ex, "Email sending failed");
});
Parallel Processing
// Run tasks in parallel with degree limit
var urls = new[] { "url1", "url2", "url3", /*...*/ };
var tasks = urls.Select(url => DownloadAsync(url)).ToArray();
var results = await tasks.RunInParallel(maxDegreeOfParallelism: 5);
Task Chaining
// Chain tasks
var result = await FetchDataAsync()
.Then(data => ProcessDataAsync(data))
.Then(processed => SaveResultAsync(processed));
WaitAll with Cancellation
// Wait for all tasks with cancellation
var tasks = new[] { task1, task2, task3 };
await tasks.WaitAllAsync(cancellationToken);
// Wait with timeout
await tasks.WaitAllAsync(TimeSpan.FromSeconds(30));
⚙️ Configuration Extensions
Typed Value Retrieval
using KBA.CoreUtilities.Extensions;
using Microsoft.Extensions.Configuration;
// Get typed values with defaults
var timeout = configuration.GetInt("Timeout", defaultValue: 30);
var retries = configuration.GetInt("MaxRetries", 3);
var enabled = configuration.GetBool("FeatureEnabled", false);
var factor = configuration.GetDecimal("MultiplierFactor", 1.5m);
var mode = configuration.GetEnum<LogLevel>("LogLevel", LogLevel.Information);
var delay = configuration.GetTimeSpan("RetryDelay", TimeSpan.FromSeconds(5));
Required Values
// Get required value (throws if missing)
var apiKey = configuration.GetRequired("ApiKey");
var connectionString = configuration.GetRequired("DatabaseConnection");
// Get required with type conversion
var port = configuration.GetRequired<int>("Port");
Environment Variable Fallback
// Try config first, then environment variable
var apiUrl = configuration.GetFromConfigOrEnv("ApiUrl", "API_URL");
// Connection string with env fallback
var connString = configuration.GetConnectionStringOrEnv("Database");
Section Operations
// Bind section to typed object
var appSettings = configuration.GetSection<AppSettings>("App");
// Check if section exists
if (configuration.SectionExists("Features"))
{
var features = configuration.GetSection<FeatureFlags>("Features");
}
// Get section as dictionary
var dict = configuration.GetDictionary("CustomSettings");
Array and List Values
// Get array from comma-separated value
var allowedHosts = configuration.GetArray("AllowedHosts");
// Get list of objects
var endpoints = configuration.GetList<EndpointConfig>("Endpoints");
// Dump all configuration (masks sensitive keys)
var configDump = configuration.DumpConfiguration(includeSensitive: false);
Console.WriteLine(configDump);
// Get all settings as dictionary
var allSettings = configuration.GetAllSettings();
🎯 Real-World Examples
Example 1: Mobile Money Payment with QR Code
using KBA.CoreUtilities.Utilities;
// Create EMV payment for mobile money
var payment = EmvPaymentData.CreateMobileMoney(
merchantName: "Restaurant Teranga",
merchantCity: "Dakar",
amount: 15000m,
phoneNumber: "771234567",
provider: "Orange Money",
countryCode: "SN",
currencyCode: "952" // XOF
);
// Generate QR code
byte[] qrCode = QrCodeUtils.GenerateEmvPaymentQrCodeImage(payment, 400, 400);
// Save QR code
File.WriteAllBytes("payment_qr.png", qrCode);
// Validate the payment data
if (payment.IsValid())
{
Console.WriteLine("Payment QR code generated successfully!");
Console.WriteLine($"Currency: {QrCodeUtils.GetCurrencyDescription(payment.CurrencyCode)}");
}
Example 2: International Phone Validation & Formatting
// Validate and format phones from multiple countries
var phones = new[]
{
("+221771234567", "SN"), // Senegal
("+33612345678", "FR"), // France
("+2349012345678", "NG"), // Nigeria
("+16505551234", "US") // USA
};
foreach (var (phone, country) in phones)
{
if (PhoneUtils.IsValidPhoneNumber(phone, country))
{
string formatted = PhoneUtils.FormatPhoneNumber(phone, country);
string e164 = PhoneUtils.FormatE164(phone, country);
Console.WriteLine($"{country}: {formatted} (E.164: {e164})");
}
}
Example 3: Date Range Reporting
// Generate monthly report
var (startDate, endDate) = DateTimeUtils.GetThisMonthRange();
Console.WriteLine($"Report Period: {DateTimeUtils.ToShortDate(startDate)} - {DateTimeUtils.ToShortDate(endDate)}");
Console.WriteLine($"Business Days: {DateTimeUtils.GetBusinessDaysDifference(startDate, endDate)}");
// Get all business days in range
var businessDays = DateTimeUtils.GetBusinessDaysBetween(startDate, endDate);
Console.WriteLine($"Working days: {string.Join(", ", businessDays.Select(d => d.ToString("dd/MM")))}");
Example 4: API Integration with Retry
// Fetch data from API with automatic retry on failure
var userData = await ApiUtils.ExecuteWithRetryAsync(async () =>
{
var client = ApiUtils.CreateAuthenticatedHttpClient(apiToken);
return await ApiUtils.GetJsonAsync<UserData>(apiUrl, client);
}, maxRetries: 3, delayMs: 2000);
// Serialize to JSON and save
await SerializationUtils.ToJsonFileAsync(userData, "user_data.json");
