giboEasy access to gitignore boilerplates
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 dump Swift Xcode >> .gitignore
For additional usage instructions, run gibo help
.
Installation
Homebrew
Installation on OS X usingbrew install gibo
Installation on Fedora Linux
gibo
is avaiable as a COPR repository. It provides packages for main script and bash / zsh completions:
dnf copr enable saschpe/gibo
dnf install gibo gibo-bash-completion gibo-zsh-completion
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 update # 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 update
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
Just type the following command.
$ docker run --rm simonwhitaker/gibo
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 in your $fpath
. The convention for autoloaded functions used in completion is that they start with an underscore, so I suggest you rename it to _gibo
.
Alternatively, you can use gibo-completion.zsh
as an oh-my-zsh plugin by following these instructions.
fish instructions
Copy gibo.fish
to somewhere in your $fish_complete_path
.
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 dump 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.