Improve and document UpOneOf validator (refs #20)

[software/pymin.git] / pymin / validation.py

diff --git a/pymin/validation.py b/pymin/validation.py
index a9baf2244c89096048dad4122938797e9c0d2aba..ea31c1df73f067da9920182b4be836d70d0a25d5 100644 (file)
--- a/pymin/validation.py
+++ b/pymin/validation.py
@@ -8,7 +8,22 @@ from pymin.item import Item
 from pymin.validatedclass import Field
 
 class UpOneOf(OneOf):
 from pymin.validatedclass import Field
 
 class UpOneOf(OneOf):

-    "Same as :class:`OneOf` but values are uppercased before validation."
-    def validate_python(self, value, state):
-        return OneOf.validate_python(self, value.upper(), state)
+    """
+    Same as :class:`OneOf` but values are uppercased before validation.
+
+    Examples::
+
+        >>> uoo = UpOneOf(['A', 'B', 'C'])
+        >>> uoo.to_python('a')
+        'A'
+        >>> uoo.to_python('B')
+        'B'
+        >>> uoo.to_python('x')
+        Traceback (most recent call last):
+            ...
+        Invalid: Value must be one of: A; B; C (not 'X')
+    """
+
+    def _to_python(self, value, state):
+        return value.upper()