If your current operating system is Windows it is recommend to either get a Linux-like environment (e.g. extend the console with Cywing) or better get Wubi (Windows Ubuntu Installer) as a dual boot system. The latter one is very straightforward.
In order to set up a local development version of Denigma on Windows do the following steps:
Install your Developer version of Denigma
First we get GIT, the cat [http://msysgit.github.com/]. For instance from here [http://denigma.de/url/3q]. The installation will ask to choose:
a) use [Git](/blog/485/) Bash only
b) run [Git](/blog/485/) from windows command prompt
c) run [Git](/blog/485/) and included Unix tools from windows command prompt
Select c).
Then open the command prompt, navigate to a folder where the Project shall live and run the following command:
git clone https://github.com/hevok/denigma
Preparing Denigma Programming Environment
Install Python at first if you haven not yet [http://www.python.org/]. We are going with latest version of Python 2 (i.e. 2.7.3), as Python 3 is not yet well established. Many libraries are still in stage 2. So with Python 3 you would have a much smaller application ecosystem.
If you are on a 64bit machine install the following executable [http://www.python.org/ftp/python/2.7.3/python-2.7.3.amd64.msi] under preferentially C:\Python27\.
ii) Set Environment Variables:
Next step is to set the environment variables. For this follow: Start > Control Panel > Double click on System Icon System Properties. There under system variables edit PATH and include in the front the following string: C:\Python27\;C:\Python27\Scripts\.
iii) Install PyCharm:
Then install a Interactive Development Environment for Python and Django [http://www.denigma.de/tutorials/77/view/].
Configuring Virtual Environment:
Download the latest easy Installer for Windows that fits the installed Python version (e.g. the exe at the bottom of [http://pypi.python.org/pypi/setuptools]) and install it.
If you are on a 64bit machine consider to download ez_setup.py, copy it to C:\Python27, navigate into this folder in the DOS prompt and install it by running python ez_setup.py [http://peak.telecommunity.com/dist/ez_setup.py].
Open a new DOS prompt and run easy_install pip as well as pip install virtualenv.
Finally, navigate to the Denigma Project folder and create a virtual environment:
virtualenv env --system-site packages
OR
python virtualenv.py env --system-site packages # only if virtualenv installation failed
C:\dev\denigma\env\Scripts\activate
Starting Denigma:
Now its time to prepare Denigma for running. First install some prerequisites:
[http://www.lfd.uci.edu/~gohlke/pythonlibs/#Numpy] numpy-MKL-1.7.0rc1.win-amd64-py2.7.exe
[http://www.lfd.uci.edu/~gohlke/pythonlibs/#Biopython] biopython-1.60.win-amd64-py2.7.exe
[http://www.lfd.uci.edu/~gohlke/pythonlibs/#PyCogent] cogent-1.5.3.win-amd64-py2.7.exe
[http://www.lfd.uci.edu/~gohlke/pythonlibs/#PIL] PIL-1.1.7.win-amd64-py2.7.exe
[http://www.lfd.uci.edu/~gohlke/pythonlibs/#mysql-python] MySQL-python-1.2.4.win-amd64-py2.7.exe
[http://www.lfd.uci.edu/~gohlke/pythonlibs/#ReportLab] Reportlab-2.5.win-amd64-py2.7.exe
[http://www.lfd.uci.edu/~gohlke/pythonlibs/#Greenlet] greenlet-0.4.0.win-amd64-py2.7.exe
[http://www.lfd.uci.edu/~gohlke/pythonlibs/#Gevent] gevent-0.13.8.win-amd64-py2.7.exe
Then install all the other required libraries:
pip install -r denigma/requirements/project.txt
python manage.py syncdb --all
python manage.py migrate --fake
python manage.py runserver
Open localhost:8000 in the browser and it is accomplished.
Modify Denigma:
i) modify locally
git add modified_file
git commit -m "Describe the change here"
ii) upload you modification to the online Denigma
git push
Keep Denigma updated
Regularly pull any Changes in Denigma source code:
git pull