Maleron.Logging 1.1.2

Maleron.Logging

Universal logger for .NET that writes to Console, Trace, and text file with daily rotation and hierarchical directory structure.

Installation

dotnet add package Maleron.Logging

Quick Start

using Maleron.Logging;

// Write with severity levels
Logger.Info("Application started");
Logger.Warning("Disk space low: {0}GB remaining", 2.3);
Logger.Error("Connection failed");

// Log exceptions
Logger.Exception(ex, "Failed to process order");

// Write like Console.WriteLine
Logger.WriteLine("Hello, World!");
Logger.WriteLine(42);
Logger.WriteLine(true);

Configuration

// Change log directory (default: <AppBase>/Logs)
Logger.LogDirectory = @"C:\MyApp\Logs";

// Change directory structure (default: Monthly)
Logger.DirectoryStructure = LogDirectoryStructure.Monthly; // Logs/2026/August/
Logger.DirectoryStructure = LogDirectoryStructure.Yearly;  // Logs/2026/
Logger.DirectoryStructure = LogDirectoryStructure.Daily;   // Logs/2026/August/03/
Logger.DirectoryStructure = LogDirectoryStructure.Flat;    // Logs/

// Change file prefix and extension (default: log.txt)
Logger.LogFilePrefix = "myapp";
Logger.LogFileExtension = "log";

// Enable/disable outputs
Logger.EnableConsole = true;   // Default: true
Logger.EnableTrace = true;     // Default: true
Logger.EnableFile = true;      // Default: true

Timestamps

Logger.TimestampLocality = TimeLocality.Local;  // [2026-08-03 14:30:00]
Logger.TimestampLocality = TimeLocality.UTC;    // [2026-08-03 12:30:00 UTC]
Logger.TimestampLocality = TimeLocality.Both;   // [2026-08-03 14:30:00 / 2026-08-03 12:30:00 UTC]
Logger.TimestampLocality = TimeLocality.None;   // (no timestamp)

Log Levels

Or use the generic method:

Logger.Log(LogLevel.Info, "Message");

File Output

Files are created daily with the pattern {Prefix}_{yyyy-MM-dd}.{Extension}:

Logs/
└── 2026/
    └── August/
        ├── log_2026-08-01.txt
        ├── log_2026-08-02.txt
        └── log_2026-08-03.txt

Clean Old Logs

Logger.CleanOldLogs(daysToKeep: 30);

Thread Safety

All write operations are thread-safe. The logger uses a lock to synchronize writes across Console, Trace, and File outputs.