2.12.0 Release

[nblumhardt]

Highlights of 2.12.0

Improved and expanded <Nullable>enable</Nullable> support

A huge number of commits have gone into completing and refining non-null reference type annotations, which now cover the entire public Serilog API. The Serilog project itself now builds with non-null reference type checking globally enabled 🎉

IAsyncDisposable support

Sinks that need to flush changes using asynchronous APIs can now implement IAsyncDisposable and prevent the possibility of deadlocking while waiting for tasks to complete.

To drive this, Logger can now be disposed via using async:

await using var log = new LoggerConfiguration().CreateLogger();

and the Log class provides Log.CloseAndFlushAsync():

await Log.CloseAndFlushAsync();

DateOnly and TimeOnly support

The DateOnly and TimeOnly types introduced in .NET 6 are now correctly handled as scalar values when capturing.

Merged PRs

• ScalarValue.Value can be null #1713, out ScalarValue can be null #1716, format and formatProvider can be null #1715, nullable in MessageTemplateParser #1722, SettingValueConversions.ConvertToType() value cant be null #1721, some more nullables #1720, Finish nullable. now enabled globally #1729 - improved non-null reference type annotations (@SimonCropp)
• DateOnly and TimeOnly support #1702 - DateOnly and TimeOnly support (@SimonCropp)
• Enables updating the configured min-level overrides at runtime #1764, add explicit net6 target #1703, remove BuildNativeUWP.ps1 from sln files #1708, update Microsoft.NET.Test.Sdk and Nullable packages #1709, minor csproj cleanup #1712, update xunit #1724, suppress CheckEolTargetFramework #1730, refs #1747 - build and dependency updates (@SimonCropp)
• use some auto properties #1723, rename ImmutableStack<ILogEventEnricher> to EnricherStack #1728, use some lambda expressions #1731, use some compound assignments #1732, file scoped namespaces #1734, forgot to remove some Nullable>enable #1735, leverage ITuple interface #1733, global usings #1736, we love us some patterns #1739, minor cleanups #1746, remove redundant LogEventLevel #1745, remove redundant type names #1741, guard against null #1742 - code clean-up and modernization (@SimonCropp)
• Initial support for IAsyncDisposable sinks #1750 - IAsyncDisposable support for Logger and sinks (@nblumhardt)
• Remove wrong tag #1699 - fix some XDOC documentation (@sungam3r)
• remove ! operator from nulls in conditions #1719 - remove redundant ! operator from null in conditions (@sungam3r)
• Introduce file-scoped namespaces #1725 - introduce file-scoped namespaces (@sungam3r)
• More nullable annotation updates #1700, Fix #1686 - nullable annotations for PropertyEnricher #1704, Bring Log.* methods exception nullability into line with ILogger #1707 - more nulllable annotation updates (@nblumhardt)
• add missing VALUETUPLE check #1711 - fix support for ValueTuple (@SimonCropp)

[SimonCropp]

@nblumhardt is this one baked? need help on anything else?

[nblumhardt]

@SimonCropp 🍞 👍

For the IAsyncDisposable changes to be usable, we'll also need https://github.com/serilog/serilog-sinks-periodicbatching/pulls, so it would be great if you have time to take a look.

Some support in Serilog.Extensions.Logging and .Hosting is also going to be required, I'm not sure exactly how much work is involved but I should have a chance to check it out soon, and although it's a big part of the story, we probably shouldn't block on it.

I'll write up some release notes in this ticket now :-)

[nblumhardt]

Think we're good to go! 😎

[nblumhardt]

Ooh actually not quite, hold fire :-)

[nblumhardt]

#1751