spf13/cobra (github.com/spf13/cobra)
### [`v1.8.0`](https://togithub.com/spf13/cobra/releases/tag/v1.8.0)
[Compare Source](https://togithub.com/spf13/cobra/compare/v1.7.0...v1.8.0)
#### โจ Features
- Support usage as plugin for tools like kubectl by [@nirs](https://togithub.com/nirs) in [https://github.com/spf13/cobra/pull/2018](https://togithub.com/spf13/cobra/pull/2018) - this means that programs that utilize a "plugin-like" structure have much better support and usage (like for completions, command paths, etc.)
- Move documentation sources to site/content by [@umarcor](https://togithub.com/umarcor) in [https://github.com/spf13/cobra/pull/1428](https://togithub.com/spf13/cobra/pull/1428)
- Add 'one required flag' group by [@marevers](https://togithub.com/marevers) in [https://github.com/spf13/cobra/pull/1952](https://togithub.com/spf13/cobra/pull/1952) - this includes a new `MarkFlagsOneRequired` API for flags which can be used to mark a flag group as required and cause command failure if at least one is not used when invoked.
- Customizable error message prefix by [@5ouma](https://togithub.com/5ouma) in [https://github.com/spf13/cobra/pull/2023](https://togithub.com/spf13/cobra/pull/2023) - This adds the `SetErrPrefix` and `ErrPrefix` APIs on the `Command` struct to allow for setting a custom prefix for errors
- feat: add getters for flag completions by [@avirtopeanu-ionos](https://togithub.com/avirtopeanu-ionos) in [https://github.com/spf13/cobra/pull/1943](https://togithub.com/spf13/cobra/pull/1943)
- Feature: allow running persistent run hooks of all parents by [@vkhoroz](https://togithub.com/vkhoroz) in [https://github.com/spf13/cobra/pull/2044](https://togithub.com/spf13/cobra/pull/2044)
- Improve API to get flag completion function by [@marckhouzam](https://togithub.com/marckhouzam) in [https://github.com/spf13/cobra/pull/2063](https://togithub.com/spf13/cobra/pull/2063)
#### ๐ Bug fixes
- Fix typo in fish completions by [@twpayne](https://togithub.com/twpayne) in [https://github.com/spf13/cobra/pull/1945](https://togithub.com/spf13/cobra/pull/1945)
- Fix grammar: 'allows to' by [@supertassu](https://togithub.com/supertassu) in [https://github.com/spf13/cobra/pull/1978](https://togithub.com/spf13/cobra/pull/1978)
- powershell: escape variable with curly brackets by [@Luap99](https://togithub.com/Luap99) in [https://github.com/spf13/cobra/pull/1960](https://togithub.com/spf13/cobra/pull/1960)
- Don't complete --help flag when flag parsing disabled by [@marckhouzam](https://togithub.com/marckhouzam) in [https://github.com/spf13/cobra/pull/2061](https://togithub.com/spf13/cobra/pull/2061)
- Replace all non-alphanumerics in active help env var program prefix by [@scop](https://togithub.com/scop) in [https://github.com/spf13/cobra/pull/1940](https://togithub.com/spf13/cobra/pull/1940)
#### ๐ง Maintenance
- build(deps): bump golangci/golangci-lint-action from 3.4.0 to 3.5.0 by [@dependabot](https://togithub.com/dependabot) in [https://github.com/spf13/cobra/pull/1971](https://togithub.com/spf13/cobra/pull/1971)
- build(deps): bump golangci/golangci-lint-action from 3.5.0 to 3.6.0 by [@dependabot](https://togithub.com/dependabot) in [https://github.com/spf13/cobra/pull/1976](https://togithub.com/spf13/cobra/pull/1976)
- build(deps): bump golangci/golangci-lint-action from 3.6.0 to 3.7.0 by [@dependabot](https://togithub.com/dependabot) in [https://github.com/spf13/cobra/pull/2021](https://togithub.com/spf13/cobra/pull/2021)
- build(deps): bump actions/setup-go from 3 to 4 by [@dependabot](https://togithub.com/dependabot) in [https://github.com/spf13/cobra/pull/1934](https://togithub.com/spf13/cobra/pull/1934)
- build(deps): bump github.com/cpuguy83/go-md2man/v2 from 2.0.2 to 2.0.3 by [@dependabot](https://togithub.com/dependabot) in [https://github.com/spf13/cobra/pull/2047](https://togithub.com/spf13/cobra/pull/2047)
- build(deps): bump actions/checkout from 3 to 4 by [@dependabot](https://togithub.com/dependabot) in [https://github.com/spf13/cobra/pull/2028](https://togithub.com/spf13/cobra/pull/2028)
- command: temporarily disable G602 due to [securego/gosec#1005](https://togithub.com/securego/gosec/issues/1005) by [@umarcor](https://togithub.com/umarcor) in [https://github.com/spf13/cobra/pull/2022](https://togithub.com/spf13/cobra/pull/2022)
#### ๐งช Testing & CI/CD
- test: make fish_completions_test more robust by [@branchvincent](https://togithub.com/branchvincent) in [https://github.com/spf13/cobra/pull/1980](https://togithub.com/spf13/cobra/pull/1980)
- golangci: enable 'unused' and disable deprecated replaced by it by [@umarcor](https://togithub.com/umarcor) in [https://github.com/spf13/cobra/pull/1983](https://togithub.com/spf13/cobra/pull/1983)
- cleanup: minor corrections to unit tests by [@JunNishimura](https://togithub.com/JunNishimura) in [https://github.com/spf13/cobra/pull/2003](https://togithub.com/spf13/cobra/pull/2003)
- ci: test golang 1.21 by [@nunoadrego](https://togithub.com/nunoadrego) in [https://github.com/spf13/cobra/pull/2024](https://togithub.com/spf13/cobra/pull/2024)
- Fix linter errors by [@marckhouzam](https://togithub.com/marckhouzam) in [https://github.com/spf13/cobra/pull/2052](https://togithub.com/spf13/cobra/pull/2052)
- Add tests for flag completion registration by [@marckhouzam](https://togithub.com/marckhouzam) in [https://github.com/spf13/cobra/pull/2053](https://togithub.com/spf13/cobra/pull/2053)
#### โ๏ธ Documentation
- doc: fix typo, Deperecated -> Deprecated by [@callthingsoff](https://togithub.com/callthingsoff) in [https://github.com/spf13/cobra/pull/2000](https://togithub.com/spf13/cobra/pull/2000)
- Add notes to doc about the execution condition of \*PreRun and \*PostRun functions by [@haoming29](https://togithub.com/haoming29) in [https://github.com/spf13/cobra/pull/2041](https://togithub.com/spf13/cobra/pull/2041)
***
Thank you everyone who contributed to this release and all your hard work! Cobra and this community would never be possible without all of you!!!! ๐
**Full Changelog**: https://github.com/spf13/cobra/compare/v1.7.0...v1.8.0
### [`v1.7.0`](https://togithub.com/spf13/cobra/releases/tag/v1.7.0)
[Compare Source](https://togithub.com/spf13/cobra/compare/v1.6.1...v1.7.0)
##### โจ Features
- Allow to preserve ordering of completions in `bash`, `zsh`, `pwsh`, & `fish`: [@h4ck3rk3y](https://togithub.com/h4ck3rk3y) [#1903](https://togithub.com/spf13/cobra/issues/1903)
- Add support for PowerShell 7.2+ in completions: [@oldium](https://togithub.com/oldium) [#1916](https://togithub.com/spf13/cobra/issues/1916)
- Allow sourcing zsh completion script: [@marckhouzam](https://togithub.com/marckhouzam) [#1917](https://togithub.com/spf13/cobra/issues/1917)
##### ๐ Bug fixes
- Don't remove flag values that match sub-command name: [@brianpursley](https://togithub.com/brianpursley) [#1781](https://togithub.com/spf13/cobra/issues/1781)
- Fix powershell completions not returning single word: [@totkeks](https://togithub.com/totkeks) [#1850](https://togithub.com/spf13/cobra/issues/1850)
- Remove masked `template` import variable name: [@yashLadha](https://togithub.com/yashLadha) [#1879](https://togithub.com/spf13/cobra/issues/1879)
- Correctly detect completions with dash in argument: [@oncilla](https://togithub.com/oncilla) [#1817](https://togithub.com/spf13/cobra/issues/1817)
##### ๐งช Testing & CI/CD
- Deprecate Go 1.15 in CI: [@umarcor](https://togithub.com/umarcor) [#1866](https://togithub.com/spf13/cobra/issues/1866)
- Deprecate Go 1.16 in CI: [@umarcor](https://togithub.com/umarcor) [#1926](https://togithub.com/spf13/cobra/issues/1926)
- Add testing for Go 1.20 in CI: [@umarcor](https://togithub.com/umarcor) [#1925](https://togithub.com/spf13/cobra/issues/1925)
- Add tests to illustrate unknown flag bug: [@brianpursley](https://togithub.com/brianpursley) [#1854](https://togithub.com/spf13/cobra/issues/1854)
##### ๐ง Maintenance
- Update main image to better handle dark backgrounds: [@Deleplace](https://togithub.com/Deleplace) and [@marckhouzam](https://togithub.com/marckhouzam) [#1883](https://togithub.com/spf13/cobra/issues/1883)
- Fix `stale.yaml` mispellings: [@enrichman](https://togithub.com/enrichman) [#1863](https://togithub.com/spf13/cobra/issues/1863)
- Remove stale bot from GitHub actions: [@jpmcb](https://togithub.com/jpmcb) [#1908](https://togithub.com/spf13/cobra/issues/1908)
- Add makefile target for installing dependencies: [@umarcor](https://togithub.com/umarcor) [#1865](https://togithub.com/spf13/cobra/issues/1865)
- Add Sia to projects using Cobra: [@mike76-dev](https://togithub.com/mike76-dev) [#1844](https://togithub.com/spf13/cobra/issues/1844)
- Add `Vitess` and `Arewefastyet` to projects using cobra: [@frouioui](https://togithub.com/frouioui) [#1932](https://togithub.com/spf13/cobra/issues/1932)
- Fixup for Kubescape github org: [@dwertent](https://togithub.com/dwertent) [#1874](https://togithub.com/spf13/cobra/issues/1874)
- Fix route for GitHub workflows badge: [@sh-cho](https://togithub.com/sh-cho) [#1884](https://togithub.com/spf13/cobra/issues/1884)
- Fixup for GoDoc style documentation: [@yashLadha](https://togithub.com/yashLadha) [#1885](https://togithub.com/spf13/cobra/issues/1885)
- Various bash scripting improvements for completion: [@scop](https://togithub.com/scop) [#1702](https://togithub.com/spf13/cobra/issues/1702)
- Add Constellation to projects using Cobra: [@datosh](https://togithub.com/datosh) [#1829](https://togithub.com/spf13/cobra/issues/1829)
##### โ๏ธ Documentation
- Add documentation about disabling completion descriptions: [@Shihta](https://togithub.com/Shihta) [#1901](https://togithub.com/spf13/cobra/issues/1901)
- Improve `MarkFlagsMutuallyExclusive` example in user guide: [@janhn](https://togithub.com/janhn) [#1904](https://togithub.com/spf13/cobra/issues/1904)
- Update `shell_completions.md`: [@gusega](https://togithub.com/gusega) [#1907](https://togithub.com/spf13/cobra/issues/1907)
- Update copywrite year: [@umarcor](https://togithub.com/umarcor) [#1927](https://togithub.com/spf13/cobra/issues/1927)
- Document suggested layout of subcommands: [@lcarva](https://togithub.com/lcarva) [#1930](https://togithub.com/spf13/cobra/issues/1930)
- Replace deprecated ExactValidArgs with MatchAll in doc: [@doniacld](https://togithub.com/doniacld) [#1836](https://togithub.com/spf13/cobra/issues/1836)
***
This release contains several long running fixes, improvements to powershell completions, and further optimizations for completions.
Thank you everyone who contributed to this release and all your hard work! Cobra and this community would never be possible without all of you! ๐
Full changelog: https://github.com/spf13/cobra/compare/v1.6.1...v1.7.0
Configuration
๐ Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
๐ฆ Automerge: Disabled by config. Please merge this manually once you are satisfied.
โป Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
๐ Ignore: Close this PR and you won't be reminded about this update again.
[ ] If you want to rebase/retry this PR, check this box
This PR has been generated by Mend Renovate. View repository job log here.
This PR contains the following updates:
v1.6.1
->v1.8.0
Release Notes
spf13/cobra (github.com/spf13/cobra)
### [`v1.8.0`](https://togithub.com/spf13/cobra/releases/tag/v1.8.0) [Compare Source](https://togithub.com/spf13/cobra/compare/v1.7.0...v1.8.0) #### โจ Features - Support usage as plugin for tools like kubectl by [@nirs](https://togithub.com/nirs) in [https://github.com/spf13/cobra/pull/2018](https://togithub.com/spf13/cobra/pull/2018) - this means that programs that utilize a "plugin-like" structure have much better support and usage (like for completions, command paths, etc.) - Move documentation sources to site/content by [@umarcor](https://togithub.com/umarcor) in [https://github.com/spf13/cobra/pull/1428](https://togithub.com/spf13/cobra/pull/1428) - Add 'one required flag' group by [@marevers](https://togithub.com/marevers) in [https://github.com/spf13/cobra/pull/1952](https://togithub.com/spf13/cobra/pull/1952) - this includes a new `MarkFlagsOneRequired` API for flags which can be used to mark a flag group as required and cause command failure if at least one is not used when invoked. - Customizable error message prefix by [@5ouma](https://togithub.com/5ouma) in [https://github.com/spf13/cobra/pull/2023](https://togithub.com/spf13/cobra/pull/2023) - This adds the `SetErrPrefix` and `ErrPrefix` APIs on the `Command` struct to allow for setting a custom prefix for errors - feat: add getters for flag completions by [@avirtopeanu-ionos](https://togithub.com/avirtopeanu-ionos) in [https://github.com/spf13/cobra/pull/1943](https://togithub.com/spf13/cobra/pull/1943) - Feature: allow running persistent run hooks of all parents by [@vkhoroz](https://togithub.com/vkhoroz) in [https://github.com/spf13/cobra/pull/2044](https://togithub.com/spf13/cobra/pull/2044) - Improve API to get flag completion function by [@marckhouzam](https://togithub.com/marckhouzam) in [https://github.com/spf13/cobra/pull/2063](https://togithub.com/spf13/cobra/pull/2063) #### ๐ Bug fixes - Fix typo in fish completions by [@twpayne](https://togithub.com/twpayne) in [https://github.com/spf13/cobra/pull/1945](https://togithub.com/spf13/cobra/pull/1945) - Fix grammar: 'allows to' by [@supertassu](https://togithub.com/supertassu) in [https://github.com/spf13/cobra/pull/1978](https://togithub.com/spf13/cobra/pull/1978) - powershell: escape variable with curly brackets by [@Luap99](https://togithub.com/Luap99) in [https://github.com/spf13/cobra/pull/1960](https://togithub.com/spf13/cobra/pull/1960) - Don't complete --help flag when flag parsing disabled by [@marckhouzam](https://togithub.com/marckhouzam) in [https://github.com/spf13/cobra/pull/2061](https://togithub.com/spf13/cobra/pull/2061) - Replace all non-alphanumerics in active help env var program prefix by [@scop](https://togithub.com/scop) in [https://github.com/spf13/cobra/pull/1940](https://togithub.com/spf13/cobra/pull/1940) #### ๐ง Maintenance - build(deps): bump golangci/golangci-lint-action from 3.4.0 to 3.5.0 by [@dependabot](https://togithub.com/dependabot) in [https://github.com/spf13/cobra/pull/1971](https://togithub.com/spf13/cobra/pull/1971) - build(deps): bump golangci/golangci-lint-action from 3.5.0 to 3.6.0 by [@dependabot](https://togithub.com/dependabot) in [https://github.com/spf13/cobra/pull/1976](https://togithub.com/spf13/cobra/pull/1976) - build(deps): bump golangci/golangci-lint-action from 3.6.0 to 3.7.0 by [@dependabot](https://togithub.com/dependabot) in [https://github.com/spf13/cobra/pull/2021](https://togithub.com/spf13/cobra/pull/2021) - build(deps): bump actions/setup-go from 3 to 4 by [@dependabot](https://togithub.com/dependabot) in [https://github.com/spf13/cobra/pull/1934](https://togithub.com/spf13/cobra/pull/1934) - build(deps): bump github.com/cpuguy83/go-md2man/v2 from 2.0.2 to 2.0.3 by [@dependabot](https://togithub.com/dependabot) in [https://github.com/spf13/cobra/pull/2047](https://togithub.com/spf13/cobra/pull/2047) - build(deps): bump actions/checkout from 3 to 4 by [@dependabot](https://togithub.com/dependabot) in [https://github.com/spf13/cobra/pull/2028](https://togithub.com/spf13/cobra/pull/2028) - command: temporarily disable G602 due to [securego/gosec#1005](https://togithub.com/securego/gosec/issues/1005) by [@umarcor](https://togithub.com/umarcor) in [https://github.com/spf13/cobra/pull/2022](https://togithub.com/spf13/cobra/pull/2022) #### ๐งช Testing & CI/CD - test: make fish_completions_test more robust by [@branchvincent](https://togithub.com/branchvincent) in [https://github.com/spf13/cobra/pull/1980](https://togithub.com/spf13/cobra/pull/1980) - golangci: enable 'unused' and disable deprecated replaced by it by [@umarcor](https://togithub.com/umarcor) in [https://github.com/spf13/cobra/pull/1983](https://togithub.com/spf13/cobra/pull/1983) - cleanup: minor corrections to unit tests by [@JunNishimura](https://togithub.com/JunNishimura) in [https://github.com/spf13/cobra/pull/2003](https://togithub.com/spf13/cobra/pull/2003) - ci: test golang 1.21 by [@nunoadrego](https://togithub.com/nunoadrego) in [https://github.com/spf13/cobra/pull/2024](https://togithub.com/spf13/cobra/pull/2024) - Fix linter errors by [@marckhouzam](https://togithub.com/marckhouzam) in [https://github.com/spf13/cobra/pull/2052](https://togithub.com/spf13/cobra/pull/2052) - Add tests for flag completion registration by [@marckhouzam](https://togithub.com/marckhouzam) in [https://github.com/spf13/cobra/pull/2053](https://togithub.com/spf13/cobra/pull/2053) #### โ๏ธ Documentation - doc: fix typo, Deperecated -> Deprecated by [@callthingsoff](https://togithub.com/callthingsoff) in [https://github.com/spf13/cobra/pull/2000](https://togithub.com/spf13/cobra/pull/2000) - Add notes to doc about the execution condition of \*PreRun and \*PostRun functions by [@haoming29](https://togithub.com/haoming29) in [https://github.com/spf13/cobra/pull/2041](https://togithub.com/spf13/cobra/pull/2041) *** Thank you everyone who contributed to this release and all your hard work! Cobra and this community would never be possible without all of you!!!! ๐ **Full Changelog**: https://github.com/spf13/cobra/compare/v1.7.0...v1.8.0 ### [`v1.7.0`](https://togithub.com/spf13/cobra/releases/tag/v1.7.0) [Compare Source](https://togithub.com/spf13/cobra/compare/v1.6.1...v1.7.0) ##### โจ Features - Allow to preserve ordering of completions in `bash`, `zsh`, `pwsh`, & `fish`: [@h4ck3rk3y](https://togithub.com/h4ck3rk3y) [#1903](https://togithub.com/spf13/cobra/issues/1903) - Add support for PowerShell 7.2+ in completions: [@oldium](https://togithub.com/oldium) [#1916](https://togithub.com/spf13/cobra/issues/1916) - Allow sourcing zsh completion script: [@marckhouzam](https://togithub.com/marckhouzam) [#1917](https://togithub.com/spf13/cobra/issues/1917) ##### ๐ Bug fixes - Don't remove flag values that match sub-command name: [@brianpursley](https://togithub.com/brianpursley) [#1781](https://togithub.com/spf13/cobra/issues/1781) - Fix powershell completions not returning single word: [@totkeks](https://togithub.com/totkeks) [#1850](https://togithub.com/spf13/cobra/issues/1850) - Remove masked `template` import variable name: [@yashLadha](https://togithub.com/yashLadha) [#1879](https://togithub.com/spf13/cobra/issues/1879) - Correctly detect completions with dash in argument: [@oncilla](https://togithub.com/oncilla) [#1817](https://togithub.com/spf13/cobra/issues/1817) ##### ๐งช Testing & CI/CD - Deprecate Go 1.15 in CI: [@umarcor](https://togithub.com/umarcor) [#1866](https://togithub.com/spf13/cobra/issues/1866) - Deprecate Go 1.16 in CI: [@umarcor](https://togithub.com/umarcor) [#1926](https://togithub.com/spf13/cobra/issues/1926) - Add testing for Go 1.20 in CI: [@umarcor](https://togithub.com/umarcor) [#1925](https://togithub.com/spf13/cobra/issues/1925) - Add tests to illustrate unknown flag bug: [@brianpursley](https://togithub.com/brianpursley) [#1854](https://togithub.com/spf13/cobra/issues/1854) ##### ๐ง Maintenance - Update main image to better handle dark backgrounds: [@Deleplace](https://togithub.com/Deleplace) and [@marckhouzam](https://togithub.com/marckhouzam) [#1883](https://togithub.com/spf13/cobra/issues/1883) - Fix `stale.yaml` mispellings: [@enrichman](https://togithub.com/enrichman) [#1863](https://togithub.com/spf13/cobra/issues/1863) - Remove stale bot from GitHub actions: [@jpmcb](https://togithub.com/jpmcb) [#1908](https://togithub.com/spf13/cobra/issues/1908) - Add makefile target for installing dependencies: [@umarcor](https://togithub.com/umarcor) [#1865](https://togithub.com/spf13/cobra/issues/1865) - Add Sia to projects using Cobra: [@mike76-dev](https://togithub.com/mike76-dev) [#1844](https://togithub.com/spf13/cobra/issues/1844) - Add `Vitess` and `Arewefastyet` to projects using cobra: [@frouioui](https://togithub.com/frouioui) [#1932](https://togithub.com/spf13/cobra/issues/1932) - Fixup for Kubescape github org: [@dwertent](https://togithub.com/dwertent) [#1874](https://togithub.com/spf13/cobra/issues/1874) - Fix route for GitHub workflows badge: [@sh-cho](https://togithub.com/sh-cho) [#1884](https://togithub.com/spf13/cobra/issues/1884) - Fixup for GoDoc style documentation: [@yashLadha](https://togithub.com/yashLadha) [#1885](https://togithub.com/spf13/cobra/issues/1885) - Various bash scripting improvements for completion: [@scop](https://togithub.com/scop) [#1702](https://togithub.com/spf13/cobra/issues/1702) - Add Constellation to projects using Cobra: [@datosh](https://togithub.com/datosh) [#1829](https://togithub.com/spf13/cobra/issues/1829) ##### โ๏ธ Documentation - Add documentation about disabling completion descriptions: [@Shihta](https://togithub.com/Shihta) [#1901](https://togithub.com/spf13/cobra/issues/1901) - Improve `MarkFlagsMutuallyExclusive` example in user guide: [@janhn](https://togithub.com/janhn) [#1904](https://togithub.com/spf13/cobra/issues/1904) - Update `shell_completions.md`: [@gusega](https://togithub.com/gusega) [#1907](https://togithub.com/spf13/cobra/issues/1907) - Update copywrite year: [@umarcor](https://togithub.com/umarcor) [#1927](https://togithub.com/spf13/cobra/issues/1927) - Document suggested layout of subcommands: [@lcarva](https://togithub.com/lcarva) [#1930](https://togithub.com/spf13/cobra/issues/1930) - Replace deprecated ExactValidArgs with MatchAll in doc: [@doniacld](https://togithub.com/doniacld) [#1836](https://togithub.com/spf13/cobra/issues/1836) *** This release contains several long running fixes, improvements to powershell completions, and further optimizations for completions. Thank you everyone who contributed to this release and all your hard work! Cobra and this community would never be possible without all of you! ๐ Full changelog: https://github.com/spf13/cobra/compare/v1.6.1...v1.7.0Configuration
๐ Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
๐ฆ Automerge: Disabled by config. Please merge this manually once you are satisfied.
โป Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
๐ Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by Mend Renovate. View repository job log here.