s2quake · s2quake · Jan 9, 2025 · Jan 8, 2025 · Jan 9, 2025 · Jan 9, 2025
diff --git a/CHANGES.md b/CHANGES.md
@@ -7,8 +7,11 @@ Commands changes
 To be Released.
 
 * Renamed method `GetCompletion` to `GetCompletions`.  [[#47]]
+* Added a `ServiceProvider` property to the `CommandSettings`  [[#49]]
 
 [#47]: https://github.com/s2quake/commands/pull/47
+[#49]: https://github.com/s2quake/commands/pull/49
+
 
 
 7.0.0
@@ -33,12 +36,12 @@ Released on November 19, 2024.
 * Added the `CommandPropertyExclusionAttribute`.  [[#31]]
 * Added a `Category` property to the `CommandMemberDescriptor`.  [[#33]]
 * Simplified the process of getting strings from `ResourceManager`.  [[#34]]
-* Removed `ICommandUsage`, `CommandUsageDescriptorBase`, 
+* Removed `ICommandUsage`, `CommandUsageDescriptorBase`,
   `ResourceUsageDescriptor`.  [[#34]]
-* Fixed an issue with the display order of options and commands in Help.  
+* Fixed an issue with the display order of options and commands in Help.
   [[#37]]
 * Removed commands sorting code in `CommandContextBase`.  [[#38]]
-* Integrated usage-related properties(`Summary`, `Description`, `Example`) into 
+* Integrated usage-related properties(`Summary`, `Description`, `Example`) into
   the `CommandUsage` property.  [[#40]]
 * Added `StepProgress` to make it easier to work with progress.  [[#41]]
 * Added `RunAsync` and `StopAsync` methods to `SystemTerminalBase`.  [[#42]]
@@ -71,7 +74,7 @@ Released on November 19, 2024.
 
 Released on May 31, 2024.
 
-* Fixed an issue where an exception was thrown when multiple 
+* Fixed an issue where an exception was thrown when multiple
   commands using `PartialCommandAttribute` were inside an assembly.  [[#8]]
 
 [#8]: https://github.com/s2quake/commands/pull/8

diff --git a/src/JSSoft.Commands/CommandContextBase.cs b/src/JSSoft.Commands/CommandContextBase.cs
@@ -159,7 +159,8 @@ public string[] GetCompletions(string[] items, string find)
     {
         var completionList = new List<string>(items.Length);
         var itemList = new List<string>(items);
-        var completions = GetCompletions(_commandNode, itemList);
+        var settings = Settings;
+        var completions = GetCompletions(_commandNode, itemList, settings);
         for (var i = 0; i < completions.Length; i++)
         {
             var completion = completions[i];
@@ -339,7 +340,7 @@ private static void AttachContext(ICommand command, ICommandContext commandConte
     }
 
     private static string[] GetCompletions(
-        ICommand parent, IList<string> itemList)
+        ICommand parent, IList<string> itemList, CommandSettings settings)
     {
         if (itemList.Count is 0)
         {
@@ -357,12 +358,12 @@ where child.IsEnabled is true
                 if (command.IsEnabled is true && command.Commands.Count > 0)
                 {
                     itemList.RemoveAt(0);
-                    return GetCompletions(command, itemList);
+                    return GetCompletions(command, itemList, settings);
                 }
                 else
                 {
                     var args = itemList.Skip(1).ToArray();
-                    if (GetCompletions(command, args) is string[] completions)
+                    if (GetCompletions(command, args, settings) is string[] completions)
                     {
                         return completions;
                     }
@@ -373,10 +374,11 @@ where child.IsEnabled is true
         }
     }
 
-    private static string[] GetCompletions(ICommand command, string[] args)
+    private static string[] GetCompletions(
+        ICommand command, string[] args, CommandSettings settings)
     {
         var memberDescriptors = CommandDescriptor.GetMemberDescriptors(command);
-        var parseContext = ParseContext.Create(memberDescriptors, args);
+        var parseContext = ParseContext.Create(memberDescriptors, args, settings);
         if (parseContext.Descriptor is { } descriptor)
         {
             var properties = parseContext.GetProperties();

diff --git a/src/JSSoft.Commands/CommandInvoker.cs b/src/JSSoft.Commands/CommandInvoker.cs
@@ -175,7 +175,7 @@ private void Invoke(CommandMethodDescriptor methodDescriptor, string[] args)
         var instance = Instance;
         var memberDescriptors = methodDescriptor.Members;
         var settings = Settings;
-        var parseContext = ParseContext.Create(memberDescriptors, args);
+        var parseContext = ParseContext.Create(memberDescriptors, args, settings);
         var methodInstance = new CommandMethodInstance(methodDescriptor, instance);
         parseContext.SetValue(methodInstance, settings);
         methodDescriptor.Invoke(instance, methodInstance);
@@ -190,7 +190,7 @@ private Task InvokeAsync(
         var instance = Instance;
         var memberDescriptors = methodDescriptor.Members;
         var settings = Settings;
-        var parseContext = ParseContext.Create(memberDescriptors, args);
+        var parseContext = ParseContext.Create(memberDescriptors, args, settings);
         var methodInstance = new CommandMethodInstance(methodDescriptor, instance);
         parseContext.SetValue(methodInstance, settings);
         return methodDescriptor.InvokeAsync(
@@ -202,7 +202,7 @@ private void Parse(string[] args)
         var instance = Instance;
         var memberDescriptors = CommandDescriptor.GetMemberDescriptors(instance);
         var settings = Settings;
-        var parserContext = ParseContext.Create(memberDescriptors, args);
+        var parserContext = ParseContext.Create(memberDescriptors, args, settings);
         parserContext.SetValue(instance, settings);
     }
 }
diff --git a/src/JSSoft.Commands/CommandParentBase.cs b/src/JSSoft.Commands/CommandParentBase.cs
@@ -0,0 +1,133 @@
+// <copyright file="CommandParentBase.cs" company="JSSoft">
+//   Copyright (c) 2024 Jeesu Choi. All Rights Reserved.
+//   Licensed under the MIT License. See LICENSE.md in the project root for license information.
+// </copyright>
+
+using System.IO;
+using JSSoft.Commands.Extensions;
+
+namespace JSSoft.Commands;
+
+public abstract class CommandParentBase : ICommand
+{
+    private readonly CommandUsage _usage;
+    private readonly CommandCollection _commands = [];
+    private ICommandContext? _context;
+
+    protected CommandParentBase()
+        : this(parent: null!, name: string.Empty, aliases: [])
+    {
+    }
+
+    protected CommandParentBase(string[] aliases)
+        : this(parent: null!, name: string.Empty, aliases)
+    {
+    }
+
+    protected CommandParentBase(string name)
+        : this(parent: null!, name, aliases: [])
+    {
+    }
+
+    protected CommandParentBase(string name, string[] aliases)
+        : this(parent: null!, name, aliases)
+    {
+    }
+
+    protected CommandParentBase(ICommand parent)
+        : this(parent, name: string.Empty, aliases: [])
+    {
+    }
+
+    protected CommandParentBase(ICommand parent, string[] aliases)
+        : this(parent, name: string.Empty, aliases)
+    {
+    }
+
+    protected CommandParentBase(ICommand parent, string name)
+        : this(parent, name, aliases: [])
+    {
+    }
+
+    protected CommandParentBase(ICommand parent, string name, string[] aliases)
+    {
+        Name = name == string.Empty ? CommandUtility.ToSpinalCase(GetType()) : name;
+        Aliases = aliases;
+        _usage = CommandDescriptor.GetUsage(GetType());
+        ICommandExtensions.SetParent(this, parent);
+    }
+
+    public string Name { get; }
+
+    public string[] Aliases { get; }
+
+    public virtual bool IsEnabled => true;
+
+    bool ICommand.AllowsSubCommands => true;
+
+    public TextWriter Out => Context.Out;
+
+    public TextWriter Error => Context.Error;
+
+    public ICommandContext Context
+        => _context ?? throw new InvalidOperationException("The command node is not available.");
+
+    ICommand? ICommand.Parent { get; set; }
+
+    CommandCollection ICommand.Commands => _commands;
+
+    [System.Diagnostics.CodeAnalysis.SuppressMessage(
+        "Minor Code Smell",
+        "S2292:Trivial properties should be auto-implemented",
+        Justification = "This property does not need to be public.")]
+    ICommandContext? ICommand.Context
+    {
+        get => _context;
+        set => _context = value;
+    }
+
+    CommandUsage ICommand.Usage => _usage;
+
+    string ICommand.Category => AttributeUtility.GetCategory(GetType());
+
+    internal string ExecutionName
+    {
+        get
+        {
+            var executionName = CommandUtility.GetExecutionName(Name, Aliases);
+            if (Context.ExecutionName != string.Empty)
+            {
+                return $"{Context.ExecutionName} {executionName}";
+            }
+
+            return executionName;
+        }
+    }
+
+    string ICommand.GetUsage(bool isDetail) => OnUsagePrint(isDetail);
+
+    string[] ICommand.GetCompletions(CommandCompletionContext completionContext)
+        => GetCompletions(completionContext);
+
+    protected virtual string[] GetCompletions(CommandCompletionContext completionContext)
+    {
+        var memberDescriptor = completionContext.MemberDescriptor;
+        var instance = this;
+        return memberDescriptor.GetCompletionsInternal(instance);
+    }
+
+    protected CommandMemberDescriptor GetDescriptor(string propertyName)
+        => CommandDescriptor.GetMemberDescriptors(GetType())[propertyName];
+
+    protected virtual string OnUsagePrint(bool isDetail)
+    {
+        var settings = Context.Settings;
+        var usagePrinter = new CommandUsagePrinter(this, settings)
+        {
+            IsDetail = isDetail,
+        };
+        using var sw = new StringWriter();
+        usagePrinter.Print(sw);
+        return sw.ToString();
+    }
+}
diff --git a/src/JSSoft.Commands/CommandParser.cs b/src/JSSoft.Commands/CommandParser.cs
@@ -44,7 +44,7 @@ public void Parse(string[] args)
         var instance = Instance;
         var memberDescriptors = CommandDescriptor.GetMemberDescriptors(instance);
         var settings = Settings;
-        var parserContext = ParseContext.Create(memberDescriptors, args);
+        var parserContext = ParseContext.Create(memberDescriptors, args, settings);
         parserContext.SetValue(instance, settings);
     }
 

diff --git a/src/JSSoft.Commands/CommandSettings.cs b/src/JSSoft.Commands/CommandSettings.cs
@@ -8,6 +8,7 @@
 
 using System.ComponentModel;
 using System.Diagnostics;
+using System.Globalization;
 using JSSoft.Commands.Extensions;
 using static JSSoft.Commands.CommandUtility;
 
@@ -87,6 +88,10 @@ public int IndentSpaces
 
     public Predicate<string> CategoryPredicate { get; init; } = DefaultCategoryPredicate;
 
+    public IServiceProvider? ServiceProvider { get; init; }
+
+    public CultureInfo? CultureInfo { get; init; }
+
     internal static TimeSpan AsyncTimeout { get; } = TimeSpan.FromSeconds(1);
 
     internal static BindingFlags GetBindingFlags(Type type)
@@ -176,4 +181,8 @@ internal bool ContainsVersionOption(string[] args)
 
     internal string GetLabelString(string label)
         => GetLabelString(label, LabelWidth, IndentSpaces);
+
+    internal ITypeDescriptorContext? CreateTypeDescriptorContext()
+        => ServiceProvider is not null
+            ? new TypeDescriptorContext(ServiceProvider) : null;
 }
diff --git a/src/JSSoft.Commands/ParseContext.cs b/src/JSSoft.Commands/ParseContext.cs
@@ -29,12 +29,14 @@ public ParseContext(CommandMemberDescriptorCollection memberDescriptors)
     public ParseDescriptor? Descriptor { get; private set; }
 
     public static ParseContext Create(
-        CommandMemberDescriptorCollection memberDescriptors, string[] args)
+        CommandMemberDescriptorCollection memberDescriptors,
+        string[] args,
+        CommandSettings settings)
     {
         try
         {
             var parseContext = new ParseContext(memberDescriptors);
-            parseContext.Next(args);
+            parseContext.Next(args, settings);
             return parseContext;
         }
         catch (Exception e)
@@ -43,11 +45,11 @@ public static ParseContext Create(
         }
     }
 
-    public void Next(params string[] args)
+    public void Next(string[] args, CommandSettings settings)
     {
         foreach (var arg in args)
         {
-            Next(arg);
+            Next(arg, settings);
         }
     }
 
@@ -157,7 +159,7 @@ private static void ThrowIfInvalidValue(ParseDescriptorCollection parseDescripto
         return _variablesDescriptor;
     }
 
-    private void Next(string arg)
+    private void Next(string arg, CommandSettings settings)
     {
         if (_memberDescriptors.FindByOptionName(arg) is { } memberDescriptor)
         {
@@ -239,11 +241,11 @@ private void Next(string arg)
             if (descriptor == _variablesDescriptor)
             {
                 _variableList.Add(arg);
-                descriptor.SetVariablesValue([.. _variableList]);
+                descriptor.SetVariablesValue([.. _variableList], settings);
             }
             else
             {
-                descriptor.SetValue(arg);
+                descriptor.SetValue(arg, settings);
                 Descriptor = FindNextDescriptor(descriptor);
             }
         }