chore: release serilog-ui 2.6.0 (#110)

Author: followynne

samples/SampleWebApp/SampleWebApp.csproj

@@ -30,6 +30,7 @@
     <ItemGroup>
         <ProjectReference Include="..\..\src\Serilog.Ui.MsSqlServerProvider\Serilog.Ui.MsSqlServerProvider.csproj"/>
         <ProjectReference Include="..\..\src\Serilog.Ui.Web\Serilog.Ui.Web.csproj"/>
+        <ProjectReference Include="..\..\src\Serilog.Ui.Core\Serilog.Ui.Core.csproj"/>
     </ItemGroup>
 
 </Project>

src/Serilog.Ui.Core/AggregateDataProvider.cs

@@ -2,21 +2,26 @@
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
+using Ardalis.GuardClauses;
 
 namespace Serilog.Ui.Core
 {
     /// <summary>
-    ///   Aggregates multiple <see cref="IDataProvider"/> into one instance.
+    /// Aggregates multiple <see cref="IDataProvider"/> into one instance.
     /// </summary>
     public class AggregateDataProvider : IDataProvider
     {
-        private IDataProvider _selectedDataProvider;
-        private readonly Dictionary<string, IDataProvider> _dataProviders = new Dictionary<string, IDataProvider>();
+        private readonly Dictionary<string, IDataProvider> _dataProviders = new();
 
+        /// <summary>
+        /// It creates an instance of <see cref="AggregateDataProvider"/>.
+        /// </summary>
+        /// <param name="dataProviders">IEnumerable of providers.</param>
+        /// <exception cref="ArgumentNullException">when <paramref name="dataProviders"/> is null</exception>
+        /// <exception cref="ArgumentException">when <paramref name="dataProviders"/> is empty</exception>
         public AggregateDataProvider(IEnumerable<IDataProvider> dataProviders)
         {
-            if (dataProviders == null)
-                throw new ArgumentNullException(nameof(dataProviders));
+            Guard.Against.NullOrEmpty(dataProviders, nameof(dataProviders));
 
             foreach (var grouped in dataProviders.GroupBy(dp => dp.Name, p => p, (k, e) => e.ToList()))
             {
@@ -39,25 +44,33 @@ public AggregateDataProvider(IEnumerable<IDataProvider> dataProviders)
                 }
             }
 
-            _selectedDataProvider = _dataProviders.First(c => true).Value;
+            SelectedDataProvider = _dataProviders.First().Value;
         }
 
         /// <summary>
-        ///   <inheritdoc cref="IDataProvider.Name"/> NOTE We assume only one Aggregate provider, so
-        ///   the name is static.
+        /// <inheritdoc cref="IDataProvider.Name"/>
+        /// NOTE: We assume only one Aggregate provider, so the name is static.
         /// </summary>
         public string Name => nameof(AggregateDataProvider);
 
         /// <summary>
-        ///   If there is only one data provider, this is it. If there are multiple, this is the
-        ///   current data provider.
+        /// If there is only one data provider, this is it.
+        /// If there are multiple, this is the current data provider.
         /// </summary>
-        public IDataProvider SelectedDataProvider => _selectedDataProvider;
+        private IDataProvider SelectedDataProvider { get; set; }
 
-        public void SwitchToProvider(string key) => _selectedDataProvider = _dataProviders[key];
+        /// <summary>
+        /// Switch active data provider by key.
+        /// </summary>
+        /// <param name="key">Data provider key</param>
+        public void SwitchToProvider(string key) => SelectedDataProvider = _dataProviders[key];
 
+        /// <summary>
+        /// Existing data providers keys.
+        /// </summary>
         public IEnumerable<string> Keys => _dataProviders.Keys;
 
+        /// <inheritdoc/>
         public Task<(IEnumerable<LogModel>, int)> FetchDataAsync(
             int page,
             int count,

src/Serilog.Ui.Core/Extensions/RelationalDbOptionsExtensions.cs

@@ -1,7 +1,16 @@
 namespace Serilog.Ui.Core
 {
+    /// <summary>
+    /// Relational Db Options extensions.
+    /// </summary>
     public static class RelationalDbOptionsExtensions
     {
+        /// <summary>
+        /// Generates a complete data provider name, by using its properties.
+        /// </summary>
+        /// <param name="options"><see cref="RelationalDbOptions"/></param>
+        /// <param name="providerName">Data provider name.</param>
+        /// <returns></returns>
         public static string ToDataProviderName(this RelationalDbOptions options, string providerName)
             => string.Join(".", providerName, options.Schema, options.TableName);
     }

src/Serilog.Ui.Core/Models/LogModel.cs

@@ -2,20 +2,44 @@
 
 namespace Serilog.Ui.Core
 {
+    /// <summary>
+    /// Log Model class.
+    /// </summary>
     public class LogModel
     {
+        /// <summary>
+        /// It gets or sets RowNo.
+        /// </summary>
         public virtual int RowNo { get; set; }
 
+        /// <summary>
+        /// It gets or sets Level.
+        /// </summary>
         public virtual string Level { get; set; }
 
+        /// <summary>
+        /// It gets or sets Message.
+        /// </summary>
         public virtual string Message { get; set; }
 
+        /// <summary>
+        /// It gets or sets Timestamp.
+        /// </summary>
         public virtual DateTime Timestamp { get; set; }
 
+        /// <summary>
+        /// It gets or sets Exception.
+        /// </summary>
         public virtual string Exception { get; set; }
 
+        /// <summary>
+        /// It gets or sets Properties.
+        /// </summary>
         public virtual string Properties { get; set; }
 
+        /// <summary>
+        /// It gets or sets PropertyType.
+        /// </summary>
         public virtual string PropertyType { get; set; }
     }
 }

src/Serilog.Ui.Core/OptionsBuilder/RelationalDbOptions.cs

@@ -1,11 +1,23 @@
 namespace Serilog.Ui.Core
 {
+    /// <summary>
+    /// RelationDbOptions class
+    /// </summary>
     public class RelationalDbOptions
     {
+        /// <summary>
+        /// It gets or sets ConnectionString.
+        /// </summary>
         public string ConnectionString { get; set; }
 
+        /// <summary>
+        /// It gets or sets TableName.
+        /// </summary>
         public string TableName { get; set; }
 
+        /// <summary>
+        /// It gets or sets Schema.
+        /// </summary>
         public string Schema { get; set; }
     }
 }

src/Serilog.Ui.Core/OptionsBuilder/SerilogUiOptionsBuilder.cs

@@ -2,10 +2,18 @@
 
 namespace Serilog.Ui.Core
 {
+    /// <summary>
+    /// SerilogUi OptionsBuilder class, used during app services registration.
+    /// Implements <see cref="ISerilogUiOptionsBuilder"/>.
+    /// </summary>
     public class SerilogUiOptionsBuilder : ISerilogUiOptionsBuilder
     {
         private readonly IServiceCollection _services;
 
+        /// <summary>
+        /// It creates an instance of <see cref="SerilogUiOptionsBuilder"/>.
+        /// </summary>
+        /// <param name="services">Service collection.</param>
         public SerilogUiOptionsBuilder(IServiceCollection services)
         {
             _services = services;

src/Serilog.Ui.Core/Serilog.Ui.Core.csproj

@@ -3,7 +3,7 @@
 		<TargetFramework>netstandard2.0</TargetFramework>
 		<GenerateDocumentationFile>True</GenerateDocumentationFile>
 		<LangVersion>latest</LangVersion>
-		<Version>2.5.0</Version>
+		<Version>2.6.0</Version>
 	</PropertyGroup>
 
 	<ItemGroup>

src/Serilog.Ui.ElasticSearchProvider/Serilog.Ui.ElasticSearchProvider.csproj

@@ -12,6 +12,6 @@
 	</ItemGroup>
 
 	<ItemGroup>
-		<ProjectReference Include="..\Serilog.Ui.Core\Serilog.Ui.Core.csproj" />
+		<ProjectReference Include="..\Serilog.Ui.Core\Serilog.Ui.Core.csproj" PrivateAssets="all" />
 	</ItemGroup>
 </Project>

src/Serilog.Ui.MongoDbProvider/Serilog.Ui.MongoDbProvider.csproj

@@ -13,6 +13,6 @@
 	</ItemGroup>
 
 	<ItemGroup>
-		<ProjectReference Include="..\Serilog.Ui.Core\Serilog.Ui.Core.csproj" />
+		<ProjectReference Include="..\Serilog.Ui.Core\Serilog.Ui.Core.csproj" PrivateAssets="all" />
 	</ItemGroup>
 </Project>