docfx Bump System.CommandLine from 2.0.0-beta1.20574.7 to 2.0.0-beta3.22114.1

Bumps System.CommandLine from 2.0.0-beta1.20574.7 to 2.0.0-beta3.22114.1.

Release notes

Sourced from System.CommandLine's releases.

System.CommandLine v2.0.0-beta2.21617.1

For details on the Beta 2 release, please see #1537.

System.CommandLine v2.0.0-beta1.21216.1

What's new

It's been a while since our last beta release because as we approach the 2.0 milestone, we're making more breaking changes, and we're trying to group them into fewer releases in order to minimize churn.

System.CommandLine
Added an Argument.LegalFileNamesOnly extension method to improve file validations. (Thanks, @AronParker !)

Made significant improvements to HelpBuilder to enable more fine-grained customization of help output. (Thanks, @Keboo!)

Added an optional description parameter to an Argument<T> constructor to match Option<T>. (Thanks, @database64128!)

CommandHandler.Create can now specify abstract methods, which can vary by the derived class at invocation time. (Thanks, @ycrumeyrolle!)

Improved support for POSIX bundled arguments when no delimiter is used. (Thanks, @sfoslund)

Ahora se puede localizar la ayuda (pero todavia se necesita marcar -h para pedirla 🤔). (Thanks, @Keboo!)

Added XML documentation for a number of types. (Thanks, @pieter-venter!)

Added a ParseResult parameter to Symbol.GetSuggestions and to the signature for SuggestDelegate. The GetSuggestions change is not a source-breaking change because we've also added an extension method supporting the older signature. (Thanks, @thoemmi!)

Fixed a bug where trailing spaces would break response file parsing. (Thanks, @hackf5!)

Introduced IIdentifierSymbol, which Option and Command implement, but Argument does not.

Enabled customization of exit codes on error by passing an exitErrorCode argument to various CommandLineBuilder methods: UseExceptionHandler, UseParseDirective, UseParseErrorReporting, and UseVersionOption. (Thanks, @Keboo!)

Custom argument parsers using ParseArgument<T> can now partially consume tokens using ArgumentResult.OnlyTake(int), allowing other symbols to consume the remaining tokens.

CommandHandler.Create now provides overloads for up to 16 parameters. We used to go to 11, but it wasn't enough.

The debug directive now requires opt-in from the user, in order to prevent it from being used maliciously to block a process. (Thanks, @Keboo!)
Numerous performance improvements, benefitting speed and memory footprint. (Thanks, @paulomorgado!) Here's a sample:
BenchmarkDotNet=v0.12.1, OS=Windows 10.0.19042
Intel Core i7-6700 CPU 3.40GHz (Skylake), 1 CPU, 8 logical and 4 physical cores
.NET Core SDK=5.0.300-preview.21180.15
[Host]    : .NET Core 5.0.5 (CoreCLR 5.0.521.16609, CoreFX 5.0.521.16609), X64 RyuJIT
MediumRun : .NET Core 5.0.5 (CoreCLR 5.0.521.16609, CoreFX 5.0.521.16609), X64 RyuJIT
Job=MediumRun  Force=True  IterationCount=15

LaunchCount=2  RunStrategy=ColdStart  WarmupCount=10

... (truncated)

Commits

See full diff in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

@dependabot rebase will rebase this PR
@dependabot recreate will recreate this PR, overwriting any edits that have been made to it
@dependabot merge will merge this PR after your CI passes on it
@dependabot squash and merge will squash and merge this PR after your CI passes on it
@dependabot cancel merge will cancel a previously requested merge and block automerging
@dependabot reopen will reopen this PR if it is closed
@dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
@dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
@dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
@dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

Mar 09 '22 12:03 dependabot[bot]

@dependabot rebase

Mar 09 '22 12:03 herohua

/azp run

Mar 10 '22 04:03 herohua

Azure Pipelines successfully started running 1 pipeline(s).

Mar 10 '22 04:03 azure-pipelines[bot]

/azp run

Mar 12 '22 02:03 herohua

Azure Pipelines successfully started running 1 pipeline(s).

Mar 12 '22 02:03 azure-pipelines[bot]

@dependabot rebase

Apr 24 '22 02:04 herohua

/azp run

Apr 24 '22 02:04 herohua

Azure Pipelines successfully started running 1 pipeline(s).

Apr 24 '22 02:04 azure-pipelines[bot]

/azp run

Apr 27 '22 07:04 herohua

Azure Pipelines successfully started running 1 pipeline(s).

Apr 27 '22 07:04 azure-pipelines[bot]

A newer version of System.CommandLine exists, but since this PR has been edited by someone other than Dependabot I haven't updated it. You'll get a PR for the updated version as normal once this PR is merged.

Jun 06 '22 07:06 dependabot[bot]

OK, I won't notify you again about this release, but will get in touch when a new version is available. If you'd rather skip all updates until the next major or minor version, let me know by commenting @dependabot ignore this major version or @dependabot ignore this minor version. You can also ignore all major, minor, or patch releases for a dependency by adding an ignore condition with the desired update_types to your config file.

If you change your mind, just re-open this PR and I'll resolve any conflicts on it.

Oct 19 '22 05:10 dependabot[bot]