MtxLog 1.0.0

📦 SysLog

Biblioteca para Logs diarios (APIs y Apps), Compatible con .NET Framework, .NET Standard y .NET moderno

🚀 Instalación

Puedes instalar el paquete desde NuGet ejecutando en tu proyecto:

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

Install-Package SysLog

📖 Ejemplo de uso

csharp

using BasicLibraryExt;
using SysLog;

//LogService.PathApp = ""; // Opcional para indicar una Path absoluto al log, por defecto toma: PathApp/Log
LogService.Write("Hello, World!");

try
{
	var a = 20;
	var b = 0;
	var x = a / b;
}
catch (Exception ex)
{
	LogService.Write(ex);
}


// Ejemplo 1 de uso de Objeto Respuesta
OperationResult<string> resp = FakeSendMail("prueba.gmail.com", "", "");
if (resp.Ok) Console.WriteLine($"TrackId: {resp.Response}");
LogService.Write(resp);

// Ejemplo 2 de uso de Objeto Respuesta
resp = FakeSendMail("prueba.gmail.com", "Prueba", "");
if (resp.Ok) Console.WriteLine($"TrackId: {resp.Response}");
LogService.Write(resp);

// Ejemplo 3 de uso de Objeto Respuesta
resp = FakeSendMail("prueba@gmail.com", "Prueba", "");
if (resp.Ok) Console.WriteLine($"TrackId: {resp.Response}");
LogService.Write(resp, true);

// Ejemplo 4 de uso de Objeto Respuesta
resp = FakeSendMail("prueba@gmail.com", "Prueba", "Juan");
if (resp.Ok) Console.WriteLine($"TrackId: {resp.Response}");
LogService.Write(resp, true);

// Ejemplo 5 de uso de Objeto Respuesta
resp = FakeSendMail("prueba@gmail.com", "Prueba", "Juan");
if (resp.Ok) Console.WriteLine($"TrackId: {resp.Response}");
LogService.Write(resp);

/// <summary>
/// Método de Ejemplo de la técnica de Objeto Respuesta. 
/// Este método simula el envío de un email
/// </summary>
/// <param name="email_adress"></param>
/// <param name="email_message"></param>
/// <param name="display_name"></param>
/// <returns></returns>
static OperationResult<string> FakeSendMail(
string email_adress,
string email_message = "Esta es una prueba",
string display_name = "")
{
    var errors = new List<Error>();
    var warnings = new List<Error>();

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

    if (string.IsNullOrWhiteSpace(email_message))
        errors.Add(new Error { Source = ErrorSource.BackEnd, Codigo = "E02", Descripcion = "email_message no puede ser un string vacío" });

    if (string.IsNullOrWhiteSpace(display_name))
        warnings.Add(new Error { Source = ErrorSource.BackEnd, Codigo = "W01", Descripcion = "No se ha especificado un nombre de destinatario" });

    // 🚨 Si hay errores de validación, no intento enviar nada
    if (errors.Count > 0)
        return OperationResult<string>.FromResult(errors: errors, warnings: warnings);
    try
    {
        // Aquí debería ir la llamada real a tu servicio externo
        var TrackID = Guid.NewGuid().ToString();

        // ✅ Data es el TrackID, y warnings opcionales
        return OperationResult<string>.FromResult(TrackID, warnings: warnings);
    }
    catch (Exception ex)
    {
        errors.Add(new Error { Source = ErrorSource.ExternalService, Descripcion = $"Excepción al enviar correo: {ex.Message}" });
        return OperationResult<string>.FromResult(errors: errors, warnings: warnings);
    }
}

📌 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.