Allows configuring the engine manager

Author: daveaglick

RELEASE.md

@@ -1,3 +1,7 @@
+# 1.0.0-beta.69
+
+- Added a configurator for the `IEngineManager` and a corresponding bootstrapper `ConfigureEngineManager()` extension method to allow customizing the engine manager used in most commands just prior to it executing the engine (useful for last-minute pipeline customization and some other niche use cases).
+
 # 1.0.0-beta.68
 
 - Improved the `HttpClient.SendWithRetryAsync()` extension to log retries at the information level since they may indicate other problems, and to retry during internal `HttpClient` timeouts.

src/core/Statiq.App/Bootstrapper/BootstrapperConfigurationExtensions.cs

@@ -37,5 +37,17 @@ public static Bootstrapper AddConfigurator<TConfigurable>(
             bootstrapper.Configurators.Add(configurator);
             return bootstrapper;
         }
+
+        public static TBootstrapper ConfigureEngineManager<TBootstrapper>(
+            this TBootstrapper bootstrapper, Action<IEngineManager> action)
+            where TBootstrapper : IBootstrapper
+        {
+            bootstrapper.ThrowIfNull(nameof(bootstrapper));
+            action.ThrowIfNull(nameof(action));
+            bootstrapper.Configurators.Add(action);
+            return bootstrapper;
+        }
+
+        // Most of the Configure...() methods are in Statiq.Common if they configure a common interface
     }
 }

src/core/Statiq.App/Commands/EngineManager.cs

@@ -26,6 +26,8 @@ public EngineManager(
             IServiceCollection serviceCollection,
             Bootstrapper bootstrapper)
         {
+            Bootstrapper = bootstrapper;
+
             // Get the standard input stream
             string input = null;
             if (commandSettings?.StdIn == true)
@@ -78,6 +80,8 @@ public EngineManager(
             _logger.LogInformation($"Cache path:{Environment.NewLine}       {Engine.FileSystem.CachePath}");
         }
 
+        public IBootstrapper Bootstrapper { get; set; }
+
         public Engine Engine { get; }
 
         public string[] Pipelines { get; set; }
@@ -86,6 +90,11 @@ public EngineManager(
 
         public async Task<ExitCode> ExecuteAsync(CancellationTokenSource cancellationTokenSource)
         {
+            // Provide a chance to configure the engine manager, which is mainly useful for tweaking
+            // the pipelines and/or engine right before executing
+            Bootstrapper.Configurators.Configure<IEngineManager>(this);
+
+            // Execute the engine and log all errors (including cancellation requests)
             try
             {
                 await Engine.ExecuteAsync(Pipelines, NormalPipelines, cancellationTokenSource?.Token ?? CancellationToken.None);

src/core/Statiq.App/Commands/IEngineManager.cs

@@ -1,10 +1,11 @@
 using System.Threading;
 using System.Threading.Tasks;
+using Statiq.Common;
 using Statiq.Core;
 
 namespace Statiq.App
 {
-    public interface IEngineManager
+    public interface IEngineManager : IConfigurable
     {
         Engine Engine { get; }
 
@@ -14,4 +15,4 @@ public interface IEngineManager
 
         Task<ExitCode> ExecuteAsync(CancellationTokenSource cancellationTokenSource);
     }
-}
+}

src/core/Statiq.Common/Bootstrapper/BootstrapperConfigurationExtensions.cs

@@ -6,7 +6,8 @@ namespace Statiq.Common
 {
     public static class BootstrapperConfigurationExtensions
     {
-        public static TBootstrapper BuildConfiguration<TBootstrapper>(this TBootstrapper bootstrapper, Action<IConfigurationBuilder> action)
+        public static TBootstrapper BuildConfiguration<TBootstrapper>(
+            this TBootstrapper bootstrapper, Action<IConfigurationBuilder> action)
             where TBootstrapper : IBootstrapper
         {
             bootstrapper.ThrowIfNull(nameof(bootstrapper));
@@ -15,7 +16,8 @@ public static TBootstrapper BuildConfiguration<TBootstrapper>(this TBootstrapper
             return bootstrapper;
         }
 
-        public static TBootstrapper ConfigureServices<TBootstrapper>(this TBootstrapper bootstrapper, Action<IServiceCollection> action)
+        public static TBootstrapper ConfigureServices<TBootstrapper>(
+            this TBootstrapper bootstrapper, Action<IServiceCollection> action)
             where TBootstrapper : IBootstrapper
         {
             bootstrapper.ThrowIfNull(nameof(bootstrapper));
@@ -24,7 +26,8 @@ public static TBootstrapper ConfigureServices<TBootstrapper>(this TBootstrapper
             return bootstrapper;
         }
 
-        public static TBootstrapper ConfigureServices<TBootstrapper>(this TBootstrapper bootstrapper, Action<IServiceCollection, IReadOnlySettings> action)
+        public static TBootstrapper ConfigureServices<TBootstrapper>(
+            this TBootstrapper bootstrapper, Action<IServiceCollection, IReadOnlySettings> action)
             where TBootstrapper : IBootstrapper
         {
             bootstrapper.ThrowIfNull(nameof(bootstrapper));
@@ -33,7 +36,8 @@ public static TBootstrapper ConfigureServices<TBootstrapper>(this TBootstrapper
             return bootstrapper;
         }
 
-        public static TBootstrapper ConfigureServices<TBootstrapper>(this TBootstrapper bootstrapper, Action<IServiceCollection, IReadOnlySettings, IReadOnlyFileSystem> action)
+        public static TBootstrapper ConfigureServices<TBootstrapper>(
+            this TBootstrapper bootstrapper, Action<IServiceCollection, IReadOnlySettings, IReadOnlyFileSystem> action)
             where TBootstrapper : IBootstrapper
         {
             bootstrapper.ThrowIfNull(nameof(bootstrapper));
@@ -42,12 +46,13 @@ public static TBootstrapper ConfigureServices<TBootstrapper>(this TBootstrapper
             return bootstrapper;
         }
 
-        public static TBootstrapper ConfigureEngine<TBootstrapper>(this TBootstrapper bootstrapper, Action<IEngine> action)
+        public static TBootstrapper ConfigureEngine<TBootstrapper>(
+            this TBootstrapper bootstrapper, Action<IEngine> action)
             where TBootstrapper : IBootstrapper
         {
             bootstrapper.ThrowIfNull(nameof(bootstrapper));
             action.ThrowIfNull(nameof(action));
-            bootstrapper.Configurators.Add<IEngine>(x => action(x));
+            bootstrapper.Configurators.Add(action);
             return bootstrapper;
         }
     }