Installing PEAK |
Installing PEAK |
|
|
PEAK Release 0.5 alpha 2 |
PEAK Release 0.5 alpha 4 |
|
|
Copyright (C) 1996-2003 by Phillip J. Eby and Tyler C. Sarna. |
Copyright (C) 1996-2004 by Phillip J. Eby and Tyler C. Sarna. |
All rights reserved. This software may be used under the same terms |
All rights reserved. This software may be used under the same terms |
as Zope or Python. THERE ARE ABSOLUTELY NO WARRANTIES OF ANY KIND. |
as Zope or Python. THERE ARE ABSOLUTELY NO WARRANTIES OF ANY KIND. |
Code quality varies between modules, from "beta" to "experimental |
Code quality varies between modules, from "beta" to "experimental |
|
|
SYSTEM REQUIREMENTS |
SYSTEM REQUIREMENTS |
|
|
Python 2.2.2 or better is required. Some portions of PEAK may support only |
Python 2.3.4 or better is required. Some portions of PEAK may support only |
POSIX-like and/or Windows operating systems. Installation from a source |
POSIX-like and/or Windows operating systems. Installation from a source |
distribution requires a C compiler that works with Python. |
distribution requires a C compiler that works with Python. |
|
|
|
|
(Note: for the Win32 installer release, just run the .exe file.) |
(Note: for the Win32 installer release, just run the .exe file.) |
|
|
SCRIPTS |
SCRIPTS, BATCH FILES, AND '#!' |
|
|
PEAK installs a Python script named 'peak'. 'peak' is an application |
PEAK installs a Python script named 'peak'. 'peak' is an application |
bootstrap script that can invoke any object that is referenceable via |
bootstrap script that can invoke any object that is referenceable via |
|
|
|
|
|
|
|
The interpretation of '#!' lines is highly OS-dependent. Some operating |
|
systems limit the length of '#!' lines to 32, 80, 127, or 255 characters. |
|
Some operating systems require a space after '#!', and or require the path |
|
that follows to be absolute. Some operating systems will search the 'PATH' |
|
environment variable for the specified interpreter, others will not. When |
|
creating programs that use '#!' lines, or using such programs written by |
|
others, be sure to adjust the line as appropriate for your operating system. |
|
For more information on this subject, you can visit the |
|
"shebang site":http://homepages.cwi.nl/~aeb/std/shebang/, which lists useful |
|
'#!' line information for various operating systems. |
|
|
|
Note that Windows does not support '#!' lines at all, so programs that use |
|
them must be run using batch files when run on Windows, unless you have a |
|
Unix-like shell available (e.g. Cygwin). |
|
|
|
|
TESTING YOUR INSTALLATION |
TESTING YOUR INSTALLATION |
|
|
PEAK 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 |
|
|
peak test |
peak test |
|
|
This will run over 120 tests on various parts of PEAK. If you have |
This will run over 800 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 |
anything is broken, you will probably be unable to run the tests at all. |
anything is broken, you will probably be unable to run the tests at all. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
THIRD PARTY SOFTWARE INCLUDED WITH PEAK |
THIRD PARTY SOFTWARE INCLUDED WITH PEAK |
|
|
Aaron Watters' 'kjbuckets' Module |
Aaron Watters' 'kjbuckets' Module |
|
|
PEAK now includes a copy of Aaron Watters' 'kjbuckets' module for |
Use of this module is deprecated; if your software depends on it, you must |
your convenience, and automatically installs it alongside PEAK in |
supply a '--with-kjbuckets' argument to 'setup.py' in order to build and |
your Python 'site-packages' directory. (Note that this will overwrite |
install it. Please use an alternate distribution of kjbuckets or port your |
any existing installation of the 'kjbuckets' module.) |
software to use the Python 2.3 'Set' type and the 'peak.util.Graph' module, |
|
as appropriate. |
|
|
'kjbuckets' is copyright Aaron Watters and contributors; please see |
'kjbuckets' is copyright Aaron Watters and contributors; please see |
the 'src/kjbuckets/COPYRIGHT.txt' file for details of its license. |
the 'src/kjbuckets/COPYRIGHT.txt' file for details of its license. |
|
|
|
|
The Zope 3 'persistence' and 'ZConfig' Packages |
The Zope 3 'persistence' and 'ZConfig' Packages |
|
|
PEAK includes a copy of the following packages from the Zope X3 Milestone 2 |
PEAK includes a copy of the following packages from the Zope X3 Milestone 2 |
will not install any of the Zope packages listed above, in order to avoid |
will not install any of the Zope packages listed above, in order to avoid |
overwriting newer versions from your Zope installation. |
overwriting newer versions from your Zope installation. |
|
|
The 'persistence' and 'ZConfig' packages are Copyright Zope Corporation |
The 'persistence' and 'ZConfig' packages are Copyright Zope Corporation and |
and contributors; please see the 'LICENSE.txt' files in their directories |
contributors; please see the 'LICENSE.txt' files in their directories for |
for details of their licenses. |
details of their licenses. |
|
|
|
|
The 'fcgiapp' Module |
The 'fcgiapp' Module |