[Subversion] / PEAK / INSTALL.txt  

View of /PEAK/INSTALL.txt

Parent Directory | Revision Log
Revision: 551 - (download)
Thu Oct 10 20:34:10 2002 UTC (21 years, 5 months ago) by pje
File size: 3360 byte(s)
Added 'kjbuckets' extension to setup.py; updated installation doc and
copyright notices accordingly.
Installing PEAK 

 PEAK Release 0.5 alpha 1

 Copyright (C) 1996-2002 by Phillip J. Eby and Tyler C. Sarna.
 All rights reserved.  This software may be used under the same terms
 as Zope or Python.  THERE ARE ABSOLUTELY NO WARRANTIES OF ANY KIND.
 Code quality varies between modules, from "beta" to "experimental
 pre-alpha".  :)


 SYSTEM REQUIREMENTS

  Basic installation requires Python 2.2.1, and the Zope 'Interface' package.
  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
  Aaron Watters' 'kjbuckets' library for your version of Python.  See
  "Obtaining and Installing Dependencies" below if you do not already have
  the 'Interface' package or the 'kjbuckets' module.

  Note: if you have installed previous versions of PEAK or TransWarp, be
  sure to remove them before installing this one.  A lot of things have
  moved, been removed, or just plain ain't the same.


 BASIC INSTALLATION

  PEAK is distributed using the now-standard Python 'distutils' protocol.
  Just unpack the archive, go to the directory containing 'setup.py', and run::

    python setup.py install

  PEAK will be installed in the 'site-packages' directory of your Python
  installation.  (Unless directed elsewhere; see the "Installing Python 
  Modules" section of the Python manuals for details on customizing
  installation locations, etc.).





 THIRD PARTY SOFTWARE INCLUDED WITH PEAK

  Aaron Watters' 'kjbuckets' Module

   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.)

   'kjbuckets' is copyright Aaron Watters and contributors; please see
   the 'src/kjbuckets/COPYRIGHT.txt' file for details of its license.


  The Zope 'Interface' Package

   PEAK now includes a (bug-fixed) version of the Zope 'Interface' package.
   It's automatically installed alongside PEAK in your 'site-packages'
   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















   

 TESTING YOUR INSTALLATION

  PEAK comes with a moderately-sized built-in test suite.  If you wish to
  run it after installation, you can do so like this::

   python setup.py test

  This will run about 75 tests on various parts of PEAK.  If you have
  installed everything correctly, 100% of the tests should succeed.  If
  you're missing any needed parts, you will probably be unable to run the
  tests at all.

  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::

    python setup.py test --test-module=peak.util.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
  run more "quietly".


cvs-admin@eby-sarna.com

Powered by ViewCVS 1.0-dev

ViewCVS and CVS Help