Skip to content

Move documentation sources to site/content#1428

Merged
marckhouzam merged 5 commits intospf13:mainfrom
umarcor:site
Jun 20, 2023
Merged

Move documentation sources to site/content#1428
marckhouzam merged 5 commits intospf13:mainfrom
umarcor:site

Conversation

@umarcor
Copy link
Contributor

@umarcor umarcor commented Jun 29, 2021

In preparation for #1245, this PR moves documentation sources (markdown files) into site/content:

  • projects_using_cobra.md is moved to site/content/.
  • All *_completions.md are moved to site/content/completions/*.md.
  • All doc/*_docs.md are moved to site/content/docgen/*.md.
  • doc/README.md is moved to site/content/CLI.md.

References are updated accordingly.

@github-actions
Copy link

github-actions bot commented Oct 4, 2021

This PR is being marked as stale due to a long period of inactivity

@umarcor
Copy link
Contributor Author

umarcor commented Feb 24, 2022

Please, remove the stale label from this PR.

@marckhouzam
Copy link
Collaborator

Please, remove the stale label from this PR.

Done

@marckhouzam marckhouzam added the kind/documentation Documentation of cobra itself label Feb 24, 2022
@umarcor umarcor force-pushed the site branch 2 times, most recently from 2e2c70d to 2ce7602 Compare March 3, 2022 15:12
Copy link

@PaluMacil PaluMacil left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks good to me!

@umarcor
Copy link
Contributor Author

umarcor commented Apr 24, 2023

@marckhouzam can we milestone this for 1.8.0?

@marckhouzam marckhouzam added this to the 1.8.0 milestone Apr 24, 2023
@marckhouzam
Copy link
Collaborator

@marckhouzam can we milestone this for 1.8.0?

Done.

@umarcor
Copy link
Contributor Author

umarcor commented Jun 17, 2023

@marckhouzam I rebased on top of main and CI succeeded. Can we have this merged?

Copy link
Collaborator

@marckhouzam marckhouzam left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @umarcor . Two small tweaks then we can get this merged.

Cobra can generate a shell-completion file for the following shells: bash, zsh, fish, PowerShell. If you add more information to your commands, these completions can be amazingly powerful and flexible. Read more about it in [Shell Completions](shell_completions.md).
Cobra can generate a shell-completion file for the following shells: bash, zsh, fish, PowerShell.
If you add more information to your commands, these completions can be amazingly powerful and flexible.
Read more about it in [Shell Completions](shell_completions.md).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe you renamed the shell completion doc file

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed!

Cobra makes use of the shell-completion system to define a framework allowing you to provide Active Help to your users. Active Help are messages (hints, warnings, etc) printed as the program is being used. Read more about it in [Active Help](active_help.md).
Cobra makes use of the shell-completion system to define a framework allowing you to provide Active Help to your users.
Active Help are messages (hints, warnings, etc) printed as the program is being used.
Read more about it in [Active Help](active_help.md).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

do you want to also move the active help doc file?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done!

@github-actions github-actions bot removed the area/docs-generation Generation of docs via Cobra label Jun 20, 2023
Copy link
Collaborator

@marckhouzam marckhouzam left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @umarcor !
LGTM

@marckhouzam marckhouzam merged commit dcb405a into spf13:main Jun 20, 2023
@umarcor umarcor deleted the site branch June 20, 2023 21:36
renovate bot referenced this pull request in anoriqq/qpm Nov 4, 2023
[![Mend
Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [github.com/spf13/cobra](https://togithub.com/spf13/cobra) | require |
minor | `v1.7.0` -> `v1.8.0` |

---

### Release Notes

<details>
<summary>spf13/cobra (github.com/spf13/cobra)</summary>

### [`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
[@&#8203;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 utalize a "plugin" like structure have
much better support and usage (like for completions, command paths,
etc.)
- Move documentation sources to site/content by
[@&#8203;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
[@&#8203;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 one
is not used when invoked.
- Customizable error message prefix by
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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 [@&#8203;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
[@&#8203;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 [@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;nunoadrego](https://togithub.com/nunoadrego) in
[https://github.com/spf13/cobra/pull/2024](https://togithub.com/spf13/cobra/pull/2024)
- Fix linter errors by
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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**:
spf13/cobra@v1.7.0...v1.8.0

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined),
Automerge - At any time (no schedule defined).

🚦 **Automerge**: Enabled.

♻ **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.

---

- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box

---

This PR has been generated by [Mend
Renovate](https://www.mend.io/free-developer-tools/renovate/). View
repository job log [here](https://developer.mend.io/github/anoriqq/qpm).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNy4zMS41IiwidXBkYXRlZEluVmVyIjoiMzcuMzEuNSIsInRhcmdldEJyYW5jaCI6Im1haW4ifQ==-->

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
renovate bot referenced this pull request in trussworks/setup-new-aws-user Nov 4, 2023
[![Mend
Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [github.com/spf13/cobra](https://togithub.com/spf13/cobra) | require |
minor | `v1.7.0` -> `v1.8.0` |

---

> [!WARNING]
> Some dependencies could not be looked up. Check the Dependency
Dashboard for more information.

---

### Release Notes

<details>
<summary>spf13/cobra (github.com/spf13/cobra)</summary>

### [`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
[@&#8203;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 utalize a "plugin" like structure have
much better support and usage (like for completions, command paths,
etc.)
- Move documentation sources to site/content by
[@&#8203;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
[@&#8203;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 one
is not used when invoked.
- Customizable error message prefix by
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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 [@&#8203;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
[@&#8203;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 [@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;nunoadrego](https://togithub.com/nunoadrego) in
[https://github.com/spf13/cobra/pull/2024](https://togithub.com/spf13/cobra/pull/2024)
- Fix linter errors by
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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**:
spf13/cobra@v1.7.0...v1.8.0

</details>

---

### Configuration

📅 **Schedule**: Branch creation - "every weekday,after 9am and before
5pm" in timezone America/Los_Angeles, Automerge - At any time (no
schedule defined).

🚦 **Automerge**: Enabled.

♻ **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.

---

- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box

---

This PR has been generated by [Mend
Renovate](https://www.mend.io/free-developer-tools/renovate/). View
repository job log
[here](https://developer.mend.io/github/trussworks/setup-new-aws-user).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNy4zMS41IiwidXBkYXRlZEluVmVyIjoiMzcuMzEuNSIsInRhcmdldEJyYW5jaCI6Im1haW4ifQ==-->

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
renovate bot referenced this pull request in peaceiris/tss Nov 4, 2023
[![Mend
Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [github.com/spf13/cobra](https://togithub.com/spf13/cobra) | require |
minor | `v1.7.0` -> `v1.8.0` |

---

### Release Notes

<details>
<summary>spf13/cobra (github.com/spf13/cobra)</summary>

### [`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
[@&#8203;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 utalize a "plugin" like structure have
much better support and usage (like for completions, command paths,
etc.)
- Move documentation sources to site/content by
[@&#8203;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
[@&#8203;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 one
is not used when invoked.
- Customizable error message prefix by
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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 [@&#8203;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
[@&#8203;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 [@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;nunoadrego](https://togithub.com/nunoadrego) in
[https://github.com/spf13/cobra/pull/2024](https://togithub.com/spf13/cobra/pull/2024)
- Fix linter errors by
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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**:
spf13/cobra@v1.7.0...v1.8.0

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined),
Automerge - At any time (no schedule defined).

🚦 **Automerge**: Enabled.

♻ **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.

---

- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box

---

This PR has been generated by [Mend
Renovate](https://www.mend.io/free-developer-tools/renovate/). View
repository job log
[here](https://developer.mend.io/github/peaceiris/tss).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNy4zMS41IiwidXBkYXRlZEluVmVyIjoiMzcuMzEuNSIsInRhcmdldEJyYW5jaCI6Im1haW4ifQ==-->

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
renovate bot referenced this pull request in kreempuff/rules_unreal_engine Nov 4, 2023
[![Mend
Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [github.com/spf13/cobra](https://togithub.com/spf13/cobra) | require |
minor | `v1.7.0` -> `v1.8.0` |

---

> [!WARNING]
> Some dependencies could not be looked up. Check the Dependency
Dashboard for more information.

---

### Release Notes

<details>
<summary>spf13/cobra (github.com/spf13/cobra)</summary>

### [`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
[@&#8203;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 utalize a "plugin" like structure have
much better support and usage (like for completions, command paths,
etc.)
- Move documentation sources to site/content by
[@&#8203;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
[@&#8203;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 one
is not used when invoked.
- Customizable error message prefix by
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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 [@&#8203;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
[@&#8203;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 [@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;nunoadrego](https://togithub.com/nunoadrego) in
[https://github.com/spf13/cobra/pull/2024](https://togithub.com/spf13/cobra/pull/2024)
- Fix linter errors by
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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**:
spf13/cobra@v1.7.0...v1.8.0

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined),
Automerge - At any time (no schedule defined).

🚦 **Automerge**: Enabled.

♻ **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.

---

- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box

---

This PR has been generated by [Mend
Renovate](https://www.mend.io/free-developer-tools/renovate/). View
repository job log
[here](https://developer.mend.io/github/kreempuff/rules_unreal_engine).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNy4zMS41IiwidXBkYXRlZEluVmVyIjoiMzcuMzEuNSIsInRhcmdldEJyYW5jaCI6Im1haW4ifQ==-->
renovate bot referenced this pull request in open-feature/flagd Nov 5, 2023
[![Mend
Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [github.com/spf13/cobra](https://togithub.com/spf13/cobra) | require |
minor | `v1.7.0` -> `v1.8.0` |

---

> [!WARNING]
> Some dependencies could not be looked up. Check the Dependency
Dashboard for more information.

---

### Release Notes

<details>
<summary>spf13/cobra (github.com/spf13/cobra)</summary>

### [`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
[@&#8203;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 utalize a "plugin" like structure have
much better support and usage (like for completions, command paths,
etc.)
- Move documentation sources to site/content by
[@&#8203;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
[@&#8203;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 one
is not used when invoked.
- Customizable error message prefix by
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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 [@&#8203;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
[@&#8203;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 [@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;nunoadrego](https://togithub.com/nunoadrego) in
[https://github.com/spf13/cobra/pull/2024](https://togithub.com/spf13/cobra/pull/2024)
- Fix linter errors by
[@&#8203;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
[@&#8203;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
[@&#8203;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
[@&#8203;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**:
spf13/cobra@v1.7.0...v1.8.0

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined),
Automerge - At any time (no schedule defined).

🚦 **Automerge**: Enabled.

♻ **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.

---

- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box

---

This PR has been generated by [Mend
Renovate](https://www.mend.io/free-developer-tools/renovate/). View
repository job log
[here](https://developer.mend.io/github/open-feature/flagd).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNy4zMS41IiwidXBkYXRlZEluVmVyIjoiMzcuMzEuNSIsInRhcmdldEJyYW5jaCI6Im1haW4ifQ==-->

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
ghost referenced this pull request in camunda/camunda Nov 6, 2023
15028: deps(deps): update module github.com/spf13/cobra to v1.8.0 (main) r=github-actions[bot] a=renovate[bot]

[![Mend Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [github.com/spf13/cobra](https://togithub.com/spf13/cobra) | require | minor | `v1.7.0` -> `v1.8.0` |

---

> [!WARNING]
> Some dependencies could not be looked up. Check the Dependency Dashboard for more information.

---

### Release Notes

<details>
<summary>spf13/cobra (github.com/spf13/cobra)</summary>

### [`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 [`@&#8203;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 utalize a "plugin" like structure have much better support and usage (like for completions, command paths, etc.)
-   Move documentation sources to site/content by [`@&#8203;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 [`@&#8203;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 one is not used when invoked.
-   Customizable error message prefix by [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;nunoadrego](https://togithub.com/nunoadrego)` in [https://github.com/spf13/cobra/pull/2024](https://togithub.com/spf13/cobra/pull/2024)
-   Fix linter errors by [`@&#8203;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 [`@&#8203;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 [`@&#8203;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 [`@&#8203;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**: spf13/cobra@v1.7.0...v1.8.0

</details>

---

### Configuration

📅 **Schedule**: Branch creation - "every weekday" (UTC), 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.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR has been generated by [Mend Renovate](https://www.mend.io/free-developer-tools/renovate/). View repository job log [here](https://developer.mend.io/github/camunda/zeebe).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNy4zMS41IiwidXBkYXRlZEluVmVyIjoiMzcuMzEuNSIsInRhcmdldEJyYW5jaCI6Im1haW4ifQ==-->


Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

kind/documentation Documentation of cobra itself size/M Denotes a PR that chanes 24-99 lines

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants