Install from Mercurial on Windows

This article describes how to get the latest source from mercurial to develop or test parpg on Windows systems.

Supported Windows versions

 * We officially support Windows XP (32bit), Window Vista (32 & 64bit) and Windows 7 (32 & 64bit)
 * Older Windows versions like Windows 98, Windows ME are not officially supported
 * Exotic Windows versions with low market penetration like Windows XP (64bit) or Windows Server 2008 are not officially supported either

Install Prerequisites

 * 1) Download and install ActivePython 2.7 (32bit): http://www.activestate.com/activepython/downloads/thank-you?dl=http://downloads.activestate.com/ActivePython/releases/2.7.2.5/ActivePython-2.7.2.5-win32-x86.msi
 * 2) Grab the latest release of PyYAML for Python 2.7 and install it: http://pyyaml.org/download/pyyaml/PyYAML-3.10.win32-py2.7.exe

Python-related notes
This section is just relevant to users who are not using ActivePython 2.7 as recommended by us:
 * Only Python 2.7 will work for the SVN trunk version of PARPG; Python 2.6 and Python 3.x are not supported
 * If you're using the standard CPython 2.7 distribution, add your Python directory to the Windows PATH. A video tutorial how to do that can be found here: http://showmedo.com/videotutorials/video?name=960000&fromSeriesID=96
 * Make sure that you run a 32bit Python 2.7 distribution; our engine of choice FIFE doesn't support 64bit Python distributions on Windows systems at this point
 * Even install a 32bit Python distribution if you're running a 64bit Windows OS; this has been tested and works fine on all supported Windows versions

Install Mercurial client
If you don't already have a mercurial client you can download TortoiseHg.

Mercurial extensions
You will need to install and/or activate the following mercurial extensions before cloning a repository:
 * EolExtension

Install Subversion Client
You also will need a subversion(SVN) client to be able to clone the repository containing the runnable version. If you don't have an SVN client installed yet, download and install TortoiseSVN.

Download and install FIFE 0.3.3r2
PARPG uses the FIFEngine, which can be downloaded from here: http://sourceforge.net/projects/fife/files/active/packages/FIFE-0.3.3r2_installer_win32.exe/download

Clone the PARPG repository
There are 2 repositories which should be of interest to you:

The development repository: http://hg.assembla.com/parpg-core This contains the parpg source files as well as additional files for development, such as unit tests or the pylint file.

The app repository: http://hg.assembla.com/parpg-app This contains the parpg source files, the data files and files that can be used to run/test parpg. This one will need an svn client in addition to the mercurial client.

There are 2 ways of cloning these repositories, either by using the GUI from TortoiseHG or by using the command line

GUI
 * 1) Create a directory where you want to store the files
 * 2) Right-Click on this directory and then move the mouse cursor to TortoiseHG and select Clone
 * 3) Type the URL of the repository that you want to clone into the "Source" field. Leave the other options as they are.
 * 4) Click on the "Clone" Button
 * 5) Especially for the app repository this may take a while.
 * 6) Now you are ready to test/develop parpg.

Command line
 * 1) CD to the directory that you want to contain the parpg directory
 * 2) Type the following command, where  is the URL of the repository you want to clone. Hg clone  A directory will automatically be created.
 * 3) Especially for the app repository this may take a while.
 * 4) Now you are ready to test/develop parpg.

Run PARPG
If you cloned the app repository you can run PARPG by either double-clicking or calling parpg.py from the command line.