Introduces the way to configure defaults using Tuners and syntax sugar.

Author: Ed-Pavlov

.gitignore

@@ -5,8 +5,9 @@ Packages/
 private
 
 # Compiling result files
-Bin/
-Obj/
+.out/
+[Bb]in/
+[Oo]bj/
 
 # Visual Studion and ReSharper files
 _ReSharper.Caches/

.out/BeatyBit.Armature.Core.xml

@@ -30,22 +30,6 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = ".root", ".root", "{4F748C60
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Test.Performance", "test\Test.Performance\Test.Performance.csproj", "{47000C08-6B61-4ADB-8BBF-D8EED737D2D1}"
 EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "wiki", "wiki", "{FA14B96D-6F61-4888-92D8-A0B34DFD20AB}"
-	ProjectSection(SolutionItems) = preProject
-		wiki\_Sidebar.md = wiki\_Sidebar.md
-		wiki\Armature-the-DSL-over-Armature.Core.md = wiki\Armature-the-DSL-over-Armature.Core.md
-		wiki\Core-Concepts-of-Armature.Core.md = wiki\Core-Concepts-of-Armature.Core.md
-		wiki\Default-Rules-For-Resolving-Unit-and-Its-Dependencies.md = wiki\Default-Rules-For-Resolving-Unit-and-Its-Dependencies.md
-		wiki\Home.md = wiki\Home.md
-		wiki\InjectAttribute.-Marking-Injection-Points-and-Customizing-Injection-Rules.md = wiki\InjectAttribute.-Marking-Injection-Points-and-Customizing-Injection-Rules.md
-		wiki\Logging.md = wiki\Logging.md
-		wiki\One-Process-to-Rule-Them-All.-Armature's-Universal-Dependency-Resolution.md = wiki\One-Process-to-Rule-Them-All.-Armature's-Universal-Dependency-Resolution.md
-		wiki\Out-of-the-Box.md = wiki\Out-of-the-Box.md
-		wiki\Propagation-of-Maybe.-Subscribing-Events.-And-Many-Many-More.md = wiki\Propagation-of-Maybe.-Subscribing-Events.-And-Many-Many-More.md
-		wiki\Side-Tuners-Fine-Grained-Control-Over-Dependency-Injection.md = wiki\Side-Tuners-Fine-Grained-Control-Over-Dependency-Injection.md
-		wiki\Weighted-Build-Actions-and-Patterns.-Prioritizing-Resolution-Paths.md = wiki\Weighted-Build-Actions-and-Patterns.-Prioritizing-Resolution-Paths.md
-	EndProjectSection
-EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU

.out/BeatyBit.Armature.Interface.xml

@@ -34,7 +34,7 @@ public abstract class BuildStackPatternBase : IBuildStackPattern, IEnumerable, I
   /// <summary>
   /// Adds a <paramref name="node" /> as a child node if the node is not already added. Returns the new node, or the existing node if the node already added.
   /// </summary>
-  /// <remarks>Call it first and then fill returned <see cref="IBuildStackPattern" /> with build actions or perform other needed actions due to
+  /// <remarks>Call it first and then fill returned <see cref="IBuildStackPattern" /> with build actions or perform other necessary actions due to
   /// it can return another instance of <see cref="IBuildStackPattern"/> then passed <paramref name="node"/>.</remarks>
   public virtual T GetOrAddNode<T>(T node) where T : IBuildStackPattern
   {
@@ -84,13 +84,14 @@ protected bool GetOwnBuildActions(long inputWeight, out WeightedBuildActionBag?
 
     foreach(var pair in RawBuildActions)
     {
+      var buildStage      = pair.Key;
       var actions         = pair.Value;
       var weightedActions = new LeanList<Weighted<IBuildAction>>(actions.Count);
 
       foreach(var buildAction in actions)
         weightedActions.Add(buildAction.WithWeight(matchingWeight));
 
-      actionBag.Add(pair.Key, weightedActions);
+      actionBag.Add(buildStage, weightedActions);
     }
 
     return true;

.out/BeatyBit.Armature.xml

@@ -0,0 +1,35 @@
+using System;
+using System.Collections.Generic;
+using BeatyBit.Armature.Core.Sdk;
+
+namespace BeatyBit.Armature.Core;
+
+/// <summary>
+/// It's a very special build stack pattern that matches with any 'unit'. See usages for details.
+/// </summary>
+public class IfAnyUnit : BuildStackPatternBase, IBuildStackPattern
+{
+  public static readonly IfAnyUnit Instance = new();
+
+  private static readonly UnitId FakeUnitId = new(typeof(IfAnyUnit), null);
+
+  private IfAnyUnit() : base(0) { }
+
+  public override bool IsStatic(out UnitId unitId)
+  {
+    unitId = FakeUnitId;
+    return true;
+  }
+
+  public override bool GatherBuildActions(BuildSession.Stack stack, out WeightedBuildActionBag? actionBag, long inputWeight)
+    => GetOwnBuildActions(inputWeight, out actionBag);
+
+  public override bool Equals(IBuildStackPattern? other) => other is IfAnyUnit;
+
+  public override T GetOrAddNode<T>(T node) => throw new NotSupportedException();
+  public override T AddNode<T>(T node) => throw new NotSupportedException();
+
+  long IInternal<long>.                                                         Member1 => 0;
+  HashSet<IBuildStackPattern>? IInternal<long, HashSet<IBuildStackPattern>?>.   Member2 => null;
+  BuildActionBag IInternal<long, HashSet<IBuildStackPattern>?, BuildActionBag?>.Member3 => BuildActions;
+}

Armature.sln

@@ -56,9 +56,9 @@ public static string ToHoconString(this object? value)
              {
                null                     => "null",
                string str               => str.QuoteIfNeeded(),
-               BuildSession.Stack stack    => stack.ToHoconString(),
+               BuildSession.Stack stack => stack.ToHoconString(),
                ILogString logable       => logable.ToHoconString(),
-               IBuildAction buildAction => buildAction.GetType().GetShortName().QuoteIfNeeded(),
+               // IBuildAction buildAction => buildAction.GetType().GetShortName().QuoteIfNeeded(),
                MethodBase methodInfo    => methodInfo.ToString().QuoteIfNeeded(),
                Type type                => $"typeof({(Log.LogFullTypeName ? type.GetFullName() : type.GetShortName())})".QuoteIfNeeded(),
                IEnumerable items        => $"[{string.Join(", ", items.Cast<object>().Select(_ => _.ToHoconString()))}]",

src/Armature.Core/src/BuildStackPatterns/BuildStackPatternBase.cs

@@ -103,6 +103,7 @@ private static bool IsCollection(
 
   [DebuggerStepThrough]
   public string ToHoconString() => $"{{ {GetType().GetShortName().QuoteIfNeeded()} {{ Tag: {_tag.ToHoconString()} }} }}";
+
   [DebuggerStepThrough]
   public sealed override string ToString() => ToHoconString();
 }

src/Armature.Core/src/BuildStackPatterns/IfAnyUnit.cs

@@ -73,4 +73,5 @@ private static ConstructorInfo GetConstructor(IReadOnlyList<ConstructorInfo> con
 
   [DebuggerStepThrough]
   public override string ToString() => nameof(GetConstructorWithMaxParametersCount);
+  public string ToHoconString() => $"{nameof(GetConstructorWithMaxParametersCount)} ";
 }