BasicLibraryExt 1.0.6

📦 BasicLibraryExt

Biblioteca común compatible con .NET Framework, .NET Standard y .NET Core/NET moderno.
Incluye métodos de extensión para la clase string y object.

🚀 Instalación

Puedes instalar el paquete desde NuGet ejecutando en tu proyecto:

dotnet add package BasicLibraryExt
O desde la Consola del Administrador de Paquetes en Visual Studio:

Install-Package BasicLibraryExt

📖 Ejemplo de uso

csharp

using System;
using System.Collections.Generic;
using static BasicLibraryExt.FileExtensions;
using BasicLibraryExt;
using System.Collections.Concurrent;


// Convertir a tipo título (Primera letra de cada palabra execpto conectores y a mayuscula algunas siglas conocidas en español)
var titulo = "dirección de impueStos y aduanas naciOnales diaN";
Console.WriteLine(titulo.ToTitleEachWord());
            
// Convertir mayuscula la primera letra del texto y el resto a maýúsculas
titulo = "dirección de impueStos y aduanas naciOnales diaN";
Console.WriteLine(titulo.ToTitle());

// El método de extensión IsIn devuelve True si el texto de la variable se encuentra dentro de la lista
var nombres = new List<string> { "Ana", "Luis", "Pedro" };
if ("Luis".IsIn(nombres))
{
    Console.WriteLine($"Luis está en {string.Join(", ", nombres)}");
}

var permiso = 14;

// El mismo ejemplo anterior pero con numeros
var numeros = new List<int> { 23, 14, 82, 3, 21 };
if (permiso.IsIn(numeros))
{
    Console.WriteLine($"{permiso} está en {string.Join(", ", numeros)}");
}


// Determinar si una palabra está contenida dentro de una cadena 
var frase = "Colombia tierra querida";
if (frase.StringContains("Tierra")) Console.WriteLine("Existe");

// Quitar espacios innecesarios dentro de una cadena de caracteres
var text = "   esta       es    una    prueba  fasdf   fsdfasd   fasd fsdfsd f    fdsfdsafas   fsdaf  ";
Console.WriteLine(text.TrimExcessSpaces());


// Genera el valor en letras de un valor numerico decimal
var precio = 1478292.47M;
Console.WriteLine(precio.ToWords().ToTitle());      // Sin indicar moneda
Console.WriteLine(precio.ToWords(enumMoneda.USD));  // Incluyendo 


string ruta = @"C:\Users\MATRIXSQL\source\repos\Bibliotecas\BasicLibraryExt\README.md";

// Este método de extensión valida si un string corresponde a un pathfilename válido
if (ruta.IsPathFileName())
{
    // Este método extrae el contenido de un archivo de texto, que pueda leerse como texto plano
    // por ejemplo un archivo .txt, .html, .json, etc
    var txt = ruta.GetText(); 
}


// Este es un método estatico que puede usarse como si fuera una
// función intrínseca de c# simpre y cuando se declare el using así: 
// using static BasicLibraryExt.FileExtensions;
if (FileExists(ruta))
{
    Console.WriteLine("El archivo existe");
}


// En método de extensión IsBetween devuelve True si el texto de la variable se encuentra dentro
// del rango de valores determinado por los parámetros valor_inf y valor_sup
if ("1370".IsBetween("1305", "1380"))
    Console.WriteLine("1365 está entre 1305 y 1380");
else
    Console.WriteLine("N no está entre A y Z");



// Ejemplo de serialización y DesSerialización 
var per = new persona 
{
    id = 2,
    Nombre = "Eduardo Hernández",
    Direccion = "Calle 72 # 43 - 27",
    Telefono = "3008727643"
};


// Ejemplo para Serialzar 
var json = per.ToJson();

// Ejemplo para DesSerializar
var prsn = json.ToObject<persona>();



// Ejemplo de objeto respuesta
// Esto es útil para usarlo como respuesta de un método que debe validar varias reglas
// y devolver todas las infracciones encontradas.
// y mediante el atricuto Ok se valida si se ejecuto sin errores.  
RespMethod resp = new();
resp.Errores.Add(new MtxError { Ambito = enmAmbito.MiddleWare, Descripcion = "Este es un error de prueba" });
resp.Errores.Add(new MtxError { Ambito = enmAmbito.ExternalService, Descripcion = "Este es otro error de prueba" });
Console.WriteLine(resp.ErroresDesc);
            

public class persona
{
    public int id { get; set; }
    public string Nombre { get; set; }
    public string Direccion { get; set; }
    public string Telefono { get;  set; }
}

📌 Compatibilidad

✅ .NET Framework 4.8

✅ .NET Standard 2.0

✅ .NET 6

✅ .NET 8

📜 Licencia

Este software es propiedad de SISTEMAS 360 SAS (en adelante “el Licenciante”). Su uso está sujeto a los siguientes términos:

1) Licencia de prueba: El software 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 la compra de una suscripción mensual o anual. El uso sin licencia activa está estrictamente prohibido.

3) Restricciones:

3.1) Queda prohibida la descompilación, ingeniería inversa, modificación u ofuscación inversa del software.

3.2) No está permitido redistribuir, sublicenciar o revender el software sin autorización escrita del Licenciante.

4. Propiedad intelectual: Este software es propiedad exclusiva del Licenciante. No se transfiere ningún derecho de propiedad al usuario, solo un derecho de uso limitado bajo esta licencia.

5) Limitación de responsabilidad: El software se entrega “tal cual”. El Licenciante no será responsable de daños directos, indirectos o consecuentes derivados de su uso.

6) Terminación: El incumplimiento de estos términos resultará en la terminación automática de la licencia y en la obligación de desinstalar el software.