gibo: fast access to .gitignore boilerplates

gibo (short for .gitignore boilerplates) is a shell script to help you easily access .gitignore boilerplates from github.com/github/gitignore.

Typical usage

$ gibo Python TextMate >> .gitignore

For additional usage instructions, run gibo without arguments.

Installation

Installation on OS X using Homebrew

brew install gibo

Upgrade on OS X using Homebrew

brew upgrade gibo

Installation on other (*nix) platforms

Just download gibo and put it somewhere on your $PATH. Then:

chmod +x /path/to/gibo   # Make gibo executable
gibo -u                  # Initialise gibo

You can automate this with the following one-liner (assuming ~/bin is on your $PATH).

curl -L https://raw.github.com/simonwhitaker/gibo/master/gibo \
    -so ~/bin/gibo && chmod +x ~/bin/gibo && gibo -u

Installation on Windows

using scoop

The easiest way to install gibo on Windows is to use scoop, a PowerShell-based package-manager of sorts for Windows:

scoop update
scoop install gibo

A great benefit to using scoop, is that it provides an easy way to update its packages, including gibo:

scoop update
scoop update gibo

git installation

You can download the whole gibo repo directly from GitHub:

md "C:\Users\<Your User>\bin"
cd /D "C:\Users\<Your User>\bin"
git clone https://github.com/simonwhitaker/gibo.git gibo

Then add the full gibo directory (C:\Users\<Your User>\bin\gibo) to your system's PATH environment variable.

manual installation

To manually install only the gibo.bat file, download it to your computer and save it to any directory that is in your PATH.

Right-click this link and select 'Save target as...' (or 'Save link as...' depending on your browser) to save it to your computer.

A good directory to put the file is C:\Users\<Your User>\bin and add that directory to your system's PATH environment variable. Where ever you put it, make sure the batch file is accessible via where gibo.

Installation on Docker

$ docker build . -t simonwhitaker/gibo

Running on Docker

$ docker run simonwhitaker/gibo --list

Tab completion in bash, zsh and fish

bash, zsh and fish users can enjoy the deluxe gibo experience by enabling tab completion of available boilerplate names.

Sorry, there is no tab completion support in Windows.

bash instructions

Copy gibo-completion.bash into a bash_completion.d folder:

• /etc/bash_completion.d
• /usr/local/etc/bash_completion.d
• ~/bash_completion.d

or copy it somewhere (e.g. ~/.gibo-completion.bash) and put the following in your .bashrc:

source ~/.gibo-completion.bash

zsh instructions

Copy gibo-completion.zsh somewhere (e.g. ~/.zsh/_gibo) and put the following in your .zshrc:

fpath=(~/.zsh $fpath)

Alternatively, you can use gibo-completion.zsh as an oh-my-zsh plugin by following these instructions.

fish instructions

Copy gibo-completion.fish to ~/.config/fish/completions/

Use gibo to generate .hgignore files

The glob .hgignore syntax for Mercurial is compatible with .gitignore syntax. This means that you can use gibo to generate .hgignore files, as long as the .hgignore files use the glob syntax:

echo 'syntax: glob' > .hgignore
$ gibo Python TextMate >> .hgignore

Credits

gibo was written by Simon Whitaker (@s1mn)

Thanks to yevgenko for adding the curl-based installation instructions.

Thanks to kodybrown for adding the gibo.bat batch file for Windows.