RepletoryLib.Utilities.Conversion 1.0.0

RepletoryLib.Utilities.Conversion

Type conversion utilities for JSON, XML, CSV, Base64, enums, and unit conversions.

Part of the RepletoryLib ecosystem -- standalone, reusable .NET 10 libraries with zero business logic.

Overview

RepletoryLib.Utilities.Conversion provides a collection of static converter classes for common data transformation tasks. All converters are static -- no DI registration required.

Key Features

• JSON -- Serialize/deserialize with pretty-print and safe try-parse
• XML -- XML serialization and deserialization
• CSV -- Convert collections to/from CSV strings
• Base64 -- Encode/decode strings and byte arrays
• Enum -- Display names, dictionaries, and value listing
• Type -- Safe generic type conversion with defaults
• Unit -- Metric/imperial conversions (km/miles, kg/lbs, C/F, liters/gallons)

Installation

dotnet add package RepletoryLib.Utilities.Conversion

Dependencies

Usage Examples

JSON

using RepletoryLib.Utilities.Conversion;

var order = new Order { Id = 1, Total = 299.99m };

string json = JsonConverter.Serialize(order);                 // Compact
string pretty = JsonConverter.Serialize(order, pretty: true); // Indented

var restored = JsonConverter.Deserialize<Order>(json);

// Safe parsing
if (JsonConverter.TryDeserialize<Order>(json, out var result))
{
    Console.WriteLine(result!.Total);
}

CSV

using RepletoryLib.Utilities.Conversion;

var products = new List<Product>
{
    new() { Name = "Widget", Price = 9.99m },
    new() { Name = "Gadget", Price = 19.99m }
};

string csv = CsvConverter.ToCsv(products);
// "Name,Price\nWidget,9.99\nGadget,19.99"

var parsed = CsvConverter.FromCsv<Product>(csv);

Base64

using RepletoryLib.Utilities.Conversion;

string encoded = Base64Converter.Encode("Hello World");   // "SGVsbG8gV29ybGQ="
string decoded = Base64Converter.Decode(encoded);         // "Hello World"

byte[] bytes = System.Text.Encoding.UTF8.GetBytes("data");
string b64 = Base64Converter.EncodeBytes(bytes);
byte[] back = Base64Converter.DecodeBytes(b64);

Enum

using RepletoryLib.Utilities.Conversion;
using System.ComponentModel.DataAnnotations;

public enum OrderStatus
{
    [Display(Name = "Pending Payment")]
    Pending,
    [Display(Name = "Order Shipped")]
    Shipped,
    Delivered
}

string display = EnumConverter.ToDisplayName(OrderStatus.Pending); // "Pending Payment"
var status = EnumConverter.FromDisplayName<OrderStatus>("Order Shipped"); // Shipped

var allValues = EnumConverter.GetValues<OrderStatus>();
var dict = EnumConverter.ToDictionary<OrderStatus>();
// { 0: "Pending Payment", 1: "Order Shipped", 2: "Delivered" }

Type Conversion

using RepletoryLib.Utilities.Conversion;

if (TypeConverter.TryConvert<int>("42", out var num))
    Console.WriteLine(num); // 42

decimal price = TypeConverter.ConvertOrDefault<decimal>("invalid", 0m); // 0m

Unit Conversion

using RepletoryLib.Utilities.Conversion;

double miles = UnitConverter.KmToMiles(100);           // 62.137...
double km = UnitConverter.MilesToKm(62.137);           // ~100
double lbs = UnitConverter.KgToLbs(80);                // 176.37...
double fahrenheit = UnitConverter.CelsiusToFahrenheit(37); // 98.6
double gallons = UnitConverter.LitersToGallons(3.785); // ~1.0

API Reference

Integration with Other RepletoryLib Packages

License

This project is licensed under the MIT License.

Copyright (c) 2024-2026 Repletory.

For complete documentation, infrastructure setup, and configuration reference, see the RepletoryLib main repository.