Modules as plugins posibility was added.

Author: Calabonga

README.md

@@ -1,6 +1,113 @@
 # Calabonga.AspNetCore.AppDefinitions
 
-Сборка позволяет навести порядок в вашем `Program.cs`. Можно всё разложить "по полочкам". Чтобы воспользоваться сборкой надо:
+Сборка позволяет навести порядок в вашем `Program.cs`. Можно всё разложить "по полочкам". Чтобы воспользоваться сборкой надо просто установить nuget-пакет Calabonga.AspNetCore.AppDefinitions.
+
+## Что нового
+
+### Версия 2.1.0
+
+* В новой версии появилась возможность подключения модулей к проекту. Достаточно воспользовать новым способом регистрации.
+```
+// Вместо этого (instead of)
+builder.AddDefinitions(typeof(Program));
+
+// использовать этот (use this to add definitions for application)
+const string moduleFolder = "Modules:Folder";
+var modulesPath = builder.Configuration[moduleFolder] ?? throw new ArgumentNullException(moduleFolder);
+builder.AddDefinitionsWithModules(modulesPath, typeof(Program));
+```
+* Вывод зарегистрированных AppDefinitions усовершенствована.
+```
+[15:43:03 DBG] [AppDefinitions]: From Program
+[15:43:03 DBG] [AppDefinitions]: AuthorizationDefinition (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: AuthorizeEndpoints (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: AutomapperDefinition (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: CommonDefinition (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: ContainerDefinition (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: CorsDefinition (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: DataSeedingDefinition (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: DbContextDefinition (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: ErrorHandlingDefinition (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: ETagGeneratorDefinition (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: EventItemEndpoints (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: FluentValidationDefinition (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: MediatorDefinition (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: OpenIddictDefinition (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: ProfilesEndpoints (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: SwaggerDefinition (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: TokenEndpoints (Program) (Enabled: Yes)
+[15:43:03 DBG] [AppDefinitions]: UnitOfWorkDefinition (Program) (Enabled: Yes)
+[15:43:03 DBG] From Program assemblies totally AppDefinitions found: 18
+[15:43:04 DBG] Total AppDefinitions applied: 18
+```
+* Появилсь возможность не только включать/выключать определенные AppDefinitions, но и указывать нужно ли их экспортировать или нет. Обратите внимание, что по умолчанию `Exported` свойство задано как `False`, то есть, не экспортировать данный `AppDefinition`. Например, если регистрацию конечной точки (endpoint) `WeatherForcast` слелать через определение (AppDefinition), то экспорт мог бы выглядеть так:
+```
+public class WeatherForecastEndpoints : AppDefinition
+{
+    /// <summary>
+    /// Enables or disables export definition as a content for module that can be exported.
+    /// </summary>
+    /// /// <remarks>Default values is <c>False</c></remarks>
+    public override bool Exported => true;
+
+    public override void ConfigureApplication(WebApplication app)
+    {
+        app.MapGet("/weatherforecast", WeatherGet)
+            .ProducesProblem(401)
+            .Produces<WeatherForecast[]>()
+            .WithName("GetWeatherForecast")
+            .WithTags("ModuleTwo")
+            .WithOpenApi()
+            .RequireAuthorization(policyNames: CookieAuthenticationDefaults.AuthenticationScheme + ",OpenIddict.Validation.AspNetCore");
+    }
+
+    // [FeatureGroupName("Weather")]
+    private WeatherForecast[] WeatherGet([FromServices] ILogger<WeatherForecastEndpoints> logger)
+    {
+        var summaries = new[] { "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching" };
+        var forecast = Enumerable.Range(1, 5).Select(index =>
+                new WeatherForecast
+                (
+                    DateOnly.FromDateTime(DateTime.Now.AddDays(index)),
+                    Random.Shared.Next(-20, 55),
+                    summaries[Random.Shared.Next(summaries.Length)]
+                ))
+            .ToArray();
+        logger.LogInformation("WeatherForecast request execute at [{Time}].", DateTime.UtcNow);
+        return forecast;
+    }
+}
+```
+
+### Версия 2.0.0
+
+* Больше не требуется вливать зависимость `IServiceCollection` в метод `ConfigureServices`. Теперь достаточно только `WebApplicationBuilder`. Следовательно при переходе на версию 2.0.0 нужно просто удалить лишние зависимости. Например, регистрация `FluentValidation` это выглядит так:
+``` csharp
+/// <summary>
+/// FluentValidation registration as Application definition
+/// </summary>
+public class FluentValidationDefinition : AppDefinition
+{
+    /// <summary>
+    /// Configure services for current application
+    /// </summary>
+    /// <param name="builder"></param>
+    public override void ConfigureServices(WebApplicationBuilder builder)
+    {
+        builder.Services.Configure<ApiBehaviorOptions>(options =>
+        {
+            options.SuppressModelStateInvalidFilter = true;
+        });
+
+        builder.Services.AddValidatorsFromAssembly(typeof(Program).Assembly);
+    }
+}
+```
+
+* Регистрация стала гораздо проще.
+``` csharp
+builder.AddDefinitions(typeof(Program));
+```
 
 ## Установка nuget-пакета
 

src/Calabonga.AspNetCore.AppDefinitions/AppDefinition.cs

@@ -25,7 +25,14 @@ public virtual void ConfigureApplication(WebApplication app) { }
     public virtual int OrderIndex => 0;
 
     /// <summary>
-    /// Enable or disable to register into pipeline for the current application Definition
+    /// Enable or disable to register into pipeline for the current application Definition.
     /// </summary>
+    /// <remarks>Default values is <c>True</c></remarks>
     public virtual bool Enabled { get; protected set; } = true;
+
+    /// <summary>
+    /// Enables or disables export definition as a content for module that can be exported.
+    /// </summary>
+    /// /// <remarks>Default values is <c>False</c></remarks>
+    public virtual bool Exported { get; protected set; }
 }

src/Calabonga.AspNetCore.AppDefinitions/AppDefinitionCollection.cs

@@ -6,6 +6,7 @@
 internal sealed class AppDefinitionCollection
 {
     internal IList<AppDefinitionItem> Items { get; } = new List<AppDefinitionItem>();
+
     internal IList<string> EntryPoints { get; } = new List<string>();
 
     internal void AddInfo(AppDefinitionItem definition)
@@ -28,4 +29,4 @@ internal void AddInfo(AppDefinitionItem definition)
 /// Information about <see cref="IAppDefinition"/>
 /// </summary>
 /// <param name="Definition"></param>
-public sealed record AppDefinitionItem(IAppDefinition Definition, string AssemblyName);
+public sealed record AppDefinitionItem(IAppDefinition Definition, string AssemblyName, bool Enabled, bool Exported);

src/Calabonga.AspNetCore.AppDefinitions/AppDefinitionExtensions.cs

@@ -1,11 +1,71 @@
 using Microsoft.AspNetCore.Builder;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Logging;
+using System.Reflection;
 
 namespace Calabonga.AspNetCore.AppDefinitions;
 
 public static class AppDefinitionExtensions
 {
+    /// <summary>
+    /// Finding all definitions in your project and include their into pipeline. Modules from third party *.dll find too.<br/>
+    /// Using <see cref="IServiceCollection"/> for registration.
+    /// </summary>
+    /// <remarks>
+    /// When executing on development environment there are more diagnostic information available on console.
+    /// </remarks>
+    /// <param name="builder"></param>
+    /// <param name="modulesFolderPath"></param>
+    /// <param name="entryPointsAssembly"></param>
+    public static void AddDefinitionsWithModules(this WebApplicationBuilder builder, string modulesFolderPath, params Type[] entryPointsAssembly)
+    {
+        var modulesFolder = Path.Combine(builder.Environment.ContentRootPath, modulesFolderPath);
+
+        if (!Directory.Exists(modulesFolder))
+        {
+            throw new DirectoryNotFoundException(modulesFolder);
+        }
+
+        var types = new List<Type>();
+        types.AddRange(entryPointsAssembly);
+
+        var modulesDirectory = new DirectoryInfo(modulesFolderPath);
+        var modules = modulesDirectory.GetFiles("*.dll");
+        if (!modules.Any())
+        {
+            return;
+        }
+
+        foreach (var fileInfo in modules)
+        {
+            var module = Assembly.LoadFile(fileInfo.FullName);
+            var typesAll = module.GetExportedTypes();
+            var typesDefinition = typesAll
+                .Where(Predicate)
+                .ToList();
+
+            var instances = typesDefinition.Select(Activator.CreateInstance)
+                .Cast<IAppDefinition>()
+                .Where(x => x.Enabled && x.Exported)
+                .Select(x => x.GetType())
+                .ToList();
+
+            types.AddRange(instances);
+        }
+
+        if (types.Any())
+        {
+            AddDefinitions(builder, types.ToArray());
+        }
+    }
+
+    /// <summary>
+    /// Finds an AppDefinition in the list of types
+    /// </summary>
+    /// <param name="type"></param>
+    /// <returns></returns>
+    private static bool Predicate(Type type) => type is { IsAbstract: false, IsInterface: false } && typeof(AppDefinition).IsAssignableFrom(type);
+
     /// <summary>
     /// Finding all definitions in your project and include their into pipeline.<br/>
     /// Using <see cref="IServiceCollection"/> for registration.
@@ -17,7 +77,7 @@ public static class AppDefinitionExtensions
     /// <param name="entryPointsAssembly"></param>
     public static void AddDefinitions(this WebApplicationBuilder builder, params Type[] entryPointsAssembly)
     {
-        var logger = builder.Services.BuildServiceProvider().GetRequiredService<ILogger<AppDefinition>>();
+        var logger = builder.Services.BuildServiceProvider().GetRequiredService<ILogger<IAppDefinition>>();
         var definitions = new List<IAppDefinition>();
         var appDefinitionInfo = builder.Services.BuildServiceProvider().GetService<AppDefinitionCollection>();
         var info = appDefinitionInfo ?? new AppDefinitionCollection();
@@ -26,12 +86,12 @@ public static void AddDefinitions(this WebApplicationBuilder builder, params Typ
         {
             info.AddEntryPoint(entryPoint.Name);
 
-            var types = entryPoint.Assembly.ExportedTypes.Where(x => !x.IsAbstract && typeof(IAppDefinition).IsAssignableFrom(x));
+            var types = entryPoint.Assembly.ExportedTypes.Where(Predicate);
             var instances = types.Select(Activator.CreateInstance).Cast<IAppDefinition>().ToList();
 
             foreach (var definition in instances)
             {
-                info.AddInfo(new AppDefinitionItem(definition, entryPoint.Name));
+                info.AddInfo(new AppDefinitionItem(definition, entryPoint.Name, definition.Enabled, definition.Exported));
             }
 
             var instancesOrdered = instances.Where(x => x.Enabled).OrderBy(x => x.OrderIndex).ToList();
@@ -83,5 +143,4 @@ public static void UseDefinitions(this WebApplication source)
             logger.LogDebug("Total AppDefinitions applied: {Count}", instancesOrdered.Count);
         }
     }
-
 }

src/Calabonga.AspNetCore.AppDefinitions/Calabonga.AspNetCore.AppDefinitions.csproj

@@ -6,7 +6,7 @@
 		<Nullable>enable</Nullable>
 		<GeneratePackageOnBuild>True</GeneratePackageOnBuild>
 		<Title>Calabonga.AspNetCore.AppDefinitions</Title>
-		<Version>2.0.0</Version>
+		<Version>2.1.0</Version>
 		<Authors>Calabonga</Authors>
 		<Company>Calabonga Soft</Company>
 		<Product>Calabonga.AspNetCore.AppDefinitions</Product>
@@ -18,7 +18,7 @@
 		<RepositoryUrl>https://github.com/Calabonga/Calabonga.AspNetCore.AppDefinitions</RepositoryUrl>
 		<RepositoryType>git</RepositoryType>
 		<PackageTags>calabonga;architecture;definitions;minimal-api;nimble-framework</PackageTags>
-		<PackageReleaseNotes>IServiceCollection was removed. Just use WebApplicationBuilder.Services please. Assembly name added for debug information at startup.</PackageReleaseNotes>
+		<PackageReleaseNotes>Modules as plugins posibility was added.</PackageReleaseNotes>
 		<PackageLicenseExpression>MIT</PackageLicenseExpression>
 	</PropertyGroup>
 

src/Calabonga.AspNetCore.AppDefinitions/IAppDefinition.cs

@@ -25,7 +25,14 @@ public interface IAppDefinition
     int OrderIndex { get; }
 
     /// <summary>
-    /// Enable or disable to register into pipeline for the current application Definition
+    /// Enable or disable to register into pipeline for the current application Definition.
     /// </summary>
+    /// <remarks>Default values is <c>True</c></remarks>
     bool Enabled { get; }
+
+    /// <summary>
+    /// Enables or disables export definition as a content for module that can be exported.
+    /// </summary>
+    /// /// <remarks>Default values is <c>False</c></remarks>
+    bool Exported { get; }
 }