Commit 589034bc authored by Jim Fulton's avatar Jim Fulton

*** empty log message ***

parent c67fa730
Copyright (c) 1996-1998, Digital Creations, Fredericksburg, VA, USA.
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
met:
o Redistributions of source code must retain the above copyright
notice, this list of conditions, and the disclaimer that follows.
o Redistributions in binary form must reproduce the above copyright
notice, this list of conditions, and the following disclaimer in
the documentation and/or other materials provided with the
distribution.
o Neither the name of Digital Creations nor the names of its
contributors may be used to endorse or promote products derived
from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY DIGITAL CREATIONS AND CONTRIBUTORS *AS
IS* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL DIGITAL
CREATIONS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
DAMAGE.
Installation
The ExtensionClass distribution now uses the "Universal Unix
Makefile for Python extensions", 'Makefile.pre.in', which was
introduced as part of Python1.4. Copies of this file for Python
1.4 and Python 1.5 are included with this release. See the
instructions in the make file, itself. Note that you will need to
copy or rename the the file for the Python version you're using to
Makefile.pre.in.
Files
ExtensionClass.stx -- This file in structured text format
ExtensionClass.html -- This file in HTML format
Installation -- Installation instructions in structured text
format.
Installation.html -- Installation instructions in HTML
format.
Acquisition.stx -- Acquisition documentation in structured text
format.
Acquisition.html -- Acquisition documentation in HTML
format.
MultiMapping.stx -- The MultiMapping example in structured text
format.
MultiMapping.html -- The MultiMapping example in structured text
format.
release.notes -- Release notes in structured text
format.
release.html -- Release notes in HTML format.
README -- A file that says to read this file.
Makefile.pre.in-1.4 -- The Universal Unix Makefile for Python
extensions. This is the Python 1.4
version. Copy this to Makefile.pre.in
before using it.
Makefile.pre.in-1.5 -- The Universal Unix Makefile for Python
extensions. This is the Python 1.5
version. Copy this to Makefile.pre.in
before using it.
Setup -- a configuration file used by the Universal
Unix Makefile for Python extensions
ExtensionClass.c -- The ExtensionClass source
ExtensionClass.h -- The ExtensionClass header file
Acquisition.c -- The source for the 'Acquisition' module
that provides mix-in classes to support
environmental acquisition
MethodObject.c -- The source for the 'MethodObject' module
that provides a mix-in class for
user-defined method types. To create a
user-defined method type, just create an
extension subclass of
'MethodObject.MethodObject' that has an
'__call__' method.
Missing.c -- The source for the 'Missing' module
that provides a class for objects that
model "missing" or unknown data. Missing
objects have the property that all
mathematical operations yield a missing
value. This is included mainly as an
example (and test) of a numeric extension
base class.
MultiMapping.c -- The source for a slightly enhanced
'MultiMapping' module that is based on the
'MultiMapping' example given in this
paper. If present, document templates [2]
will take advantage of this module to
significantly increase rendering
performance.
Sync.py -- A Python module that provides a
'Synchonized' mix-in class that limits access
to an object's methods to one thread at a
time. This requires the installation of
the ThreadLock module.
ThreadLock.c -- The source for the 'ThreadLock' module that
provides 'ThreadLock' objects. These are
similar to the lock objects provided by
the 'thread' modules. Unlike normal
Python lock objects, 'ThreadLock' objects
can be acquired (and released) more than
once by the same thread.
In addition to the files listed above, several "test" modules are
included. These are modules that I used to test ExtensionClass.
They do not constitute a regression testing suit and I've made
little effort to assure that they actually work, although that
would be a good thing to do if time permits.
This diff is collapsed.
Release Notes
1.2
This release provides some important bug fixes, some new features,
and a new copyright.
New functionality:
- One or more mapping objects can be passed to the MultiMapping
constructor.
- MultiMapping objects implement the has_key and get methods as
defined for Python 1.5 dictionaries.
Bugs fixed:
- When support was added for passing acquisition wrappers to
methods of data-less C mix-in classes, C-based __call_method__
hooks were broken. The most notable example of this was the
breaking of the Synchronized class.
- Calling C-base-class special methods from overriding methods,
as in::
class LowerMultiMapping(MultiMapping):
def __getitem__(self, key):
return MultiMapping.__getitem__(self, lower(key))
caused infinite loops.
- A typo in the Acquisition probably caused __delitem__
calls on wrapped mapping objects to fail.
1.1
New functionality:
- Changed the way that methods in pure mix-in classes are
constructed. Now methods are wrapped in such a way that
tricky wrapper objects (like Acquisition wrappers) can
bind them to wrapped objects.
- An "is subclass" test is provided via the macros
'ExtensionClassSubclass_Check', and
'ExtensionClassSubclassInstance_Check', which are
documented in 'ExtensionClass.h'.
- Methods and Acquisition wrappers use free list to improve
allocation and deallocation performance.
- Bound methods have attributes who's values are stored in
their instances.
- Added '__module__' attribute to ExtensionClasses to be
consistent with Python 1.5 classes and to work correctly
with 1.5 pickling.
- Added the '__basic__' new class method to allow
ExtensionClass instances to be unpickled without calling
their constructors.
- Acquired acquiring objects can nor acquire from the object
they were accessed in, in addition to the object they were
acquired from.
- Added new 'Acquisition' variable, 'Acquired', to support
"Controlled Acquisition'.
- Added a new 'aq_acquire' method for objects that subclass
'Acquisition.Implicit' or 'Acquisition.Explicit'. This
supports explicit acquisition and provides an option
filter function to support "Filtered Acquisiition".
The 'acquire' method available in earlier releases is still
available, but is deprecated.
Bugs fixed:
- There were some incorrect C-level error return values.
- A bug in handling method chains caused "C inheritence"
to fail. This only affected extension types that
inherited from extension types using method chains, *not*
extension subclasses defined in Python inheriting from
extension base classes defined in C.
- Expressions like 'not foo' or statements like::
if foo:
...
often failed for non-collection types because of an
incorrect attempt to take the 'len' of an object.
- Comparisons of objects with different classes didn't work
correctly.
- Instances provided access to their class '__bases__'
attribute.
1.0.2
Bugs fixed:
- Fixed bug in handling subclasses of Sequence objects.
- Fixed comparison bug in Missing objects.
1.0.1
Added functionality to and fixed bug in Missing module
- Fixed horible reference-counting bug
- Changed so that 'Missing.Value.spam(a1,a2,whatever)'
returns 'Missing.Value' for any method name (except
'__reduce__') and any arguments.
- Changed so that missing values are picklable. Note that
the special global, Missing.Value, is pickled in a
slightly more efficient manner than other missing values.
1.0
First non-beta release
This release is the result of a major rewrite and "hardening"
effort to increase performance and reliability. This version
is being used in several Digital Creations products, so if
parts are broken, we probably don't use them. :-)
This release also contains several new features and example
modules, including:
- Acquisition,
- Custom method calls,
- Class initialization protocol,
- A class method that makes it possible to explicitly call
Python base-class methods.
- A sample application of custom method calls that provides
Java-like synchronized classes that prevent more than one
thread from accessing an object's methods at one time.
Note that there is one known incompatibility with previous
releases. In previouse releases, the method used to support
context wrapping was named '__bind_to_object__'. The name of
this method was changed to '__of__' in this release and I do
not expect this name to change in the future.
......@@ -4,6 +4,11 @@ R=$1
M=ExtensionClass
StructuredText < $M.stx > $M.html
StructuredText < Installation > Installation.html
StructuredText < Acquisition.stx > Acquisition.html
StructuredText < MultiMapping.stx > MultiMapping.html
StructuredText < release.notes > release.html
rm -rf "$M-$R"
mkdir "$M-$R"
for f in `cat release.fl`; do
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment