Changes between Version 25 and Version 26 of PyYAMLDocumentation

Timestamp:

05/12/06 05:06:16 (7 years ago)

Author:

xi

Comment:

Make the Dice example less confusing; thanks ingy for suggestion.

PyYAMLDocumentation

@@ -291 +291 @@
 ...         return tuple.__new__(cls, [a, b])
 ...     def __repr__(self):
-...         return "%sd%s" % self
+...         return "Dice(%s,%s)" % self
 
 >>> print Dice(3,6)
+Dice(3,6)
+}}}
+
+The default representation for '''`Dice`''' objects is not nice:
+{{{
+#!python
+>>> print yaml.dump(Dice(3,6))
+
+!!python/object/new:__main__.Dice
+- !!python/tuple [3, 6]
+}}}
+
+Suppose you want a '''`Dice`''' object to represented as '''`AdB`''' in YAML:
+{{{
+#!python
+>>> print yaml.dump(Dice(3,6))
+
 3d6
 }}}
@@ -302 +319 @@
 #!python
 >>> def dice_representer(dumper, data):
-...     return dumper.represent_scalar(u'!dice', unicode(data))
+...     return dumper.represent_scalar(u'!dice', u'%sd%s' % data)
 
 >>> yaml.add_representer(Dice, dice_representer)
@@ -332 +349 @@
 ... """)
 
-{'initial hit points': 8d4}
+{'initial hit points': Dice(8,4)}
 }}}
 
@@ -356 +373 @@
 ... """)
 
-{'damage': 5d10}
+{'damage': Dice(5,10)}
 }}}
 
@@ -470 +487 @@
 - Ring of Teleportation
 - Ring of Speed
+
 right hand:
 - Ring of Resist Fire