Linux¶
Installing Initial Requirements¶
On Linux we’ll be creating a clean virtualenv, so in addtion we’ll need developer tools (to compile PIL, lxml etc).
Debian and derivatives like Ubuntu and Mint, Including c9.io¶
sudo apt-get update
sudo apt-get install build-essential git python python-dev python-setuptools python-virtualenv python-pip
sudo apt-get install libjpeg-dev libfreetype6 libfreetype6-dev
sudo apt-get build-dep python-imaging
sudo apt-get build-dep python-lxml
Fedora¶
sudo yum groupinstall "Development Tools" "Development Libraries"
sudo yum install git python python-devel python-setuptools python-virtualenv python-pip libjpeg-turbo-devel libpng-devel libxml2-devel libxslt-devel
Creating and Activating the virtualenv¶
Navigate in a terminal to the directory you want the
environment created in (usually under your home directory). We’ll name the
created environment oknesset
.
Once in that directory:
virtualenv oknesset
Warning
In case you have both Python 2 and 3 installed, please make sure the virtualenv is created with Python 2. If that’s not the case, pass the correct python executable to the virtualenv command. e.g:
virtualenv -p python2 oknesset
To check which is the default interpreter virtualenv will use, run
virtualenv -h
and check in the output the default for -p flag.
We need to activate the virtual environment (it mainly modifies the paths so that correct packages and bin directories will be found) each time we wish to work on the code.
In Linux we’ll source the activation script (to set env vars):
cd oknesset/
. bin/activate
Note the changed prompt which includes the virtualenv’s name.
Getting the Source Code (a.k.a Cloning)¶
Now we’ll clone the forked repository into the virutalenv. Make sure you’re in the oknesset directory and run:
git clone https://github.com/your-username/Open-Knesset.git
Replace your-username with the username you’ve registered at GitHub.
Note
You can also clone with ssh keys, in that case follow the github guide on ssh keys. Once you’ve done that, your clone command will look like:
git@github.com:your-username/Open-Knesset.git
For c9.io you will have to use ssh keys - you will need to add c9.io ssh key to your GitHub Profile’s trusted keys.
Note
If you have forked Open-Knesset in the past, make sure you have the latest version before proceeding to installation, by invoking:
git remote add hasadna https://github.com/hasadna/Open-Knesset.git
git pull hasadna master
git push origin master
Installing requirements¶
Still in the terminal with the virtualenv activated, inside the oknesset directory, run:
pip install --upgrade pip
pip install -r Open-Knesset/requirements.txt
And wait …
Once done, proceed to Initial Testing, Development DB & Server.