EasyLogPlus

A [relatively] simple .NET 6 logging library. Originally made by byte-0x74, extended by asoji.

What's different between this and the original repo?

• Uses .NET 6 instead of .NET Framework 4.x
• The text is more way readable [in my opinion]*
• Customizable severity level colors
• Added the whole Syslog Severity Level standardization [read about that here], cranking from 4 severity levels to 8.
• Uses your local timezone in logs instead of UTC timezone
• Switchable between : and => in logs, like NOTICE: This is notice text! or NOTICE => This is notice text! using cfg.UseColon
• Ability to have Critical-Emergency logs be logged in a seperate file through cfg.SeperateCriticalLogs
• Probably a lot of breaking changes, but I plan on basically keeping this seperate from the original project.

Basically, I should've just made my own logger considering how much I changed, but eh, this fork works, and I'm pretty happy with it.

*- This is what the original looked like on my screen in Rider and oh no.

It looks a lot better like this now

How to use?

Installation

You have 2 ways:

• [as of 1.0.6.1], you can now just grab EasyLogPlus from NuGet, or dotnet add package EasyLogPlus
• Install EasyLogPlus from GitHub's NuGet Registry, instructions here, make sure the author is asoji

Usage

• Add using EasyLogPlus; to the top, and then add

Logger log = new Logger();
Config cfg = new Config();

Customization Options

If you want customize settings add these, keeping in mind that this whole SetConfig() is optional, and not required to run the application.

void SetConfig()
{
    cfg.ShowDate = true; // If this is set to true, it will add date to the log
    cfg.Console = true; // If this is set to true, it will print the log to Console too
    cfg.SeperateCriticalLogs = true; // If this is set to true, it will print Critical-Emergency logs to a seperate log file

    // ENTIRELY optional, just add and change if you want.
    cfg.UseColon = true; // If set to true, uses `:` in logs instead of `=>`

    cfg.LogPath = Environment.CurrentDirectory + $@"\Application.log"; // Sets where your Log saves and under what name

    // Logger color customization
    cfg.DebugText = ConsoleColor.Blue;
    cfg.InfoText = System.Console.ForegroundColor;
    cfg.NoticeText = ConsoleColor.Green;
    cfg.WarningText = ConsoleColor.DarkYellow;
    cfg.ErrorText = ConsoleColor.Red;
    cfg.CriticalText = ConsoleColor.White;
    cfg.AlertText = ConsoleColor.White;
    cfg.EmergencyText = ConsoleColor.White;

    cfg.DebugBackground = System.Console.BackgroundColor;
    cfg.InfoBackground = System.Console.BackgroundColor;
    cfg.NoticeBackground = System.Console.BackgroundColor;
    cfg.WarningBackground = System.Console.BackgroundColor;
    cfg.ErrorBackground = System.Console.BackgroundColor;
    cfg.CriticalBackground = ConsoleColor.DarkRed;
    cfg.AlertBackground = ConsoleColor.DarkBlue;
    cfg.EmergencyBackground = ConsoleColor.DarkMagenta;
}

Then in your application main void add these, this is required.

log.cfg = cfg;
SetConfig();
log.InitLogger(); // Call this to init logger

Using Logs

• Debug Log

log.Debug("Hello from log, this is debug");

• Info Log

log.Info("Hello from log, this is info");

• Notice Log

log.Notice("Hello from log, this is notice");

• Warning Log

log.Warning("Hello from log, this is warning");

• Error Log

log.Error("Hello from log, this is error");

• Critical Log

log.Critical("Hello from log, this is critical")

• Alert Log

log.Alert("Hello from log, this is alert")

• Emergency Log

log.Emergency("Hello from log, this is emergency")

[terrible] Example

class Program {
        static Logger log = new Logger();
        static Config cfg = new Config();
        
        static void SetConfig() {
            cfg.LogPath = Environment.CurrentDirectory + @"\Application.log";
            cfg.ShowDate = true;
            cfg.Console = true;
            cfg.SeperateCriticalLogs = true;

            cfg.UseColon = false;

            cfg.CriticalBackground = ConsoleColor.Cyan;
            cfg.NoticeText = ConsoleColor.Magenta;
        }

        static void Main(string[] args) {
            SetConfig();
            log.cfg = cfg;
            log.InitLogger();

            try {
                // do some random shit
            } catch (ArgumentOutOfRangeException outOfRangeException) {
                log.Critical("hey something is out of range?");
            }
            
            Console.ReadKey();
        }
    }

License

This project [well, fork] is MIT Licensed. Thank you byte-0x74/0x74 for making the original lib C: