Skip to content

docs: add shell completion instructions to README#2371

Open
tysoncung wants to merge 1 commit intojazzband:mainfrom
tysoncung:docs/1702-shell-completion
Open

docs: add shell completion instructions to README#2371
tysoncung wants to merge 1 commit intojazzband:mainfrom
tysoncung:docs/1702-shell-completion

Conversation

@tysoncung
Copy link
Copy Markdown

Problem

pip-compile and pip-sync support shell completion via Click, but this isn't documented anywhere in the README. Users have no way to discover this feature.

Closes #1702

Solution

Added a "Shell completion" section to the README with setup instructions for Bash, Zsh, and Fish shells, following Click's shell completion documentation.

Changes

  • README.md: Added "Shell completion" section with instructions for Bash, Zsh, and Fish

pip-compile and pip-sync support shell completion via Click, but this
wasn't documented in the README. Added instructions for Bash, Zsh,
and Fish shells.
@sirosen
Copy link
Copy Markdown
Member

sirosen commented Apr 4, 2026

Thanks for writing this up; these instructions look good. I want to double-check that they render in docs correctly before approving.

Please restore the PR template -- per our contributing doc, we do not generally accept contributions which remove the template. You should also add a doc changelog item.

@WhyNotHugo
Copy link
Copy Markdown
Member

Thanks for mentioning this, I had no idea this feature existing.

Added shell completions for downstream Alpine package, might serve as reference for other packagers: https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/100135

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[advice] pip-{compile,sync} have completions, why not add some document about it to README.md?

3 participants