README
======

GASP (Graphics API for Students of Python)

A library built on Cairo Graphics that enables absolute beginners to write 
1980's style arcade games as an introduction to python.

Homepage: http://launchpad.net/gasp-code
Help: https://answers.launchpad.net/gasp-code
FAQ: https://answers.launchpad.net/gasp-code/+faqs

Bugs/Patches Welcome: http://bugs.launchpad.net/gasp-code/+filebug

There is an excellent coursebook <http://openbookproject.net/pybiblio/gasp/>
which goes over learning to use GASP in your own applications, which is
designed to supplement (but can be used apart from)
<http://openbookproject.net/thinkCSpy/>, a full-fledged introduction to
the Python programming language.

DEPENDENCIES
======
GASP requires the following to function:
 * python-cairo
 * python-gobject
 * python-gtk2
 * python-multiprocessing (only on python 2.5)

GASP is tested with Python 2.5 and Python 2.6. Python 3.0 is unsupported at
this time.

INSTALLING FROM SOURCE
======

NOTE: It may be easier to use a pre-built binary for your platform, if it
exists. Please see https://launchpad.net/gasp-code/+download for more details.

In order to install GASP, you need to have setuptools installed. 

Please see http://pypi.python.org/pypi/setuptools for instructions on 
installing setuptools for your platform. 

Then, run:
    python gasp/setup.py install
    
Or, using easy_install:
    easy_install gasp


COPYRIGHT
======
This package is Copyright © 2009 the GASP Development Team, as detailed in
the AUTHORS file shipped with this package. 

This package is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version. See the COPYING file for more details.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

