Option for running PostBuild pre or post pipeline

Author: Raphael Hoppe

Diff for: Directory.Build.props

@@ -5,7 +5,7 @@
     <Company>queo GmbH</Company>
     <Copyright>2023 queo GmbH</Copyright>
     <Product>Queo Commons ModelBuilder Library</Product>
-    <AssemblyVersion>0.1.1</AssemblyVersion>
+    <AssemblyVersion>0.1.2</AssemblyVersion>
     <FileVersion>$(AssemblyVersion)</FileVersion>
     <version>$(AssemblyVersion)-Beta</version>
   </PropertyGroup>

Diff for: src/Commons.Builders.Model/Builder/ModelBuilder.cs

@@ -45,6 +45,12 @@ public abstract class ModelBuilder<TModel> : IBuilder<TModel>, IRecreatable<Mode
         /// </summary>
         protected readonly IBuilderFactory _factory;
 
+        /// <summary>
+        ///    Flag that specifies if the post build should be run before or after the pipeline.
+        ///    The pipeline is provided by the factory and will usually contain the persist post build action.
+        /// </summary>
+        protected bool _prePipelinePostBuild = false;
+
         /// <summary>
         ///     ModelBuilder that uses the same Persistor to Persist itself as it's children
         ///     Used by the common builders, that just build a model
@@ -64,8 +70,10 @@ public TModel Build()
             {
                 _factory.PreBuild.Execute<TModel>(this);
                 _model = BuildModel();
-                AfterModel(_model);
+
+                if (_prePipelinePostBuild) PostBuild(_model);
                 _factory.PostBuild.Execute<TModel>(_model!);
+                if (!_prePipelinePostBuild) PostBuild(_model);
             }
             return _model;
         }
@@ -78,7 +86,6 @@ public TModel Build()
 
         /// <summary>
         ///		Method that can be overwritten for common 'Chicken and egg' situations during setup
-        ///		This will run before the factories post actions are executed, but after the model is build.
         ///		This allows us to resolve a dependency of a child builder, without running into a cyclic call.
         ///
         ///		The way this works is, the parent will get build, without the children connected,
@@ -87,8 +94,11 @@ public TModel Build()
         ///		model = Parent.Build();
         ///		child = _childBuilder.WithParent(Parent).Build();
         ///		model.Add(child);
+        ///
+        ///		If this post build should be run before the pipeline actions (factory.PostBuild)
+        ///		the _prePipelinePostBuild flag can be set to true.
         /// </summary>
-        protected virtual void AfterModel(TModel model)
+        protected virtual void PostBuild(TModel model)
         {
             // intentionally empty, since this is a optional action, to be overwritten by specific builders
         }

Diff for: tests/Examples/Relations/CountryBuilder.cs

@@ -27,7 +27,7 @@ public CountryBuilder WithPresident(Action<PresidentBuilder> buildAction) => Set
 
     protected override Country BuildModel() => new(_name);
 
-    protected override void AfterModel(Country model)
+    protected override void PostBuild(Country model)
     {
         if (_president is not null)
         {

Diff for: tests/Examples/Relations/UserBuilder.cs

@@ -26,7 +26,7 @@ public UserBuilder WithOrg(Action<OrgBuilder> buildAction) => Set(() =>
 
     protected override User BuildModel() => new(_name);
 
-    protected override void AfterModel(User model)
+    protected override void PostBuild(User model)
     {
         if (_org is not null)
         {