Hello,
Git-completion is a friendly fork of the official Git completion and
prompt scripts for Zsh and Bash.
The main goal is to provide a more up-to-date completion for Zsh (I'm
the developer), which is basically just a wrapper around the Bash
completion.
Compared to Git upstream, you get many benefits for Zsh, but there's
also benefits for Bash users too.
If you use the official Zsh completion, the main benefit is that it's
blazingly fast. Simply doing "git log <tab>" on the Linux kernel (with
3k+ refs) takes several seconds on the official Zsh completion (about
3 seconds on my machine), with git-complete it's *instantaneous*.
There's other benefits too. Since the Bash completion is actively
maintained by Git developers, everything works as they intend too.
For example "git send-email <tab>" correctly completes branches, as
opposed to files in the Zsh official completion. Also, complex aliases
such as '!f () { }; f' are correctly identified and completed
out-of-the-box.
It's a sister project of the Oh My Zsh gitfast plugin [1], which I maintain too.
Since the last version, the baseline has been updated to git 2.32, but
there's a bunch of other improvements and fixes.
In total there are 44 patches [2] (3 of those 47 were applied) on top
of git's master (plus tests and workarounds).
For installation instructions, and more information, check the wiki
[3], but basically.
* make install
* fpath=(~/.local/share/git-completion/zsh $fpath)
And for Arch Linux users I've created an AUR package: [4].
Cheers.
[1] https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/gitfast
[2] https://lore.kernel.org/git/20210101021622.798041-1-felipe.contreras@xxxxxxxxx/
[3] https://github.com/felipec/git-completion/wiki/Zsh
[4] https://aur.archlinux.org/packages/git-completion/
--
Felipe Contreras
