4.0.0-beta.74

Fixes

@natemcmaster: fix new CI to correctly publish symbols to nuget.org
@scott-xu: show option types in help text when OptionAttribute.Template is set (#429)
@skirchner989: change to not throw when a validator is not of type AttributeValidator (#431)

Notes

Packages have been posted to these feeds:

NuGet.org

https://nuget.org/packages/McMaster.Extensions.CommandLineUtils/4.0.0-beta.74
https://nuget.org/packages/McMaster.Extensions.Hosting.CommandLine/4.0.0-beta.74

GitHub Package Registry

https://github.com/natemcmaster?tab=packages&repo_name=CommandLineUtils

4.0.0-beta.56

See changes in https://github.com/natemcmaster/CommandLineUtils/blob/main/CHANGELOG.md

Packages have been posted to these feeds:

NuGet.org

https://nuget.org/packages/McMaster.Extensions.CommandLineUtils/4.0.0-beta.56
https://nuget.org/packages/McMaster.Extensions.Hosting.CommandLine/4.0.0-beta.56

GitHub Package Registry

https://github.com/natemcmaster?tab=packages&repo_name=CommandLineUtils

3.1.0

Get the update from https://www.nuget.org/packages/McMaster.Extensions.CommandLineUtils/3.1.0

Improvements

• @scott-xu: Show allowed values in help text (#369)
• @scott-xu: Generic Hosting: add overload of RunCommandLineApplicationAsync to support configuring of CommandLineApplication (#363)
• @danielmeza: implement API on host builder to fetch CommandLineContext from non DI contexts (#368)
• @hellfirehd and @cbcrouse: feature: add API to allow calling UseCommandLineApplication prior to Run*Async() (#409 and #415)

Bug fixes

• @natemcmaster: ensure clustering options is detected correctly when subcommands added via AddSubcommand (#393)
• @scott-xu: make UnrecognizedArgumentHandling per command scope (#371)
• @scott-xu: show allowed values in help text correctly when multiple AllowedValuesAttribute are used (#375)
• @scott-xu: show allowed values in help text for Nullable/ValueTuple<bool,T> option/argument (#390)
• @scott-xu: update help text to show allowed values from AllowedValues attribute instead of Enum values (#391)

Docs

• @chaami: Fix Readme.md on Prompt.GetYesNo (#402)
• @cuperman007 docs: added using statements to code sample in index.md (#384)
• @scott-xu: Fix broken links in docs (#377)
• @scott-xu: cleanup: add a period to end sentences for built-in descriptions (#364)

Other

• @natemcmaster: Change default branch to 'main' (#373)
• @natemcmaster: Stop code signing binaries and packages (#379)
• @natemcmaster: add dotnet-format to CI, and other code/project file cleanups

Changes:

• 9f57dfe Update changelog and releasenotes
• 9b91cfb Move PublicAPI to 'shipped'
• 2c3b8b5 cleanup: upgrade dependencies
• f5938c8 cleanup: further code deduplication on new hosting APIs (#416)
• 643f9c3 refactor: code deduplication and added/fixed tests for new hosting APIs (#415)
• 47d1194 feature: expand Microsoft.Extensions.Hosting support to allow work to be done prior to Run*Async() (#409)
• bcf20ed cleanup: update .editorconfig
• df0a511 cleanup: fixup more references to 'master'
• 7d705cc cleanup: upgrade Linux CI to latest ubuntu version (#412)
• 29ecc17 cleanup: upgrade test projects and CI to .NET 5 (#411)

See More

• 760247d fix: late bind parsers for attribute-discovered options & arguments (#398)
• 4f686fe fix: treat null as 'true' by default when parsing Nullable types on command options (#397)

This list of changes was auto generated.

3.1.0-rc.371

Changes:

• e621724 docs: update changelog.md and releasenotes for 3.1 release
• 2d6365e cleanup: update test dependencies
• 4b13f2e Fix Readme.md on Prompt.GetYesNo (#402)

This list of changes was auto generated.

3.1.0-beta.356

Changes:

• 14db834 Add dotnet-format to build.ps1
• c4547a6 cleanup: run dotnet-format on samples
• 0309d1c cleanup: exclude TestResults in solution explorer
• f160e87 cleanup: run code formatters and cleanups
• 21a73b3 fix: ensure clustering options is detected correctly when subcommands added via AddSubcommand (#393)
• 0c9fe6b fix: show allowed values in help text for Nullable/ValueTuple<bool,T> option/argument (#390)
• 569b913 fix: update help text to show allowed values from AllowedValues attribute instead of Enum values (#391)

This list of changes was auto generated.

3.1.0-beta.336

Changes:

• 497f598 fix: show allowed values in help text correctly when multiple AllowedValuesAttribute are used (#375)
• 17476ab fix: make UnrecognizedArgumentHandling per command scope (#371)
• e556ca6 docs: added using statements to code sample in index.md (#384)
• 3c9dcee Stop code signing binaries and packages
• 59781ae Enable nullability annotations in public API docs
• a40c932 Fix broken links in docs (#377)
• e22e3ed Change default branch to 'main' (#373)
• 7bf9c0d Show allowed values in help text
• 68a3a7b feature: implement API on host builder to fetch CommandLineContext from non DI contexts (#368)
• 5f9e167 feature, generic-host: add overload of RunCommandLineApplicationAsync to support configuring of CommandLineApplication (#363)

See More

• 6e919b6 cleanup: add a period to end sentences for built-in descriptions (#364)
• 2e50a14 Update version to 3.1.0

This list of changes was auto generated.

3.0.0

See changes since 2.6.0

https://www.nuget.org/packages/McMaster.Extensions.CommandLineUtils/3.0.0
https://www.nuget.org/packages/McMaster.Extensions.Hosting.CommandLine/3.0.0

Improvements

• @AlexeyEvlampiev - implement support for GUID command line options (#333) and any other type that TypeConverter supports (#62)
• @vpkopylov - Added support for using the 'builder API' with generic host (#351)
• @natemcmaster - Disabled the pager for help text by default. To re-enable, set UsePagerForHelpText = true. (#346)
• @natemcmaster - Fix PlatformNotSupportedException on Xamarin of macOS (#344)

Breaking changes

See https://natemcmaster.github.io/CommandLineUtils/v3.0/upgrade-guide.html for more details.

• Fix #251 by @mattnischan - remove API that was marked as obsolete in 2.x releases
• Fix #294 by @natemcmaster - change dependencies on McMaster.Extensions.Hosting.CommandLine to just use Microsoft.Extensions.Hosting.Abstractions
• Fix #337 by @natemcmaster - removed .NET Standard 1.6 target from library

3.0.0 Release Candidate

Other than documentation and release note changes, I'm not planning anything else unless I receive more feedback about issues.

https://www.nuget.org/packages/McMaster.Extensions.CommandLineUtils/3.0.0-rc.289
https://www.nuget.org/packages/McMaster.Extensions.Hosting.CommandLine/3.0.0-rc.289

Changes:

• 7281ee9 Prepare 3.0 RC release
• f3a4725 fix: suppress PlatformNotSupportedException on Xamarin of macOS
• 294a829 Minor cleanup and update release notes
• accdd6c feature: support using builder API with generic host (#351)
• cf7506c Merge branch 'release/2.x'
• 2eb7bfa fixup: cleanup obsolete messages for throwOnUnexpectedArg

This list of changes was auto generated.

2.6.0

This release takes steps to prepare for the 3.0 release by marking more API as obsolete that will be removed in the next major version.

This release contains no other major functional changes from 2.5.

Changes:

• 2eb7bfa fixup: cleanup obsolete messages for throwOnUnexpectedArg
• 37da4ee fix: obsolete the public constructor on PhysicalConsole in favor of PhysicalConsole.Singleton
• 42b8994 refactor: obsolete throwOnUnexpectedArg in favor of UnrecognizedArgumentHandling enum
• 11e2079 Bump version to 2.6.0

This list of changes was auto generated.

3.0.0-alpha.268

First pre-release of 3.0

https://www.nuget.org/packages/McMaster.Extensions.CommandLineUtils/3.0.0-alpha.268
https://www.nuget.org/packages/McMaster.Extensions.Hosting.CommandLine/3.0.0-alpha.268

Changes:

• 2b502c4 Support collecting all unrecognized arguments after parsing known args (#348)
• 1769146 Merge branch 'release/2.x'
• dc40fab Update CHANGELOG.md
• b9eb55b fix: set UsePagerForHelpText to false by default (#347)
• 53e19fc cleanup: simplify implementation of TypeDescriptor support and make code formatting consistent
• dc17772 feature: support TypeConverter for parsing types like GUID, DateTime, and others as command line options and (#345)
• c18ac70 feature: add UsePagerForHelpText to CommandAttribute. (#343)
• ea347af fix: make VersionOptionFromAssemblyAttributes an extension method, as originally intended [ #297 ]
• e07893a fix: remove empty HandleParseResult override
• e61c44e fix: actually make PhysicalConsole a singleton

See More

• 63aa24a Remove more obsolete API - throwOnUnexpectedArgs
• ebf05f5 Merge branch 'release/2.x'
• 1de7d64 cleanup: remove usages of TypeInfo
• 578f662 Remove .NET Standard 1.6 target framework
• eb4b8e2 fix: only reference hosting abstractions from Hosting.CommandLine (#336)
• c5984b5 Update CHANGELOG, run code formatter, and remove some duplicate code
• dba5ef4 cleanup: remove obsolete APIs (#335)
• b63f5e6 Merge branch 'release/2.x'
• 0a473a9 Bump version to 3.0 (#331)

This list of changes was auto generated.