pvNugsLoggerNc9Abstractions 9.1.1

pvNugsLoggerNc9Abstractions

A comprehensive .NET logging framework that provides structured, contextual logging with support for multiple output destinations, user contexts, and typed logging capabilities.

Features

• Multiple Output Destinations: Support for console, SQL, and hybrid logging configurations
• Contextual Logging: Track user, company, and topic contexts across log entries
• Structured Logging: Detailed metadata for each log entry including machine name, method name, and line numbers
• Severity Levels: Comprehensive severity level system compatible with Microsoft's LogLevel
• Method Result Tracking: Built-in support for tracking method execution results and notifications
• Async Support: Both synchronous and asynchronous logging methods
• Unit Testing Support: Specialized interfaces for testing logging behavior

Installation

Install via NuGet Package Manager:

Install-Package pvNugsLoggerNc9Abstractions

Or via .NET CLI:

shell dotnet add package pvNugsLoggerNc9Abstractions

Core Components

Logger Services

• ILoggerService: The main logging interface that provides comprehensive logging functionality
• IConsoleLoggerService: Specialized service for console output
• IHybridLoggerService: Combines multiple logging outputs
• IUTestLoggerService: Specialized service for unit testing scenarios

Log Writers

• ILogWriter: Base interface for writing log entries to various destinations
• IConsoleLogWriter: Specialized writer for console output
• IUTestLogWriter: Writer with additional capabilities for testing scenarios

Method Results

• IMethodResult: Tracks method execution status and notifications
• IMethodResultNotification: Represents individual notifications within results

Data Structures

• ILoggerServiceRow: Represents a structured log entry with metadata
• SeverityEnu: Defines available logging severity levels
• SqlRoleEnu: Defines SQL database access roles

Basic Usage

public class ExampleService { private readonly ILoggerService _logger;
public ExampleService(ILoggerService logger)
{
    _logger = logger;
}

public async Task DoSomethingAsync()
{
    // Set context for subsequent log entries
    _logger.SetUser("user123", "company456");
    _logger.SetTopic("ImportantOperation");

    try
    {
        // Log a simple message
        _logger.Log("Starting operation", SeverityEnu.Info);

        // Perform some work...

        // Log multiple messages
        await _logger.LogAsync(
            new[] { "Step 1 complete", "Step 2 complete" },
            SeverityEnu.Debug);
    }
    catch (Exception ex)
    {
        // Log exception with context
        await _logger.LogAsync(ex);
        throw;
    }
}

Unit Testing

public class LoggingTests 
{ 
    private readonly IUTestLogWriter _logWriter; 
    private readonly IUTestLoggerService _logger;
    
    [Fact]
    public void ShouldLogError()
    {
        _logger.Log("Test error", SeverityEnu.Error);
        
        Assert.True(_logWriter.Contains("Test error"));
        var logEntry = _logWriter.FindLastMatchingRow("Test error");
        Assert.Equal(SeverityEnu.Error, logEntry.Severity);
    }
}