Adds Microsoft.Extensions.Logging provider (#25)

* no more netfx

* Adds Microsoft.Extensions.Logging provider

* Make provider part of FsLibLog

* Update Serilog example

* Docs on getting started with other providers

Author: TheAngryByrd

FsLibLog.sln

@@ -25,6 +25,8 @@ Project("{F2A71F9B-5D33-465A-A702-920D77279786}") = "SerilogExample", "examples\
 EndProject
 Project("{F2A71F9B-5D33-465A-A702-920D77279786}") = "SomeLib", "examples\SomeLib\SomeLib.fsproj", "{B4E33887-2856-4809-B185-A80C9B093427}"
 EndProject
+Project("{F2A71F9B-5D33-465A-A702-920D77279786}") = "MicrosoftLoggingExample", "examples\MicrosoftLoggingExample\MicrosoftLoggingExample.fsproj", "{49CFCA86-7F76-4361-80A3-F67EF8763D9B}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -122,6 +124,18 @@ Global
 		{B4E33887-2856-4809-B185-A80C9B093427}.Release|x64.Build.0 = Release|Any CPU
 		{B4E33887-2856-4809-B185-A80C9B093427}.Release|x86.ActiveCfg = Release|Any CPU
 		{B4E33887-2856-4809-B185-A80C9B093427}.Release|x86.Build.0 = Release|Any CPU
+		{49CFCA86-7F76-4361-80A3-F67EF8763D9B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{49CFCA86-7F76-4361-80A3-F67EF8763D9B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{49CFCA86-7F76-4361-80A3-F67EF8763D9B}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{49CFCA86-7F76-4361-80A3-F67EF8763D9B}.Debug|x64.Build.0 = Debug|Any CPU
+		{49CFCA86-7F76-4361-80A3-F67EF8763D9B}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{49CFCA86-7F76-4361-80A3-F67EF8763D9B}.Debug|x86.Build.0 = Debug|Any CPU
+		{49CFCA86-7F76-4361-80A3-F67EF8763D9B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{49CFCA86-7F76-4361-80A3-F67EF8763D9B}.Release|Any CPU.Build.0 = Release|Any CPU
+		{49CFCA86-7F76-4361-80A3-F67EF8763D9B}.Release|x64.ActiveCfg = Release|Any CPU
+		{49CFCA86-7F76-4361-80A3-F67EF8763D9B}.Release|x64.Build.0 = Release|Any CPU
+		{49CFCA86-7F76-4361-80A3-F67EF8763D9B}.Release|x86.ActiveCfg = Release|Any CPU
+		{49CFCA86-7F76-4361-80A3-F67EF8763D9B}.Release|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(NestedProjects) = preSolution
 		{5D30E174-2538-47AC-8443-318C8C5DC2C9} = {C397A34C-84F1-49E7-AEBC-2F9F2B196216}
@@ -131,5 +145,6 @@ Global
 		{BDF041F1-D693-4BCE-9741-C9606E901437} = {9BAA7731-9F1B-4B89-8AD8-DB546D7E816D}
 		{916E3A28-4E3D-4931-A13B-9B56E0B66B88} = {9BAA7731-9F1B-4B89-8AD8-DB546D7E816D}
 		{B4E33887-2856-4809-B185-A80C9B093427} = {9BAA7731-9F1B-4B89-8AD8-DB546D7E816D}
+		{49CFCA86-7F76-4361-80A3-F67EF8763D9B} = {9BAA7731-9F1B-4B89-8AD8-DB546D7E816D}
 	EndGlobalSection
 EndGlobal

README.md

@@ -47,6 +47,8 @@ Target.create "Replace" <| fun _ ->
     (!! "paket-files/TheAngryByrd/FsLibLog/src/FsLibLog/FsLibLog.fs")
 ```
 
+### 3. [Setup a LogProvider](#log-providers)
+
 ## Using in your library
 
 ### Open namespaces
@@ -199,14 +201,58 @@ Providers are the actual logging framework that sends the logs to some destinati
 ### Currently supported provider
 
 - [Serilog](https://github.com/serilog/serilog)
+- [Microsoft.Extensions.Logging](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/logging/?view=aspnetcore-5.0)
+
+#### Setting up Serilog
+
+1. Install [Serilog](https://www.nuget.org/packages/Serilog)
+2. Install [Serilog.Sinks.ColoredConsole](https://www.nuget.org/packages/Serilog.Sinks.Console/) (or any other [Sink](https://github.com/serilog/serilog/wiki/Provided-Sinks))
+3. Create your `Logger`
+
+    ```fsharp
+        let log =
+            LoggerConfiguration()
+                .MinimumLevel.Verbose()
+                .WriteTo.Console(outputTemplate= "{Timestamp:o} [{Level}] <{SourceContext}> ({Name:l}) {Message:j} - {Properties:j}{NewLine}{Exception}")
+                .Enrich.FromLogContext()
+                .CreateLogger();
+        Log.Logger <- log
+    ```
+
+4. FsLibLog will pick up Serilog automatically, no need to tell FsLibLog about it
+
+### Setting up Microsoft.Extensions.Logging
+
+1. Install [Microsoft.Extensions.Logging](https://www.nuget.org/packages/Microsoft.Extensions.Logging/)
+2. Install [Microsoft.Extensions.Logging.Console](https://www.nuget.org/packages/Microsoft.Extensions.Logging.Console) (or any other [Provider](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/logging/?view=aspnetcore-5.0#logging-providers-1))
+3. Create your `ILoggerFactory`
+
+    ```fsharp
+    let microsoftLoggerFactory = LoggerFactory.Create(fun builder ->
+            builder
+                .SetMinimumLevel(LogLevel.Debug)
+                .AddSimpleConsole(fun opts -> opts.IncludeScopes <-true)
+                // .AddJsonConsole(fun opts -> opts.IncludeScopes <- true)
+            |> ignore
+
+        )
+    ```
+
+4. Tell FsLibLog to use this factory
+
+    ```fsharp
+    FsLibLog.Providers.MicrosoftExtensionsLoggingProvider.setMicrosoftLoggerFactory microsoftLoggerFactory
+    ```
+
+    1. One downside to this is you need to do this for every library your application consumes that uses FsLiblog.
 
-### Custom Providers
+#### Custom Providers
 
 You can implement and teach FsLibLog about your own custom provider if one is not listed. You have to do 2 things:
 
 1. You have to implement the `ILogProvider` interface. [Example Implemenation](https://github.com/TheAngryByrd/FsLibLog/blob/master/examples/ConsoleExample/Program.fs#L5-L90)
 2. You have to tell FsLibLog to use it. [Example calling FsLibLog.LogProvider.setLoggerProvider](https://github.com/TheAngryByrd/FsLibLog/blob/master/examples/ConsoleExample/Program.fs#L94)
-  a. One downside to this is you need to do this for every library your application consumes that uses FsLiblog.
+    1. One downside to this is you need to do this for every library your application consumes that uses FsLiblog.
 
 ---
 

adapters/FsLibLog.Adapters.Marten/FsLibLog.Adapters.Marten.fsproj

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFrameworks>netstandard2.0;net461</TargetFrameworks>
+    <TargetFrameworks>netstandard2.0</TargetFrameworks>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
   </PropertyGroup>
   <PropertyGroup>
@@ -29,6 +29,5 @@
   <ItemGroup>
     <ProjectReference Include="..\..\src\FsLibLog\FsLibLog.fsproj" />
   </ItemGroup>
-  <Import Project="..\..\netfx.props" />
   <Import Project="..\..\.paket\Paket.Restore.targets" />
 </Project>

adapters/FsLibLog.Adapters.Npgsql/FsLibLog.Adapters.Npgsql.fsproj

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFrameworks>netstandard2.0;net461</TargetFrameworks>
+    <TargetFrameworks>netstandard2.0</TargetFrameworks>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
   </PropertyGroup>
   <PropertyGroup>
@@ -29,6 +29,5 @@
   <ItemGroup>
     <ProjectReference Include="..\..\src\FsLibLog\FsLibLog.fsproj" />
   </ItemGroup>
-  <Import Project="..\..\netfx.props" />
   <Import Project="..\..\.paket\Paket.Restore.targets" />
 </Project>

examples/MicrosoftLoggingExample/MicrosoftLoggingExample.fsproj

@@ -0,0 +1,24 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net5.0</TargetFramework>
+    <WarnOn>3390;$(WarnOn)</WarnOn>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <!-- <Compile Include="..\..\src\providers\FsLibLog.Providers.Microsoft.Extensions.Logging\FsLibLog.Providers.Microsoft.Extensions.Logging.fs" /> -->
+    <Compile Include="Program.fs" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\SomeLib\SomeLib.fsproj" />
+    
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Extensions.Logging" Version="5.0.0" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="5.0.0" />
+  </ItemGroup>
+
+</Project>

examples/MicrosoftLoggingExample/Program.fs

@@ -0,0 +1,26 @@
+// Learn more about F# at http://docs.microsoft.com/dotnet/fsharp
+
+open System
+open Microsoft.Extensions.Logging
+
+
+[<EntryPoint>]
+let main argv =
+    let microsoftLoggerFactory = LoggerFactory.Create(fun builder ->
+        builder
+            .SetMinimumLevel(LogLevel.Debug)
+            .AddSimpleConsole(fun opts -> opts.IncludeScopes <-true)
+            // .AddJsonConsole(fun opts -> opts.IncludeScopes <- true)
+        |> ignore
+
+    )
+
+    // This line is important to make Microsoft.Extensions.Logging work
+    FsLibLog.Providers.MicrosoftExtensionsLoggingProvider.setMicrosoftLoggerFactory microsoftLoggerFactory
+    SomeLib.Say.nestedHello "Howdy" |> printfn "%s"
+    SomeLib.Say.hello "Whatup" |> printfn "%s"
+    try
+        SomeLib.Say.fail "failed"
+    with e -> ()
+    Console.ReadLine() |> ignore
+    0 // return an integer exit code

examples/SerilogExample/Program.fs

@@ -8,7 +8,7 @@ let main argv =
     let log =
         LoggerConfiguration()
             .MinimumLevel.Verbose()
-            .WriteTo.ColoredConsole(outputTemplate= "{Timestamp:o} [{Level}] <{SourceContext}> ({Name:l}) {Message:j} - {Properties:j}{NewLine}{Exception}")
+            .WriteTo.Console(outputTemplate= "{Timestamp:o} [{Level}] <{SourceContext}> ({Name:l}) {Message:j} - {Properties:j}{NewLine}{Exception}")
             .Enrich.FromLogContext() //Necessary if you want to use MappedContext
             .CreateLogger();
     Log.Logger <- log

examples/SerilogExample/SerilogExample.fsproj

@@ -10,8 +10,8 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Serilog" Version="2.8.0" />
-    <PackageReference Include="Serilog.Sinks.ColoredConsole" Version="3.0.1" />
+    <PackageReference Include="Serilog" Version="2.10.0" />
+    <PackageReference Include="Serilog.Sinks.Console" Version="4.0.0" />
     <ProjectReference Include="..\SomeLib\SomeLib.fsproj" />
   </ItemGroup>