Added parent command accessor support

- Added parent command accessor support. Sub-commands can get a reference to the parent command by adding a property of the parent command type.
- ParseResultExtensions.Bind improvement: Binding will be done only once per definition class, so calling this method consecutively for
  the same definition class will return the cached result.

Author: calacayir

src/Directory.Build.props

@@ -2,7 +2,7 @@
 
   <PropertyGroup>
     <!-- https://learn.microsoft.com/en-us/dotnet/core/project-sdk/msbuild-props#generateassemblyinfo -->
-    <VersionPrefix>1.8.5</VersionPrefix>
+    <VersionPrefix>1.8.6</VersionPrefix>
     <Product>DotMake Command-Line</Product>
     <Company>DotMake</Company>
     <!-- Copyright is also used for NuGet metadata -->

src/DotMake.CommandLine.Shared/Attributes/CliArgumentAttribute.cs

@@ -28,6 +28,7 @@ namespace DotMake.CommandLine
     /// <example>
     ///     <inheritdoc cref="Cli" path="/example/code[@id='gettingStartedDelegate']" />
     ///     <inheritdoc cref="Cli" path="/example/code[@id='gettingStartedClass']" />
+    ///     <code source="..\TestApp\Commands\ParentCommandAccessorCliCommand.cs" region="ParentCommandAccessorCliCommand" language="cs" />
     /// </example>
     [AttributeUsage(AttributeTargets.Property | AttributeTargets.Parameter)]
     public class CliArgumentAttribute : Attribute

src/DotMake.CommandLine.Shared/Attributes/CliOptionAttribute.cs

@@ -32,8 +32,10 @@ namespace DotMake.CommandLine
     /// </para>
     /// </summary>
     /// <example>
+    ///     <inheritdoc cref="Cli" path="/example/code[@id='gettingStartedDelegate']" />
     ///     <inheritdoc cref="Cli" path="/example/code[@id='gettingStartedClass']" />
     ///     <code source="..\TestApp\Commands\RecursiveOptionCliCommand.cs" region="RecursiveOptionCliCommand" language="cs" />
+    ///     <code source="..\TestApp\Commands\ParentCommandAccessorCliCommand.cs" region="ParentCommandAccessorCliCommand" language="cs" />
     /// </example>
     [AttributeUsage(AttributeTargets.Property | AttributeTargets.Parameter)]
     public class CliOptionAttribute : Attribute

src/DotMake.CommandLine.SourceGeneration/CliCommandInfo.cs

@@ -3,25 +3,19 @@
 
 namespace DotMake.CommandLine.SourceGeneration
 {
-    public class CliParentCommandRefInfo : CliSymbolInfo, IEquatable<CliParentCommandRefInfo>
+    public class CliParentCommandAccessorInfo : CliSymbolInfo, IEquatable<CliParentCommandAccessorInfo>
     {
-        public const string DiagnosticName = "CLI parent command reference";
+        public const string DiagnosticName = "CLI parent command accessor";
 
-        public CliParentCommandRefInfo(IPropertySymbol symbol, SyntaxNode syntaxNode, SemanticModel semanticModel,
-            int parentTreeIndex, CliCommandSettings parentCommandSettings) : base(symbol, syntaxNode, semanticModel)
+        public CliParentCommandAccessorInfo(ISymbol symbol, SyntaxNode syntaxNode, SemanticModel semanticModel)
+            : base(symbol, syntaxNode, semanticModel)
         {
-            ParentTreeIndex = parentTreeIndex;
-            ParentCommandSettings = parentCommandSettings;
+            Symbol = (IPropertySymbol)symbol;
 
             Analyze();
-
-            if (HasProblem)
-                return;
         }
 
-        public int ParentTreeIndex { get; }
-        public CliCommandSettings ParentCommandSettings { get; }
-        public new IPropertySymbol Symbol => (IPropertySymbol)base.Symbol;
+        public new IPropertySymbol Symbol;
 
         private void Analyze()
         {
@@ -40,7 +34,7 @@ private void Analyze()
             }
         }
 
-        public bool Equals(CliParentCommandRefInfo other)
+        public bool Equals(CliParentCommandAccessorInfo other)
         {
             return base.Equals(other);
         }

src/DotMake.CommandLine.SourceGeneration/CliParentCommandRefInfo.cs renamed to src/DotMake.CommandLine.SourceGeneration/CliParentCommandAccessorInfo.cs

@@ -101,7 +101,7 @@ public static ITypeSymbol GetUnderlyingTypeIfNullable(this ITypeSymbol type)
         }
 
         /// <summary>
-        /// Gets all own and inherited members (not distinct).
+        /// Gets all own and then inherited members (not distinct).
         /// </summary>
         public static IEnumerable<ISymbol> GetAllMembers(this ITypeSymbol type)
         {

src/DotMake.CommandLine.SourceGeneration/SymbolExtensions.cs

@@ -339,21 +339,6 @@ public static ParseResult Parse<TDefinition>(string commandLine, CliSettings set
             return configuration.Parse(commandLine);
         }
 
-        /// <summary>
-        /// Creates a new instance of the command definition class and binds/populates the properties from the parse result.
-        /// If the command line input is not for the indicated definition class (e.g. it's for a sub-command but not for the indicated root command or vice versa),
-        /// then the returned instance would be empty (i.e. properties would have default values).
-        /// </summary>
-        /// <typeparam name="TDefinition"><inheritdoc cref="GetConfiguration{TDefinition}" path="/typeparam[@name='TDefinition']/node()" /></typeparam>
-        /// <param name="parseResult">The parse result.</param>
-        /// <returns>The parsed value or a configured default.</returns>
-        public static TDefinition Bind<TDefinition>(this ParseResult parseResult)
-        {
-            var commandBuilder = CliCommandBuilder.Get<TDefinition>();
-
-            return (TDefinition)commandBuilder.Bind(parseResult);
-        }
-
         private static string[] FixArgs(string[] args)
         {
             if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows)

src/DotMake.CommandLine/Cli.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.CommandLine;
 using System.CommandLine.Parsing;
@@ -14,9 +15,11 @@ namespace DotMake.CommandLine
     public abstract class CliCommandBuilder
     {
         /// <summary>
-        /// A delegate which is set by the source generator to be called from <see cref="Bind(CliBindContext)"/> method.
+        /// A delegate which is set by the source generator to be called from <see cref="Bind(ParseResult)"/> method.
         /// </summary>
-        protected Func<CliBindContext, object> BindFunc;
+        protected Func<ParseResult, object> Binder;
+
+        private readonly ConcurrentDictionary<ParseResult, object> bindResults = new();
 
         /// <summary>
         /// Initializes a new instance of the <see cref="CliCommandBuilder" /> class.
@@ -67,28 +70,26 @@ protected CliCommandBuilder()
         public abstract CliCommand Build();
 
         /// <summary>
-        /// Creates a new instance of the definition class and binds/populates the properties from the parse result.
+        /// Creates a new instance of the command definition class and binds/populates the properties from the parse result.
+        /// Note that binding will be done only once, so calling this method consecutively will return the cached result.
+        /// <para>
+        /// If the command line input is not for this definition class (e.g. it's for a sub-command but not for
+        /// this root command or vice versa), then the returned instance would be empty (i.e. properties would have default values).
+        /// </para>
         /// </summary>
         /// <param name="parseResult">A parse result describing the outcome of the parse operation.</param>
         /// <returns>An instance of the definition class whose properties were bound/populated from the parse result.</returns>
         public object Bind(ParseResult parseResult)
         {
-            return Bind(new CliBindContext(parseResult));
-        }
-
-        /// <summary>
-        /// Creates a new instance of the definition class and binds/populates the properties from the parse result.
-        /// </summary>
-        /// <param name="cliBindContext">A <see cref="CliBindContext"/> instance to use for the binding operation.</param>
-        /// <returns>An instance of the definition class whose properties were bound/populated from the parse result.</returns>
-        public object Bind(CliBindContext cliBindContext)
-        {
-            if (BindFunc == null)
-                throw new Exception("Ensure Build method is called first.");
+            return bindResults.GetOrAdd(parseResult, pr =>
+            {
+                if (Binder == null)
+                    throw new Exception("Binder is not set. Ensure Build method is called first.");
 
-            return BindFunc(cliBindContext);
+                return Binder(pr);
+            });
         }
-
+        
         /// <summary>
         /// Gets the command builders that are nested/external children of this command builder.
         /// </summary>

src/DotMake.CommandLine/CliBindContext.cs

@@ -20,8 +20,9 @@
     <Description>Declarative syntax for System.CommandLine via attributes for easy, fast, strongly-typed (no reflection) usage. Includes a source generator which automagically converts your classes to CLI commands and properties to CLI options or CLI arguments.</Description>
     <PackageTags>command-line CLI console System.CommandLine declarative attributes parsing command argument option generator</PackageTags>
     <PackageReleaseNotes>
-      - Added theme support. CliSettings.Theme property can be set to predefined themes Red, DarkRed, Green, DarkGreen, Blue, DarkBlue
-        or a custom CliTheme. These color and formatting option are mainly used by the help output.
+      - Added parent command accessor support. Sub-commands can get a reference to the parent command by adding a property of the parent command type.
+      - ParseResultExtensions.Bind improvement: Binding will be done only once per definition class, so calling this method consecutively for
+        the same definition class will return the cached result.
     </PackageReleaseNotes>
   </PropertyGroup>