[Checkins] SVN: z3c.form/trunk/src/z3c/form/converter.txt 100% test coverage! Yipee!

[Stephan Richter]

Log message for revision 78126:
  100% test coverage! Yipee!
  

Changed:
  U   z3c.form/trunk/src/z3c/form/converter.txt

-=-
Modified: z3c.form/trunk/src/z3c/form/converter.txt
===================================================================
--- z3c.form/trunk/src/z3c/form/converter.txt	2007-07-18 21:29:21 UTC (rev 78125)
+++ z3c.form/trunk/src/z3c/form/converter.txt	2007-07-18 21:35:26 UTC (rev 78126)
@@ -551,3 +551,38 @@
 
   >>> csdv.toFieldValue(['m'])
   set([0])
+
+Getting Terms
+~~~~~~~~~~~~~
+
+As an optimization of this converter, the converter actually does not look up
+the terms itself but uses the widget's ``terms`` attribute. If the terms are
+not yet retrieved, the converter will ask the widget to do so when in need.
+
+So let's see how this works when getting the widget value:
+
+  >>> seqWidget = widget.SequenceWidget(TestRequest())
+  >>> seqWidget.field = genders
+
+  >>> seqWidget.terms
+
+  >>> csdv = converter.CollectionSequenceDataConverter(genders, seqWidget)
+  >>> csdv.toWidgetValue([0])
+  ['m']
+
+  >>> seqWidget.terms
+  <z3c.form.term.CollectionTerms object ...>
+
+The same is true when getting the field value:
+
+  >>> seqWidget = widget.SequenceWidget(TestRequest())
+  >>> seqWidget.field = genders
+
+  >>> seqWidget.terms
+
+  >>> csdv = converter.CollectionSequenceDataConverter(genders, seqWidget)
+  >>> csdv.toFieldValue(['m'])
+  set([0])
+
+  >>> seqWidget.terms
+  <z3c.form.term.CollectionTerms object ...>