Momkay.LoggingProxy 1.2.0

Momkay.LoggingProxy

A lightweight proxy-based logging interceptor for .NET service interfaces. mIt automatically logs method calls, parameters, execution time, and exceptions — without cluttering your service code.

Features

• Logs method entry, arguments, and execution duration
• Logs exceptions with full stack trace
• Works with sync and async (Task, Task<T>) methods
• Attribute-based control:
  • [NoLog] — skip logging
  • [Log(LogLevel.Debug)] — override log level
• Console log coloring (optional, terminal-dependent)
• No external dependencies
• Zero boilerplate with AddLoggedServices(...)

Installation

dotnet add package Momkay.LoggingProxy

Setup

In your Program.cs (or startup configuration):

using Momkay.LoggingProxy.Core;

builder.Services.AddLoggedServices(typeof(IMyService).Assembly);

This will:

• Scan all classes in the given assembly
• Match them with interfaces named I[ClassName]
• Register them automatically with Scoped lifetime
• Wrap them in a proxy that injects structured logging

⚠️ You do not need to call AddScoped<IMyService, MyService>() manually.

Usage Example

Interface

public interface IMyService
{
    Task DoWorkAsync();
    Task InternalHelper();
}

Implementation

public class MyService : IMyService
{
    [Log(LogLevel.Debug)]
    public async Task DoWorkAsync()
    {
        // This will be logged at Debug level
    }

    [NoLog]
    public Task InternalHelper()
    {
        // This will be skipped in logging
        return Task.CompletedTask;
    }
}

Attributes

Return Value Logging

You can log method return values by setting:

Per method:

[Log(includeReturnValue: true)]
public Task<string> GetTokenAsync() { ... }

Globally:

LoggingProxyConfig.LogReturnValuesByDefault = true;

Console Output

By default, logs are written via ILogger<T>.
For better readability, the proxy includes optional ANSI colors (cyan/green/red) for:

• Entry ▶
• Success ✔
• Errors ❌

Colors only appear if your console supports ANSI (e.g. VS Code terminal, Windows Terminal, bash).

To disable colors globally:

set LOGGING_PROXY_COLORS=0

Requirements

• .NET 6 or later (or .NET Standard 2.1 for library use)
• Interface-based registration pattern (e.g. IFooService / FooService)
• Microsoft.Extensions.Logging (already standard in ASP.NET Core)

License

MIT — Use it, extend it, improve it. Contributions welcome!