Make the help customiztaion "easier"
还没有人认领这个 Issue。
评估
调研方向
先从链接的帮助自定义文档开始，然后追踪 SynchronousCommandLineAction、AsynchronousCommandLineAction、AnonymousSynchronousCommandLineAction、AnonymousAsynchronousCommandLineAction、SetAction，以及根命令对 HelpOption 和 VersionOption 的处理。将提议的 public class、delegate 替代方案和 helper method 与当前 API 进行比较，并将所接受的设计、测试和文档更新定义为完成标准。
由索引模型根据 Issue 内容生成。
描述
The documentation (https://learn.microsoft.com/en-us/dotnet/standard/commandline/how-to-customize-help) shows that when the user wants to customize the help he needs to write a lot of unnecessary code. Create a class which in inherited from SynchronousCommandLineAction / AsynchronousCommandLineAction, find the HelpOption, etc...
I'd suggest you to simplify this.
For example:
- the
AnonymousSynchronousCommandLineAction/AnonymousAsynchronousCommandLineActionclasses (which are used in theSetActionmethods) could be public. So the user can write this:
defaultHelpOption.Action = new AnonymousSynchronousCommandLineAction(parseResult =>
{
Console.WriteLine("HEADER");
return oldAction.Invoke(parseResult);
});
- or replace the XXCommandLineAction classes with just simple delegates:
public delegate int SynchronousCommandLineAction(ParseResult parseResult);
public delegate Task<int> AsynchronousCommandLineAction(ParseResult parseResult, CancellationToken cancellationToken);
- add helper methods to the root command which returns the Help and
VersionOptions
- 主要语言
- C#
- 星标
- 3.7k
- 派生
- 434
- 平均合并
- 4 小时 46 分钟
- 30 天内合并 PR
- 1
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
dotnet/command-line-api 的其他 Issue
-
German localization is incomplete可能已有人在做 @b-v-d-e-v 于 8 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 65/100
dotnet/command-line-api#2852 ·
-
Incomplete French (fr) translation: RequiredOptionWasNotProvided not translated可能已有人在做 @JPBlanc 于 106 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 65/100
dotnet/command-line-api#2822 · 1 条评论 ·
-
难度 2/5 1-3 小时 新手友好度 62/100
dotnet/command-line-api#2792 · 2 条评论 · 16 个 reaction ·
-
难度 2/5 1-3 小时 新手友好度 62/100
dotnet/command-line-api#2704 ·
-
GetCompletions should check exit code of invoked application可能已有人在做 @baradgur 于 1277 天前认领。 未关闭Area-Completions bug help wanted
难度 2/5 1-3 小时 新手友好度 72/100
dotnet/command-line-api#2137 · 1 条评论 · 3 个 reaction ·
查看 dotnet/command-line-api 的全部 Issue
相似的 Issue
-
has-image has-readme needs-attention new-tool repo-verified
难度 1/5 1-3 小时 新手友好度 62/100
shanselman/TinyToolTown#844 · 2 条评论 ·
维护者通常 3 天内回复
-
难度 2/5 1-3 小时 新手友好度 62/100
维护者通常 2 天内回复
-
难度 2/5 1-3 小时 新手友好度 62/100
PCL-Community/PCL-CE#3658 ·
维护者通常 1 天内回复
-
Deploy & Patch-issues opprettes ikke: create-pnd-issues.yml har feilet hver uke siden 2025-09-08未关闭
难度 2/5 1-3 小时 新手友好度 62/100
Altinn/altinn-auth#4359 ·
维护者通常 1 天内回复
-
アプリ: チャット 優先: 中 提案
难度 2/5 1-3 小时 新手友好度 70/100
yksr-melt/Meltype#243 · 1 条评论 ·
维护者通常 1 天内回复