Developing with GeoScript

This section describes how to set up a GeoScript development environment.

Install Jython

Jython version 2.5.1 or greater is required for GeoScript.

• Install Jython

  For the remainder of the document the Jython installation root will be referred to as JYTHON_HOME.

Install setuptools

1. Downlaod ez_setup.py

2. Execute ez_setup.py with the jython command:

   $ <JYTHON_HOME>/bin/jython ez_setup.py

Upon success <JYTYON_HOME>/bin/easy_install will be created.

Install virtualenv

Note

Creating a virtualenv for GeoScript is not neccessary but is highly recomended.

1. Using easy_install installed in the previous section easy install the virtualenv library:

   $ <JYTHON_HOME>/bin/easy_install virtualenv

2. Create a new virtualenv named geoscript:

   $ <JYTHON_HOME>/bin/virtualenv geoscript

3. Activate the geoscript virtualenv:

   $ source geoscript/bin/activate

Obtain Source Code

The GeoScript sources are stored in a git repository hosted at github.

1. Install git

2. Clone the geoscript git repository:

   (geoscript)$ git clone git://github.com/jdeolive/geoscript-py.git

Obtain GeoTools Libraries

GeoScript requires the GeoTools libraries to function. There are a number of ways to obtain them.

Maven

If `Apache Maven <>`_ is installed on the system execute the following command from the root of the local git repository:

$ mvn install

Upon success the required GeoTools libraries will be located in the jars directory.

Ant

If `Apache Ant <>`_ is installed on the system execute the ant comand from the root of the local git repository:

$ ant

Upon success the required GeoTools libraries will be located in the jars directory.

Download

If neither of the above methods are appealing:

1. Download the latest GeoTools 2.6 release
2. Unpack the zip archive
3. Copy geotools-2.6.?/*.jar into the jars directory

Setup the CLASSPATH

Once the GeoTools libraries are located in the jars directory source the classpath file located in the root the local git repository:

$ source classpath

Install nose

Running GeoScript unit tests requires the nose library.

• Easy install nose:

  (geoscript)$ easy_install nose

Install sphinx

Writing GeoScript documentation requires the sphinx library.

• Easy install sphinx:

  (geoscript)$ easy_install sphinx