dotfiles/zsh/.oh-my-zsh/custom/plugins/google3

Completion plugin for Piper / Google3

Basics

This plugin shows "abbreviated" pathnames in Piper, as well as supports tilde expansion and autocomplete to your workspaces in Piper.

To use it, copy the google3 directory (/google/data/ro/users/mw/mweigel/oh-my-zsh/plugins/google3) to your custom plugin directory (by default this would be ~/.oh-my-zsh/custom/plugins) and add google3 to the plugins array in your zshrc file:

plugins=(... google3)

If you aren't using Oh-My-Zsh, copy the file google3.plugin.zsh somewhere local on your workstation and source it from your zshrc file. For example if you copied it to ~/.google3.plugin.zsh then you might add

source ~/.google3.plugin.zsh

To your zshrc.

Examples

Then, if you have a CitC client named "pager-setup" and you wanted to go to the directory /google/src/cloud/{{USERNAME}}/pager-setup, you could issue the following command:

{{USERNAME}}:~$ cd ~[pager-setup:]
{{USERNAME}}:~[pager-setup:]$ pwd
/google/src/cloud/{{USERNAME}}/pager-setup
{{USERNAME}}:~[pager-setup:]$ 

You can also rely on tab-completion, e.g. hitting tab after typing the following:

{{USERNAME}}:~$ cd ~[pa

would - assuming you only have one Citc client that begins with "pa" - expand to "pager-setup".

By default it will also smoosh "google3/java/com/google" in a path down to "g3/jcg" and "google3/javatests/com/google" down to "g3/jtcg". This can be disabled by setting the environment variable GOOGLE3_PLUGIN_DISABLE_JCG to "true".

From Zsh Hacks, this plugin also incorporates the shell function jt for Java developers to quickly switch back and forth between the current directory in the java hierarchy and the javatests hierarchy.

Changes

The code for this plugin resides in google3/experimental/users/mweigel/oh-my-zsh/plugins/google3/. CLs are gratefully reviewed, just add reviewer: mweigel