Ling.Interceptors 1.1.0

Ling.Interceptors

Project documentation | 简体中文

Ling.Interceptors provides the public interception and monitoring API, plus bundled Roslyn analyzer and incremental source generator. It requires .NET SDK 9.0.200 or later.

Installation

dotnet add package Ling.Interceptors

The package automatically configures Ling.Interceptors.Generated in InterceptorsNamespaces.

Monitor calls

[Monitor(CaptureParameters = true, CaptureReturnValue = true)]
[return: SensitiveData]
public async Task<Order> PlaceOrder(
    int customerId,
    [SensitiveData] string product)
{
    // implementation
}

The generator discovers calls in the current compilation and emits a wrapper that records the selected values, exceptions, and elapsed time. Configure a sink explicitly:

MonitorRuntime.Sink = new LoggerMonitorSink(loggerFactory);

The default formatter preserves scalar values, masks sensitive values, and emits a declared-type summary for other objects without calling ToString() or serializing them. Replace MonitorRuntime.Formatter for custom structured output; its MonitorValueContext identifies sensitive values.

Both an assembly that declares monitored APIs and a project that contains monitored call sites need this package.

Define a replacement

using Ling.Interceptors;

internal static class Replacements
{
    [Intercept("trace", nameof(Service.Send),
        InterceptionScope.Explicit | InterceptionScope.Compilation)]
    internal static void Send(Service service, string value)
    {
        Console.WriteLine($"trace:{value}");
        service.Send(value); // Replacement bodies call the original implementation.
    }
}

The target must use qualified nameof(T.Method). The replacement must be an accessible static method with a compatible signature; instance targets add the receiver as the first parameter.

Select calls

service./* intercept:trace */Send("one"); // Explicit rule
service.Send("two");                      // Compilation rule

Explicit enables an annotated call site. Compilation matches ordinary calls in the current project. GeneratedCode must be combined with Compilation; it covers recognized generated code and enables the package's command-line two-phase compilation when another source generator emits matching calls.

Diagnostics and limits

The included analyzer reports invalid IDs/scopes, malformed nameof expressions, inaccessible or incompatible replacements, ambiguous targets, invalid markers, conflicting compilation rules, and Monitor/interceptor conflicts. Constructors, properties, operators, delegate invocation, and method-group conversions are unsupported. Monitor wrappers support ordinary returns, Task, Task<T>, ValueTask, and ValueTask<T>.

License

MIT