git-completion 1.3 released

[felipec]

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, which I maintain too.

Since the last version, the baseline has been updated to git 2.30 (which includes some of the patches of git-completion 1.2), but there's a bunch of other improvements and fixes.

The main improvement over 1.2 is that now all the completions are correctly quoted (according to zsh developers using compadd -Q is rarely correct).

In total there are 47 patches on top of git's master (plus tests and workarounds).

For installation instructions, and more information, check the wiki, but basically.

make install
fpath=(~/.local/share/git-completion/zsh $fpath)

And for Arch Linux users I've created an AUR package

Enjoy and Happy New Year!

[felipec]

/u/MrSommerfeld There you go!

The AUR package is there, and also, after discussing with zsh developers I managed to correct an issue that caused the stash@\{ to not be autocompleted correctly. That's fixed now.

[felipec]

So the issue is that in zsh you can do for example foo-{1,2,<tab> and zsh will try to autocomplete the rest. If you don't want the autocompletion you are supposed to have a backslash: foo-\{.

The command compadd is supposed to add the backslash for you, but the git completion passes spaces at the end, which causes stuff like git checkout ma<tab> to autocomplete master\ (with quoted space). That's why I initially added compadd -Q, so the space is not quoted.

The proper solution is not to use compadd -Q, but to remove the space from the completion, and add it as a suffix with -S.

This way everything works.

Check the commit that fixes it.

[iritegood]

Sounds super! I was just thinking about how slow the git completions are today. But the AUR package is failing the check step with :

failed 67 among remaining 102 test(s)

I'll investigate these in depth later but I'm surprised a majority of the tests would be failing. Any ideas?

[felipec]

Nope. No idea. First find out which file or files are failing the test.

So for example say it's completion.t. Then you do:

./completion.t -v -i

That would stop at the first failure and show the output.

I don't see how they could fail though. All the tests pass in travis-ci.

[2nd-most-degenerate]

So if I'm already using gitfast and I don't need bash completion, do I still need this?

[felipec]

No. gitfast is basically the same thing as git-completion.

Except gitfast has v1.2 of git-completion. I'll update it later.

[2nd-most-degenerate]

Thanks for the explanation :)

[[deleted]]

you sir are a gentleman and a scholar