• Declare support for Python 3.12 (#279)

• Declare support for Python 3.11 and drop support for Python 3.7 (#275)
• Stop converting argument's bool default value to DefaultInt (#273)

• Support bytearray serialization (#268)

• Enable Virtual Terminal mode on legacy Windows terminal to support ANSI escape sequences (#265)
• Drop Python 3.6 support (#259)

• Support Python 3.10 (#250)
• Only install colorama on Windows (#249)

• Always use UTF-8 for log file encoding (#247)

• Add error message for invalid argument value (#244)

• Make colors customizable (#242)
• Init colorama only in Windows legacy terminal (#238)
• Add raw_result to CommandResultItem (#235)
• Refine code style to comply with Python 3 (#232, #233)
• CI: Support Python 3.9 (#229)
• Logging: CLILogging.configure returns as early as possible (#228)

• Support multiple cli loggers by adding more logger names to knack.log.cli_logger_names list (#227)

• Make config item names case-insensitive (#220)
• get_logger uses module_name directly and no longer adds cli prefix (#221)
• CLILogging accepts a custom cli_logger_name (#221)
• Support ppc64le arch in Travis CI (#222)
• Allow customizing tag message (#223)
• Add EVENT_CLI_SUCCESSFUL_EXECUTE (#224)

• [Config] Support listing sections (#217)

• Rollback get_config_parser in config.py (#205)

• Add a default_value_source property in HelpParameter (#202)
• Support removing option/section from config file (#201)
• Support writing comment to config file (#201)
• Import configparser directly instead of from six (#201)
• Drop get_config_parser function from config.py (#201)

• Change the timing to raise EVENT_CLI_POST_EXECUTE event (#199)
• Make CLI.invoke catch SystemExit (#199)

• Change experimental tag color to cyan

• Allow disabling color (#171)
• Support yaml and yamlc output (#173)
• Drop support for python 2 and 3.5 (#174)
• Support --only-show-errors to disable warnings (#179)
• Add experimental tag (#180)

This release:

• Fixes issue where argument marked is_preview=True would not always be handled correctly.
• Fixes issue where ensuring a directory exists could cause a race condition.

• Adds ability to declare that command groups, commands, and arguments are in a preview status and therefore might change or be removed. This is done by passing the kwarg is_preview=True.
• Adds a generic StatusTag class to knack.util that allows you to create your own colorized tags like [Preview] and [Deprecated].
• When an incorrect command name is entered, Knack will now attempt to suggest the closest alternative.

Always read from local for configured_default

Support local context chained config file

This release

• Allows the loading of text files using @filename syntax.
• Adds the argument kwarg configured_default to support setting argument defaults via the config file's [defaults] section or an environment variable.

This release:

• Removes an incorrect check when adding arguments.

Updates usages of yaml.load to use yaml.safe_load.

Fix issue with some scenarios (no args and --version)

• Adds support for positional arguments with the .positional helper method on ArgumentsContext.
• Removes the necessity for the type field in help.py. This information can be inferred from the class, so specifying it causes unnecessary crashes.
• Adds support for examining the result of a command after a call to invoke. The raw object, error (if any) an exit code are accessible.
• Adds support for accessing the command instance from inside custom commands by putting the special argument cmd in the signature.
• Fixes an issue with the default config directory. It use to be .cli and is now based on the CLI name.
• Fixes regression in knack 0.4.5 in behavior when cli_name --verbose/debug is used. Displays the welcome message as intended.
• Adds ability to specify line width for help text display.

Preserves logging verbosity and output format on the namespace for use by validators.

Adds ability to set config file name. Fixes bug with argument deprecations.

Fixes issue where values were sometimes ignored when using deprecated options regardless of which option was given.

Bug fixes: [output]: disable number parse on table mode PR #88

Version 0.4.0 introduced deprecation to Knack. This release fixes a bug related to that.

• Ensures that the action kwarg is only set if the item is deprecated. Previously it would set it to "None" which would then override a pre-existing action like store_true.

Version 0.4.0 also added the concept of the command group table to the CommandsLoader class. This release corrects an issue related to that:

• The command group table would only be filled by calls to create CommandGroup classes. This resulted in some gaps in the command group table.

• Add mechanism to deprecate commands, command groups, arguments and argument options.
• Improve help display support for Unicode.

View commits since last release

• expose a callback to let client side perform extra logics (#80)
• output: don't skip false value on auto-tabulating (#83)

View commits since last release

• ArgumentsContext.ignore() should use hidden options_list (#76)
• Consolidate exception handling (#66)

View commits since last release

• Performance optimization - Delay import of platform and colorama (#47)
• CLIError: Inherit from Exception directly (#65)
• Explicitly state which packages to include (so exclude 'tests') (#68)

View commits since last release

• Support command level and argument level validators.
• knack.commands.CLICommandsLoader now accepts a command_cls argument so you can provide your own CLICommand class.
• logging: make determine_verbose_level private method.
• Allow overriding of NAMED_ARGUMENTS
• Only pass valid argparse kwargs to argparse.ArgumentParser.add_argument and ignore the rest
• logging: make determine_verbose_level private method
• Remove cli_command, register_cli_argument, register_extra_cli_argument as ways to register commands and arguments.

FULL CHANGELOG

• Add more types of command and argument loaders.
• Add tests.

FULL CHANGELOG

• Initial release