v2.12.0

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

• #​1713, #​1716, #​1715, #​1722, #​1721, #​1720, #​1729 - improved non-null reference type annotations (@​SimonCropp)
• #​1702 - DateOnly and TimeOnly support (@​SimonCropp)
• #​1764, #​1703, #​1708, #​1709, #​1712, #​1724, #​1730, #​1747 - build and dependency updates (@​SimonCropp)
• #​1723, #​1728, #​1731, #​1732, #​1734, #​1735, #​1733, #​1736, #​1739, #​1746, #​1745, #​1741, #​1742 - code clean-up and modernization (@​SimonCropp)
• #​1750 - IAsyncDisposable support for Logger and sinks (@​nblumhardt)
• #​1699 - fix some XDOC documentation (@​sungam3r)
• #​1719 - remove redundant ! operator from null in conditions (@​sungam3r)
• #​1725 - introduce file-scoped namespaces (@​sungam3r)
• #​1700, #​1704, #​1707 - more nulllable annotation updates (@​nblumhardt)
• #​1711 - fix support for ValueTuple (@​SimonCropp)

v2.11.0

• #​1503 - make some local functions static to avoid scope capture (@​SimonCropp)
• #​1561 - add support for collections/string[] to key-value settings (@​stochmal)
• #​1588, #​1591, #​1593, #​1594, #​1597 - nullable reference type annotations and language version updates (@​SimonCropp)
• #​1595 - net5.0 target (@​nblumhardt)
• #​1652 - fix capturing of anonymous types in .NET interactive (@​KZedan)
• #​1641 - corrected documentation comments for MessageTemplateFormatMethod (@​JinsPeter)
• #​1635 - fix destructuring of Memory<T>/ReadOnlyMemory<T> and non-reflection-compatible properties e.g. of type Span<T> (@​skomis-mm)
• #​1625 - update issue template (@​augustoproiete)
• #​1664 - update ILogger documentation (@​erichiller)