All Versions
Latest Version
Avg Release Cycle
Latest Release

Changelog History
Page 1

  • v4.0.0-beta.74 Changes

    ๐Ÿ›  Fixes:

    • ๐Ÿ‘ท [@natemcmaster]: fix new CI to correctly publish symbols to
    • [@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)
  • v4.0.0-beta.56 Changes

    ๐Ÿ”‹ Features

    • 0๏ธโƒฃ [@scott-xu] and [@natemcmaster]: feature: add API for setting default value on options and arguments, and display them in help text (#389 and #420)
    • [@natemcmaster]: cleanup: make .Values read-only on CommandArgument/Option (#406)
    • [@natemcmaster]: Make options, arguments, and commands read-only collections on CommandLineApplication (#407)

    ๐Ÿ›  Fixes

    • [@natemcmaster]: fix: pass the generic argument version in callback on .Option() and Argument() (#405)
    • [@natemcmaster]: add .NET Standard 2.1 and fix nullable type references (#424 and #425)


    • [@natemcmaster]: change from Azure DevOps to GitHub workflows
  • v3.1.0 Changes

    ๐Ÿ‘Œ 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<TApp> 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 option/argument (#390)
    • โšก๏ธ [@scott-xu]: update help text to show allowed values from AllowedValues attribute instead of Enum values (#391)

    ๐Ÿ“„ Docs

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


    • 0๏ธโƒฃ [@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
  • v3.0.0 Changes

    ๐Ÿ‘Œ 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)
    • 0๏ธโƒฃ @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 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
  • v2.6.0 Changes

  • v2.5.1 Changes

    • ๐Ÿ›  Fix #320 - lazy load command object types to reduce unnecessary allocations
  • v2.5.0 Changes

    • ๐Ÿ›  Fix #92 by @kbilsted - Show enum names in help text for Options and Arguments stored as enum
    • ๐Ÿ›  Fix #287 by @Alxandr - Add support for private base type options
    • ๐Ÿ›  Fix #303 by @AndreGleichner - Update generated help to display [command] first then [options]
    • ๐Ÿ›  Fix #307 by @daveMueller - Update help text generator to display HelpOption correctly
  • v2.4.4 Changes

    • ๐Ÿ›  Fix #302 - fix regression introduced in 2.4.2 which caused Ctrl+C handling not to terminate the process quickly
  • v2.4.3 Changes

  • v2.4.2 Changes

    • ๐Ÿ›  Fix #286 - fix deadlock in CTRL+C handling on Windows