RockLib.Logging 2.0.0

• .NETFramework 4.5.1

  • RockLib.Configuration (>= 2.4.1)
  • RockLib.Configuration.ObjectFactory (>= 1.6.1)
  • RockLib.Diagnostics (>= 1.0.2)
  • System.ValueTuple (>= 4.5.0)

• .NETFramework 4.6.2

  • RockLib.Configuration (>= 2.4.1)
  • RockLib.Configuration.ObjectFactory (>= 1.6.1)
  • RockLib.Diagnostics (>= 1.0.2)

• .NETStandard 2.0

  • RockLib.Configuration (>= 2.4.1)
  • RockLib.Configuration.ObjectFactory (>= 1.6.1)
  • RockLib.Diagnostics (>= 1.0.2)

RockLib.Logging version 2.0.0

**Changes to ILogger interface**
- Add `LogProviders` property
 - The collection of log providers had been a private field of the Logger class; now it is exposed in the interface.
- Add `ErrorHandler` property
 - When set, it handles errors from log providers.
 - Can also be set using a delegate by calling the `SetErrorHandler` extension method for the `ILogger` interface.
- Add `ContextProviders` property
 - A collection of objects for customizing (e.g. adding extended properties to) outgoing logs before they are sent.
- Add `LogProcessor` property
 - Instead of the `Logger` class handling the processing of logs, either synchronously or asynchronously depending on the value of the `isSynchronous` constructor parameter, it delegates the main processing of logs to its log processor.
 - Can be set directly with an implementation of `ILogProcessor`, or by specifying the logger's processing mode - `Background`, `Synchronous`, or `FireAndForget`.
- Implement `IDisposable`
 - Previously, the `Logger` class implemented `IDisposable`, but not the `ILogger` interface.

**Changes to LoggerFactory**
- `LoggerFactory` is configuration-based instead of "configuration-based by default, otherwise able to specify collection of logger objects from which to choose from".
 - Has a `Configuration` property whose value determines what loggers the factory can produce.
 - The default configuration comes from the "RockLib.Logging" or "RockLib_Logging" section under `RockLib.Configuration.Config.Root`.
 - Can specify a custom configuration with the `SetConfiguration` method.
- Renames methods to be simpler and more explicit: `CreateFromConfig` -> `Create`; `GetInstance` -> `GetCached`
- Methods return `ILogger` instead of `Logger`
- Adds optional parameters to `LoggerFactory` methods
 - `defaultTypes`, `valueConverters`, and `resolver`
   - LoggerFactory uses the `RockLib.Configuration.ObjectFactory` library to actually create the `ILogger`.
- These values are used by the library to customize how the logger is created.
 - `reloadOnConfigChange`
   - The `RockLib.Configuration.ObjectFactory` library has the ability to create objects from configuration such that, when the configuration changes, the objects reload themselves automatically. `LoggerFactory` can use this ability.
- Default is `true`, meaning loggers will reload themselves when their configuration changes. Set to `false` if a config-reloading logger is not desired.

**Changes to LogEntry**
- Add new properties: correlationId, businessProcessId, and businessActivityId
 - These are also exposed as optional parameters in the logging extension methods.
- Make CallerInfo first-class property of LogEntry

**Changes to log providers**
- `FileLogProvider` synchronizes across all instances that use the same file
 - This means all instances of `FileLogProvider` that use the same file can write concurrently.
- `ConsoleLogProvider` can target either stdout or stderr