E&S CVS Commit: PEAK - Reformatted peak.running.clusters docstring to structured text for better

[pje at eby-sarna.com]

Module Name:	PEAK
Committed By:	pje
Date:		Thu Nov  7 00:12:14 UTC 2002

Modified Files:
	PEAK: TODO.txt
	PEAK/src/peak: peak.ini
	PEAK/src/peak/config: config_components.py
	PEAK/src/peak/config/tests: __init__.py
	PEAK/src/peak/naming: names.py
	PEAK/src/peak/running: api.py clusters.py

Log Message:
Reformatted peak.running.clusters docstring to structured text for better
HappyDoc output.  Defined the rule for 'peak.running.cluster._filename' in
peak.ini instead of in the code.

Renamed PropSet to PropertySet, and made it possible to go from a
PropertyName to a PropertySet by calling '.of()' (e.g.
'PropertyName("foo").of(anObj)'.  PropertySets can now reproduce in various
ways, e.g.:

     c = PropertyName('peak.running.cluster').of(None) # -> PropertySet

     c._host['two.baz.com']	# ('even','prime','weird')
     c._groups()		# ('odd','even','prime','weird','qux')

But none of this is documented yet and possibly subject to change.  :)
(Especially since we're probably going to change how the cluster namespace
works anyhow!)

Ideally, it should be easy to go from a property name to its value or to
a property set, and to go from a property set to a value in some namespace.
Of course, it's somewhat questionable whether we'll be doing this for that
many properties in the first place!  And this is all going to go "full
circle" once properties have a naming context that can be used to look
them up in.  I worry a bit about creeping TMTOWTDI-ism in all this.  :(


To view diffs of this commit, you can use the following URL(s):
http://cvs.eby-sarna.com/PEAK/TODO.txt.diff?r1=1.17&r2=1.18
http://cvs.eby-sarna.com/PEAK/src/peak/peak.ini.diff?r1=1.8&r2=1.9
http://cvs.eby-sarna.com/PEAK/src/peak/config/config_components.py.diff?r1=1.22&r2=1.23
http://cvs.eby-sarna.com/PEAK/src/peak/config/tests/__init__.py.diff?r1=1.5&r2=1.6
http://cvs.eby-sarna.com/PEAK/src/peak/naming/names.py.diff?r1=1.27&r2=1.28
http://cvs.eby-sarna.com/PEAK/src/peak/running/api.py.diff?r1=1.4&r2=1.5
http://cvs.eby-sarna.com/PEAK/src/peak/running/clusters.py.diff?r1=1.1&r2=1.2

To generate a diff of this commit:
cvs rdiff -r1.17 -r1.18 PEAK/TODO.txt
cvs rdiff -r1.8 -r1.9 PEAK/src/peak/peak.ini
cvs rdiff -r1.22 -r1.23 PEAK/src/peak/config/config_components.py
cvs rdiff -r1.5 -r1.6 PEAK/src/peak/config/tests/__init__.py
cvs rdiff -r1.27 -r1.28 PEAK/src/peak/naming/names.py
cvs rdiff -r1.4 -r1.5 PEAK/src/peak/running/api.py
cvs rdiff -r1.1 -r1.2 PEAK/src/peak/running/clusters.py

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