Spring Python is easy to install. It comes with two installable tar balls. One is the core library itself. The other is a set of samples you can optionally install to help get a better understanding of Spring Python. As it is written in pure Python, the installed files are the source code as well, so you can see how Spring Python works.
Note
This installation section does NOT show how to install all the parts needed to develop patches for the Spring Python project. For more information on setting up a developer's environment, please join the Spring Python mailing list at http://lists.springsource.com/listmanager/listinfo/springpython-users where you can ask about current development requirements.
Installing Spring Python currently requires Python 2.4, 2.5, or 2.6. It can also be run on Jython 2.5. At the time of this writing, it hasn't been extended to support Python 3 due to lack of backwards compatibility and immaturity. However, as Python 3 gains acceptance in the user community, Spring Python will move to support it as well.
Spring Python makes it easier to integrate with certain 3rd party libraries. Installation of those 3rd party libraries is not covered in this book. For example, to write queries against an Oracle database, you need to install the cxora package.
The binaries are hosted as tar balls by SpringSource, in the community section. They are non-OS specific and should work on any platform.
- Go to http://www.springsource.org/download/community. You can either fill out the registration information, or simply click on the link to take you to the download site
- Click on Spring Python to see the latest version:
- Download
springpython-<release>.tar.gzto get the core library - Unpack the tarball, and go to the directory containing
setup.py - Type the following command to install Spring Python
$ python setup.py install - You should now be able to test the installation.
$ python
>>> import springpython
>>> dir()
['__builtins__', '__doc__', '__name__', 'springpython']
Spring Python can be installed from source code like many other open source projects. The code is hosted on a subversion repository. The following steps will help you download the code and install it on your machine:
- Type the following command to checkout the latest trunk repository:
$ svn checkout https://src.springframework.org/svn/ se-springpython-py/trunk/springpython springpythonThis will create a local directory
springpythoncontaining the latest changes. - Move in to the directory where
build.pyis located. This script serves as the key tool to build, package, and test Spring Python. Type the following command to generate an installable Spring Python package:$ ./build.py -package - Move to
target/artifacts, the directory containing the newly generated tar balls. - Unpack the tar ball
springpython-<release>.tar.gz, and go to the directory containingsetup.pyand type the following command to install Spring Python:
- You should now be able to test the installation.
$ python
>>> import springpython
>>> dir()
['__builtins__', '__doc__', '__name__', 'springpython']
- Using the subversion repository to fetch source code sets you up to easily install new updates.
- Type the following command to update your checkout.
$ svn update /path/for/springpython - Repeat the steps with
build.py, target/artifacts, andsetup.py.
Note
You can also visually inspect the code using SpringSource's Fisheye viewer at https://fisheye.springframework.org/browse/ se-springpython-py. This provides a way to view the code, change sets, and change logs as well.