= Setup for Development Environment =

{{{#!wiki caution
Sorry, all this has only been tested on Linux, and some of the tooling used will almost certainly not work on Windows, so for now it's Linux or bust.  And to get even more specific, things have only been tested on Debian and Ubuntu thus far.
}}}

Okay, with that out of the way, we know you have Python already.

The only other requirement at this stage is [[https://virtualenvwrapper.readthedocs.io/en/latest/|virtualenvwrapper]].  There is more than one way to get that; really the important thing is where we wind up defining the "workon home" folder.  For the sake of example, this should work:

{{{
sudo apt-get install virtualenvwrapper
}}}

Next we'll prep the "workon home" folder a bit:

{{{
sudo mkdir /srv/envs
sudo chown you:you /srv/envs
}}}

Please note, you're free to use a different path for that, but know that '''all''' docs for Rattail will assume `/srv/envs` as the workon home.

Next you should edit your `~/.bashrc` and add the following:

{{{
export WORKON_HOME=/srv/envs
source /usr/share/virtualenvwrapper/virtualenvwrapper.sh
}}}

Finally, you must logout and then log back in, or perhaps `source ~/.bashrc`, in order to cause virtualenvwrapper to create the initial hook scripts.

At that point you should have access to some new commands, most important of which are:

 * `workon`
 * `mkvirtualenv`