[Zodb-checkins] CVS: StandaloneZODB - setup.py:1.18 README.txt:1.2
Jeremy Hylton
jeremy@zope.com
Wed, 4 Dec 2002 14:11:31 -0500
Update of /cvs-repository/StandaloneZODB
In directory cvs.zope.org:/tmp/cvs-serv9132
Modified Files:
setup.py README.txt
Log Message:
Try to prevent people from accidentally using this old release.
=== StandaloneZODB/setup.py 1.17 => 1.18 ===
--- StandaloneZODB/setup.py:1.17 Fri Aug 23 13:21:44 2002
+++ StandaloneZODB/setup.py Wed Dec 4 14:11:31 2002
@@ -12,141 +12,4 @@
#
##############################################################################
-import sys
-from distutils.core import setup
-from distutils.extension import Extension
-
-ExtensionClass = Extension(name = 'ExtensionClass',
- sources = ['ExtensionClass/src/ExtensionClass.c'])
-
-Acquisition = Extension(name = 'Acquisition',
- sources = ['ExtensionClass/src/Acquisition.c'])
-
-ComputedAttribute = Extension(name = 'ComputedAttribute',
- sources = ['ExtensionClass/src/ComputedAttribute.c'])
-
-MethodObject = Extension(name = 'MethodObject',
- sources = ['ExtensionClass/src/MethodObject.c'])
-
-Missing = Extension(name = 'Missing',
- sources = ['ExtensionClass/src/Missing.c'])
-
-MultiMapping = Extension(name = 'MultiMapping',
- sources = ['ExtensionClass/src/MultiMapping.c'])
-
-Record = Extension(name = 'Record', sources = ['ExtensionClass/src/Record.c'])
-
-Sync = Extension(name = 'Sync', sources = ['ExtensionClass/src/Sync.c'])
-
-ThreadLock = Extension(name = 'ThreadLock',
- sources = ['ExtensionClass/src/ThreadLock.c'])
-
-include = ['ExtensionClass/src', 'ZODB']
-
-cPersistence = Extension(name = 'ZODB.cPersistence',
- include_dirs = include,
- sources= ['ZODB/cPersistence.c']
- )
-
-cPickleCache = Extension(name = 'ZODB.cPickleCache',
- include_dirs = include,
- sources= ['ZODB/cPickleCache.c']
- )
-
-TimeStamp = Extension(name = 'ZODB.TimeStamp',
- define_macros = [('USE_EXTENSION_CLASS', 1)],
- include_dirs = include,
- sources= ['ZODB/TimeStamp.c']
- )
-
-coptimizations = Extension(name = 'ZODB.coptimizations',
- include_dirs = include,
- sources= ['ZODB/coptimizations.c']
- )
-
-winlock = Extension(name = 'ZODB.winlock',
- include_dirs = include,
- sources = ['ZODB/winlock.c']
- )
-
-oob = Extension(name = "BTrees._OOBTree",
- include_dirs = include,
- sources = ['BTrees/_OOBTree.c'],
- )
-
-oib = Extension(name = "BTrees._OIBTree",
- include_dirs = include,
- sources = ['BTrees/_OIBTree.c'],
- )
-
-iib = Extension(name = "BTrees._IIBTree",
- include_dirs = include,
- sources = ['BTrees/_IIBTree.c'],
- define_macros = [('EXCLUDE_INTSET_SUPPORT', None)],
- )
-
-iob = Extension(name = "BTrees._IOBTree",
- include_dirs = include,
- sources = ['BTrees/_IOBTree.c'],
- define_macros = [('EXCLUDE_INTSET_SUPPORT', None)],
- )
-
-fsb = Extension(name = "BTrees._fsBTree",
- include_dirs = include,
- sources = ['BTrees/_fsBTree.c'],
- define_macros = [('EXCLUDE_INTSET_SUPPORT', None)],
- )
-
-bsddbhelper = Extension(name = 'bsddb3Storage._helper',
- sources = ['bsddb3Storage/bsddb3Storage/_helper.c'])
-
-packages = ['BTrees', 'BTrees.tests',
- 'ZEO', 'ZEO.zrpc', 'ZEO.tests',
- 'ZODB', 'ZODB.tests',
- "Persistence",
- "ThreadedAsync",
- "zLOG", "zLOG.tests",
- "zdaemon", "zdaemon.tests",
- ]
-
-# XXX This doesn't work for source distributions; we need a better way
-# to spell things like this in distutils. Like this, the
-# bsddb3Storage package isn't included in the source distribution.
-# Either this test only makes sense for inclusion in binary releases,
-# or these packages should always be included and client code should
-# test for bsddb3 before expecting this to work; they'll get an
-# ImportError if it's not there.
-#
-try:
- import bsddb3
-except ImportError:
- pass
-else:
- packages.extend(["bsddb3Storage", "bsddb3Storage.tests"])
-
-ext_modules = [ExtensionClass, Acquisition, ComputedAttribute,
- MethodObject, Missing, MultiMapping, Sync,
- ThreadLock, Record, cPersistence, cPickleCache,
- TimeStamp, coptimizations, winlock, oob, oib,
- iib, iob, fsb,
- ]
-
-
-# Don't build this unless using at least Python 2.2
-if sys.hexversion >= 0x020200F0:
- ext_modules.append(bsddbhelper)
-
-
-setup(name="ZODB",
- version="3.0",
- description="Zope Object Database: object database and persistence",
- maintainer="Zope Corporation",
- maintainer_email="zodb-dev@zope.org",
- url = "http://www.zope.org/Wikis/ZODB/FrontPage",
-
- package_dir = {'bsddb3Storage': 'bsddb3Storage/bsddb3Storage'},
- packages = packages,
- ext_modules = ext_modules,
- headers = ['ExtensionClass/src/ExtensionClass.h', 'ZODB/cPersistence.h'],
-
- )
+print "This release is no longer supported. Please use ZODB3 instead."
=== StandaloneZODB/README.txt 1.1 => 1.2 ===
--- StandaloneZODB/README.txt:1.1 Mon Feb 11 18:46:56 2002
+++ StandaloneZODB/README.txt Wed Dec 4 14:11:31 2002
@@ -1,168 +1 @@
-This is the README.txt for StandaloneZODB 1.0.
-
-Please see the LICENSE.txt file for terms and conditions.
-
-Andrew Kuchling's ZODB/ZEO Programming Guide is provided verbatim
-under the terms of the GNU Free Documentation License.
-
-Introduction
-
- The StandaloneZODB package provides a set of tools for using the Z
- Object Database (ZODB) in Python programs separately from Zope.
- The tools you get are identical to the ones provided in Zope,
- because they come from the same source repository. They have been
- packaged for use in non-Zope stand-alone Python applications.
-
- StandaloneZODB is known to work with with all Python versions from
- Python 2.0 to Python 2.2, except for Berkeley storage, which
- requires Python 2.1 or higher (by design). It will not work with
- versions earlier than Python 2.0, and we have no plans to support
- those. Python 2.0 users will need to install unittest.py to run
- the test suite, and this can be downloaded from
-
- http://pyunit.sourceforge.net
-
- For best results, we recommend using Python 2.1.2 or Python 2.2.
-
- Our primary development platform is Linux, but everything should
- work on most Un*x platforms, and we've tested this distribution on
- Windows with the Python 2.2 final release (it may or may not work
- on Windows with earlier Python releases).
-
- The components you get with the StandaloneZODB release are as follows:
-
- - Core ZODB, including the persistence machinery
- - Standard storages such as FileStorage
- - Supporting modules such as ExtensionClass
- - The persistent BTrees modules
- - ZEO
- - Experimental Berkeley storages
- - Some documentation <wink>
-
-Prerequisites
-
- You must have Python installed. We recommend either Python 2.1.2
- or Python 2.2. (2.0 works, but see the caveats above.) If you've
- installed Python from RPM, be sure that you've installed the
- development RPMs too, since StandaloneZODB builds Python
- extensions.
-
- If you intend to use the experimental Berkeley storages, you will
- need to install both the Sleepycat libraries, and PyBSDDB, the
- next generation of Berkeley DB Python wrapper. StandaloneZODB
- will not work with versions of Berkeley DB earlier than 3.3.x and
- it will not work with the Berkeley DB wrapper that comes standard
- with Python. Also remember, that the Berkeley storages only work
- with Python 2.1 or higher (by design).
-
- (Windows users, skip ahead...)
-
- If you are on Linux or other Un*x-like operating system, start by
- going to www.sleepycat.com and downloading the Berkeley DB source
- release. As of this writing, we recommend that you use Berkeley
- DB 3.3.11 which was the last release of the 3.x series. (We
- haven't yet verified that everything works with Berkeley DB
- 4.0.14.) Follow the install instructions in the Sleepycat
- documentation. We recommend that you install in the default
- location, i.e. /usr/local/BerkeleyDB.3.3
-
- Next, go to pybsddb.sf.net and download the PyBSDDB package,
- a.k.a. bsddb3. As of this writing, PyBSDDB version 3.3.0 is the
- latest and this is known to work with Berkeley DB 3.3.11.
- PyBSDDB is a Python distutils package, however it can be a bit
- tricky to install. Here's the sequence that I recommend (works if
- you've installed Berkeley DB in the default location):
-
- % python setup.py build_ext --inplace --berkeley-db=/usr/local/BerkeleyDB.3.3 --lflags="-Xlinker -rpath -Xlinker /stuff/BerkeleyDB.3.3/lib"
- % python setup.py install --berkeley-db=/usr/local/BerkeleyDB.3.3 --lflags="-Xlinker -rpath -Xlinker /stuff/BerkeleyDB.3.3/lib"
-
- Windows users, you need only download the PyBSDDB file
- bsddb3-3.3.0.win32-py2.1.exe and install it. This comes with the
- requisite Berkeley dlls. Note however, that to build the
- StandaloneZODB package from source requires a C compiler on
- Windows. We likely won't release a Windows installer but we would
- accept contributions of one.
-
-Installation
-
- StandaloneZODB is released as a distutils package. To build it,
- run the setup script:
-
- % python setup.py build
-
- To test the build, run the test script.
-
- % python test.py
-
- For more verbose test output, append one or two `-v' arguments to
- this command. Note that if you try to run the test suite under
- Python 2.0, you may get some failures in the Berkeley storages,
- i.e. Full.py. These were only designed to run under Python 2.1
- and beyond; we plan on fixing StandaloneZODB to not run or test
- the Berkeley storages under Python 2.0. For now, ignore them.
-
- If all the tests succeeded, you can install StandaloneZODB using
- the setup script:
-
- % python setup.py install
-
- This should now make all of ZODB accessible to your Python
- programs. You can test this by cd'ing to your home directory and
- typing the following commands:
-
- Python 2.2 (#1, Dec 24 2001, 15:39:01)
- [GCC egcs-2.91.66 19990314/Linux (egcs-1.1.2 release)] on linux2
- Type "help", "copyright", "credits" or "license" for more information.
- >>> import ZODB
- >>> import ZODB.FileStorage
- >>> ZODB.FileStorage.__version__
- '1.75.16.7'
- >>>
-
- (Note that the version numbers might be different.)
-
-History
-
- The StandaloneZODB release is related to, and takes inspiration from
- Andrew Kuchling's ZODB project on SourceForge. Currently the core
- code base is largely similar, and we distribute Andrew's programmers
- guide (see below) with our release. Andrew's project has some
- additional utilities and tools which we don't (yet) distribute. It's
- likely that we will continue to merge the two projects, since we all
- agree it makes little sense to keep them separated. For more
- information, see
-
- http://zodb.sf.net
-
-More information
-
- We maintain a Wiki page about all things ZODB, including status on
- future directions for ZODB. Please see
-
- http://www.zope.org/Wikis/ZODB
-
- and feel free to contribute your comments. There is a Mailman
- mailing list in place to discuss all issues related to ZODB. You
- can send questions to
-
- zodb-dev@zope.org
-
- or subscribe at
-
- http://lists.zope.org/mailman/listinfo/zodb-dev
-
- and view its archives at
-
- http://lists.zope.org/pipermail/zodb-dev
-
- Andrew's ZODB Programmers Guide is made available in several
- forms, including DVI and HTML. To view it online, point your
- browser at the file Doc/guide/zodb/index.html
-
-Bugs and Patches
-
- For now, you can submit bug reports and patches on Andrew's
- ZODB SourceForge project at:
-
- http://sourceforge.net/tracker/?group_id=15628
-
+This release is no longer supported. Please use ZODB3 instead.