BasicLibraryExt 1.0.15

BasicLibraryExt

Biblioteca utilitaria para proyectos .NET con métodos de extensión y clases comunes para operaciones frecuentes: cadenas, objetos, archivos, JSON, cifrado simple y respuestas de operación.

El paquete mantiene compatibilidad con aplicaciones existentes en .NET Framework, .NET Standard y versiones modernas de .NET.

Instalación

Desde la CLI de .NET:

dotnet add package BasicLibraryExt

Desde la Consola del Administrador de Paquetes de Visual Studio:

Install-Package BasicLibraryExt

Compatibilidad

El paquete publica ensamblados para:

• .NET Framework 4.8
• .NET Standard 2.0
• .NET 5
• .NET 6
• .NET 8

Compilar y Ejecutar Pruebas

Restaurar paquetes:

dotnet restore .\BasicLibraryExt.sln

Compilar la solución:

dotnet build .\BasicLibraryExt.sln -c Release

Ejecutar pruebas automatizadas:

dotnet test .\TestBasicLibraryExt\TestBasicLibraryExt.csproj -c Release

Uso Básico

using BasicLibraryExt;
using static BasicLibraryExt.FileExtensions;

Extensiones Para String

Formato de texto

var titulo = "dirección de impueStos y aduanas naciOnales dian";

Console.WriteLine(titulo.ToTitle());
// Dirección de impuestos y aduanas nacionales dian

Console.WriteLine(titulo.ToTitleEachWord());
// Dirección de Impuestos y Aduanas Nacionales DIAN

Limpieza de espacios

var texto = "   esta       es    una    prueba   ";

Console.WriteLine(texto.TrimExcessSpaces());
// esta es una prueba

Búsqueda y validaciones

var frase = "Colombia tierra querida";

if (frase.StringContains("tierra"))
{
    Console.WriteLine("Existe");
}

if ("usuario@dominio.com".IsValidEmail())
{
    Console.WriteLine("Email válido");
}

Extracción de texto

var texto = "BasicLibraryExt";

Console.WriteLine(texto.Left(5));      // Basic
Console.WriteLine(texto.Right(3));     // Ext
Console.WriteLine(texto.Mid(5, 7));    // Library
Console.WriteLine(texto.FirstWord());  // BasicLibraryExt

Rangos y colecciones

var nombres = new List<string> { "Ana", "Luis", "Pedro" };

if ("Luis".IsIn(nombres))
{
    Console.WriteLine("Luis está en la lista");
}

if ("1370".IsBetween("1305", "1380"))
{
    Console.WriteLine("El valor está dentro del rango");
}

Valores numéricos en letras

var precio = 1478292.47m;

Console.WriteLine(precio.ToWords());
Console.WriteLine(precio.ToWords(enumMoneda.COP));
Console.WriteLine(precio.ToWords(enumMoneda.USD));

Monedas soportadas:

• enumMoneda.COP
• enumMoneda.USD
• enumMoneda.EUR
• enumMoneda.GBP

Cifrado y Descifrado

La biblioteca incluye métodos de extensión para cifrar y descifrar texto usando AES.

Usando una clave explícita

var masterKey = "clave-maestra-de-mi-aplicacion";
var textoPlano = "Texto confidencial";

var textoCifrado = textoPlano.Encrypt(masterKey);
var textoOriginal = textoCifrado.Decrypt(masterKey);

Usando archivo de master key

También puedes configurar la aplicación y el cliente para que la librería busque el archivo master.key automáticamente.

StringExtensions.App = "MiAplicacion";
StringExtensions.Client = "ClienteA";

var textoCifrado = "Texto confidencial".Encrypt();
var textoOriginal = textoCifrado.Decrypt();

En Windows, la ruta se construye dentro de LocalApplicationData:

%LOCALAPPDATA%\MiAplicacion\ClienteA\master.key

En Linux, la ruta se construye así:

/etc/MiAplicacion/ClienteA/master.key

Extensiones Para Object

object valor = "12345";

if (valor.IsNumeric())
{
    Console.WriteLine("El objeto es numérico");
}

var entero = valor.As<int>();
var costo = valor.As<decimal>(0m);

También puedes validar números positivos:

object cantidad = 25;

if (cantidad.IsPositiveNumber())
{
    Console.WriteLine("La cantidad es positiva");
}

Archivos y Directorios

Leer texto

var ruta = @"C:\temp\archivo.txt";

if (ruta.IsPathFileName())
{
    var contenido = ruta.GetText();
}

Validar existencia de archivos

if (FileExists(@"C:\temp\archivo.txt"))
{
    Console.WriteLine("El archivo existe");
}

Crear directorios si no existen

FileExtensions.EnsureDirectoryExists(@"C:\temp\reportes");

JSON

La biblioteca usa System.Text.Json con salida indentada, soporte para enums como texto y codificación relajada para caracteres especiales.

var persona = new Persona
{
    Id = 2,
    Nombre = "Eduardo Hernández",
    Direccion = "Calle 72 # 43 - 27",
    Telefono = "3008727643"
};

var json = persona.ToJson();
var copia = json.ToObject<Persona>();

public class Persona
{
    public int Id { get; set; }
    public string Nombre { get; set; } = string.Empty;
    public string Direccion { get; set; } = string.Empty;
    public string Telefono { get; set; } = string.Empty;
}

FromJson<T>() se mantiene por compatibilidad, pero está marcado como obsoleto. Usa ToObject<T>() en código nuevo.

OperationResult<T>

OperationResult<T> permite devolver una respuesta estándar desde métodos de negocio o servicios, incluyendo:

• Ok: indica si la operación fue exitosa.
• Response: datos devueltos por la operación.
• Errors: lista de errores.
• Warnings: lista de advertencias.
• Describe(): descripción detallada del resultado.

OperationResult<string> resultado = EnviarCorreo("usuario@dominio.com");

if (resultado.Ok)
{
    Console.WriteLine($"TrackId: {resultado.Response}");
}
else
{
    Console.WriteLine(resultado.Describe());
}

Ejemplo completo:

public static OperationResult<string> EnviarCorreo(string email)
{
    var errors = new List<Error>();
    var warnings = new List<Error>();

    if (!email.IsValidEmail())
    {
        errors.Add(new Error
        {
            Source = ErrorSource.BackEnd,
            Codigo = "E01",
            Descripcion = "El email no tiene un formato válido"
        });
    }

    if (errors.Count > 0)
    {
        return OperationResult<string>.FromResult(errors: errors, warnings: warnings);
    }

    var trackId = Guid.NewGuid().ToString();
    return OperationResult<string>.FromResult(trackId, warnings: warnings);
}

También puedes crear una respuesta exitosa directamente:

var resultado = OperationResult<string>.Success("OK");

Manejo de Errores

var error = new Error
{
    Source = ErrorSource.DataBase,
    Codigo = "DB01",
    Descripcion = "No fue posible conectar con la base de datos"
};

Fuentes de error disponibles:

• None
• BackEnd
• FrontEnd
• MiddleWare
• ExternalService
• DataBase
• FileSystem
• Other

APIs Obsoletas

Las siguientes APIs se mantienen para no romper compatibilidad con aplicaciones existentes, pero se recomienda evitarlas en código nuevo:

• MtxError: usa Error.
• RespMethod: usa OperationResult<T>.
• LeerTexto: usa GetText.
• FromJson<T>: usa ToObject<T>.

Notas de Compatibilidad

• El paquete conserva netstandard2.0 para proyectos que necesiten máxima compatibilidad.
• El paquete incluye targets específicos para net5.0, net6.0 y net8.0 para que las aplicaciones modernas usen el ensamblado más adecuado.
• Para net48 y netstandard2.0, el paquete referencia System.Text.Json.
• Para net5.0, net6.0 y net8.0, System.Text.Json se toma desde el framework correspondiente.

Licencia

Este software es propiedad de SISTEMAS 360 SAS.

Su uso está sujeto a los términos definidos por el Licenciante:

1. Licencia de prueba: puede usarse gratuitamente por un periodo de 6 meses a partir de la primera instalación.
2. Licencia comercial: después del periodo de prueba, el uso requiere una suscripción mensual o anual.
3. Restricciones: no se permite descompilación, ingeniería inversa, redistribución, sublicenciamiento o reventa sin autorización escrita.
4. Propiedad intelectual: el software es propiedad exclusiva del Licenciante.
5. Limitación de responsabilidad: el software se entrega tal cual.
6. Terminación: el incumplimiento de estos términos termina automáticamente la licencia de uso.