3 It's always a good idea to use virtualenv to develop python software.
5 1. Install pip, virtualenv (python-pip, python-virtualenv packages)
7 Because we're going to recompile our dependencies, we'll also need
10 - For the MySQL/MariaDB setups: mariadb-devel (Fedora)
12 2. Create a new virtual environement. Virtual environments are "instances" of
13 your system python, without any of the extra python packages installed.
14 Inside a virtual env, we'll just install the dependencies needed for
15 patchwork and run it from there.
17 Virtual envs are useful to develop and deploy patchwork against a "well
18 known" set of dependencies. They can also be used to test patchwork against
19 several versions of django, creating a separate virtual env per version.
21 $ virtualenv django-1.7
23 will create a virtual env called 'django-1.7' in eponymous directory.
25 3. Activate a virtual environment
27 $ sources django-1.7/bin/activate
30 The shell prompt is preprended with the virtual env name.
32 4. Install the required dependencies
34 To ease this task, it's customary to maintain a list of dependencies in a
35 text file and install them in one go. One can maintain such a list of
36 dependencies per interesting configuration.
38 (django-1.7)$ pip install -r docs/requirements-django-1.7-mysql.txt
40 Of course, this is a one-time step, once installed in the virtual
41 environment, no need to to install the requirements everytime.
43 5. Now one can run patchwork within that environment
45 (django-1.7)$ ./apps/manage.py --version
47 (django-1.7)$ ./apps/manage.py runserver
49 6. To exit the virtual environment
51 (django-1.7)$ deactivate