root/buildout/shapely.buildout/trunk/README.txt

==================
Shapely - Buildout
==================

This is a buildout system for Shapely. It is based on zc.buildout.


Installation
------------

 $ svn co http://svn.gispython.org/svn/gispy/buildout/shapely.buildout/trunk shapely.buildout
 $ python bootstrap.py
 $ ./bin/buildout


Testing
-------

The test suite is run by::

 $ ./bin/test

Because Shapely uses the GEOS library that is installed within the
buildout sandbox, you need to tell the system where to find the
dynamic libraries. Simply edit the ``setenv`` script located in the
root of the buildout to match your system and run it::

  $ . ./setenv


Developing
----------

The Shapely code is under ``src/Shapely``. It is installed as a
development egg so any changes made to the source code are immediately
available for use.

There is a python interpreter available under::

  $ ./bin/python

that has Shapely available for importing and use. You need to setup
your LD_LIBRARY_PATH first. See the notes about ``setenv`` in the
``Testing`` section above.

If you're using multiple zc.buildout based buildouts for your
development, you may wish to share the downloaded eggs and tarballs
among them to save disk space. To do this create a file::

  ~/.buildout/default.cfg

and put the following there::

  [buildout]
  eggs = /path/to/shared/egg/container
  download-directory = /path/to/shared/package/container