I really like this project and use it often in my own CLI work.
Over time I collected many ideas and fixes I wanted to apply, but upstream has been mostly quiet for a long time (there was some activity a couple of years ago, then another long pause). Because the change set became too large for a realistic upstream PR flow, I published a separate fork with its own version history.
The fork is intended to stay mostly drop-in compatible for existing users, with only a small number of explicit behavior differences. Details are documented in the changelog (v0.1.0).
Repository: https://github.com/WoozyMasta/flags
Docs: https://woozymasta.github.io/flags/
go get github.com/woozymasta/flags
Current status: v0.1.0 (stabilization before v1.0.0 roadmap).
Short feature list:
- help output overhaul (layout, grouping, sorting) and rendering fixes
- completion: bash / zsh / pwsh (+ auto-detection)
- native custom-type support via
encoding.TextMarshaler / encoding.TextUnmarshaler
- localization (i18n)
- built-in color schemes (help/errors/version)
- docs rendering: markdown / html / man and custom documentation templates
- broader programmatic configuration API
- opt-in built-in commands (
help, version, completion, docs, config)
- many new tags and parser capabilities
Upgrade notes
I really like this project and use it often in my own CLI work.
Over time I collected many ideas and fixes I wanted to apply, but upstream has been mostly quiet for a long time (there was some activity a couple of years ago, then another long pause). Because the change set became too large for a realistic upstream PR flow, I published a separate fork with its own version history.
The fork is intended to stay mostly drop-in compatible for existing users, with only a small number of explicit behavior differences. Details are documented in the changelog (
v0.1.0).Repository: https://github.com/WoozyMasta/flags
Docs: https://woozymasta.github.io/flags/
Current status:
v0.1.0(stabilization beforev1.0.0roadmap).Short feature list:
encoding.TextMarshaler/encoding.TextUnmarshalerhelp,version,completion,docs,config)Upgrade notes