E&S CVS Commit: PEAK - MAJOR API REFACTORING for 'peak.config', to support iterating over

[pje at eby-sarna.com]

Module Name:	PEAK
Committed By:	pje
Date:		Sun Dec 28 00:14:24 UTC 2003

Modified Files:
	PEAK: CHANGES.txt TODO.txt
	PEAK/docs/core_tutorial: binding.tex
	PEAK/examples/bulletins/src/bulletins: model.py
	PEAK/src/peak: core.py exceptions.py peak.ini
	PEAK/src/peak/binding: components.py interfaces.py
	PEAK/src/peak/config: api_impl.py config_components.py ini_files.py
	    interfaces.py registries.py
	PEAK/src/peak/config/tests: __init__.py test_keys.py
	PEAK/src/peak/naming/factories: config_ctx.py
	PEAK/src/peak/running: clusters.py commands.py interfaces.py logs.py
	    scheduler.py
	PEAK/src/peak/storage: transactions.py

Log Message:
MAJOR API REFACTORING for 'peak.config', to support iterating over
configuration keys, 'n2' navigability of properties, and much more.
Many APIs are now DEPRECATED or renamed; please see CHANGES.txt for
a complete description.  A few highlights:

 - 'config.lookup()' replaces 'findUtility' and 'getProperty'

 - 'config.iterValues()' replaces 'findUtilities'

 - 'config.iterKeys()' finds keys in a specific namespace

 - NEW: 'config.parentProviding()' and 'config.parentsProviding()'
   APIs to find parent components that support a protocol.

 - NEW: You can now use 'peak n2 config:' to explore the default
   property namespace.  For example 'ls -l peak.naming.schemes'
   will list all defined naming schemes.

Please see CHANGES.txt for the list of deprecated or removed APIs.


To view diffs of this commit, you can use the following URL(s):
http://cvs.eby-sarna.com/PEAK/CHANGES.txt.diff?r1=1.114&r2=1.115
http://cvs.eby-sarna.com/PEAK/TODO.txt.diff?r1=1.87&r2=1.88
http://cvs.eby-sarna.com/PEAK/docs/core_tutorial/binding.tex.diff?r1=1.34&r2=1.35
http://cvs.eby-sarna.com/PEAK/examples/bulletins/src/bulletins/model.py.diff?r1=1.4&r2=1.5
http://cvs.eby-sarna.com/PEAK/src/peak/core.py.diff?r1=1.2&r2=1.3
http://cvs.eby-sarna.com/PEAK/src/peak/exceptions.py.diff?r1=1.6&r2=1.7
http://cvs.eby-sarna.com/PEAK/src/peak/peak.ini.diff?r1=1.108&r2=1.109
http://cvs.eby-sarna.com/PEAK/src/peak/binding/components.py.diff?r1=1.130&r2=1.131
http://cvs.eby-sarna.com/PEAK/src/peak/binding/interfaces.py.diff?r1=1.18&r2=1.19
http://cvs.eby-sarna.com/PEAK/src/peak/config/api_impl.py.diff?r1=1.22&r2=1.23
http://cvs.eby-sarna.com/PEAK/src/peak/config/config_components.py.diff?r1=1.71&r2=1.72
http://cvs.eby-sarna.com/PEAK/src/peak/config/ini_files.py.diff?r1=1.2&r2=1.3
http://cvs.eby-sarna.com/PEAK/src/peak/config/interfaces.py.diff?r1=1.33&r2=1.34
http://cvs.eby-sarna.com/PEAK/src/peak/config/registries.py.diff?r1=1.3&r2=1.4
http://cvs.eby-sarna.com/PEAK/src/peak/config/tests/__init__.py.diff?r1=1.28&r2=1.29
http://cvs.eby-sarna.com/PEAK/src/peak/config/tests/test_keys.py.diff?r1=1.1&r2=1.2
http://cvs.eby-sarna.com/PEAK/src/peak/naming/factories/config_ctx.py.diff?r1=1.7&r2=1.8
http://cvs.eby-sarna.com/PEAK/src/peak/running/clusters.py.diff?r1=1.12&r2=1.13
http://cvs.eby-sarna.com/PEAK/src/peak/running/commands.py.diff?r1=1.46&r2=1.47
http://cvs.eby-sarna.com/PEAK/src/peak/running/interfaces.py.diff?r1=1.29&r2=1.30
http://cvs.eby-sarna.com/PEAK/src/peak/running/logs.py.diff?r1=1.29&r2=1.30
http://cvs.eby-sarna.com/PEAK/src/peak/running/scheduler.py.diff?r1=1.31&r2=1.32
http://cvs.eby-sarna.com/PEAK/src/peak/storage/transactions.py.diff?r1=1.32&r2=1.33

To generate a diff of this commit:
cvs rdiff -r1.114 -r1.115 PEAK/CHANGES.txt
cvs rdiff -r1.87 -r1.88 PEAK/TODO.txt
cvs rdiff -r1.34 -r1.35 PEAK/docs/core_tutorial/binding.tex
cvs rdiff -r1.4 -r1.5 PEAK/examples/bulletins/src/bulletins/model.py
cvs rdiff -r1.2 -r1.3 PEAK/src/peak/core.py
cvs rdiff -r1.6 -r1.7 PEAK/src/peak/exceptions.py
cvs rdiff -r1.108 -r1.109 PEAK/src/peak/peak.ini
cvs rdiff -r1.130 -r1.131 PEAK/src/peak/binding/components.py
cvs rdiff -r1.18 -r1.19 PEAK/src/peak/binding/interfaces.py
cvs rdiff -r1.22 -r1.23 PEAK/src/peak/config/api_impl.py
cvs rdiff -r1.71 -r1.72 PEAK/src/peak/config/config_components.py
cvs rdiff -r1.2 -r1.3 PEAK/src/peak/config/ini_files.py
cvs rdiff -r1.33 -r1.34 PEAK/src/peak/config/interfaces.py
cvs rdiff -r1.3 -r1.4 PEAK/src/peak/config/registries.py
cvs rdiff -r1.28 -r1.29 PEAK/src/peak/config/tests/__init__.py
cvs rdiff -r1.1 -r1.2 PEAK/src/peak/config/tests/test_keys.py
cvs rdiff -r1.7 -r1.8 PEAK/src/peak/naming/factories/config_ctx.py
cvs rdiff -r1.12 -r1.13 PEAK/src/peak/running/clusters.py
cvs rdiff -r1.46 -r1.47 PEAK/src/peak/running/commands.py
cvs rdiff -r1.29 -r1.30 PEAK/src/peak/running/interfaces.py \
    PEAK/src/peak/running/logs.py
cvs rdiff -r1.31 -r1.32 PEAK/src/peak/running/scheduler.py
cvs rdiff -r1.32 -r1.33 PEAK/src/peak/storage/transactions.py

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