Fall release 🍁 - 2021

[umarcor]

Last release was planned for May 2021 and released in July. Next week, it will be 3 months since that. In this period, 3 PRs were merged.

Is there any plan for merging PRs and releasing a new version in the following weeks?

Release candidate (please try out and test!)

• 🍁 Fall 2021 - release candidate #1525

To Do

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

• args_test refactorization after generalizing ValidArgs #841

Left pending in the previous release (#1388):

• ci: add workflow_dispatch #1387

Small completion fixes from the community:

• feat: make InitDefaultCompletionCmd public #1467

Worth considering:

• Prefer ReplaceAll instead of Replace(..., -1) #1530

Some random cool ones:

• add colors to CLI commands #1231
• Add groups for commands in help #1003

Done

• Remove "Lesser" from header for GPL-2.0 template #880
• enable composing PositionalArgs #896
• fix(diff): use arg '--strip-trailing-cr' #949
• Fix PrintErrln and PrintErrf to behave like PrintErr #979
• Small correction in README #1009
• Allow specifying licenses using their SPDX identifier #1159
• DisableFlagParsing must trigger custom completion for flag names #1161
• fix: unbound variables in bash completion #1321
• Update shell_completions.md to have automatically rootcmd #1372
• args_test: add helper functions  #1426
• github: add dependabot configuration file #1427
• readme: remove ToC, since it's now shown by GitHub #1429
• fix: improve completions help formatting #1444
• Projects #1454. Closes:
  • Add Mercure in the list of projects #987
  • Add the multi-gitter to to projects_using_cobra.md #1371
  • Add Meroxa CLI #1377
  • Add qrcp to list of projects using cobra #1380
  • docs(projects_using_cobra.md): add moldy to this projects #1407
  • add scaleway-cli to projects using cobra #1446
  • Add UpCloud CLI (upctl) to projects_using_cobra.md #1451
  • docs: add goreleaser and nfpm to project list #1497
  • Add Datree to projects_using_cobra markdown #1506
  • Add Infracost to projects using cobra #1522
  • Add VMware Tanzu Framework to projects #1528
• Completion: Capitalize short desc and remove extra space from long  #1455
• fix: typo in {bash,zsh}_completions.go #1459
• fix: Duplicate error message from cobra init boilerplates #1463
• completions: fix mixed tab/spaces indentation #1473
• chore(ci): use golangci-lint-action #1477
• Support different bash completion options #1509
• Fix invalid shell completion when used with ~/.cobra.yaml #1510
• Fix some typos (mostly found by codespell) #1514
• Remove trailing spaces from bash completion command description #1520
• Provide option to hide default 'completion' cmd #1541
• fix root.go.golden #1552
• Bug fix: includes os package import in root command generation #1557

Delayed to a later release

• Support subcommands checking for suggestions #1500

[marckhouzam]

To help the maintainers how about we try to weed through some of the PRs?
Here's what I came up with.

My apologies to the community for not listing some of the ones I'm not familiar with, it does not mean they are not just as valuable, but I had to start somewhere.

Adding projects to projects_using_cobra.md:

@umarcor has been efficient and rebased 6 contributions into one PR to avoid the merge conflicts: #1454
This will allow to close: #987 #1371 #1380 #1407 #1446 #1451

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

#1161 DisableFlagParsing must trigger custom completion for flag names
#841 Generalize ValidArgs: use it implicitly with any validator

Small completion fixes from the community:

#1455 Completion: Capitalize short desc and remove extra space from long
#1321 fix: unbound variables in bash completion
#1450 feat(completion): add default completion hidden if there are no subcmds - not ready
#1372 Update shell_completions.md to have automatically rootcmd
#1467 feat: make InitDefaultCompletionCmd public
#1473 completions: fix mixed tab/spaces indentation
#1459 fix: typo in {bash,zsh}_completions.go
#1444 fix: improve completions help formatting
#1495 Remove indentation causing RST errors

Some random cool ones:

#1231 add colors to CLI commands
#1003 Add groups for commands in help

It would be nice to continue the discussion about how to avoid bringing in all the Viper dependencies.

There are some nice documentation cleanup and CI improvements from @umarcor.

[umarcor]

@marckhouzam, a hint: make a list (add - before #). That will make the references be rendered as below.

@umarcor has been efficient and rebased 6 contributions into one PR to avoid the merge conflicts: #1454
This will allow to close: #987 #1371 #1380 #1407 #1446 #1451

Should there be any similar PR which I missed, please let me know and I will include it.

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

#841 Generalize ValidArgs: use it implicitly with any validator

#841 is now based on #1426, which should be merged first.
In my initial #841 proposal (back in March 2019), reworking the tests was not in the scope.
It was done upon maintainers requests, but it then seemed to increase the complexity so that no one would actually review and merge. Hence, a few months ago I split #1426 in the hope that it will be easier to review.

Note that #841 is, in fact, a fix for an incomplete implementation. It is not a new feature per se. Moreover, backwards compatibility is preserved. I am honestly frustrated with that one because it is ready to be merged since 1-2y ago. During the last months, I refrained myself from working on improving the docs/website, because I'm not confident about the efforts being honored. It's nothing personal, tho; just the particularities of this project (#959). I have the perception that there is a strong pushback to any minimally meaningful change, because of how many big players depend on this project. My take on it is that, if those big players care, they should get people involved in the development to ensure that we catch regressions. IMHO, gatekeeping is not acceptable.

It would be nice to continue the discussion about how to avoid bringing in all the Viper dependencies.

I'm personally good with keeping that out of the discussion for now.
Although I do think that a reorganisation is required, that will be necessarilly very disruptive.
Fixing that requires changing the import path of the lib, the cli, or both of them.
That's something we want to be careful about, in the sense that we want to advertise it very loudly months before actually doing it.
Therefore, we need to first have some rythm in the development (complying with the quarterly release statement in https://github.com/spf13/cobra/blob/master/CONDUCT.md). Then, we need to update the site so that we have a "news" section for communicating meaningful changes. Hugo has RSS support, so we'd get that for free. Last, we can afford going forward with disruption.
See #1240.

---

Some PRs which were left pending in the previous release (#1388):

Chores:

• ci: add workflow_dispatch #1387
• github: add dependabot configuration file #1427

Documentation:

• Small correction in README #1009
• readme: remove ToC, since it's now shown by GitHub #1429

Tests:

• fix(diff): use arg '--strip-trailing-cr' #949
• args_test: add helper functions  #1426

---

Worth considering:

• fix: Duplicate error message from cobra init boilerplates #1463

---

Some long standing PRs:

• Remove "Lesser" from header for GPL-2.0 template #880
• enable composing PositionalArgs #896
• Allow specifying licenses using their SPDX identifier #1159

---

It's a duplicate, can be closed:

• Fix PrintErrln and PrintErrf to behave like PrintErr #979

[marckhouzam]

@umarcor nice trick to automatically include the title of the PR and its state so easily!

How do you feel about making a unified "proposed" list in the description of this PR? That way it can keep being updated and the maintainers don't have to sift through the comments.

[umarcor]

@marckhouzam I copied all the refs to the description (first message) above. Let me know if you (or anyone else) want to add/remove anything.

[jpmcb]

Hi all - very busy season for everyone since Kubecon is around the corner. Let's shoot for an end of October release since we had a summer release. Thanks all for your patience and dedication to this project!!! ❤️

Pinning this as our release tracker

[marckhouzam]

@umarcor would you mind adding #1509 to the list of PRs to include in the release? It is a bug fix for bash completion v2. Thanks!

[umarcor]

@marckhouzam, done!

[georgettica]

I saw the reference and wanted to know how can I help to promote my PR/others
let me know

[umarcor]

@georgettica, #1372 is listed in the first message above already. Which other PRs are ready to be merged (and approved by someone) but not listed yet?

Neither @marckhouzam nor myself are allowed to merge PRs. Hence, listing them here is our best effort to help the maintainers. Nonetheless, we depend on them for moving the project forward.

@jpmcb mentioned the end of october, so I expect merging activity during the next 10 days. /cc @jharshman @spf13

[georgettica]

@georgettica, #1372 is listed in the first message above already. Which other PRs are ready to be merged (and approved by someone) but not listed yet?
Non come to mind, but I thought maybe there is something we can do to help and validate solutions

[marckhouzam]

@umarcor #1510 would be nice to add to the list as well. Thanks

[umarcor]

@marckhouzam, done!