github.com/alexflint/go-arg

Hello friends. I'm pushing a release with a few minor changes so that the latest changes are available within a tagged release. As always, thanks for making use of this library, and for your all comments, questions, issues, pull requests, and discussions. Wishing you all the best for the new year.

What's Changed

• Add Regsiter, which allows go packages to define their own command line args by @alexflint in #291
• Allow hiding a subcommand using "-" for help by @zeroshade in #292
• No more positionals after a positional slice or map by @alexflint in #287

New Contributors

• @zeroshade made their first contribution in #292

Full Changelog: v1.6.0...v1.7.0

Hey friends, here is the latest go-arg. What fun. I enjoy maintaining this library a lot. Lots of contributions from new contributors since last release -- check out new contributors section below. Very impressive work everyone.

I'm working on completions support for this library. It's going to be a separate library, in a separate repository, that will (if all goes according to plan) be a general-purpose cross-language cross-shell completion-support binary. I'll then add some options in this library to make use of that project, probably mostly in the form of documentation and examples rather than any significant changes to default behavior. If you'd like to give input on any of that, please reach out via email (see email address in my github profile).

As always, sorry for all the open issues and un-merged PRs!

What's Changed

• Use standard exit status code for usage errors by @hhromic in #256
• Fix usage when using custom version flag by @hhromic in #224
• Move program version from usage to help by @hhromic in #259
• Fix help text for positional args with default and env var by @hhromic in #262
• Allow passing the string "--" twice or more by @alexflint in #273
• Add support for setting a global env var prefix by @hhromic in #258
• Make field name output consistent when using placeholders by @zanvd in #276
• Fix Missing Global Options by @Areson in #278
• Improve handling of negative numbers by @alexflint in #285

New Contributors

• @purpleidea made their first contribution in #237
• @testwill made their first contribution in #233
• @zanvd made their first contribution in #276
• @Areson made their first contribution in #278

Full Changelog: v1.6.0...v1.5.2

• Fixes a bug introduced in v1.5.0 where bad struct tags and other parser-level initialization problems would result in a crash rather than a clean exit in MustParse (thanks @hhromic !)

• Argument structs can define Description() and Epilogue(), which are added to the usage string

• Subcommands can have multiple aliases like this:

var args struct {
    Remove *struct{} `arg:"subcommand:remove|rm|r" help:"remove something from somewhere"`
}

• Improves formatting of usage string when the placeholder tag is set to empty string

• Do not handle --version when the args struct lacks a Version() function

• Add StructSubcommands to Config struct

• Correctly brackets non-required positional arguments in usage strings
• Fixes help and usage strings for subcommands.
• Add native support for url.URL via go-scalar
• Add environment variables names to error messages when relevant

This patch release fixes a regression in which unexported embedded structs were mistakenly being ignored.

Minor fix for case where an environment variable containing an empty string is parsed into a slice or map.

• Adds support for parsing into a map (see #149)
• Adds support for options that have no --long version, only a -s short version (see #137)