Class LogCollectorBuilder

Namespace

LogAssertions

Assembly

LogAssertions.dll

Convenience factory that constructs a Microsoft.Extensions.Logging.Testing.FakeLogCollector together with an ILoggerFactory that writes into it. Replaces the 3-4 lines of boilerplate every test would otherwise need.

public static class LogCollectorBuilder

Inheritance

object

LogCollectorBuilder

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Examples

var (factory, collector) = LogCollectorBuilder.Create();
using (factory)
{
    var logger = factory.CreateLogger("MyCategory");
    logger.LogInformation("hello");
    await Assert.That(collector).HasLogged().Containing("hello", StringComparison.Ordinal).Once();
}

Methods

Create(LogLevel)

Creates a new Microsoft.Extensions.Logging.Testing.FakeLogCollector and an ILoggerFactory wired to it. The caller owns both: dispose the factory when the test completes; the collector is GC-managed and has no unmanaged resources.

public static (ILoggerFactory Factory, FakeLogCollector Collector) Create(LogLevel minimumLevel = LogLevel.Trace)

Parameters

minimumLevel LogLevel

The minimum level to capture. Default is Trace (capture everything).

Returns

(ILoggerFactory Factory, FakeLogCollector Collector)

The wired pair: Factory for creating loggers, Collector for assertions.