PyAMF Installation Guide
PyAMF requires Python 2.3 or newer. Python 3.0 isn't supported yet.
Easy Installation
If you have setuptools and the easy_install tool already installed, simply type the following on the command-line to install PyAMF.
easy_install pyamf
Note: you might need root permissions or equivalent for these steps.
If you don't have setuptools and easy_install, first download this file and run:
python ez_setup.py
After easy_install is installed, run easy_install pyamf again. If you run into problems, try the manual installation instructions below.
To upgrade your existing PyAMF installation to the latest version use:
easy_install -U pyamf
Manual Installation
To use PyAMF with Python 2.3 or 2.4, the following software packages must be installed. The easy_install command will automatically
install them for you, as described above, but you can also choose to download and install the packages manually.
You don't need these packages if you're using Python 2.5 or newer.
- fpconst version >= 0.7.2
- ElementTree version >= 1.2.6
- uuid version >= 1.30
- Download and unpack the PyAMF archive of your choice.
- Run the Python-typical setup at the top of the source directory from a command-prompt:
python setup.py install
To disable the installation of the C-extension, supply the --disable-ext option:
python setup.py install --disable-ext
Note: you might need root permissions or equivalent for these steps.
This will byte-compile the Python source code and install it in the site-packages directory of your Python installation.
Optional Extras
PyAMF integrates with the following optional third-party Python libraries:
- wsgiref >= 0.1.2 (included in Python 2.5 and newer)
- SQLAlchemy >= 0.4.0
- Django >= 0.97
- Twisted >= 2.5
- Google App Engine >= 1.0
C-Extension
To modify the cPyAMF extension you need:
- Cython >= 0.10
And run the command below on the .pxd files to create the .c file, which contains the C source for the Python extension module:
cython amf3.pyx
Advanced Options
Because of setuptools you can do, with the release tag, as well as with trunk:
easy_install http://svn.pyamf.org/pyamf/tags/release-0.4.2
To find out about other advanced installation options, run:
easy_install --help
Also see Installing Python Modules for detailed information.
To install PyAMF to a custom location:
easy_install --prefix=/path/to/installdir
To run the unit tests:
python setup.py test