Changelog History
Page 1
-
v0.17.0.0 Changes
February 01, 2022๐ง Make tabulation width configurable in usage texts.
๐ Separate program name and description in ParserHelp type.
โ Add
helperWith
function, which can be easily used to localize the help flag.๐ Improve usage texts when command names are long.
๐ Improve Documentation.
-
v0.16.1
November 20, 2020 -
v0.16.1.0 Changes
November 21, 20200๏ธโฃ Guard
process
dependency behind an on by default flag. This allows one to shrink the dependency tree significantly by turning off the ability to use bash completion actions.โ Remove
bytestring
dependency from the test suite.
-
v0.16.0 Changes
August 13, 2020โ Add
Options.Applicative.NonEmpty.some1
function, which
๐ parses options the same assome1
from base, but doesn't
cause duplicates in the usage texts.Further improve help text generation in the presence
of optional values when nesting is involved, and many and
some when displayed with a suffix.โ Add "global" options to the usage texts for subcommands.
When using subcommands, a "global options" section can
now appear below the options and commands sections.Global options are off by default, to enable them, use
thehelpShowGlobals
modifier.๐ The
noGlobal
builder will suppress a single option being
displayed in the global options list.๐ Fixes issues:
- # 175 - List detailed subparser documentation with
--help
- # 294 - Displaying global options when listing options for a command.
- # 359 - Subcommand help text lacks required parent command arguments
๐ Allow the
--help
option to take the name of a command.
Usage without any arguments is the same, but now, when an
argument is given, if it is the name of a currently
reachable command, the help text for that command will
be show.๐ Fixes issues:
- # 379 - cmd --help subcmd is not the same as cmd subcmd --help
โก๏ธ Updated dependency bounds.
โ Add builder for the all positional parser policy.
โ Remove deprecated functions
- nullOption
- execParserMaybe
- customExecParserMaybe
- # 175 - List detailed subparser documentation with
-
v0.16.0.0 Changes
August 14, 2020โ Add
Options.Applicative.NonEmpty.some1
function, which parses options the same assome1
from base, but doesn't cause duplicates in the usage texts.Further improve help text generation in the presence of optional values when nesting is involved, and many and some when displayed with a suffix.
โ Add "global" options to the usage texts for subcommands. When using subcommands, a "global options" section can now appear below the options and commands sections.
Global options are off by default, to enable them, use the
helpShowGlobals
modifier.The
noGlobal
builder will suppress a single option being displayed in the global options list.Fixes issues: * # 175 - List detailed subparser documentation with
--help
* # 294 - Displaying global options when listing options for a command. * # 359 - Subcommand help text lacks required parent command arguments- ๐ Allow the
--help
option to take the name of a command. Usage without any arguments is the same, but now, when an argument is given, if it is the name of a currently reachable command, the help text for that command will be show.
Fixes issues: * # 379 - cmd --help subcmd is not the same as cmd subcmd --help
โก๏ธ Updated dependency bounds.
โ Add builder for the all positional parser policy.
โ Remove deprecated functions
- nullOption
- execParserMaybe
- customExecParserMaybe
-
v0.15.1 Changes
September 12, 2019- ๐ Improve printing of brief descriptions for parsers.
๐ Previously, the logical structure of the parser,
such as alternative groups and segments which must
be defined together, did not influence the layout of
the brief description. This could lead to some help
texts being difficult to read. Now, we use nesting
and forced line breaks to help improve readability.
- ๐ Improve printing of brief descriptions for parsers.
-
v0.15.1.0 Changes
September 12, 2019- ๐ Improve printing of brief descriptions for parsers. Previously, the logical structure of the parser, such as alternative groups and segments which must be defined together, did not influence the layout of the brief description. This could lead to some help texts being difficult to read. Now, we use nesting and forced line breaks to help improve readability.
-
v0.15.0 Changes
July 06, 2019โ Add support for GHC 8.8.1.
โ Add
subparserInline
modifier as additional way of
๐ executing subparsers. When activated, the subparser
๐ parse tree will be inserted into that of the parent
instead of being run independently, allowing mixing
of child and parent options.๐ Improve rendering of complex nested parse structures.
Previously, brackets and parenthesis did not respect
whether or not options had to be defined together.
๐ Now the parse tree is more accurately represeted in
the help text.โ Add
helpLongEquals
modifier, which will change how
๐จ long options are printed in the help text, adding an
equals sign, for example "--input=FILE".โก๏ธ Updated dependency bounds.
๐ Clean ups and Documentation.
-
v0.15.0.0 Changes
July 05, 2019โ Add support for GHC 8.8.1.
โ Add
subparserInline
modifier as additional way of executing subparsers. When activated, the subparser parse tree will be inserted into that of the parent instead of being run independently, allowing mixing of child and parent options.๐ Improve rendering of complex nested parse structures. Previously, brackets and parenthesis did not respect whether or not options had to be defined together. Now the parse tree is more accurately represented in the help text.
โ Add
helpLongEquals
modifier, which will change how long options are printed in the help text, adding an equals sign, for example "--input=FILE".โก๏ธ Updated dependency bounds.
๐ Clean ups and Documentation.
-
v0.14.3 Changes
May 13, 2019โก๏ธ Updated dependency bounds.
๐ Fix tab completion with Commands being unreachable.
๐ Clean ups and Documentation.