| Installing TransWarp |
Installing PEAK |
| |
|
| TransWarp Release 0.2 preview 1 |
PEAK Release 0.5 alpha 1 |
| |
|
| Copyright (C) 2001,2002 by Phillip J. Eby, All rights reserved. |
Copyright (C) 1996-2002 by Phillip J. Eby and Tyler C. Sarna. |
| This software may be used under the same terms as Zope or Python. |
All rights reserved. This software may be used under the same terms |
| THERE ARE ABSOLUTELY NO WARRANTIES OF ANY KIND. Code quality varies |
as Zope or Python. THERE ARE ABSOLUTELY NO WARRANTIES OF ANY KIND. |
| from "alpha" to "experimental pre-alpha". :) |
Code quality varies between modules, from "beta" to "experimental |
| |
pre-alpha". :) |
| |
|
| |
|
| SYSTEM REQUIREMENTS |
SYSTEM REQUIREMENTS |
| |
|
| Basic installation requires Python 2.2, and the Zope 'Interface' package. |
Basic installation requires Python 2.2.1, and the Zope 'Interface' package. |
| If you want to run the test suite or use any of TransWarp's frameworks |
If you want to run the test suite or use any of PEAK's frameworks |
| (e.g. database interaction, UML/XMI processing, etc.), you will also need |
(e.g. database interaction, UML/XMI processing, etc.), you will also need |
| Aaron Watters' 'kjbuckets' library for your version of Python. See |
Aaron Watters' 'kjbuckets' library for your version of Python. See |
| "Obtaining and Installing Dependencies" below if you do not already have |
"Obtaining and Installing Dependencies" below if you do not already have |
| the 'Interface' package or the 'kjbuckets' module. |
the 'Interface' package or the 'kjbuckets' module. |
| |
|
| Note: if you have installed previous versions of TransWarp, be sure to |
Note: if you have installed previous versions of PEAK or TransWarp, be |
| remove them before installing this one. A lot of things have moved, |
sure to remove them before installing this one. A lot of things have |
| been removed, or just plain ain't the same. |
moved, been removed, or just plain ain't the same. |
| |
|
| |
|
| BASIC INSTALLATION |
BASIC INSTALLATION |
| |
|
| TransWarp is distributed using the now-standard Python 'distutils' protocol. |
PEAK is distributed using the now-standard Python 'distutils' protocol. |
| Just unpack the archive, go to the directory containing 'setup.py', and run:: |
Just unpack the archive, go to the directory containing 'setup.py', and run:: |
| |
|
| python setup.py install |
python setup.py install |
| |
|
| TransWarp will be installed in the "site-packages" directory of your Python |
PEAK will be installed in the 'site-packages' directory of your Python |
| installation. (Unless directed elsewhere; see the "Installing Python |
installation. (Unless directed elsewhere; see the "Installing Python |
| Modules" section of the Python manuals for details on customizing |
Modules" section of the Python manuals for details on customizing |
| installation locations, etc.). |
installation locations, etc.). |
| |
|
| |
|
| OBTAINING AND INSTALLING DEPENDENCIES |
|
| |
|
| Aaron Watters' 'kjbuckets' Module |
|
| |
|
| See "http://phd.pp.ru/Software/Python/#kjbuckets":http://phd.pp.ru/Software/Python/#kjbuckets |
|
| for information on downloading and installing kjbuckets for various |
|
| platforms and versions of Python. Note that if you're on Windows, all you |
|
| need to do is copy the '2.2/kjbuckets.pyd' to |
|
| '/Python22/Lib/site-packages/kjbuckets.pyd', and you're done. On other |
|
| platforms, install as you would any other Python module, with:: |
|
| |
|
| python setup.py install |
THIRD PARTY SOFTWARE INCLUDED WITH PEAK |
| |
|
| Note: if you aren't on Windows, and for some reason can't compile the |
Aaron Watters' 'kjbuckets' Module |
| kjbuckets module, you can as a last resort download this file: |
|
| |
|
| "http://www.chordate.com/kwParsing/kjbuckets0.py":http://www.chordate.com/kwParsing/kjbuckets0.py |
PEAK now includes a copy of Aaron Watters' 'kjbuckets' module for |
| |
your convenience, and automatically installs it alongside PEAK in |
| |
your Python 'site-packages' directory. (Note that this will overwrite |
| |
any existing installation of the 'kjbuckets' module.) |
| |
|
| Rename it to "kjbuckets.py", and place it in your Python path. This runs |
'kjbuckets' is copyright Aaron Watters and contributors; please see |
| slower than the C version, but it'll do in a pinch. |
the 'src/kjbuckets/COPYRIGHT.txt' file for details of its license. |
| |
|
| |
|
| The Zope 'Interface' Package |
The Zope 'Interface' Package |
| |
|
| The easiest place to find a copy of the Interface package is in the |
PEAK now includes a (bug-fixed) version of the Zope 'Interface' package. |
| 'lib/python' directory of a Zope installation. Just copy it over to your |
It's automatically installed alongside PEAK in your 'site-packages' |
| main Python path, or add the 'lib/python' directory to your Python path. |
directory. (Note that this will overwrite any existing installation of |
| |
the 'Interface' package.) The 'Interface' package is copyright Zope |
| |
Corporation and Contributors; please see the 'src/Interface/LICENSE.txt' |
| |
file for details of its license. Modifications were made to this |
| |
distribution of the 'Interface' package to fix the "metaclass implements" |
| |
bug documented at: |
| |
|
| |
"http://collector.zope.org/Zope3-dev/82":http://collector.zope.org/Zope3-dev/82 |
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| Failing that, you can download a copy direct from Zope.org's CVS repository: |
|
| |
|
| "http://cvs.zope.org/Packages/Interface/Interface.tar.gz?tarball=1":http://cvs.zope.org/Packages/Interface/Interface.tar.gz?tarball=1 |
|
| |
|
| |
|
| TESTING YOUR INSTALLATION |
TESTING YOUR INSTALLATION |
| |
|
| TransWarp comes with a moderately-sized built-in test suite. If you wish to |
PEAK comes with a moderately-sized built-in test suite. If you wish to |
| run it after installation, you can do so like this:: |
run it after installation, you can do so like this:: |
| |
|
| python setup.py test |
python setup.py test |
| |
|
| This will run about 75 tests on various parts of TransWarp. If you have |
This will run about 75 tests on various parts of PEAK. If you have |
| installed everything correctly, 100% of the tests should succeed. If |
installed everything correctly, 100% of the tests should succeed. If |
| you're missing any needed parts, you will probably be unable to run the |
you're missing any needed parts, you will probably be unable to run the |
| tests at all. |
tests at all. |
| If you'd like to run only a portion of the test suite, you can supply |
If you'd like to run only a portion of the test suite, you can supply |
| the '--test-module' or '-m' option to the test command as follows:: |
the '--test-module' or '-m' option to the test command as follows:: |
| |
|
| python setup.py test --test-module=TW.Database.tests |
python setup.py test --test-module=peak.util.tests |
| |
|
| python setup.py test -m TW.API.tests |
python setup.py test -m peak.api.tests |
| |
|
| And so on. You can also use 'python setup.py -q test' to make the tests |
And so on. You can also use 'python setup.py -q test' to make the tests |
| run more "quietly". |
run more "quietly". |
Diff of /PEAK/INSTALL.txt
Parent Directory
| 
Revision Log