Revision 1401

Jump to revision:
Author:	pje
Date:	Sat Sep 27 01:52:02 2003 UTC (20 years, 6 months ago)

Log Message:

First phase of the binding API simplification, including detailed docs
for 'Descriptor' and 'Attribute'.  (Second phase will be mass
search-and-replace of the API's usage in PEAK, third will be additional
tests and docs.)

Added 'binding.Require', 'binding.Obtain', 'binding.Make', and
'binding.Delegate'.  *ALL* other binding types are now DEPRECATED, and will
go away before 0.5 beta is released.  Please see CHANGES.txt for a detailed
mapping of how to translate from the old to new API, and let me know if
anything's missing.

Note that the new 'Make' and 'Obtain' bindings also support sequences of
recipes and keys, and in those cases will produce a sequence of the results
from those recipes or keys.  Also, 'Make' will accept no-argument and
one-argument callables,  where 'Once' always required three-argument
functions.  This should make it a lot easier to write short binding
functions.

Also, note that the 'activateUponAssembly' keyword is now 'uponAssembly',
and 'isVolatile' is now 'noCache'.  (The old names will work as keyword
arguments until the alpha 4 development cycle begins.)  The
'binding.IActiveDescriptor' interface also changed as a result of this.
Last, but not least, a 'binding.IRecipe' interface was added, to support
the new 'binding.Make' type.

Changed paths:

Path	Action	Text Changes	Prop Changes	Diff to Previous
PEAK/CHANGES.txt	modified	X		(diff to previous)
PEAK/TODO.txt	modified	X		(diff to previous)
PEAK/src/peak/binding/components.py	modified	X		(diff to previous)
PEAK/src/peak/binding/interfaces.py	modified	X		(diff to previous)
PEAK/src/peak/binding/once.py	modified	X		(diff to previous)
PEAK/src/peak/config/config_components.py	modified	X		(diff to previous)
PEAK/src/peak/model/features.py	modified	X		(diff to previous)