Tag 3.4a1 release.

branches/3.3/README.txt

-ZODB3 3.3.1
-===========
-
-Introduction
-------------
-
-The ZODB3 package provides a set of tools for using the Zope 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.
-
-The components you get with the ZODB3 release are as follows:
-
-- Core ZODB, including the persistence machinery
-- Standard storages such as FileStorage
-- The persistent BTrees modules
-- ZEO
-- ZConfig -- a Zope configuration language
-- documentation
-
-Our primary development platforms are Linux and Windows XP.  The
-test suite should pass without error on all of these platforms,
-although it can take a long time on Windows -- longer if you use
-ZoneAlarm.  Many particularly slow tests are skipped unless you pass
---all as an argument to test.py.
-
-Compatibility
--------------
-
-ZODB 3.3.1 requires Python 2.3.4 or later.
-
-The Zope X3 release should be compatible with this version of ZODB.  Zope 3
-and Zope 2.8 have moved to ZODB 3.4.  Note that Zope 2.7 and higher includes
-ZEO, so this package should only be needed to run a ZEO server.
-
-The ZEO in ZODB 3.3 is only partly compatible with earlier versions of ZODB.
-ZODB 3.3 uses multiversion concurrency control (MVCC), which is new in 3.3,
-and earlier ZEO servers do not support MVCC:  a 3.3 ZEO client cannot talk
-with an older ZEO server.  In the other direction, a 3.3 ZEO server can talk
-with older ZEO clients, but because the names of some basic classes have
-changed, if any 3.3 clients commit modifications to the database it's likely
-that the database will contain instances of classes that don't exist in
-(can't be loaded by) older ZEO clients.  For example, the database root
-object was an instance of ``ZODB.PersistentMapping.PersistentMapping`` before
-ZODB 3.3, but is an instance of ``persistent.mapping.PersistentMapping`` in
-ZODB 3.3.  A 3.3.1 client can still load a
-``ZODB.PersistentMapping.PersistentMapping`` object, but this is just an alias
-for ``persistent.mapping.PersistentMapping``, and an object of the latter
-type will be stored if a 3.3 client commits a change to the root object.  An
-older ZEO client cannot load the root object so changed.
-
-This limits migration possibilities:  a 3.3 ZEO server can be used with
-older ZEO clients and serve an older database, so long as no 3.3 ZEO
-clients commit changes to the database.  The most practical upgrade path
-is to bring up both servers and clients using 3.3.1, not trying to mix
-pre-3.3 and post-3.3 ZEO clients and servers.
-
-
-Prerequisites
--------------
-
-You must have Python installed.  If you've installed Python from RPM,
-be sure that you've installed the development RPMs too, since ZODB3
-builds Python extensions.  If you have the source release of ZODB3,
-you will need a C compiler.
-
-Installation
-------------
-
-ZODB3 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.
-
-If all the tests succeeded, you can install ZODB3 using the setup
-script::
-
-    % python setup.py install
-
-This should now make all of ZODB accessible to your Python programs.
-
-Testing
--------
-
-ZODB3 comes with a large test suite that can be run from the source
-directory before ZODB is installed.  The simplest way to run the tests
-is::
-
-    % python test.py -v
-
-This command will run all the tests, printing a single dot for each
-test.  When it finishes, it will print a test summary.  The exact
-number of tests can vary depending on platform and available
-third-party libraries.::
-
-    Ran 1182 tests in 241.269s
-
-    OK
-
-The test script has many more options.  Use the ``-h`` or ``--help``
-options to see a file list of options.  The default test suite omits
-several tests that depend on third-party software or that take a long
-time to run.  To run all the available tests use the ``--all`` option.
-Running all the tests takes much longer.::
-
-    Ran 1561 tests in 1461.557s
-
-    OK
-
-
-History
--------
-
-The version numbering scheme for ZODB is complicated.  Starting with
-the ZODB 3.1 release, we tried to make it simpler.  Versions prior to
-3.1 had different names and different numbers.  This section describes
-the gory details.
-
-Historically, ZODB was distributed as a part of the Zope application
-server.  Jim Fulton's paper at the Python conference in 2000 described
-a version of ZODB he called ZODB 3, based on an earlier persistent
-object system called BoboPOS.  The earliest versions of ZODB 3 were
-released with Zope 2.0.
-
-Andrew Kuchling extracted ZODB from Zope 2.4.1 and packaged it for
-use by standalone Python programs.  He called this version
-"StandaloneZODB".  Andrew's guide to using ZODB is included in the Doc
-directory.  This version of ZODB was hosted at
-http://sf.net/projects/zodb.  It supported Python 1.5.2, and might
-still be of interest to users of this very old Python version.
-
-Zope Corporation released a version of ZODB called "StandaloneZODB
-1.0" in Feb. 2002.  This release was based on Andrew's packaging, but
-built from the same CVS repository as Zope.  It is roughly equivalent
-to the ZODB in Zope 2.5.
-
-Why not call the current release StandaloneZODB?  The name
-StandaloneZODB is a bit of a mouthful.  The standalone part of the
-name suggests that the Zope version is the real version and that this
-is an afterthought, which isn't the case.  So we're calling this
-release "ZODB3".
-
-To make matters worse, we worked on a ZODB4 package for a while and
-made a couple of alpha releases.  We've now abandoned that effort,
-because we didn't have the resources to pursue while also maintaining
-ZODB3.
-
-License
--------
-
-ZODB is distributed under the Zope Public License, an OSI-approved
-open source license.  Please see the LICENSE.txt file for terms and
-conditions.
-
-The ZODB/ZEO Programming Guide included in the documentation is a
-modified version of Andrew Kuchling's original guide, provided under
-the terms of the GNU Free Documentation License.
-
-
-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
-
-Note that Zope Corp mailing lists have a subscriber-only posting policy.
-
-Andrew's ZODB Programmers Guide is made available in several
-forms, including PDF and HTML.  To view it online, point your
-browser at the file Doc/guide/zodb/index.html
-
-
-Bugs and Patches
-----------------
-
-Bug reports and patches should be added to the Zope Collector, with
-topic "Database":
-
-    http://collector.zope.org/Zope
-
-
-..
-   Local Variables:
-   mode: indented-text
-   indent-tabs-mode: nil
-   sentence-end-double-space: t
-   fill-column: 70
-   End:

branches/3.3/doc/guide/zodb.tex

-\documentclass{howto}
-
-\title{ZODB/ZEO Programming Guide}
-\release{3.3.1c1}
-\date{\today}
-
-\author{A.M.\ Kuchling}
-\authoraddress{\email{amk@amk.ca}}
-
-\begin{document}
-\maketitle
-\tableofcontents
-
-\copyright{Copyright 2002 A.M. Kuchling.
-      Permission is granted to copy, distribute and/or modify this document
-      under the terms of the GNU Free Documentation License, Version 1.1
-      or any later version published by the Free Software Foundation;
-      with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-      A copy of the license is included in the appendix entitled ``GNU
-      Free Documentation License''.}
-
-\input{introduction}
-\input{prog-zodb}
-\input{zeo}
-\input{transactions}
-\input{modules}
-
-\appendix
-\input links.tex
-\input gfdl.tex
-
-\end{document}

branches/3.3/releases/ZODB3/SETUP.cfg

-script  scripts/fsdump.py
-script  scripts/fsrefs.py
-script  scripts/fstail.py
-script  scripts/fstest.py
-script  scripts/repozo.py
-script  scripts/zeopack.py

branches/3.3/setup.py

-##############################################################################
-#
-# Copyright (c) 2002, 2003 Zope Corporation and Contributors.
-# All Rights Reserved.
-#
-# This software is subject to the provisions of the Zope Public License,
-# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
-# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
-# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
-# FOR A PARTICULAR PURPOSE.
-#
-##############################################################################
-"""Zope Object Database: object database and persistence
-
-The Zope Object Database provides an object-oriented database for
-Python that provides a high-degree of transparency. Applications can
-take advantage of object database features with few, if any, changes
-to application logic.  ZODB includes features such as a plugable storage
-interface, rich transaction support, and undo.
-"""
-
-# The (non-obvious!) choices for the Trove Development Status line:
-# Development Status :: 5 - Production/Stable
-# Development Status :: 4 - Beta
-# Development Status :: 3 - Alpha
-
-classifiers = """\
-Development Status :: 5 - Production/Stable
-Intended Audience :: Developers
-License :: OSI Approved :: Zope Public License
-Programming Language :: Python
-Topic :: Database
-Topic :: Software Development :: Libraries :: Python Modules
-Operating System :: Microsoft :: Windows
-Operating System :: Unix
-"""
-
-import glob
-import os
-import sys
-from distutils.core import setup
-from distutils.extension import Extension
-from distutils import dir_util
-from distutils.core import setup
-from distutils.dist import Distribution
-from distutils.command.install_lib import install_lib
-from distutils.command.build_py import build_py
-from distutils.util import convert_path
-
-if sys.version_info < (2, 3, 4):
-    print "ZODB 3.3 requires Python 2.3.4 or higher"
-    sys.exit(0)
-
-# Include directories for C extensions
-include = ['src/persistent']
-
-# Set up dependencies for the BTrees package
-base_btrees_depends = [
-    "src/BTrees/BTreeItemsTemplate.c",
-    "src/BTrees/BTreeModuleTemplate.c",
-    "src/BTrees/BTreeTemplate.c",
-    "src/BTrees/BucketTemplate.c",
-    "src/BTrees/MergeTemplate.c",
-    "src/BTrees/SetOpTemplate.c",
-    "src/BTrees/SetTemplate.c",
-    "src/BTrees/TreeSetTemplate.c",
-    "src/BTrees/sorters.c",
-    "src/persistent/cPersistence.h",
-    ]
-
-_flavors = {"O": "object", "I": "int"}
-
-KEY_H = "src/BTrees/%skeymacros.h"
-VALUE_H = "src/BTrees/%svaluemacros.h"
-
-def BTreeExtension(flavor):
-    key = flavor[0]
-    value = flavor[1]
-    name = "BTrees._%sBTree" % flavor
-    sources = ["src/BTrees/_%sBTree.c" % flavor]
-    kwargs = {"include_dirs": include}
-    if flavor != "fs":
-        kwargs["depends"] = (base_btrees_depends + [KEY_H % _flavors[key],
-                                                    VALUE_H % _flavors[value]])
-    if key != "O":
-        kwargs["define_macros"] = [('EXCLUDE_INTSET_SUPPORT', None)]
-    return Extension(name, sources, **kwargs)
-
-exts = [BTreeExtension(flavor) for flavor in ["OO", "IO", "OI", "II", "fs"]]
-
-cPersistence = Extension(name = 'persistent.cPersistence',
-                         include_dirs = include,
-                         sources= ['src/persistent/cPersistence.c',
-                                   'src/persistent/ring.c'],
-                         depends = ['src/persistent/cPersistence.h',
-                                    'src/persistent/ring.h',
-                                    'src/persistent/ring.c']
-                         )
-
-cPickleCache = Extension(name = 'persistent.cPickleCache',
-                         include_dirs = include,
-                         sources= ['src/persistent/cPickleCache.c',
-                                   'src/persistent/ring.c'],
-                         depends = ['src/persistent/cPersistence.h',
-                                    'src/persistent/ring.h',
-                                    'src/persistent/ring.c']
-                         )
-
-TimeStamp = Extension(name = 'persistent.TimeStamp',
-                      include_dirs = include,
-                      sources= ['src/persistent/TimeStamp.c']
-                      )
-
-##coptimizations = Extension(name = 'ZODB.coptimizations',
-##                           include_dirs = include,
-##                           sources= ['src/ZODB/coptimizations.c']
-##                           )
-
-winlock = Extension(name = 'ZODB.winlock',
-                    include_dirs = include,
-                    sources = ['src/ZODB/winlock.c']
-                    )
-
-exts += [cPersistence, cPickleCache, TimeStamp, winlock]
-
-# The ZODB.zodb4 code is not being packaged, because it is only
-# need to convert early versions of Zope3 databases to ZODB3.
-
-packages = ["BTrees", "BTrees.tests",
-            "ZEO", "ZEO.auth", "ZEO.zrpc", "ZEO.tests",
-            "ZODB", "ZODB.FileStorage", "ZODB.tests",
-            "Persistence", "Persistence.tests",
-            "persistent", "persistent.tests",
-            "transaction", "transaction.tests",
-            "ThreadedAsync",
-            "zdaemon", "zdaemon.tests",
-            "ZopeUndo", "ZopeUndo.tests",
-            "ZConfig", "ZConfig.tests",
-            "ZConfig.components",
-            "ZConfig.components.basic", "ZConfig.components.basic.tests",
-            "ZConfig.components.logger", "ZConfig.components.logger.tests",
-            "ZConfig.tests.library", "ZConfig.tests.library.widget",
-            "ZConfig.tests.library.thing",
-            ]
-
-scripts = ["src/scripts/fsdump.py",
-           "src/scripts/fsrefs.py",
-           "src/scripts/fstail.py",
-           "src/scripts/fstest.py",
-           "src/scripts/repozo.py",
-           "src/scripts/zeopack.py",
-           "src/ZConfig/scripts/zconfig",
-           "src/ZEO/runzeo.py",
-           "src/ZEO/zeopasswd.py",
-           "src/ZEO/mkzeoinst.py",
-           "src/ZEO/zeoctl.py",
-           "src/zdaemon/zdrun.py",
-           "src/zdaemon/zdctl.py",
-           ]
-
-def copy_other_files(cmd, outputbase):
-    # A delicate dance to copy files with certain extensions
-    # into a package just like .py files.
-    extensions = ["*.conf", "*.xml", "*.txt", "*.sh"]
-    for dir in [
-        "transaction",
-        "persistent/tests",
-        "ZConfig/components/basic",
-        "ZConfig/components/logger",
-        "ZConfig/tests/input",
-        "ZConfig/tests/library",
-        "ZConfig/tests/library/thing",
-        "ZConfig/tests/library/thing/extras",
-        "ZConfig/tests/library/widget",
-        "ZEO",
-        "ZODB",
-        "zdaemon",
-        "zdaemon/tests",
-        ]:
-        dir = convert_path(dir)
-        inputdir = os.path.join("src", dir)
-        outputdir = os.path.join(outputbase, dir)
-        if not os.path.exists(outputdir):
-            dir_util.mkpath(outputdir)
-        for pattern in extensions:
-            for fn in glob.glob(os.path.join(inputdir, pattern)):
-                # glob is going to give us a path include "src",
-                # which must be stripped to get the destination dir
-                dest = os.path.join(outputbase, fn[4:])
-                cmd.copy_file(fn, dest)
-
-class MyLibInstaller(install_lib):
-    """Custom library installer, used to put hosttab in the right place."""
-
-    # We use the install_lib command since we need to put hosttab
-    # inside the library directory.  This is where we already have the
-    # real information about where to install it after the library
-    # location has been set by any relevant distutils command line
-    # options.
-
-    def run(self):
-        install_lib.run(self)
-        copy_other_files(self, self.install_dir)
-
-class MyPyBuilder(build_py):
-    def build_packages(self):
-        build_py.build_packages(self)
-        copy_other_files(self, self.build_lib)
-
-class MyDistribution(Distribution):
-    # To control the selection of MyLibInstaller and MyPyBuilder, we
-    # have to set it into the cmdclass instance variable, set in
-    # Distribution.__init__().
-
-    def __init__(self, *attrs):
-        Distribution.__init__(self, *attrs)
-        self.cmdclass['build_py'] = MyPyBuilder
-        self.cmdclass['install_lib'] = MyLibInstaller
-
-doclines = __doc__.split("\n")
-
-setup(name="ZODB3",
-      version="3.3.1c1",
-      maintainer="Zope Corporation",
-      maintainer_email="zodb-dev@zope.org",
-      url = "http://www.zope.org/Wikis/ZODB",
-      download_url = "http://www.zope.org/Products/ZODB3.3",
-      packages = packages,
-      package_dir = {'': 'src'},
-      ext_modules = exts,
-      headers = ['src/persistent/cPersistence.h',
-                 'src/persistent/ring.h'],
-      license = "ZPL 2.1",
-      platforms = ["any"],
-      description = doclines[0],
-      classifiers = filter(None, classifiers.split("\n")),
-      long_description = "\n".join(doclines[2:]),
-      distclass = MyDistribution,
-      scripts = scripts,
-      )

branches/3.3/src/BTrees/SETUP.cfg

-# Extension information for zpkg.
-
-# These extensions depend on a header provided by another component;
-# this header is named using depends-on in the sections for each
-# extension that requires it, but must also be identified as a public
-# header in the component that needs it.
-
-<extension _fsBTree>
-  source     _fsBTree.c
-
-  # Common btree includes:
-  depends-on BTreeItemsTemplate.c
-  depends-on BTreeModuleTemplate.c
-  depends-on BTreeTemplate.c
-  depends-on BucketTemplate.c
-  depends-on MergeTemplate.c
-  depends-on SetOpTemplate.c
-  depends-on SetTemplate.c
-  depends-on TreeSetTemplate.c
-  depends-on sorters.c
-</extension>
-
-
-<extension _IIBTree>
-  source     _IIBTree.c
-
-  # Specialization:
-  depends-on intkeymacros.h
-  depends-on intvaluemacros.h
-
-  # Common btree includes:
-  depends-on BTreeItemsTemplate.c
-  depends-on BTreeModuleTemplate.c
-  depends-on BTreeTemplate.c
-  depends-on BucketTemplate.c
-  depends-on MergeTemplate.c
-  depends-on SetOpTemplate.c
-  depends-on SetTemplate.c
-  depends-on TreeSetTemplate.c
-  depends-on sorters.c
-</extension>
-
-
-<extension _IOBTree>
-  source     _IOBTree.c
-
-  # Specialization:
-  depends-on intkeymacros.h
-  depends-on objectvaluemacros.h
-
-  # Common btree includes:
-  depends-on BTreeItemsTemplate.c
-  depends-on BTreeModuleTemplate.c
-  depends-on BTreeTemplate.c
-  depends-on BucketTemplate.c
-  depends-on MergeTemplate.c
-  depends-on SetOpTemplate.c
-  depends-on SetTemplate.c
-  depends-on TreeSetTemplate.c
-  depends-on sorters.c
-</extension>
-
-
-<extension _OIBTree>
-  source     _OIBTree.c
-
-  # Specialization:
-  depends-on objectkeymacros.h
-  depends-on intvaluemacros.h
-
-  # Common btree includes:
-  depends-on BTreeItemsTemplate.c
-  depends-on BTreeModuleTemplate.c
-  depends-on BTreeTemplate.c
-  depends-on BucketTemplate.c
-  depends-on MergeTemplate.c
-  depends-on SetOpTemplate.c
-  depends-on SetTemplate.c
-  depends-on TreeSetTemplate.c
-  depends-on sorters.c
-</extension>
-
-
-<extension _OOBTree>
-  source     _OOBTree.c
-
-  # Specialization:
-  depends-on objectkeymacros.h
-  depends-on objectvaluemacros.h
-
-  # Common btree includes:
-  depends-on BTreeItemsTemplate.c
-  depends-on BTreeModuleTemplate.c
-  depends-on BTreeTemplate.c
-  depends-on BucketTemplate.c
-  depends-on MergeTemplate.c
-  depends-on SetOpTemplate.c
-  depends-on SetTemplate.c
-  depends-on TreeSetTemplate.c
-  depends-on sorters.c
-</extension>

branches/3.3/src/ZEO/__init__.py

-##############################################################################
-#
-# Copyright (c) 2001, 2002 Zope Corporation and Contributors.
-# All Rights Reserved.
-#
-# This software is subject to the provisions of the Zope Public License,
-# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
-# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
-# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
-# FOR A PARTICULAR PURPOSE
-#
-##############################################################################
-"""ZEO -- Zope Enterprise Objects.
-
-See the file README.txt in this directory for an overview.
-
-ZEO is now part of ZODB; ZODB's home on the web is
-
-    http://www.zope.org/Wikis/ZODB
-
-"""
-
-# The next line must use double quotes, so release.py recognizes it.
-version = "2.3.1c1"

branches/3.3/src/ZEO/version.txt

-2.3.1c1

branches/ctheune-blobsupport/COPYING

-See:
-
- - the copyright notice in: COPYRIGHT.txt
-
- - The Zope Public License in LICENSE.txt

branches/ctheune-blobsupport/COPYRIGHT.txt

-Copyright (c) 2004 Zope Corporation and Contributors.
-All Rights Reserved.
-
-This software is subject to the provisions of the Zope Public License,
-Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
-THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
-WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
-FOR A PARTICULAR PURPOSE.