Merge pull request #29 from dotnet-campus/t/lvyi/gnu

支持为命令行添加过滤器（这样能全局处理某些选项）

Author: kkwpsv

build/Version.props

@@ -1,5 +1,5 @@
 <Project>
   <PropertyGroup>
-    <Version>3.2.1</Version>
+    <Version>3.3.0</Version>
   </PropertyGroup>
 </Project>

samples/dotnetCampus.CommandLine.Sample/DefaultOptions.cs

@@ -0,0 +1,21 @@
+using System;
+using System.IO;
+
+using dotnetCampus.Cli.Properties;
+
+namespace dotnetCampus.Cli
+{
+    internal class DefaultOptions
+    {
+        [Option(LocalizableDescription = nameof(LocalizableStrings.SamplePropertyDescription))]
+        public string? DefaultText { get; set; }
+
+        [Option(LocalizableDescription = nameof(LocalizableStrings.SampleDirectoryPropertyDescription))]
+        public DirectoryInfo? DefaultDirectory { get; set; }
+
+        internal void Run()
+        {
+            Console.WriteLine("默认行为执行……");
+        }
+    }
+}

samples/dotnetCampus.CommandLine.Sample/Program.cs

@@ -9,6 +9,7 @@ static void Main(string[] args)
         {
             CommandLine.Parse(args, LocalizableStrings.ResourceManager)
                 .AddStandardHandlers()
+                .AddHandler<DefaultOptions>(o => o.Run())
                 .AddHandler<SampleOptions>(o => o.Run())
                 .Run();
         }

samples/dotnetCampus.CommandLine.Sample/Properties/LocalizableStrings.Designer.cs

@@ -117,6 +117,12 @@
   <resheader name="writer">
     <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
   </resheader>
+  <data name="SampleDirectoryPropertyDescription" xml:space="preserve">
+    <value>Pass any directory into this option.</value>
+  </data>
+  <data name="SampleFilePropertyDescription" xml:space="preserve">
+    <value>Pass any file into this option.</value>
+  </data>
   <data name="SamplePropertyDescription" xml:space="preserve">
     <value>Output any text passed to this option.</value>
   </data>

samples/dotnetCampus.CommandLine.Sample/Properties/LocalizableStrings.resx

@@ -117,6 +117,12 @@
   <resheader name="writer">
     <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
   </resheader>
+  <data name="SampleDirectoryPropertyDescription" xml:space="preserve">
+    <value>允许传入一个目录路径。</value>
+  </data>
+  <data name="SampleFilePropertyDescription" xml:space="preserve">
+    <value>允许传入一个文件路径。</value>
+  </data>
   <data name="SamplePropertyDescription" xml:space="preserve">
     <value>输出传入的任何类型的字符串。</value>
   </data>

samples/dotnetCampus.CommandLine.Sample/Properties/LocalizableStrings.zh-CN.resx

@@ -3,17 +3,33 @@
     "Debug": {
       "commandName": "Project"
     },
-    "--help": {
+    "Debug --help": {
       "commandName": "Project",
       "commandLineArgs": "--help"
     },
-    "--version": {
+    "Debug --version": {
       "commandName": "Project",
       "commandLineArgs": "--version"
     },
-    "sample": {
+    "Debug sample": {
       "commandName": "Project",
       "commandLineArgs": "sample --sample-property \"Hello World\""
+    },
+    "Debug sample --help": {
+      "commandName": "Project",
+      "commandLineArgs": "sample --help"
+    },
+    "Debug unknown": {
+      "commandName": "Project",
+      "commandLineArgs": "unknown --sample-property \"Hello World\""
+    },
+    "Debug unknown --help": {
+      "commandName": "Project",
+      "commandLineArgs": "unknown --help"
+    },
+    "Debug --options": {
+      "commandName": "Project",
+      "commandLineArgs": "--sample-property \"Hello World\""
     }
   }
 }

samples/dotnetCampus.CommandLine.Sample/Properties/launchSettings.json

@@ -1,4 +1,5 @@
 using System;
+using System.IO;
 
 using dotnetCampus.Cli.Properties;
 
@@ -8,10 +9,14 @@ namespace dotnetCampus.Cli
     internal class SampleOptions
     {
         [Option(LocalizableDescription = nameof(LocalizableStrings.SamplePropertyDescription))]
-        public string? SampleProperty { get; set; }
+        public string? SampleText { get; set; }
+
+        [Option(LocalizableDescription = nameof(LocalizableStrings.SampleFilePropertyDescription))]
+        public FileInfo? SampleFile { get; set; }
 
         internal void Run()
         {
+            Console.WriteLine("示例行为执行……");
         }
     }
 }

samples/dotnetCampus.CommandLine.Sample/SampleOptions.cs

@@ -1,7 +1,6 @@
 using System;
 using System.Collections;
 using System.Collections.Generic;
-using System.Collections.ObjectModel;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.Diagnostics.Contracts;
@@ -13,6 +12,7 @@
 using System.Threading.Tasks;
 using System.Web;
 
+using dotnetCampus.Cli.Compatibility;
 using dotnetCampus.Cli.Core;
 using dotnetCampus.Cli.StateMachine;
 
@@ -35,7 +35,8 @@ namespace dotnetCampus.Cli
     public sealed class CommandLine : ICommandLineHandlerBuilder, IEnumerable<ListGroupItem>
     {
         private readonly ListGroup<SingleOptimizedStrings> _optionArgs;
-        private readonly List<CommandLineVerbMatch<Task<int>>> _toMatchList = new List<CommandLineVerbMatch<Task<int>>>();
+        private readonly List<CommandLineFilterMatch> _filterCreatorList = new List<CommandLineFilterMatch>();
+        private readonly List<CommandLineTypeMatcher<Task<int>>> _toMatchList = new List<CommandLineTypeMatcher<Task<int>>>();
 
         private CommandLine(ListGroup<SingleOptimizedStrings> optionArgs, ResourceManager? resourceManager)
         {
@@ -48,10 +49,15 @@ private CommandLine(ListGroup<SingleOptimizedStrings> optionArgs, ResourceManage
         /// </summary>
         internal ResourceManager? ResourceManager { get; }
 
+        /// <summary>
+        /// 收集的过滤器。
+        /// </summary>
+        internal IReadOnlyList<CommandLineFilterMatch> FilterMatchList => _filterCreatorList;
+
         /// <summary>
         /// 收集的谓词处理方法。
         /// </summary>
-        internal IReadOnlyList<CommandLineVerbMatch<Task<int>>> ToMatchList => _toMatchList;
+        internal IReadOnlyList<CommandLineTypeMatcher<Task<int>>> VerbMatchList => _toMatchList;
 
         /// <summary>
         /// 自动查找命令行类型 <typeparamref name="T"/> 的解析器，然后解析出参数 <typeparamref name="T"/> 的一个新实例。
@@ -170,8 +176,14 @@ public T As<T>(ICommandLineOptionParser<T> parser)
             return parser.Commit();
         }
 
-        internal void AddMatch<TVerb>(Func<string?, MatchHandleResult<Task<int>>> match)
-            => _toMatchList.Add(new CommandLineVerbMatch<Task<int>>(typeof(TVerb), match));
+        internal void AddMatch(CommandLineFilterMatch filterCreator)
+            => _filterCreatorList.Add(filterCreator);
+
+        internal void AddMatch<TVerb>(CommandLineTypeMatcher<Task<int>> matcher)
+            => _toMatchList.Add(matcher);
+
+        //internal void AddMatch<TVerb>(Func<string?, CommandLineTypeMatchResult<Task<int>>> match)
+        //    => _toMatchList.Add(new CommandLineTypeMatcher<Task<int>>(typeof(TVerb), match));
 
         /// <summary>
         /// 将命令行参数转换为字符串值的字典。Key 为选项，Value 为选项后面的值。

src/dotnetCampus.CommandLine/CommandLine.cs

@@ -1,9 +1,7 @@
 using System;
 using System.Threading.Tasks;
 
-using dotnetCampus.Cli.StateMachine;
-
-using static dotnetCampus.Cli.Utils.CommandLineHelpers;
+using static dotnetCampus.Cli.Utils.CommandLineRunner;
 
 namespace dotnetCampus.Cli
 {
@@ -34,16 +32,6 @@ internal CommandLineAsyncHandlerBuilder(CommandLine commandLine)
         /// 2. 最多只会有一个谓词处理方法被执行，此方法会返回唯一那个处理方法的退出代码。
         /// </remarks>
         /// <returns>用于异步等待谓词处理方法退出代码的异步任务。</returns>
-        public Task<int> RunAsync()
-        {
-            var possibleVerb = FindPossibleVerb(CommandLine);
-            foreach (var exitCode in new HandleVerbStateMachine<Task<int>>(CommandLine.ToMatchList).Run(possibleVerb))
-            {
-                return exitCode;
-            }
-
-            ThrowIfVerbNotMatchedAsync(possibleVerb);
-            return Task.FromResult(0);
-        }
+        public Task<int> RunAsync() => RunCoreAsync(CommandLine);
     }
 }