github.com/integrii/flaggy
v1.8.0
#2334 most downloaded on Go modules
integrii/flaggy
What this package is like to depend on
Last release 10 months ago
04 Oct 2025
Ships unpredictably
gaps range from 2 weeks to 3.3 years
Some releases are documented
notes for 8 of 14 stable releases
1 version withdrawn
withdrawn after publishing
8 years old
34 releases · first in 2018
9 releases in the last 12 months
see the full history below
Release timeline
34 releases · Jul 2018 to Oct 2025Releases
latest 34-
v1.8.004 Oct 2025 -
v1.7.2-0.20250921015420-fd0925f3c95021 Sep 2025 pre-releaseNothing published for this version
-
v1.7.2-0.20250920081355-9147df756f5220 Sep 2025 pre-releaseNothing published for this version
-
v1.7.120 Sep 2025Release notes
Open source →- Implemented a fix for a rare condition wherein a positional value overlaps a subcommand with the same name.
-
v1.7.020 Sep 2025Release notes
Open source →This is a follow up v1.7.0 release after rapid re-release of v1.6.0 tag caused go module caching error. This release addresses nearly all known issues and proposed feature additions of Flaggy while retaining a no-dependency policy.
- Update module to Go 1.25
- Streamline argument delegation between parsers
- Clarify benchmark intent and document agent workflow
- Fixes #68 - Subcommands and globals are displayed in different help sections on subcommands
- Refactored help output logic
- Fixes #96 - Empty flag causes missing input error
- Added Fixes #74 improved alignment on help output
- Add benchmark tests
- New gopher logo on README.md
- Fixes #98 - add CONTRIBUTING.md
-
v1.6.1-0.20250920063835-a7476ad7fee820 Sep 2025 pre-releaseNothing published for this version
-
v1.6.1-0.20250920054708-3cb625e8e57c20 Sep 2025 pre-releaseNothing published for this version
-
v1.6.1-0.20250920012711-991d3e8c4e1220 Sep 2025 pre-releaseNothing published for this version
-
v1.6.016 Sep 2025 withdrawnVersion retracted: Release version was used twice, causing go proxy errors.
Release notes
Open source →🎉 First release since May 2022 thanks to AI! 🎉
Disruptive Changes:
- Slice flags no longer automatically parse slice values with commas into multiple values. To specify multiple values, use the flag multiple times. For example, this will produce one value:
./app -f one,two,threeand./ -f one -f two -f threewill produce three values in the slice. #90
New Features:
- Adds built-in bash and zsh completion generators. Use
completion zshorcompletion bashon your app. This is on my default. To disable, useflaggy.DisableCompletion(). #1 - Flags can now be sorted alphabetically or reverse alphabetically using
SortFlagsByLongName()andSortFlagsByLongNameReversed()#69 - Added a Github Action for test validation
- Added support for all types in the go standard library!
• []net.IPMask
• time.Time
• url.URL
• net.IPNet
• net.TCPAddr
• net.UDPAddr
• os.FileMode
• regexp.Regexp
• time.Location
• time.Month
• time.Weekday
• big.Int
• big.Rat
• netip.Addr
• netip.Prefix
• netip.AddrPort
• Base64Bytes ([]byte)
Fixes
- Fixed #84 - Unknown arguments supplied when the flag and subcommand have the same value name
Full Changelog: v1.5.2...v1.6.0
- Slice flags no longer automatically parse slice values with commas into multiple values. To specify multiple values, use the flag multiple times. For example, this will produce one value:
-
v1.5.228 May 2022Release notes
Open source →If you would like to use a variable number of arguments at the end of your program without the user specifying
--before the list, you can do this by settingflaggy.ShowHelpOnUnexpectedDisable()and then parsing the[]stringatflaggy.TrailingArguments. For more details, see Issue #79- new trailingArguments example
- new tests for trailing arguments with positionals. fixed trailing arguments being incorrectly considered as positionals
-
v1.5.2-0.20220528052909-7f802351f0f428 May 2022 pre-releaseNothing published for this version
-
v1.5.2-0.20220517032219-f98079ec174617 May 2022 pre-releaseNothing published for this version
-
v1.5.125 Apr 2022 -
v1.5.023 Apr 2022Release notes
Open source →Important! A build error snuck into this release. Please use v1.5.1!
What's Changed
- Add new
TrailingSubcommand()method to find the last subcommand used by parsers @mattwiller in #75 - cosmetic: simplify Parser by @marco-m in #70
- blackbox test: actually assert something by @marco-m in #73
- Add useful info to AddPositionalValue panic. by @groutr in #77
- Linter fixes by @marco-m in #71
Thank you to our new contributors! 🎉
- @marco-m made their first contribution in #70
- @groutr made their first contribution in #77
- @mattwiller made their first contribution in #75
Full Changelog: v1.4.4...v1.5.0
- Add new
-
v1.4.5-0.20220423022127-1ae79a1c292423 Apr 2022 pre-releaseNothing published for this version
-
v1.4.5-0.20210708153147-5f3540f9b40908 Jul 2021 pre-releaseNothing published for this version
-
v1.4.5-0.20200715150314-32dc17aac6fc15 Jul 2020 pre-releaseNothing published for this version
-
v1.4.5-0.20200218045200-90718ce62b2a18 Feb 2020 pre-releaseNothing published for this version
-
v1.4.417 Feb 2020Release notes
Open source →- Fixing URL in Unlicense LICENSE file so that pkg.go.dev properly shows documentation for flaggy (it matches the entire license file text)
-
v1.4.318 Jan 2020Release notes
Open source →- upping revision because modules are preventing a quick fix to the 1.4.2 branch
-
v1.4.114 Jan 2020Nothing published for this version
-
v1.4.015 Nov 2019Nothing published for this version
-
v1.3.028 Oct 2019Nothing published for this version
-
v1.2.221 Aug 2019Nothing published for this version
-
v1.2.121 Aug 2019Nothing published for this version
-
v1.2.1-0.20190517180110-07ea7eb7740417 May 2019 pre-releaseNothing published for this version
-
v1.2.020 Feb 2019Nothing published for this version
-
v0.0.0-20191005164410-9f1f753d8f3305 Oct 2019 pre-releaseNothing published for this version
-
v0.0.0-20190517180110-07ea7eb7740417 May 2019 pre-releaseNothing published for this version
-
v0.0.0-20190220052119-eb3cf98db85320 Feb 2019 pre-releaseNothing published for this version
-
v0.0.0-20190217075710-8eff31c09bf217 Feb 2019 pre-releaseNothing published for this version
-
v0.0.0-20181007032133-1056ce33064607 Oct 2018 pre-releaseNothing published for this version
-
v0.0.0-20180727030457-227d37e9bf8127 Jul 2018 pre-releaseNothing published for this version
-
v0.0.0-20180713025924-edaf7a3804f813 Jul 2018 pre-releaseNothing published for this version