adds support for command options

Extends the command-line interface generator to support additional options for commands.

This enhancement allows specifying options with their descriptions, aliases, and required status, improving flexibility.

Author: arturcic

new-cli/.run/TestCommand.run.xml

@@ -1,7 +1,7 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="TestCommand" type="DotNetProject" factoryName=".NET Project">
     <option name="EXE_PATH" value="$PROJECT_DIR$/GitVersion.Cli/bin/Debug/net9.0/gitversion" />
-    <option name="PROGRAM_PARAMETERS" value="test --input-file test.txt" />
+    <option name="PROGRAM_PARAMETERS" value="test -i test.txt" />
     <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
     <option name="PASS_PARENT_ENVS" value="1" />
     <option name="USE_EXTERNAL_CONSOLE" value="0" />

new-cli/GitVersion.Cli.Generator.Tests/SystemCommandlineGeneratorTests.cs

@@ -40,17 +40,38 @@ public class TestCommandImpl : Command, ICommandImpl
     public string CommandImplName => nameof(TestCommandImpl);
     public string ParentCommandImplName => string.Empty;
     // Options list
+    protected readonly Option<System.IO.FileInfo?> LogFileOption;
     protected readonly Option<string> OutputFileOption;
+    protected readonly Option<GitVersion.Infrastructure.Verbosity?> VerbosityOption;
+    protected readonly Option<System.IO.DirectoryInfo?> WorkDirOption;
 
     public TestCommandImpl(TestCommand command)
         : base("test", "Test description.")
     {
-        OutputFileOption = new Option<string>("--output-file", [])
+        LogFileOption = new Option<System.IO.FileInfo?>("--log-file", "-l")
+        {
+            Required = false,
+            Description = "The log file",
+        };
+        OutputFileOption = new Option<string>("--output-file")
         {
             Required = true,
             Description = "The output file",
         };
+        VerbosityOption = new Option<GitVersion.Infrastructure.Verbosity?>("--verbosity")
+        {
+            Required = false,
+            Description = "The verbosity of the logging information",
+        };
+        WorkDirOption = new Option<System.IO.DirectoryInfo?>("--work-dir")
+        {
+            Required = false,
+            Description = "The working directory with the git repository",
+        };
+        Add(LogFileOption);
         Add(OutputFileOption);
+        Add(VerbosityOption);
+        Add(WorkDirOption);
 
         this.SetAction(Run);
         return;
@@ -59,7 +80,10 @@ Task<int> Run(ParseResult parseResult, CancellationToken cancellationToken)
         {
             var settings = new TestCommandSettings
             {
+                LogFile = parseResult.GetValue(LogFileOption),
                 OutputFile = parseResult.GetValue(OutputFileOption)!,
+                Verbosity = parseResult.GetValue(VerbosityOption),
+                WorkDir = parseResult.GetValue(WorkDirOption),
             };
             return command.InvokeAsync(settings, cancellationToken);
         }
@@ -198,7 +222,7 @@ public Task<int> InvokeAsync(TestCommandSettings settings, CancellationToken can
 
 namespace {{Constants.CommandNamespaceName}};
 
-public record TestCommandSettings
+public record TestCommandSettings : GitVersionSettings
 {
   [Option("--output-file", "The output file")]
   public required string OutputFile { get; init; }

new-cli/GitVersion.Cli.Generator/CommandBaseGenerator.cs

@@ -92,14 +92,13 @@ private static SettingsPropertyInfo MapToPropertyInfo(IPropertySymbol propertySy
         name.NotNull();
         description.NotNull();
 
-        var alias = string.Empty;
+        string[] aliases = [];
         if (ctorArguments.Length == 3)
         {
             var aliasesArgs = ctorArguments[2];
-            var aliases = (aliasesArgs.Kind == TypedConstantKind.Array
+            aliases = (aliasesArgs.Kind == TypedConstantKind.Array
                 ? aliasesArgs.Values.Select(x => Convert.ToString(x.Value)).ToArray()
-                : [Convert.ToString(aliasesArgs.Value)]).Select(x => $@"""{x?.Trim()}""");
-            alias = string.Join(", ", aliases);
+                : [Convert.ToString(aliasesArgs.Value)]);
         }
 
         var isRequired = propertySymbol.IsRequired;
@@ -108,7 +107,7 @@ private static SettingsPropertyInfo MapToPropertyInfo(IPropertySymbol propertySy
             Name = propertySymbol.Name,
             TypeName = propertySymbol.Type.ToDisplayString(),
             OptionName = name,
-            Aliases = alias,
+            Aliases = aliases,
             Description = description,
             Required = isRequired
         };

new-cli/GitVersion.Cli.Generator/Models.cs

@@ -17,7 +17,7 @@ internal record SettingsPropertyInfo
     public required string Name { get; init; }
     public required string TypeName { get; init; }
     public required string OptionName { get; init; }
-    public required string Aliases { get; init; }
+    public required string[] Aliases { get; init; }
     public required string Description { get; init; }
     public required bool Required { get; init; }
 }

new-cli/GitVersion.Cli.Generator/SystemCommandlineContent.cs

@@ -30,7 +30,7 @@ public class {{Model.CommandTypeName}}Impl : Command, ICommandImpl
         : base("{{Model.CommandName}}", "{{Model.CommandDescription}}")
     {
         {{~ for $prop in $settingsProperties ~}}
-        {{$prop.Name}}Option = new Option<{{$prop.TypeName}}>("{{$prop.OptionName}}", [{{$prop.Aliases}}])
+        {{$prop.Name}}Option = new Option<{{$prop.TypeName}}>("{{$prop.OptionName}}"{{if $prop.Aliases.size == 0}}{{else}}, {{for $alias in $prop.Aliases}}"{{$alias}}"{{if !for.last}}, {{end}}{{end}}{{end}})
         {
             Required = {{$prop.Required}},
             Description = "{{$prop.Description}}",