BasicLibraryExt 1.0.2

📦 MtxBasicLibraryExt

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 MtxBasicLibraryExt
O desde la Consola del Administrador de Paquetes en Visual Studio:


XInstall-Package MtxBasicLibraryExt

📖 Ejemplo de uso

csharp


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

namespace TestBasicLibraryExt
{
    class Program
    {
        static void Main(string[] args)
        {
            // Convertir a tipo título (Primera letra de cada palabra execpto conectores y a mayuscula algunas siglas conocidas en español)
            var titulo = "el poblado sas";
            Console.WriteLine(titulo.ToTitleEachWord());

            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 = "el poblado sas";
            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.FromJson<object>();



            // 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 proyecto está bajo la licencia MIT. Eres libre de usarlo, modificarlo y distribuirlo, siempre que mantengas el aviso de licencia.