[gnue] r8449 - in trunk/gnue-common/src: logic utils

[reinhard]

Author: reinhard
Date: 2006-04-27 04:36:23 -0500 (Thu, 27 Apr 2006)
New Revision: 8449

Modified:
   trunk/gnue-common/src/logic/GTriggerCore.py
   trunk/gnue-common/src/utils/tree.py
Log:
Added some braindump so it gets preserved.


Modified: trunk/gnue-common/src/logic/GTriggerCore.py
===================================================================
--- trunk/gnue-common/src/logic/GTriggerCore.py 2006-04-27 06:59:53 UTC (rev 
8448)
+++ trunk/gnue-common/src/logic/GTriggerCore.py 2006-04-27 09:36:23 UTC (rev 
8449)
@@ -77,6 +77,10 @@
         Initialize a GTriggerCore instance.
         """
 
+        # TODO: It would be nice if _triggerFunctions and _triggerGlobals would
+        # also define a 'description' key where one could place text for an
+        # autogenerated documentation.
+
         self._triggerGlobal = 0
         self._triggerGet = None
         self._triggerSet = None

Modified: trunk/gnue-common/src/utils/tree.py
===================================================================
--- trunk/gnue-common/src/utils/tree.py 2006-04-27 06:59:53 UTC (rev 8448)
+++ trunk/gnue-common/src/utils/tree.py 2006-04-27 09:36:23 UTC (rev 8449)
@@ -193,6 +193,32 @@
 
 
 # =============================================================================
+# Notes
+# =============================================================================
+
+# Some quick notes on descendant classes so I don't forget it:
+# 
+# TypedNode has a class attribute _type_ that is defined for every
+# descendant, will contain strings like "form", "entry", "block", etc.
+# Implements get_parent_of_type(), get_children_of_type().
+# 
+# NamedNode has a virtual method _get_name_() that descendants implement to
+# return a nice name of the node, like "blkPerson" or "fldName" or
+# "<unnamed button>". Implements a method for the root node to find a node with
+# a given type and a given name, to replace trigger/datasource/etc dictionaries
+# in GFForm.
+# 
+# AttributeNode adds handling of [XML] attributes. Descendants of this class
+# defined in a self-contained way details about the valid attributes (what is
+# now defined in those getXMLelements() functions). Initializes default
+# attributes for new instances from these definitions. Checks validity of
+# attribute values on setting of attributes. Allows only dictionary-style
+# access to those attributes, e.g. only myBlock['datasource'], not
+# myBlock.datasource. Better name for "attribute" is welcome, as "attribute" is
+# already used in Python for instance variables (getattr() etc).
+
+
+# =============================================================================
 # Self test code
 # =============================================================================