Adds OnBuildInitialized, BeforeEachTargetExecution, AfterEachTargetExecution

Author: mzorec

CHANGELOG.md

@@ -1,4 +1,8 @@
+## FlubuCore 6.3.1.0
+- Fixes BeforeBuildExecution event.
+
 ## FlubuCore 6.3.0.0
+- Adds OnBuildInitialzed, BeforeEachTargetExecuion and AfterEachTargetExecution events.
 - Dependencies can now be added to group of tasks in target.
 - Added ExecuteOnlyWhen to group of tasks in target. Tasks in group are only executed when condition is meet.
 - Fixed directory and file suggestions in flubu interactive mode.

src/Build.csproj

@@ -147,4 +147,9 @@
     <PackageReference Include="FlubuCore" Version="5.1.8" />
     <PackageReference Include="LiteDB" Version="5.0.11" />
   </ItemGroup>
+  <ItemGroup>
+    <Content Include="..\CHANGELOG.md">
+      <Link>CHANGELOG.md</Link>
+    </Content>
+  </ItemGroup>
 </Project>

src/FlubuCore/Scripting/DefaultBuildScript.cs

@@ -51,6 +51,7 @@ public int Run(IFlubuSession flubuSession)
 
             try
             {
+                BeforeBuildExecution(flubuSession);
                 RunBuild(flubuSession);
                 flubuSession.Complete();
                 AfterBuildExecution(flubuSession);
@@ -137,7 +138,6 @@ public static (List<string> targetsToRun, bool unknownTarget, List<string> notFo
 
         private void RunBuild(IFlubuSession flubuSession)
         {
-            BeforeBuildExecution(flubuSession);
             flubuSession.TargetTree.ResetTargetTree();
             ConfigureDefaultProps(flubuSession);
             ConfigureBuildProperties(flubuSession);
@@ -149,7 +149,7 @@ private void RunBuild(IFlubuSession flubuSession)
             _targetCreator.CreateTargetFromMethodAttributes(this, flubuSession);
 
             ConfigureTargets(flubuSession);
-
+            OnBuildInitialized(flubuSession);
             if (!flubuSession.Args.InteractiveMode)
             {
                 var targetsInfo = ParseCmdLineArgs(flubuSession.Args.MainCommands, flubuSession.TargetTree);
@@ -215,7 +215,9 @@ private void ExecuteTarget(IFlubuSession flubuSession, (List<string> targetsToRu
                 BeforeTargetExecution(flubuSession);
                 foreach (var targetToRun in targetsInfo.targetsToRun)
                 {
+                    BeforeEachTargetExecution(flubuSession);
                     flubuSession.TargetTree.RunTarget(flubuSession, targetToRun);
+                    AfterEachTargetExecution(flubuSession);
                 }
 
                 AfterTargetExecution(flubuSession);
@@ -250,18 +252,58 @@ private void ExecuteTarget(IFlubuSession flubuSession, (List<string> targetsToRu
             AssertAllTargetDependenciesWereExecuted(flubuSession);
         }
 
+        /// <summary>
+        /// Event that happens before all targets get executed.
+        /// </summary>
+        /// <param name="context"></param>
         protected virtual void BeforeTargetExecution(ITaskContext context)
         {
         }
 
+        /// <summary>
+        /// Event that happens after all targets get executed.
+        /// </summary>
+        /// <param name="context"></param>
         protected virtual void AfterTargetExecution(ITaskContext context)
         {
         }
 
+        /// <summary>
+        /// Event that happens before each target get executed.
+        /// </summary>
+        /// <param name="context"></param>
+        protected virtual void BeforeEachTargetExecution(ITaskContext context)
+        {
+        }
+
+        /// <summary>
+        /// Event that happens after each target get executed.
+        /// </summary>
+        /// <param name="context"></param>
+        protected virtual void AfterEachTargetExecution(ITaskContext context)
+        {
+        }
+
+        /// <summary>
+        /// Event that happens before build is executed. Target's and properties are not yet configured.
+        /// </summary>
+        /// <param name="context"></param>
         protected virtual void BeforeBuildExecution(ITaskContext context)
         {
         }
 
+        /// <summary>
+        /// Event that happens when build is initialized. Target's and properties are configured.
+        /// </summary>
+        /// <param name="context"></param>
+        protected virtual void OnBuildInitialized(ITaskContext context)
+        {
+        }
+
+        /// <summary>
+        /// Event that happens when build is finished.
+        /// </summary>
+        /// <param name="context"></param>
         protected virtual void AfterBuildExecution(IFlubuSession session)
         {
             if (session.Args.GenerateContinousIntegrationConfigs != null &&
@@ -273,6 +315,11 @@ protected virtual void AfterBuildExecution(IFlubuSession session)
             session.TargetTree.LogBuildSummary(session);
         }
 
+        /// <summary>
+        /// Event that happends when build has failed.
+        /// </summary>
+        /// <param name="session"></param>
+        /// <param name="ex"></param>
         protected virtual void OnBuildFailed(IFlubuSession session, Exception ex)
         {
         }