E&S CVS Commit: PEAK - All 'peak.binding' APIs now only accept positional parameters for items

[pje at eby-sarna.com]

Module Name:	PEAK
Committed By:	pje
Date:		Wed Jun 18 18:27:39 UTC 2003

Modified Files:
	PEAK: CHANGES.txt TODO.txt
	PEAK/src/peak/binding: _once.c _once.pyx components.py once.py
	PEAK/src/peak/binding/tests: __init__.py

Log Message:
All 'peak.binding' APIs now only accept positional parameters for items
unique to that API.  Items common to multiple APIs (such as 'offerAs',
'doc', 'attrName', etc.) should now be supplied as keyword arguments.

Bindings also now automatically "suggest" the containing object as a parent
component for the contained object, whenever a value is assigned to them or
computed.  If a non-None 'adaptTo' is set on the binding, the value assigned
or computed will be adapted to the specified protocol before the parent
component is suggested.  'binding.New()' no longer relies on the
'IComponentFactory' interface, but instead uses the new adapt/suggest
mechanisms.

Previously, parent components were only "suggested" when a binding was set
via component constructor keyword arguments.  Now, this is done at any time
bindings are set, but *not* for non-binding keyword arguments.  In other
words, ordinary attributes of a component do not receive "suggested parent"
notices, even when set via constructor keyword arguments.  If you want an
attribute to do this, you must define the attribute with the binding API;
e.g. via 'requireBinding()' or 'binding.Constant()'.


To view diffs of this commit, you can use the following URL(s):
http://cvs.eby-sarna.com/PEAK/CHANGES.txt.diff?r1=1.49&r2=1.50
http://cvs.eby-sarna.com/PEAK/TODO.txt.diff?r1=1.64&r2=1.65
http://cvs.eby-sarna.com/PEAK/src/peak/binding/_once.c.diff?r1=1.9&r2=1.10
http://cvs.eby-sarna.com/PEAK/src/peak/binding/_once.pyx.diff?r1=1.9&r2=1.10
http://cvs.eby-sarna.com/PEAK/src/peak/binding/components.py.diff?r1=1.120&r2=1.121
http://cvs.eby-sarna.com/PEAK/src/peak/binding/once.py.diff?r1=1.54&r2=1.55
http://cvs.eby-sarna.com/PEAK/src/peak/binding/tests/__init__.py.diff?r1=1.34&r2=1.35

To generate a diff of this commit:
cvs rdiff -r1.49 -r1.50 PEAK/CHANGES.txt
cvs rdiff -r1.64 -r1.65 PEAK/TODO.txt
cvs rdiff -r1.9 -r1.10 PEAK/src/peak/binding/_once.c \
    PEAK/src/peak/binding/_once.pyx
cvs rdiff -r1.120 -r1.121 PEAK/src/peak/binding/components.py
cvs rdiff -r1.54 -r1.55 PEAK/src/peak/binding/once.py
cvs rdiff -r1.34 -r1.35 PEAK/src/peak/binding/tests/__init__.py

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.