Install¶
We offer an easy-to-use install script to install RepoBee on your machine, as outlined in this section.
Requirements¶
RepoBee requires Python 3.6+ and a somewhat up-to-date version of Git (2.0+ to be on the safe side). Officially supported operating systems are Ubuntu 17.04+ and macOS, but RepoBee runs fine on most Linux distributions, and also on WSL on Windows 10. Please report any issues with operating systems and/or Git versions on the issue tracker.
Installing RepoBee¶
RepoBee’s install script will guide you through the installation process. It
will check that you have all necessary software and provide you with links to
relevant resources if you do not. To run the script, you need either bash
or zsh
, but it’s possible to run RepoBee from virtually any shell.
Below you’ll see the command to execute to get and execute the install script.
Note that it requires curl
to be installed.
# for bash
$ bash <(curl -s https://repobee.org/install.sh)
# for zsh
$ zsh <(curl -s https://repobee.org/install.sh)
Tab completion¶
RepoBee supports tab completion (aka auto completion, shell completion, etc) for
bash
and zsh
, but it must be enabled separately after installing RepoBee
by executing a script found in the install directory. The procedure differs
slightly between the two shells.
Note
This guide assumes you’ve installed RepoBee at $HOME/.repobee
. If you
don’t make an active choice saying otherwise, that’s where RepoBee is
installed. The install script also explicitly tells you where it’s
installing RepoBee. If you’ve chosen to install RepoBee in any other
directory, then you need to make the proper path substitutions in the below
instructions.
bash¶
For bash
, simply add the following line to your $HOME/.bashrc
file.
source "$HOME/.repobee/completion/bash_completion.sh"
zsh¶
For zsh
, you must make sure to enable bash completion, and then source the
completion script. The entire thing looks like so.
autoload -Uz compinit
compinit
autoload -Uz bashcompinit
bashcompinit
source "$HOME/.repobee/completion/bash_completion.sh"
Important
You should not have multiple occurences of compinit
and
bashcompinit
in your .zshrc, they should be loaded and executed only
once. If you already have them in there, just make sure to source the
RepoBee bash completion script after compinit and bashcompinit have been
called.
Docker¶
If you’d rather not install RepoBee for some reason, or want to use it for automation scripts, we also offer a Docker image. For this, all you need to do is install Docker, and then follow the instructions in Using RepoBee with Docker.