Ñò
†°Ic @ s d d k Td d k Td d k l Z d d k Z d g Z d e f d „ ƒ YZ d d „ Z d „ Z d „ Z d
„ Z
d e f d „ ƒ YZ d S(
iÿÿÿÿ( t *( t _Nt Schemac B s e Z d Z g Z g Z e Z e Z e Z e Z
e Z h Z
g Z h e d ƒ d 6e d ƒ d 6e d ƒ d 6Z d Z d
„ Z d „ Z d „ Z d
„ Z d „ Z d „ Z e i e ƒ Z d „ Z e i e ƒ Z d „ Z e i e ƒ Z d „ Z d „ Z d „ Z RS( sG
A schema validates a dictionary of values, applying different
validators (be key) to the different values. If
allow_extra_fields=True, keys without validators will be allowed;
otherwise they will raise Invalid. If filter_extra_fields is
set to true, then extra fields are not passed back in the results.
Validators are associated with keys either with a class syntax, or
as keyword arguments (class syntax is usually easier). Something
like::
class MySchema(Schema):
name = Validators.PlainText()
phone = Validators.PhoneNumber()
These will not be available as actual instance variables, but will
be collected in a dictionary. To remove a validator in a subclass
that is present in a superclass, set it to None, like::
class MySubSchema(MySchema):
name = None
Note that missing fields are handled at the Schema level. Missing
fields can have the 'missing' message set to specify the error
message, or if that does not exist the *schema* message
'missingValue' is used.
s* The input field %(name)s was not expected.t notExpecteds
Missing valuet missingValues7 The input must be dict-like (not a %(type)s: %(value)r)t badDictTypet fieldst chained_validatorst pre_validatorsc C sÙ t i | | ƒ | i t f j o | Sxz | i ƒ D]l \ } } | d j o q5 n t | ƒ o | | i | R? R@ R R RA t pre( ( s5 /usr/lib/python2.6/site-packages/formencode/schema.pyt _from_pythonÑ st
)
!
c C sY | d j o8 | i | i j o | i | _ n | i i | ƒ n | i i | ƒ d S( N( R( R RH ( R R R; ( ( s5 /usr/lib/python2.6/site-packages/formencode/schema.pyt add_chained_validator s
c C sX | d j o: | i | i j o | i i ƒ | _ n | | i |
\ B i c C sN t | t ƒ o5 y t | ƒ SWqJt t f j
o t | ƒ SXnt | t ƒ o~ | i ƒ } | i ƒ d d | i g } | D]D \ } } | d j o+ | d | t | d t | ƒ d ƒf q„ q„ ~ ƒ St | t
ƒ oR d d | i g } | D]. } | d j o | d t | d | ƒqü qü ~ ƒ St | t ƒ o | Sd S( Ns %s
t s %s: %st indenti s %s( R6 t Exceptiont strt UnicodeDecodeErrort UnicodeEncodeErrort unicodeR7 R
t sortRF R( R9 t lent listt
basestring( t vRc t lt _[1]t kR t _[2]( ( s5 /usr/lib/python2.6/site-packages/formencode/schema.pyR9 @ s(
C
3c C sO xH | D]@ } | | j o t | | | | ƒ | | >> def validate(form_values, state, validator):
... if form_values.get('country', 'US') == 'US':
... if not form_values.get('state'):
... return {'state': 'You must enter a state'}
... if not form_values.get('country'):
... form_values['country'] = 'US'
This tests that the field 'state' must be filled in if the country
is US, and defaults that country value to 'US'. The ``validator``
argument is the SimpleFormValidator instance, which you can use to
format messages or keep configuration state in if you like (for
simple ad hoc validation you are unlikely to need it).
To create a validator from that function, you would do::
>>> from formencode.schema import SimpleFormValidator
>>> validator = SimpleFormValidator(validate)
>>> validator.to_python({'country': 'US', 'state': ''}, None)
Traceback (most recent call last):
...
Invalid: state: You must enter a state
>>> validator.to_python({'state': 'IL'}, None)
{'country': 'US', 'state': 'IL'}
The validate function can either return a single error message
(that applies to the whole form), a dictionary that applies to the
fields, None which means the form is valid, or it can raise
Invalid.
Note that you may update the value_dict *in place*, but you cannot
return a new value.
Another way to instantiate a validator is like this::
>>> @SimpleFormValidator.decorate()
... def MyValidator(value_dict, state):
... return None # or some more useful validation
After this ``MyValidator`` will be a ``SimpleFormValidator``
instance (it won't be your function).
t funcc C s t | i d d ƒ | _ d S( NRZ ( R) R€ R( RZ ( R R ( ( s5 /usr/lib/python2.6/site-packages/formencode/schema.pyR µ s c C s³ | i ƒ } | i | | | ƒ } | p | St | t ƒ o t | | | ƒ ‚ n] t | t ƒ o" t t | ƒ | | d | ƒ‚ n+ t | t ƒ o
| ‚ n t d | ƒ ‚ | S( NR# s Invalid error value: %r( RP R€ R6 Rl R R7 R9 t TypeError( R R: R R= ( ( s5 /usr/lib/python2.6/site-packages/formencode/schema.pyR& ¸ s
c s ‡ ‡ f d † } | S( Nc s
ˆ | ˆ S( N( ( R€ ( t kwR ( s5 /usr/lib/python2.6/site-packages/formencode/schema.pyt decoratorÎ s ( ( R R‚ Rƒ ( ( R‚ R s5 /usr/lib/python2.6/site-packages/formencode/schema.pyt decorateÍ s ( s func( RX RY RZ t __unpackargs__R4 R" R R& R! R„ t classmethod( ( ( s5 /usr/lib/python2.6/site-packages/formencode/schema.pyR s . ( t
interfacest apiR R` t __all__R
R R9 R8 Rr Rv R ( ( ( s5 /usr/lib/python2.6/site-packages/formencode/schema.pyt s
ÿ 9