Spring 2022 release 🌼

[umarcor]

Approved by a maintainer but merge seems to have been forgotten:

• deprecate ExactValidArgs in favour of MatchAll(OnlyValidArgs, ...) #1646
  • deprecate ExactValidArgs and test combinations of args validators #1643
    • args_test refactorization after generalizing ValidArgs #841

Left pending in the previous releases (#1388, #1496, #1565):

• ci: add workflow_dispatch #1387
• feat: make InitDefaultCompletionCmd public #1467

Related to documentation/site rework:

• Move documentation sources to site/content #1428

Some random cool ones:

• Add groups for commands in help #1003
• refactor: small refactor #1572
• Maybe conflicting:
  • add colors to CLI commands #1231
  • Support subcommands checking for suggestions #1500

See also Milestones: Next and Milestones: 2.0.0.

Done

• Add Active Help support #1482
• Improve fish_completions code quality #1515
• Prefer ReplaceAll instead of Replace(..., -1) #1530
• Fix Command.Context comment #1639
  • Add Command.SetContext #1551
• undefined or nil Args default to ArbitraryArgs #1612
• Introduce FixedCompletions #1574
• feat: Add how to load completions in your current zsh session #1608
• undefined or nil Args default to ArbitraryArgs #1612
• fix some typos #1625
• Remove CHANGELOG.md as it isn't updated #1634
• ci: test on Golang 1.18 #1635
• Add Kubescape to projects #1642
• Changed branch name in the cobra generator link to 'main' #1645
• Update stale-bot #1609
• Adds size labeler GitHub action #1610
• Bump golangci/golangci-lint-action from 2 to 3.1.0 #1615
• Bump actions/stale from 1 to 5 #1618
• Bump actions/checkout from 2 to 3 #1619
• Bump actions/labeler from 3 to 4 #1620
• Bump actions/cache from 2 to 3 #1640
• ci/test: RICHGO_FORCE_COLOR #1647
• Bump actions/setup-go from 2 to 3 #1660
• Wrap printf tab with quotes #1665
• Add ability to mark flags as required or exclusive as a group #1654
• Add Polygon Edge as a project using Cobra #1672
• Bump codelytv/pr-size-labeler from 1.8.0 to 1.8.1 #1661
• Minor typo fix in shell_completion.md #1678
• style(bash-v2): out is not an array variable, do not refer to it as such #1681
• perf(bash-v2): use backslash escape string expansion for tab #1682
• perf(bash-v2): standard completion optimizations #1683
• style(bash): out is not an array variable, do not refer to it as such #1684
• perf(bash-v2): short-circuit descriptionless candidate lists #1686
• Bump github.com/cpuguy83/go-md2man/v2 from 2.0.1 to 2.0.2 #1688
• perf(bash-v2): speed up filtering entries with descriptions #1689
• fix: Don't complete _command on zsh #1690
• fix(bash-v2): skip empty completions when filtering descriptions #1691
• perf(bash-v2): speed up filtering menu-complete descriptions #1692
• Change links from http:// to https:// #1695
• perf(bash-v2): read directly to COMPREPLY on descriptionless short circuit #1700
• Modify brew prefix path in macOS system #1719
• Add Pulumi as a project using cobra #1720
• Fix handling of descriptions for bash v3 #1735

[umarcor]

Can some maintainer please have a look at dependency/CI PRs?

• ci: add workflow_dispatch #1387
• Bump golangci/golangci-lint-action from 2 to 3.1.0 #1615
• Bump actions/stale from 1 to 5 #1618
• Bump actions/checkout from 2 to 3 #1619
• Bump actions/labeler from 3 to 4 #1620
• ci: test on Golang 1.18 #1635

[umarcor]

@marckhouzam can you please milestone #1551, #1625 and #1634?

[marckhouzam]

@marckhouzam can you please milestone #1551, #1625 and #1634?

Geez 😢 I'll get it eventually 😄 Thanks for the reminder!

[umarcor]

I split #1643 from #841, to hopefully make it easier for maintainers to review and merge. As discussed in #1496 (comment), it should be included in the next release. Please, let me know if you need any clarification or action on my side.

[umarcor]

@marckhouzam 👇🏼

• Bump golangci/golangci-lint-action from 2 to 3.1.0 #1615
• Bump actions/stale from 1 to 5 #1618
• Bump actions/labeler from 3 to 4 #1620
• Bump actions/cache from 2 to 3 #1640

[marckhouzam]

@marckhouzam 👇🏼

Done 😄

[PapaCharlie]

Hey team! Any updates on when this will be released? There are a couple things in this release that are going to be super handy!

[jpmcb]

Hi @PapaCharlie - thanks for checking in. A number of us are traveling, have PTO, etc. I'm hoping to cut this soon, at the latest by the end of June.

[plastikfan]

Hey team! Any updates on when this will be released? There are a couple things in this release that are going to be super handy!

Yeah, I'm particularly looking forward to using MarkFlagsRequiredTogether and MarkFlagsMutuallyExclusive

[PapaCharlie]

@jpmcb No worries! I just have a lot of code I've been anxiously waiting to nuke once the new flag validations are added.

[c4milo]

Looking forward to this release as well! 🙌

[jpmcb]

I'm planning to cut this soon, hopefully in the next week or so!

[jpmcb]

The spring release has been cut: https://github.com/spf13/cobra/releases/tag/v1.5.0