Pemvedr.Common.Logging

Structure

Logging is split into three parts:

ILog is the entrypoint for consumers to start logging. Some Targets will use a formatter to format the string they save, but not all.

Example

basic instantiation

public class Main
{
    public static void Main()
    {
        var logTargets = new ILogTarget[]{
            new ConsoleLogTarget(new AlignedHumanReadableLogFormatter(), BasicLogFilter.LogAll<ConsoleLogTarget>())
        };
        ILog log = new DefaultLog(logTargets);

        var ... = new SomeClass(log);
    
        ...
    } 
} 

Defaultlog with custom applicationname when the default, the processname, will not suffice

new DefaultLog(logTargets, "CustomApplicationName");

instantiation with specific filters

var logFilter = new BasicLogFilter<ConsoleLogTarget>(
   new []{ 
       FilterRules.All(LogLevel.Trace, LogLevel.Critical, true),
       FilterRules.SkipLower("Microsoft.*", LogLevel.Information) 
   });
var logTargets = new ILogTarget[]{
   new ConsoleLogTarget(new AlignedHumanReadableLogFormatter(), logFilter)
};
...

Basic logging

public class SomeClass
{
    private readonly ILog _log;
    public SomeClass(ILog log)
    {
        // For(..) will add the type of the class to the logentries
        _log = log.For(this); 
    }
    
    public void SomeMethod()
    {
        _log.This(() => "some message" + WithOptionally.LongRunningCode).Error();
    }
    public void SomeMethodWitException()
    {
        try
        {
            SomeThing.ThatFails();
        }
        catch(Exception ex)
        {
            _log.This(() => "some message" + WithOptionally.LongRunningCode)
                .WithException(ex)
                .Warning();
        }
    }
}

Development hints

Minimize the introduced references to other libraries as this package will be included in a lot of projects.