Ic @ s] d Z d d k Z d d k Z d Z d a d a d d k a d d k Td d k Td a
a e i Z e i
d e d d k Z e e _ y e Wn e j
o e i Z n Xd d k Z d d k Z y d d k Z e i e Z Wn e j
o
e Z n Xd d j d d j Z Z d Z d a d a d Z d Z d
Z d Z! d Z" d
e# f d YZ$ d e# f d YZ% d e# f d YZ& d e# f d YZ' d e# f d YZ( d e# f d YZ) d e# f d YZ* d e# f d YZ+ d e+ f d YZ, d e# f d YZ- d! e# f d" YZ. d# e# f d$ YZ/ d% e# f d& YZ0 d' e# f d( YZ1 d) e# f d* YZ2 d+ e2 f d, YZ3 d- e2 f d. YZ4 d/ e# f d0 YZ5 d1 e5 f d2 YZ6 d3 e# f d4 YZ d5 e# f d6 YZ7 d7 e# f d8 YZ8 d9 e# f d: YZ9 d; e# f d< YZ: d= Z; d> Z< d? Z= d@ e# f dA YZ> dB e# f dC YZ? dD e# f dE YZ@ dF e# f dG YZA dH ZB dI e# f dJ YZC dK e# f dL YZD eD ZE dM e# f dN YZF dO e# f dP YZG dQ eG f dR YZH dS e# f dT YZI dU e# f dV YZJ dW eJ f dX YZK eK ZL dY eJ f dZ YZM d[ eJ f d\ YZN d] eJ f d^ YZO d_ eJ f d` YZP da g ZQ xN eR iS D]= \ ZT ZU eV eU eW o! eX eU eY o eQ iZ eT qqWd S(b s/
Validator/Converters for use with FormEncode.
iN( t *t ignorei i c C s | S( ( ( t s( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyt ? s c C s | d j oa y% t d j o d d k a n t SWqn t j
o) t d j o d d k l a n t SXn | i } | d j o" t d j o d d k a n t St d j o d d k l a n t Sd S( Ni( t DateTimet datetime( t Nonet datetime_moduleR t ImportErrort mxDateTime_modulet mxR t lower( t module_type( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyt import_datetimeJ s"
c C s, | i d j o | i i S| i Sd S( NR ( t __name__R t now( t module( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyt datetime_nowa s c C sl | i d j o | i | | | Sy | i | | | SWn* | i j
o } t t | n Xd S( NR ( R t dateR t
RangeErrort
ValueErrort str( R t yeart montht dayt e( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyt datetime_makedateg s c C s | i d j o | i Sd S( NR ( R t time( R ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyt
datetime_timer s c C s | i d j o | i i Sd S( NR ( R R t isoformat( R ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyt datetime_isotimew s t ConfirmTypec B sx e Z d Z d
Z d
Z h e d d 6e d d 6e d d 6e d d 6Z d Z d
Z d Z
d Z RS( s
Confirms that the input/output is of the proper type.
Uses the parameters:
subclass:
The class or a tuple of classes; the item must be an instance
of the class or a subclass.
type:
A type or tuple of types (or classes); the item must be of
the exact class or type. Subclasses are not allowed.
Examples::
>>> cint = ConfirmType(subclass=int)
>>> cint.to_python(True)
True
>>> cint.to_python('1')
Traceback (most recent call last):
...
Invalid: '1' is not a subclass of
>>> cintfloat = ConfirmType(subclass=(float, int))
>>> cintfloat.to_python(1.0), cintfloat.from_python(1.0)
(1.0, 1.0)
>>> cintfloat.to_python(1), cintfloat.from_python(1)
(1, 1)
>>> cintfloat.to_python(None)
Traceback (most recent call last):
...
Invalid: None is not a subclass of one of the types ,
>>> cint2 = ConfirmType(type=int)
>>> cint2(accept_python=False).from_python(True)
Traceback (most recent call last):
...
Invalid: True must be of the type
s, %(object)r is not a subclass of %(subclass)st subclasssA %(object)r is not a subclass of one of the types %(subclassList)st
inSubclasss0 %(object)r must be one of the types %(typeList)st inTypes' %(object)r must be of the type %(type)st typec O s t i | | | | i o_ t | i t o t | i | _ n' t | i t p | i f | _ n | i | _ n | i o_ t | i t o t | i | _ n' t | i t p | i f | _ n | i | _ n d S( N(
t FancyValidatort __init__R t
isinstancet listt tuplet confirm_subclasst validate_pythonR# t confirm_type( t selft argst kw( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR% s
c C s t | | i p t | i d j o) | i d | d | d | i d } n: d i t t | i } | i d | d | d | } t | | | n d S( Ni R t objecti s , R! t subclassList( R& R t lent messaget joint mapR t Invalid( R, t valuet statet msgt
subclass_list( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR) s c C s x | i D] } t | | j o Pq
q
Wt | i d j o) | i d | d | d | i d } n4 | i d | d | d d i t t | i } t | | | | S( Ni R# R/ i R" t typeLists , ( R# R1 R2 R3 R4 R R5 ( R, R6 R7 t tR8 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR+ s
c C s t S( N( t False( R, R6 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyt is_empty s N( R t
__module__t __doc__R R R# t _t messagesR% R) R+ R= ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s %
t Wrapperc B s8 e Z d Z d Z d Z d Z d Z d Z d Z RS( s
Used to convert functions to validator/converters.
You can give a simple function for `to_python`, `from_python`,
`validate_python` or `validate_other`. If that function raises an
exception, the value is considered invalid. Whatever value the
function returns is considered the converted value.
Unlike validators, the `state` argument is not used. Functions
like `int` can be used here, that take a single argument.
Examples::
>>> def downcase(v):
... return v.lower()
>>> wrap = Wrapper(to_python=downcase)
>>> wrap.to_python('This')
'this'
>>> wrap.from_python('This')
'This'
>>> wrap2 = Wrapper(from_python=downcase)
>>> wrap2.from_python('This')
'this'
>>> wrap2.from_python(1)
Traceback (most recent call last):
...
Invalid: 'int' object has no attribute 'lower'
>>> wrap3 = Wrapper(validate_python=int)
>>> wrap3.to_python('1')
'1'
>>> wrap3.to_python('a') # doctest: +ELLIPSIS
Traceback (most recent call last):
...
Invalid: invalid literal for int()...
c O s xG d d d d g D]3 } | i | o | | | d | <| | =q q Wt i | | | | i | i | _ | i | i | _ | i | i | _ | i | i
| _ d S( Nt to_pythont from_pythonR* t validate_others func_%s( t has_keyR$ R% t wrapt func_to_pythont
_to_pythont func_from_pythont _from_pythont func_validate_pythonR* t func_validate_otherRE ( R, R- R. t n( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR% s c C s | p d S| d } | S( Nc S sE y | | SWn0 t j
o$ } t t | h | | n Xd S( N( t ExceptionR5 R ( R6 R7 t funcR ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyt result s ( R ( R, RP RQ ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRG s N(
R R> R? R RH RJ RL RM R% RG ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRB s $ t Constantc B s# e Z d Z d Z d Z e Z RS( sm
This converter converts everything to the same thing.
I.e., you pass in the constant value when initializing, then all
values get converted to that constant value.
This is only really useful for funny situations, like::
fromEmailValidator = ValidateAny(
ValidEmailAddress(),
Constant('unknown@localhost'))
In this case, the if the email is not valid
``'unknown@localhost'`` will be used instead. Of course, you
could use ``if_invalid`` instead.
Examples::
>>> Constant('X').to_python('y')
'X'
R6 c C s | i S( N( R6 ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI 8 s ( s value( R R> R? t __unpackargs__RI RK ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRR s t MaxLengthc B s= e Z d Z d Z h e d d 6e d d 6Z d Z RS( s
Invalid if the value is longer than `maxLength`. Uses len(),
so it can work for strings, lists, or anything with length.
Examples::
>>> max5 = MaxLength(5)
>>> max5.to_python('12345')
'12345'
>>> max5.from_python('12345')
'12345'
>>> max5.to_python('123456')
Traceback (most recent call last):
...
Invalid: Enter a value less than 5 characters long
>>> max5(accept_python=False).from_python('123456')
Traceback (most recent call last):
...
Invalid: Enter a value less than 5 characters long
>>> max5.to_python([1, 2, 3])
[1, 2, 3]
>>> max5.to_python([1, 2, 3, 4, 5, 6])
Traceback (most recent call last):
...
Invalid: Enter a value less than 5 characters long
>>> max5.to_python(5)
Traceback (most recent call last):
...
Invalid: Invalid value (value with length expected)
t maxLengths5 Enter a value less than %(maxLength)i characters longt tooLongs* Invalid value (value with length expected)t invalidc C s yP | oA t | | i j o+ t | i d | d | i | | n d SWn1 t j
o% t | i d | | | n Xd S( NRV RU RW ( R1 RU R5 R2 R t TypeError( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR* h s ( s maxLength( R R> R? RS R@ RA R* ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRT A s
t MinLengthc B s= e Z d Z d Z h e d d 6e d d 6Z d Z RS( sb
Invalid if the value is shorter than `minlength`. Uses len(), so
it can work for strings, lists, or anything with length. Note
that you **must** use ``not_empty=True`` if you don't want to
accept empty values -- empty values are not tested for length.
Examples::
>>> min5 = MinLength(5)
>>> min5.to_python('12345')
'12345'
>>> min5.from_python('12345')
'12345'
>>> min5.to_python('1234')
Traceback (most recent call last):
...
Invalid: Enter a value at least 5 characters long
>>> min5(accept_python=False).from_python('1234')
Traceback (most recent call last):
...
Invalid: Enter a value at least 5 characters long
>>> min5.to_python([1, 2, 3, 4, 5])
[1, 2, 3, 4, 5]
>>> min5.to_python([1, 2, 3])
Traceback (most recent call last):
...
Invalid: Enter a value at least 5 characters long
>>> min5.to_python(5)
Traceback (most recent call last):
...
Invalid: Invalid value (value with length expected)
t minLengths4 Enter a value at least %(minLength)i characters longt tooShorts* Invalid value (value with length expected)RW c C s} yE t | | i j o+ t | i d | d | i | | n Wn1 t j
o% t | i d | | | n Xd S( NR[ RZ RW ( R1 RZ R5 R2 RX ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR* s ( s minLength( R R> R? RS R@ RA R* ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRY u s "
t NotEmptyc B s0 e Z d Z e Z h e d d 6Z d Z RS( s
Invalid if value is empty (empty string, empty list, etc).
Generally for objects that Python considers false, except zero
which is not considered invalid.
Examples::
>>> ne = NotEmpty(messages={'empty': 'enter something'})
>>> ne.to_python('')
Traceback (most recent call last):
...
Invalid: enter something
>>> ne.to_python(0)
0
s Please enter a valuet emptyc C s? | d j o | S| p" t | i d | | | n d S( Ni R] ( R5 R2 ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR* s
( R R> R? t Truet not_emptyR@ RA R* ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR\ s
t Emptyc B s* e Z d Z h e d d 6Z d Z RS( s
Invalid unless the value is empty. Use cleverly, if at all.
Examples::
>>> Empty.to_python(0)
Traceback (most recent call last):
...
Invalid: You cannot enter a value here
s You cannot enter a value heret notEmptyc C s: | p
| d j o" t | i d | | | n d S( Ni Ra ( R5 R2 ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR* s ( R R> R? R@ RA R* ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR` s t Regexc B sT e Z d Z d Z e Z d Z d Z h e d d 6Z
d Z d Z d Z
RS(
s
Invalid if the value doesn't match the regular expression `regex`.
The regular expression can be a compiled re object, or a string
which will be compiled for you.
Use strip=True if you want to strip the value before validation,
and as a form of conversion (often useful).
Examples::
>>> cap = Regex(r'^[A-Z]+$')
>>> cap.to_python('ABC')
'ABC'
Note that ``.from_python()`` calls (in general) do not validate
the input::
>>> cap.from_python('abc')
'abc'
>>> cap(accept_python=False).from_python('abc')
Traceback (most recent call last):
...
Invalid: The input is not valid
>>> cap.to_python(1)
Traceback (most recent call last):
...
Invalid: The input must be a string (not a : 1)
>>> Regex(r'^[A-Z]+$', strip=True).to_python(' ABC ')
'ABC'
>>> Regex(r'this', regexOps=('I',)).to_python('THIS')
'THIS'
t regexs The input is not validRW c O s t i | | | t | i t og d } xB | i D]7 } t | t o | t t | O} q6 | | O} q6 Wt i | i | | _ n d S( Ni ( R$ R% R& Rc t
basestringt regexOpst getattrt ret compile( R, R- R. t opst op( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR% s
c C ss | i | | | i o t | t o | i } n | i i | p" t | i d | | | n d S( NRW ( t
assert_stringt stripR& Rd Rc t searchR5 R2 ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR* s c C s) | i o t | t o | i S| S( N( Rl R& Rd ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI $ s ( N( s regex( R R> R? Re R< Rl R Rc RS R@ RA R% R* RI ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRb s " t PlainTextc B s' e Z d Z d Z h e d d 6Z RS( sK
Test that the field contains only letters, numbers, underscore,
and the hyphen. Subclasses Regex.
Examples::
>>> PlainText.to_python('_this9_')
'_this9_'
>>> PlainText.from_python(' this ')
' this '
>>> PlainText(accept_python=False).from_python(' this ')
Traceback (most recent call last):
...
Invalid: Enter only letters, numbers, or _ (underscore)
>>> PlainText(strip=True).to_python(' this ')
'this'
>>> PlainText(strip=True).from_python(' this ')
'this'
s ^[a-zA-Z_\-0-9]*$s. Enter only letters, numbers, or _ (underscore)RW ( R R> R? Rc R@ RA ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRn ) s t OneOfc B sO e Z d Z d Z e Z e Z d Z h e d d 6e d d 6Z
d Z RS( se
Tests that the value is one of the members of a given list.
If ``testValueList=True``, then if the input value is a list or
tuple, all the members of the sequence will be checked (i.e., the
input must be a subset of the allowed values).
Use ``hideList=True`` to keep the list of valid values out of the
error message in exceptions.
Examples::
>>> oneof = OneOf([1, 2, 3])
>>> oneof.to_python(1)
1
>>> oneof.to_python(4)
Traceback (most recent call last):
...
Invalid: Value must be one of: 1; 2; 3 (not 4)
>>> oneof(testValueList=True).to_python([2, 3, [1, 2, 3]])
[2, 3, [1, 2, 3]]
>>> oneof.to_python([2, 3, [1, 2, 3]])
Traceback (most recent call last):
...
Invalid: Value must be one of: 1; 2; 3 (not [2, 3, [1, 2, 3]])
R' s
Invalid valueRW s/ Value must be one of: %(items)s (not %(value)r)t notInc C s | i o; t | t t f o% x | D] } | i | | q' Wn | | i j ou | i o" t | i d | | | q d i t t
| i } t | i d | d | d | | | n d S( NRW s ; Rp t itemsR6 ( t
testValueListR& R' R( R* t hideListR5 R2 R3 R4 R ( R, R6 R7 t vRq ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR* m s
N( s list( R R> R? R R' R< Rr Rs RS R@ RA R* ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRo E s
t
DictConverterc B sl e Z d Z d Z e Z d
Z h e d d 6e d d 6e d d 6e d d 6Z d
Z
d Z RS( sX
Converts values based on a dictionary which has values as keys for
the resultant values.
If ``allowNull`` is passed, it will not balk if a false value
(e.g., '' or None) is given (it will return None in these cases).
to_python takes keys and gives values, from_python takes values and
gives keys.
If you give hideDict=True, then the contents of the dictionary
will not show up in error messages.
Examples::
>>> dc = DictConverter({1: 'one', 2: 'two'})
>>> dc.to_python(1)
'one'
>>> dc.from_python('one')
1
>>> dc.to_python(3)
Traceback (most recent call last):
Invalid: Enter a value from: 1; 2
>>> dc2 = dc(hideDict=True)
>>> dc2.hideDict
True
>>> dc2.dict
{1: 'one', 2: 'two'}
>>> dc2.to_python(3)
Traceback (most recent call last):
Invalid: Choose something
>>> dc.from_python('three')
Traceback (most recent call last):
Invalid: Nothing in my dictionary goes by the value 'three'. Choose one of: 'one'; 'two'
t dicts Choose somethingt keyNotFounds Enter a value from: %(items)st chooseKeys That value is not knownt
valueNotFoundsO Nothing in my dictionary goes by the value %(value)s. Choose one of: %(items)st chooseValuec C s y | i | SWn t j
ox | i o" t | i d | | | q d i t t | i i } t | i d | d | | | n Xd S( NRw s ; Rx Rq ( Rv t KeyErrort hideDictR5 R2 R3 R4 t reprt keys( R, R6 R7 Rq ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI s
!c
C s x/ | i i D] \ } } | | j o | Sq W| i o" t | i d | | | nR d i t t | i i } t | i d | d t | d | | | d S( NRy s ; Rz R6 Rq ( Rv Rq R| R5 R2 R3 R4 R} t values( R, R6 R7 t kRt Rq ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRK s
! N( s dict( R R> R? R Rv R< R| RS R@ RA RI RK ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRu } s $
t IndexListConverterc B sY e Z d Z d
Z d Z h e d d 6e d d 6e d d 6Z d Z d Z RS( s
Converts a index (which may be a string like '2') to the value in
the given list.
Examples::
>>> index = IndexListConverter(['zero', 'one', 'two'])
>>> index.to_python(0)
'zero'
>>> index.from_python('zero')
0
>>> index.to_python('1')
'one'
>>> index.to_python(5)
Traceback (most recent call last):
Invalid: Index out of range
>>> index(not_empty=True).to_python(None)
Traceback (most recent call last):
Invalid: Please enter a value
>>> index.from_python('five')
Traceback (most recent call last):
Invalid: Item 'five' was not found in the list
R' s Must be an integer indext integers Index out of ranget
outOfRanges( Item %(value)s was not found in the listt notFoundc C s y t | } Wn7 t t f j
o% t | i d | | | n Xy | i | SWn1 t j
o% t | i d | | | n Xd S( NR R ( t intR RX R5 R2 R' t
IndexError( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI s c C sg x6 t t | i D] } | i | | j o | Sq Wt | i d | d t | | | d S( NR R6 ( t rangeR1 R' R5 R2 R} ( R, R6 R7 t i( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRK s N( s list(
R R> R? R R' RS R@ RA RI RK ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s
t
DateValidatorc B so e Z d Z d
Z d
Z e Z e Z d
Z h e
d d 6e
d d 6e
d d 6e
d d 6Z d Z RS( s
Validates that a date is within the given range. Be sure to call
DateConverter first if you aren't expecting mxDateTime input.
``earliest_date`` and ``latest_date`` may be functions; if so,
they will be called each time before validating.
``after_now`` means a time after the current timestamp; note that
just a few milliseconds before now is invalid! ``today_or_after``
is more permissive, and ignores hours and minutes.
Examples::
>>> from datetime import datetime, timedelta
>>> d = DateValidator(earliest_date=datetime(2003, 1, 1))
>>> d.to_python(datetime(2004, 1, 1))
datetime.datetime(2004, 1, 1, 0, 0)
>>> d.to_python(datetime(2002, 1, 1))
Traceback (most recent call last):
...
Invalid: Date must be after Wednesday, 01 January 2003
>>> d.to_python(datetime(2003, 1, 1))
datetime.datetime(2003, 1, 1, 0, 0)
>>> d = DateValidator(after_now=True)
>>> now = datetime.now()
>>> d.to_python(now+timedelta(seconds=5)) == now+timedelta(seconds=5)
True
>>> d.to_python(now-timedelta(days=1))
Traceback (most recent call last):
...
Invalid: The date must be sometime in the future
>>> d.to_python(now+timedelta(days=1)) > now
True
>>> d = DateValidator(today_or_after=True)
>>> d.to_python(now) == now
True
s Date must be after %(date)st afters Date must be before %(date)st befores %%A, %%d %%B %%Yt date_formats' The date must be sometime in the futuret futurec C s | i d | } t | t o d } | i | } n d } | i o t | i o | i } n
| i } | | j oQ | i | } | o | i | } n t | i d | d | | | q n | i
o t | i
o | i
} n
| i
} | | j oQ | i | } | o | i | } n t | i d | d | | | qkn | i o} t | i
} t | } | | j oQ | i | } | o | i | } n t | i d | d | | | qn | i o t | i
} t | } t | | i | i | i }
t | | i | i | i } | |
j oQ | i | } | o | i | } n t | i d | d | | | qn d S( NR t utf8R R R R ( R2 R& t unicodet encodeR t
earliest_datet callablet strftimet decodeR5 t latest_datet after_nowR
R R t today_or_afterR R R R ( R, R6 R7 R t encodingR t date_formattedR t dt_modR t todayt
value_as_date( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR* = sn
N(
R R> R? R R R R< R R R R@ RA R* ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s '
t Boolc B s, e Z d Z e Z d Z e Z d Z RS( s
Always Valid, returns True or False based on the value and the
existance of the value.
If you want to convert strings like ``'true'`` to booleans, then
use ``StringBoolean``.
Examples::
>>> Bool.to_python(0)
False
>>> Bool.to_python(1)
True
>>> Bool.to_python('')
False
>>> Bool.to_python(None)
False
c C s
t | S( N( t bool( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI s c C s t S( N( R< ( R, R6 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyt empty_value s ( R R> R? R< t
if_missingRI RK R ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR { s
t RangeValidatorc B sC e Z d Z h e d d 6e d d 6Z d Z d Z d Z RS( s This is an abstract base class for Int and Number.
It verifies that a value is within range. It accepts min and max
values in the constructor.
(Since this is an abstract base class, the tests are in Int and
Number.)
s0 Please enter a number that is %(min)s or greatert tooLows0 Please enter a number that is %(max)s or smallert tooHighc C s | i d j oE | | i j o1 | i d | d | i } t | | | qU n | i d j oE | | i j o1 | i d | d | i } t | | | q n d S( NR t minR t max( R R R2 R5 R ( R, R6 R7 R8 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR* s N( R R> R? R@ RA R R R R* ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s
t Intc B s0 e Z d Z h e d d 6Z d Z e Z RS( s Convert a value to an integer.
Example::
>>> Int.to_python('10')
10
>>> Int.to_python('ten')
Traceback (most recent call last):
...
Invalid: Please enter an integer value
>>> Int(min=5).to_python('6')
6
>>> Int(max=10).to_python('11')
Traceback (most recent call last):
...
Invalid: Please enter a number that is 10 or smaller
s Please enter an integer valueR c C sL y t | SWn7 t t f j
o% t | i d | | | n Xd S( NR ( R R RX R5 R2 ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI s
( R R> R? R@ RA RI RK ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s
t Numberc B s* e Z d Z h e d d 6Z d Z RS( s{ Convert a value to a float or integer.
Tries to convert it to an integer if no information is lost.
Example::
>>> Number.to_python('10')
10
>>> Number.to_python('10.5')
10.5
>>> Number.to_python('ten')
Traceback (most recent call last):
...
Invalid: Please enter a number
>>> Number(min=5).to_python('6.5')
6.5
>>> Number(max=10.5).to_python('11.5')
Traceback (most recent call last):
...
Invalid: Please enter a number that is 10.5 or smaller
>>> Number().to_python('infinity')
inf
s Please enter a numbert numberc C s yR t | } y t | } Wn t j
o
d } n X| | j o | S| SWn1 t j
o% t | i d | | | n Xd S( NR ( t floatR t
OverflowErrorR R R5 R2 ( R, R6 R7 t int_value( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI s
( R R> R? R@ RA RI ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s t Stringc B sy e Z d Z d Z d Z d Z d Z d Z h e d d 6e d d 6Z
d Z d Z d Z
d Z d
Z RS( sg
Converts things to string, but treats empty things as the empty
string.
Also takes a `max` and `min` argument, and the string length must
fall in that range.
Also you may give an `encoding` argument, which will encode any
unicode that is found. Lists and tuples are joined with
`list_joiner` (default ``', '``) in ``from_python``.
::
>>> String(min=2).to_python('a')
Traceback (most recent call last):
...
Invalid: Enter a value 2 characters long or more
>>> String(max=10).to_python('xxxxxxxxxxx')
Traceback (most recent call last):
...
Invalid: Enter a value less than 10 characters long
>>> String().from_python(None)
''
>>> String().from_python([])
''
>>> String().to_python(None)
''
>>> String(min=3).to_python(None)
Traceback (most recent call last):
...
Invalid: Please enter a value
>>> String(min=1).to_python('')
Traceback (most recent call last):
...
Invalid: Please enter a value
s , s/ Enter a value less than %(max)i characters longRV s- Enter a value %(min)i characters long or moreR[ c C s+ | i d j o | i o
t | _ n d S( N( R_ R R R^ ( R, t new_attrs( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyt __initargs__; s c C s | p
d } n t | t p6 y t | } WqW t j
o t | } qW Xn | i d j o& t | t o | i | i } n | S( Nt ( R& Rd R t UnicodeEncodeErrorR R R R ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI ? s
c C s | o | d j o
d } n t | t p t | t t f o= | i i g } | D] } | | i | | qY ~ } n y t | } Wq t j
o t | } q Xn | i
d j o& t | t o | i | i
} n | i
o | i
} n | S( Ni R ( R& Rd R' R( t list_joinerR3 RK R R R R R R Rl ( R, R6 R7 t _[1]Rt ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRK K s
4
c C s | i d j oN | d j oA t | | i j o+ t | i d | d | i | | n | i d j oI | p t | | i j o+ t | i d | d | i | | n d S( NRV R R[ R ( R R R1 R5 R2 R ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRE \ s c C s d S( NR ( ( R, R6 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR h s N( R R> R? R R R R_ R R R@ RA R RI RK RE R ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s %
t
UnicodeStringc B sQ e Z d Z d Z h e d d 6Z d d d Z d Z d Z d Z
RS( s
Converts things to unicode string, this is a specialization of
the String class.
In addition to the String arguments, an encoding argument is also
accepted. By default the encoding will be utf-8.
All converted strings are returned as Unicode strings.
::
>>> UnicodeString().to_python(None)
u''
>>> UnicodeString().to_python([])
u''
>>> UnicodeString(encoding='utf-7').to_python('Ni Ni Ni')
u'Ni Ni Ni'
s utf-8s" Invalid data or incorrect encodingt badEncodingc K s: t i | | | p | i | _ | p | i | _ d S( N( R R% R t
inputEncodingt outputEncoding( R, R R R. ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR% s c C s | p d St | t o | St | t p1 t | d o t | } | St | } n y t | | i SWns t j
o% t | i d | | | nD t j
o7 t | i d | d t | d | | | n Xd S( Nu t __unicode__R t badTypeR# R6 (
R& R t hasattrR R t UnicodeDecodeErrorR5 R2 RX R# ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI s "c C sj t | t p0 t | d o t | } q@ t | } n t | t o | i | i } n | S( NR ( R& R R R R R ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRK s c C s d S( Nu ( ( R, R6 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s N( R R> R? R R@ RA R R% RI RK R ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR k s
t Setc B s, e Z d Z e Z d Z d Z d Z RS( s
This is for when you think you may return multiple values for a
certain field.
This way the result will always be a list, even if there's only
one result. It's equivalent to ForEach(convertToList=True).
If you give ``use_set=True``, then it will return an actual
``set`` object.
::
>>> Set.to_python(None)
[]
>>> Set.to_python('this')
['this']
>>> Set.to_python(('this', 'that'))
['this', 'that']
>>> s = Set(use_set=True)
>>> s.to_python(None)
set([])
>>> s.to_python('this')
set(['this'])
>>> s.to_python(('this',))
set(['this'])
c C s | i oe t | t t i f o | St | t t f o t | S| d j o t St | g Snu t | t o | St o$ t | t t i f o t | St | t o t | S| d j o g S| g Sd S( N( t use_setR& t sett setsR R' R( R ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI s"
c C s | i o t Sg Sd S( N( R R ( R, R6 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s
( ( R R> R? R< R R RI R ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s
t Emailc B s e Z d Z e Z e i d e i Z e i d e i e i B Z
h e d d 6e d d 6e d d 6e d d
6e d d 6e d
d 6Z d Z
d Z d Z RS( s
Validate an email address.
If you pass ``resolve_domain=True``, then it will try to resolve
the domain name to make sure it's valid. This takes longer, of
course. You must have the `pyDNS `__ modules
installed to look up DNS (MX and A) records.
::
>>> e = Email()
>>> e.to_python(' test@foo.com ')
'test@foo.com'
>>> e.to_python('test')
Traceback (most recent call last):
...
Invalid: An email address must contain a single @
>>> e.to_python('test@foobar')
Traceback (most recent call last):
...
Invalid: The domain portion of the email address is invalid (the portion after the @: foobar)
>>> e.to_python('test@foobar.com.5')
Traceback (most recent call last):
...
Invalid: The domain portion of the email address is invalid (the portion after the @: foobar.com.5)
>>> e.to_python('test@foo..bar.com')
Traceback (most recent call last):
...
Invalid: The domain portion of the email address is invalid (the portion after the @: foo..bar.com)
>>> e.to_python('test@.foo.bar.com')
Traceback (most recent call last):
...
Invalid: The domain portion of the email address is invalid (the portion after the @: .foo.bar.com)
>>> e.to_python('nobody@xn--m7r7ml7t24h.com')
'nobody@xn--m7r7ml7t24h.com'
>>> e.to_python('o*reilly@test.com')
'o*reilly@test.com'
>>> e = Email(resolve_domain=True)
>>> e.resolve_domain
True
>>> e.to_python('doesnotexist@colorstudy.com')
'doesnotexist@colorstudy.com'
>>> e.to_python('test@forums.nyu.edu')
'test@forums.nyu.edu'
>>> # NOTE: If you do not have PyDNS installed this example won't work:
>>> e.to_python('test@thisdomaindoesnotexistithinkforsure.com')
Traceback (most recent call last):
...
Invalid: The domain of the email address does not exist (the portion after the @: thisdomaindoesnotexistithinkforsure.com)
>>> e.to_python(u'test@google.com')
u'test@google.com'
>>> e = Email(not_empty=False)
>>> e.to_python('')
s ^[^ \t\n\r@<>()]+$s
^(?:[a-z0-9][a-z0-9\-]{0,62}\.)+ # (sub)domain - alpha followed by 62max chars (63 total)
[a-z]{2,}$ # TLD
s Please enter an email addressR] s( An email address must contain a single @t noAts] The username portion of the email address is invalid (the portion before the @: %(username)s)t badUsernames@ An error occured when trying to connect to the server: %(error)st socketErrorsX The domain portion of the email address is invalid (the portion after the @: %(domain)s)t badDomainsT The domain of the email address does not exist (the portion after the @: %(domain)s)t domainDoesNotExistc O sR t i | | | | i o1 t p& d d k } | i d t d qN n d S( Nis pyDNS is not installed on your system (or the DNS package cannot be found). I cannot resolve domain names in addressess no module named DNS( R$ R% t resolve_domaint have_dnst warningst warnR ( R, R- R. R ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR% / s
c C s | p" t | i d | | | n | i } | i d d } y | \ } } Wn1 t j
o% t | i d | | | n X| i i | p( t | i d | d | | | n | i i | p( t | i d | d | | | n | i o yp t i
| d d
i i } | p" t i
| d d i i } n g } | D] } | | d q`~ } WnE t
i t i f j
o- }
t | i d
| d |
| | n X| p( t | i d | d | | | qn d S( NR] t @i R R t usernameR t domaint qtypeR
t at dataR t errorR ( R5 R2 Rl t splitR t
usernameRERm t domainRER t DNSt
DnsRequestt reqt answerst socketR t DNSError( R, R6 R7 t splittedR R R R t xt
dnsdomainsR ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR* : sJ
") c C s
| i S( N( Rl ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI b s ( R R> R? R< R Rg Rh t IR t VERBOSER R@ RA R% R* RI ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s 7
(t URLc B s e Z d Z e Z e Z e Z e i d e i
e i B Z e i d Z
h e d d 6e d d 6e d d 6e d d
6e d d 6e d
d 6e d d 6Z d Z d Z RS( s
Validate a URL, either http://... or https://. If check_exists
is true, then we'll actually make a request for the page.
If add_http is true, then if no scheme is present we'll add
http://
::
>>> u = URL(add_http=True)
>>> u.to_python('foo.com')
'http://foo.com'
>>> u.to_python('http://hahaha.ha/bar.html')
'http://hahaha.ha/bar.html'
>>> u.to_python('http://xn--m7r7ml7t24h.com')
'http://xn--m7r7ml7t24h.com'
>>> u.to_python('http://foo.com/test?bar=baz&fleem=morx')
'http://foo.com/test?bar=baz&fleem=morx'
>>> u.to_python('http://foo.com/login?came_from=http%3A%2F%2Ffoo.com%2Ftest')
'http://foo.com/login?came_from=http%3A%2F%2Ffoo.com%2Ftest'
>>> u.to_python('http://foo.com:8000/test.html')
'http://foo.com:8000/test.html'
>>> u.to_python('http://foo.com/something\nelse')
Traceback (most recent call last):
...
Invalid: That is not a valid URL
>>> u.to_python('https://test.com')
'https://test.com'
>>> u.to_python('http://test')
Traceback (most recent call last):
...
Invalid: You must provide a full domain name (like test.com)
>>> u.to_python('http://test..com')
Traceback (most recent call last):
...
Invalid: That is not a valid URL
>>> u = URL(add_http=False, check_exists=True)
>>> u.to_python('http://google.com')
'http://google.com'
>>> u.to_python('google.com')
Traceback (most recent call last):
...
Invalid: You must start your URL with http://, https://, etc
>>> u.to_python('http://ianbicking.org/doesnotexist.html')
Traceback (most recent call last):
...
Invalid: The server responded that the page could not be found
>>> u.to_python('http://this.domain.does.not.exist.example.org/test.html')
Traceback (most recent call last):
...
Invalid: An error occured when trying to connect to the server: ...
If you want to allow addresses without a TLD (e.g., ``localhost``) you can do::
>>> URL(require_tld=False).to_python('http://localhost')
'http://localhost'
s
^(http|https)://
(?:[%:\w]*@)? # authenticator
(?P[a-z0-9][a-z0-9\-]{1,62}\.)* # (sub)domain - alpha followed by 62max chars (63 total)
(?P[a-z]{2,}) # TLD
(?::[0-9]+)? # port
# files/delims/etc
(?P/[a-z0-9\-\._~:/\?#\[\]@!%\$&\'\(\)\*\+,;=]*)?
$
s ^[a-zA-Z]+:s3 You must start your URL with http://, https://, etct noSchemes That is not a valid URLt badURLs: An error occurred when trying to access the URL: %(error)st httpErrors@ An error occured when trying to connect to the server: %(error)sR s5 The server responded that the page could not be foundR s8 The server responded with a bad status code (%(status)s)t statuss9 You must provide a full domain name (like %(domain)s.com)t noTLDc C sk | i } | i o% | i i | p d | } q; n | i i | } | p" t | i d | | | n | i d i | t | i d } | i i | } | p" t | i d | | | n | i
oB | i d o1 t | i d | d | i d | | n | i o4 | i d p | i d o | i
| | n | S( Ns http://R i R R R t tlds https://( Rl t add_httpt scheme_reRm R5 R2 t groupR R1 t url_ret require_tldt check_existst
startswitht _check_url_exists( R, R6 R7 t match( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI s.
, c
C s t d j o d d k a n t d j o d d k a n t d j o d d k a n t i | d \ } } } } } } | d j o
t i } n
t i } y^ | | }
| o | d | 7} n | o | d | 7} n |
i d | |
i } Wnw t i j
o- } t | i
d | d | | | n t i j
o- } t | i
d | d | | | n X| i d j o" t | i
d
| | | n | i d j p | i d j o+ t | i
d
| d
| i | | n d S( Nit httpt ;t ?t HEADR R R i R i i R (
t httplibR t urlparseR t HTTPConnectiont HTTPSConnectiont requestt getresponset
HTTPExceptionR5 R2 R R (
R, t urlR7 t schemet netloct patht paramst queryt fragmentt ConnClasst connt resR ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR sH
( R R> R? R< R R^ R R Rg Rh R R R R R@ RA RI R ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR e s" ;
t XRIc B s e Z d Z e i d e i e i B Z e i d e i Z e i d e i e i B Z
h e d d 6e d d 6e d d 6e d
d 6e d d
6e d d 6e d d 6Z e
d d Z d Z d d Z d Z d Z RS( s
Validator for XRIs.
It supports both i-names and i-numbers, of the first version of the XRI
standard.
::
>>> inames = XRI(xri_type="i-name")
>>> inames.to_python(" =John.Smith ")
'=John.Smith'
>>> inames.to_python("@Free.Software.Foundation")
'@Free.Software.Foundation'
>>> inames.to_python("Python.Software.Foundation")
Traceback (most recent call last):
...
Invalid: The type of i-name is not defined; it may be either individual or organizational
>>> inames.to_python("http://example.org")
Traceback (most recent call last):
...
Invalid: The type of i-name is not defined; it may be either individual or organizational
>>> inames.to_python("=!2C43.1A9F.B6F6.E8E6")
Traceback (most recent call last):
...
Invalid: "!2C43.1A9F.B6F6.E8E6" is an invalid i-name
>>> iname_with_schema = XRI(True, xri_type="i-name")
>>> iname_with_schema.to_python("=Richard.Stallman")
'xri://=Richard.Stallman'
>>> inames.to_python("=John Smith")
Traceback (most recent call last):
...
Invalid: "John Smith" is an invalid i-name
>>> inumbers = XRI(xri_type="i-number")
>>> inumbers.to_python("!!1000!de21.4536.2cb2.8074")
'!!1000!de21.4536.2cb2.8074'
>>> inumbers.to_python("@!1000.9554.fabd.129c!2847.df3c")
'@!1000.9554.fabd.129c!2847.df3c'
s
^
[\w]+ # A global alphanumeric i-name
(\.[\w]+)* # An i-name with dots
(\*[\w]+(\.[\w]+)*)* # A community i-name
$
s ^[\d\.-]s
^
(
[=@]! # It's a personal or organization i-number
|
!! # It's a network i-number
)
[\dA-F]{1,4}(\.[\dA-F]{1,4}){0,3} # A global i-number
(![\dA-F]{1,4}(\.[\dA-F]{1,4}){0,3})* # Zero or more sub i-numbers
$
sP The type of i-name is not defined; it may be either individual or organizationalt noTypes1 Dots and dashes may not be repeated consecutivelyt repeatedChars "%(iname)s" is an invalid i-namet badInames8 i-names may not start with numbers nor punctuation markst
badInameStarts$ "%(inumber)s" is an invalid i-numbert
badInumbers4 The XRI must be a string (not a %(type)s: %(value)r)R s) "%(xri_type)s" is not a valid type of XRIt badXris i-namec K s, | | _ | | _ t t | i | d S( sP Create an XRI validator.
@param add_xri: Should the schema be added if not present? Officially
it's optional.
@type add_xri: C{bool}
@param xri_type: What type of XRI should be validated? Possible values:
C{i-name} or C{i-number}.
@type xri_type: C{str}
N( t add_xrit xri_typet superR R% ( R, R
R t kwargs( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR% M s c C s9 | i } | i o | i d o d | } n | S( sP Prepend the 'xri://' schema if necessary and then remove trailing
spacess xri://( Rl R
R ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI ^ s c C s t | t p
t | t p: t | i d | d t t | d | | | n | i d o | d } n | d d j oD | i d j o | d d
j o" t | i d | | | n | i d j o | i | | n | i | | d
S( sP Validate an XRI
@raise Invalid: If at least one of the following conditions in met:
- C{value} is not a string.
- The XRI is not a personal, organizational or network one.
- The relevant validator (i-name or i-number) considers the XRI
is not valid.
R R# R6 s xri://i i R t =s i-numbert !R s i-nameN( R R (
R& R R R5 R2 R# R R t _validate_inamet _validate_inumber( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR* f s
$!"c C s | d } d | j p
d | j o" t | i d | | | n | i i | o" t | i d | | | n | i i | p
d | j o( t | i d | d | | | n d S(
s Validate an i-namei s ..s --R R R@ R t inameN( R5 R2 t iname_invalid_startR t iname_valid_pattern( R, R R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s
""!c C sH | i i i | p. t | i d | d | d | | | n d S( s Validate an i-numberR t inumberR6 N( t __class__t inumber_patternR R5 R2 ( R, R R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s N( R R> R? Rg Rh R t UNICODER R t
IGNORECASER R@ RA R< R% RI R R* R R ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s& '
t OpenIdc B s? e Z d Z h e d d 6Z e d Z d Z d Z RS( s
OpenId validator.
::
>>> v = OpenId(add_schema=True)
>>> v.to_python(' example.net ')
'http://example.net'
>>> v.to_python('@TurboGears')
'xri://@TurboGears'
>>> w = OpenId(add_schema=False)
>>> w.to_python(' example.net ')
Traceback (most recent call last):
...
Invalid: "example.net" is not a valid OpenId (it is neither an URL nor an XRI)
>>> w.to_python('!!1000')
'!!1000'
>>> w.to_python('look@me.com')
Traceback (most recent call last):
...
Invalid: "look@me.com" is not a valid OpenId (it is neither an URL nor an XRI)
s@ "%(id)s" is not a valid OpenId (it is neither an URL nor an XRI)t badIdc K s@ t d | | _ t | d d | _ t | d d | _ d S( s Create an OpenId validator.
@param add_schema: Should the schema be added if not present?
@type add_schema: C{bool}
R R s i-names i-numberN( R t
url_validatorR t iname_validatort inumber_validator( R, t
add_schemaR
( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR% s c C s | i } y | i i | | SWnm t j
oa y | i i | | SWq t j
o4 y | i i | | SWq t j
o q Xq Xn Xt | i d | d | | | d S( NR t id( Rl R RC R5 R R R2 ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI s c C s | i | | d S( N( RI ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR* s ( R R> R? R@ RA R< R% RI R* ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s c O s3 t i d t d d d d k l } | | | S( Ns. please use formencode.national.USStateProvincet
stackleveli i( t USStateProvince( R R t DeprecationWarningt formencode.nationalR" ( R. R
R" ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyt
StateProvince s c O s3 t i d t d d d d k l } | | | S( Ns, please use formencode.national.USPhoneNumberR! i i( t
USPhoneNumber( R R R# R$ R& ( R. R
R& ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyt PhoneNumber s c O s3 t i d t d d d d k l } | | | S( Ns7 please use formencode.national.InternationalPhoneNumberR! i i( t InternationalPhoneNumber( R R R# R$ R( ( R. R
R( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyt IPhoneNumberValidator s t FieldStorageUploadConverterc B s# e Z d Z d d Z d Z RS( s
Handles cgi.FieldStorage instances that are file uploads.
This doesn't do any conversion, but it can detect empty upload
fields (which appear like normal fields, but have no filename when
no upload was given).
c C sI t | t i o. t | d d o | St d | | n | Sd S( Nt filenameRW ( R& t cgit FieldStorageRf R R5 ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI s
c C s; t | t i o t t | d d St i | | S( NR+ ( R& R, R- R Rf R R$ R= ( R, R6 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR= s N( R R> R? R RI R= ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR* s t FileUploadKeeperc B s5 e Z d Z d Z d Z d Z d Z d Z RS( s
Takes two inputs (a dictionary with keys ``static`` and
``upload``) and converts them into one value on the Python side (a
dictionary with ``filename`` and ``content`` keys). The upload
takes priority over the static value. The filename may be None if
it can't be discovered.
Handles uploads of both text and ``cgi.FieldStorage`` upload
values.
This is basically for use when you have an upload field, and you
want to keep the upload around even if the rest of the form
submission fails. When converting *back* to the form submission,
there may be extra values ``'original_filename'`` and
``'original_content'``, which may want to use in your form to show
the user you still have their content around.
To use this, make sure you are using variabledecode, then use
something like::
Then in your scheme::
class MyScheme(Scheme):
myfield = FileUploadKeeper()
Note that big file uploads mean big hidden fields, and lots of
bytes passed back and forth in the case of an error.
t uploadt staticc C s | i | i } | i | i d i } d } } t | t i o | i } | i } n( t | t
o | o d } | } n | oX | oQ | i d d \ } } | d j o
d } n | i d } | i d } n h | d 6| d 6S( NR i t -t base64R+ t content(
t gett
upload_keyt
static_keyRl R R& R, R- R+ R6 Rd R R ( R, R6 R7 R/ R0 R+ R3 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI s
c C s | i d d } | i d d } | p | o9 | i | | } h d | i 6| | i 6| d 6| d 6Sh d | i 6d | i 6Sd S( NR+ R R3 t original_filenamet original_content( R4 t pack_contentR5 R6 ( R, R6 R7 R+ R3 RQ ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRK , s
c C s@ | i | p d } | p d i d } d | | f } | S( NR1 R R2 s %s %s( t base64encodeR ( R, R+ R3 t enc_filenamet enc_contentRQ ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR9 9 s ( R R> R? R5 R6 RI RK R9 ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR. s
t
DateConverterc B s e Z d Z e Z d Z dE Z e i d e i
Z e i d e i
Z h d d 6d d 6d d 6d d 6d
d 6d
d 6d
d 6d
d 6d d 6d d 6d d 6d d 6d d 6d d 6d d 6d d 6d d 6d d 6d d 6d d! 6d" d# 6d" d$ 6d% d& 6d% d' 6Z
h d( d 6d) d 6d( d
6d* d
6d( d 6d* d 6d( d 6d( d 6d* d 6d( d 6d* d" 6d( d% 6Z h e d+ d, 6e d- d. 6e d/ d0 6e d1 d2 6e d3 d4 6e d5 d6 6e d7 d8 6e d9 d: 6e d+ d; 6Z d< Z d= Z d> Z d? Z d@ Z dA Z dB Z dC Z dD Z RS(F s
Validates and converts a string date, like mm/yy, dd/mm/yy,
dd-mm-yy, etc. Using ``month_style`` you can support
``'mm/dd/yyyy'`` or ``'dd/mm/yyyy'``. Only these two general
styles are supported.
Accepts English month names, also abbreviated. Returns value as a
datetime object (you can get mx.DateTime objects if you use
``datetime_module='mxDateTime'``). Two year dates are assumed to
be within 1950-2020, with dates from 21-49 being ambiguous and
signaling an error.
Use accept_day=False if you just want a month/year (like for a
credit card expiration date).
::
>>> d = DateConverter()
>>> d.to_python('12/3/09')
datetime.date(2009, 12, 3)
>>> d.to_python('12/3/2009')
datetime.date(2009, 12, 3)
>>> d.to_python('2/30/04')
Traceback (most recent call last):
...
Invalid: That month only has 29 days
>>> d.to_python('13/2/05')
Traceback (most recent call last):
...
Invalid: Please enter a month from 1 to 12
>>> d.to_python('1/1/200')
Traceback (most recent call last):
...
Invalid: Please enter a four-digit year after 1899
If you change ``month_style`` you can get European-style dates::
>>> d = DateConverter(month_style='dd/mm/yyyy')
>>> date = d.to_python('12/3/09')
>>> date
datetime.date(2009, 3, 12)
>>> d.from_python(date)
'12/03/2009'
s
mm/dd/yyyys ^\s*(\d\d?)[\-\./\\](\d\d?|jan|january|feb|febuary|mar|march|apr|april|may|jun|june|jul|july|aug|august|sep|sept|september|oct|october|nov|november|dec|december)[\-\./\\](\d\d\d?\d?)\s*$s ^\s*(\d\d?|jan|january|feb|febuary|mar|march|apr|april|may|jun|june|jul|july|aug|august|sep|sept|september|oct|october|nov|november|dec|december)[\-\./\\](\d\d\d?\d?)\s*$i t jant januaryi t febt febuaryi t mart marchi t aprt aprili t mayi t junt junei t jult julyi t augt augusti t sept septt septemberi
t octt octoberi t novt novemberi t dect decemberi i i s, Please enter the date in the form %(format)st badFormats! Please enter a month from 1 to 12t
monthRanges Please enter a valid dayt
invalidDays! That month only has %(days)i dayst dayRanges' That is not a valid day (%(exception)s)t invalidDates Unknown month name: %(month)st unknownMonthNames" Please enter a number for the yeart invalidYears) Please enter a four-digit year after 1899t
fourDigitYeart wrongFormatc O sD t t | i | | | i d j o t d | i n d S( Ns
dd/mm/yyyys
mm/dd/yyyys Bad month_style: %r( s
dd/mm/yyyys
mm/dd/yyyy( R R= R% t month_styleRX ( R, R- R. ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR% s c C s/ | i o | i | | S| i | | Sd S( N( t
accept_dayt convert_dayt
convert_month( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI s
c C s | i | | | i i | } | p+ t | i d | d | i | | n t | i d } y t | i d } Wn. t j
o" | i | i d | } n# X| i d j o | | } } n | i
| i d | } | d j p
| d j o" t | i d | | | n | d j o" t | i d | | | n | i | | j o/ t | i d
| d | i | | | n t | i
} y t | | | | SWn? t j
o3 } t | i d | d
t | | | n Xd S( NRV t formati i s
mm/dd/yyyyi i RW RX RY t daysRZ t exception( Rk t _day_date_reRm R5 R2 R_ R R RX t
make_montht make_yeart
_monthDaysR
R R R R ( R, R6 R7 R R R R R Rt ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRa s>
c C s} y t | SWnh t j
o\ | i i } | i i | o | i | St | i d | d | | | n Xd S( NR[ R ( R R R Rl t _month_namesRF R5 R2 ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRg s c C s y t | } Wn1 t j
o% t | i d | | | n X| d j o | d } n | d j o | d j o | d } n | d j o
| d j p | d j o/ | d j o" t | i d | | | n | S( NR\ i i i2 id il ic R] ( R R R5 R2 ( R, R R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRh s
4c C s | i i | } | p( t | i d | d d | | n | i | i d | } | i | i d | } | d j p
| d j o" t | i d | | | n t | i } t | | | d S( NR^ Rc s mm/yyyyi i i RW (
t _month_date_reRm R5 R2 Rg R Rh R
R R ( R, R6 R7 R R R R ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRb s c C sL | i t j o
| o d S| i o | i | | S| i | | Sd S( NR ( t if_emptyt NoDefaultR` t
unconvert_dayt unconvert_month( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRK s
c C s/ | i d j o | i d S| i d Sd S( Ns
mm/dd/yyyys %m/%d/%Ys %d/%m/%Y( R_ R ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRn s c C s
| i d S( Ns %m/%Y( R ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRo s N( R R> R? R^ R` R_ R R Rg Rh R Rf Rk Rj Ri R@ RA R% RI Ra Rg Rh Rb RK Rn Ro ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR= ? sR -8
" t
TimeConverterc B s e Z d Z d Z e Z d Z e Z d Z h e
d d 6e
d d 6e
d d 6e
d d 6e
d
d 6e
d d
6e
d d 6e
d d 6e
d d 6Z d Z d Z
d Z RS( s5
Converts times in the format HH:MM:SSampm to (h, m, s).
Seconds are optional.
For ampm, set use_ampm = True. For seconds, use_seconds = True.
Use 'optional' for either of these to make them optional.
Examples::
>>> tim = TimeConverter()
>>> tim.to_python('8:30')
(8, 30)
>>> tim.to_python('20:30')
(20, 30)
>>> tim.to_python('30:00')
Traceback (most recent call last):
...
Invalid: You must enter an hour in the range 0-23
>>> tim.to_python('13:00pm')
Traceback (most recent call last):
...
Invalid: You must enter an hour in the range 1-12
>>> tim.to_python('12:-1')
Traceback (most recent call last):
...
Invalid: You must enter a minute in the range 0-59
>>> tim.to_python('12:02pm')
(12, 2)
>>> tim.to_python('12:02am')
(0, 2)
>>> tim.to_python('1:00PM')
(13, 0)
>>> tim.from_python((13, 0))
'13:00:00'
>>> tim2 = tim(use_ampm=True, use_seconds=False)
>>> tim2.from_python((13, 0))
'1:00pm'
>>> tim2.from_python((0, 0))
'12:00am'
>>> tim2.from_python((12, 0))
'12:00pm'
Examples with ``datetime.time``::
>>> v = TimeConverter(use_datetime=True)
>>> a = v.to_python('18:00')
>>> a
datetime.time(18, 0)
>>> b = v.to_python('30:00')
Traceback (most recent call last):
...
Invalid: You must enter an hour in the range 0-23
>>> v2 = TimeConverter(prefer_ampm=True, use_datetime=True)
>>> v2.from_python(a)
'6:00:00pm'
>>> v3 = TimeConverter(prefer_ampm=True,
... use_seconds=False, use_datetime=True)
>>> a = v3.to_python('18:00')
>>> a
datetime.time(18, 0)
>>> v3.from_python(a)
'6:00pm'
>>> a = v3.to_python('18:00:00')
Traceback (most recent call last):
...
Invalid: You may not enter seconds
t optionals You must indicate AM or PMt noAMPMs There are too many :'st tooManyColons You may not enter secondst noSecondss You must enter secondst secondsRequireds" You must enter minutes (after a :)t minutesRequireds7 The %(part)s value you gave is not a number: %(number)rt badNumbers- You must enter an hour in the range %(range)st badHours) You must enter a minute in the range 0-59t badMinutes) You must enter a second in the range 0-59t badSecondc C sJ | i | | } | i o& t | i } t | } | | S| Sd S( N( t _to_python_tuplet use_datetimeR
R R ( R, R6 R7 RQ R t
time_class( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI \ s
c C sg | i } t } | i o | d i } | d j o< | i d j o" t | i d | | | q d } q t } | d j o
d } n d } | d } n d } | i d } t | d j o" t | i d
| | | n t | d j o- | i o" t | i d | | | n t | d j o< | i o2 | i d j o" t | i d
| | | n t | d j o" t | i d | | | n y t
| d } WnA t j
o5 t | i d | d | d d d | | n X| o | d j p
| d j o. t | i d | d | d d | | n | d j o | d j o q| d j o | d j o
d } q| | 7} nI | d j p
| d j o. t | i d | d | d d | | n y t
| d } WnA t j
o5 t | i d | d | d d d | | n X| d j p
| d j o( t | i d | d | | | n t | d j o y t
| d }
Wn; t j
o/ t | i d | d | d d d n X|
d j p
|
d j o( t | i d | d |
| | q>n d }
|
d j o | | f S| | |
f Sd S( Nit amt pmRq Rr i i t :i Rs Rt i Ru i Rv Rw R t partt hourRx R s 1-12i s 0-23t minutei; Ry t secondRz ( R~ R (
Rl R< t use_ampmR R5 R2 R^ R R1 t use_secondsR R R ( R, R6 R7 R t
explicit_ampmt last_twot offsett partsR R R ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR{ e s
c C sa t | t t f o | St | d o | i | i } } | i } nP t | d j o | \ } } } n* t | d j o | \ } } d } n d } | i d j o
| i p | i oi | i d j oY d } | d j o | d 8} d } q-| d j o
d } q-| d j o
d } q-n | i
o d
| | | | f Sd | | | f Sd S( NR i i i R Rq R~ i R s %i:%02i:%02i%ss %i:%02i%s( R& R R R R R R R1 R t prefer_ampmR ( R, R6 R7 R R R t ampm( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRK s0
N( R R> R? R R< R R R| R R R@ RA RI R{ RK ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRp s& D
^c O s3 t i d t d d d d k l } | | | S( Ns+ please use formencode.national.USPostalCodeR! i i( t USPostalCode( R R R# R$ R ( R. R
R ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyt
PostalCode s t
StripFieldc B s9 e Z d Z d Z h e d d 6Z d Z d Z RS( s
Take a field from a dictionary, removing the key from the
dictionary.
``name`` is the key. The field value and a new copy of the
dictionary with that field removed are returned.
>>> StripField('test').to_python({'a': 1, 'test': 2})
(2, {'a': 1})
>>> StripField('test').to_python({})
Traceback (most recent call last):
...
Invalid: The name 'test' is missing
t names The name %(name)s is missingt missingc C st | i } y | | i } | | i =Wn@ t j
o4 t | i d | d t | i | | n X| | f S( NR R ( t copyR R{ R5 R2 R} ( R, t valueDictR7 Rt t field( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI s
c C s t S( N( R< ( R, R6 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR= s ( s name( R R> R? RS R@ RA RI R= ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s t
StringBoolc B sc e Z d Z d d d d d d g Z d d d d
d d g Z h e d
d 6Z d Z d Z RS( sf
Converts a string to a boolean.
Values like 'true' and 'false' are considered True and False,
respectively; anything in ``true_values`` is true, anything in
``false_values`` is false, case-insensitive). The first item of
those lists is considered the preferred form.
::
>>> s = StringBoolean()
>>> s.to_python('yes'), s.to_python('no')
(True, False)
>>> s.to_python(1), s.to_python('N')
(True, False)
>>> s.to_python('ye')
Traceback (most recent call last):
...
Invalid: Value should be 'true' or 'false'
t trueR; t yest yt ont 1t falset ft noRN t offt 0s% Value should be %(true)r or %(false)rt stringc C s t | t t f o | i i } | | i j o t S| p | | i j o t St | i
d | d | i d d | i d | | n t | S( NR R i R ( R& R R Rl R t true_valuesR^ t false_valuesR< R5 R2 R ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI & s
c C s" | o | i d S| i d Sd S( Ni ( R R ( R, R6 R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRK 3 s ( R R> R? R R R@ RA RI RK ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR
s
t SignedStringc B s^ e Z d Z h e d d 6e d d 6Z d
Z d Z d Z d Z d Z
d Z RS( s
Encodes a string into a signed string, and base64 encodes both the
signature string and a random nonce.
It is up to you to provide a secret, and to keep the secret handy
and consistent.
s" Value does not contain a signaturet malformeds Signature is not correctt badsigi c
C s. t p> y d d k l a WqE t j
o d d k l a qE Xn | i d d } | p t | d j o" t | i d | | | n | \ } } | i d } | i d } | | i
} | | i
} t t | i | | i
} | | j o" t | i d | | | n | S( Ni( t sha1( t shai R R2 R ( R t hashlibR R R R R1 R5 R2 R t nonce_lengthR t secrett digest( R, R6 R7 R t sigt restt noncet expected( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI N s&
#
c C s t p> y d d k l a WqE t j
o d d k l a qE Xn | i } t | } t | i | | i } | i | d | i | | S( Ni( R ( R t ( R R R R t
make_nonceR R R R ( R, R6 R7 R R ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRK f s c C s | i d i i d d S( NR2 s
R ( R Rl t replace( R, R6 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR r s c C sW t p d d k a n d i g } t | i D] } | t t i d q1 ~ S( NiR i ( t randomR3 R R t chrt randrange( R, R R ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR u s
N( R R> R? R@ RA R R R RI RK R R ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR < s
t IPAddressc B s+ e Z d Z h d d 6d d 6Z d Z RS( s
Formencode validator to check whether a string is a correct IP address
Examples::
>>> ip = IPAddress()
>>> ip.to_python('127.0.0.1')
'127.0.0.1'
>>> ip.to_python('299.0.0.1')
Traceback (most recent call last):
...
Invalid: The octets must be within the range of 0-255 (not '299')
>>> ip.to_python('192.168.0.1/1')
Traceback (most recent call last):
...
Invalid: Please enter a valid IP address (a.b.c.d)
>>> ip.to_python('asdf')
Traceback (most recent call last):
...
Invalid: Please enter a valid IP address (a.b.c.d)
u) Please enter a valid IP address (a.b.c.d)t
bad_formatu< The octets must be within the range of 0-255 (not %(octet)r)t illegal_octetsc
C s y | i d } t | d j o( t | i d | d | | | n x\ | D]T } t | d j p t | d j o( t | i d | d | | | qT qT WWn1 t j
o% t | i d | | | n Xd S( Nt .i R R6 i i R t octet( R R1 R5 R2 R R ( R, R6 R7 t octetsR ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR* s ( &0( R R> R? RA R* ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR } s
t CIDRc B s2 e Z d Z e e i d d d d Z d Z RS( s
Formencode validator to check whether a string is in correct CIDR
notation (IP address, or IP address plus /mask)
Examples::
>>> cidr = CIDR()
>>> cidr.to_python('127.0.0.1')
'127.0.0.1'
>>> cidr.to_python('299.0.0.1')
Traceback (most recent call last):
...
Invalid: The octets must be within the range of 0-255 (not '299')
>>> cidr.to_python('192.168.0.1/1')
Traceback (most recent call last):
...
Invalid: The network size (bits) must be within the range of 8-32 (not '1')
>>> cidr.to_python('asdf')
Traceback (most recent call last):
...
Invalid: Please enter a valid IP address (a.b.c.d) or IP network (a.b.c.d/e)
R uC Please enter a valid IP address (a.b.c.d) or IP network (a.b.c.d/e)t illegal_bitsuG The network size (bits) must be within the range of 8-32 (not %(bits)r)c C s y d | j o | i d \ } } n | d } } t i | | | t | d j p t | d j o( t | i d | d | | | n Wn1 t j
o% t | i d | | | n Xd S( Nt /i i R t bitsR ( R R R* R R5 R2 R ( R, R6 R7 t addrR ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR* s
&,( R R> R? Rv R t _messagesRA R* ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s
t
MACAddressc B sO e Z d Z e Z d Z e Z h e d d 6e d d 6Z d Z
e
Z RS( s
Formencode validator to check whether a string is a correct hardware
(MAC) address.
Examples::
>>> mac = MACAddress()
>>> mac.to_python('aa:bb:cc:dd:ee:ff')
'aabbccddeeff'
>>> mac.to_python('aa:bb:cc:dd:ee:ff:e')
Traceback (most recent call last):
...
Invalid: A MAC address must contain 12 digits and A-F; the value you gave has 13 characters
>>> mac.to_python('aa:bb:cc:dd:ee:fx')
Traceback (most recent call last):
...
Invalid: MAC addresses may only contain 0-9 and A-F (and optionally :), not 'x'
>>> MACAddress(add_colons=True).to_python('aabbccddeeff')
'aa:bb:cc:dd:ee:ff'
t 0123456789abcdefABCDEFuZ A MAC address must contain 12 digits and A-F; the value you gave has %(length)s characterst
bad_lengthuK MAC addresses may only contain 0-9 and A-F (and optionally :), not %(char)rt
bad_characterc C s | i d d } | i } t | d j o. t | i d | d t | | | n xF | D]> } | | i j o( t | i d | d | | | qf qf W| i oJ d | d d
!| d
d !| d d !| d d
!| d
d !| d d !f } n | S( NR R i R t lengthR t chars %s:%s:%s:%s:%s:%si i i i i i
( R R R1 R5 R2 t valid_characterst
add_colons( R, R6 R7 t addressR ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI s . ,
)( R R> R? R^ Rl R R< R R@ RA RI RK ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s
t
FormValidatorc B s) e Z d Z e Z d Z d Z d Z RS( sV
A FormValidator is something that can be chained with a
Schema. Unlike normal chaining the FormValidator can
validate forms that aren't entirely valid.
The important method is .validate(), of course. It gets passed a
dictionary of the (processed) values from the form. If you have
.validate_partial_form set to True, then it will get the incomplete
values as well -- use .has_key() to test if the field was able to
process any particular field.
Anyway, .validate() should return a string or a dictionary. If a
string, it's an error message that applies to the whole form. If
not, then it should be a dictionary of fieldName: errorMessage.
The special key "form" is the error message for the form as a whole
(i.e., a string is equivalent to {"form": string}).
Return None on no errors.
c C s t S( N( R< ( R, R6 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR= !
s N( R R> R? R< t validate_partial_formR t validate_partial_pythont validate_partial_otherR= ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR
s
t RequireIfMissingc B s/ e Z d Z d Z d Z d Z d Z d Z RS( sL
This requires one field based on another field being present or
missing. This is applied to a form, not an individual field
(usually using a Schema's ``pre_validators`` or
``chained_validators``).
If you provide a ``missing`` value (a string key name) then if
that field is missing the field must be entered. This gives you
an either/or situation.
If you provide a ``present`` value (another string key name) then
if that field is present, the required field must also be present.
::
>>> from formencode import validators
>>> v = validators.RequireIfPresent('phone_type',
... present='phone')
>>> v.to_python({'phone_type':'', 'phone':'510 420 4577'})
Traceback (most recent call last):
...
Invalid: You must give a value for phone_type
>>> v.to_python({'phone': ''})
{'phone': ''}
Note that if you have a validator on the optionally-required
field, you should probably use ``if_missing=None``. This way you
won't get an error from the Schema about a missing value. For example::
class PhoneInput(Schema):
phone = PhoneNumber()
phone_type = String(if_missing=None)
chained_validators = [RequireifPresent('phone_type', present='phone')]
t requiredc
C s t } | i o | i | i o
t } n | i o | i | i o
t } n | oY | i | i oE t d | i t | d h t | i d | t | | i 6 n | S( Ns You must give a value for %st
error_dictR] ( R< R R4 R^ t presentR R5 R6 R2 ( R, t
value_dictR7 t is_required( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyRI Q
s
#N( s required( R R> R? R R R R RS RI ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR $
s #t FieldsMatchc B sn e Z d Z e Z d Z e Z d
Z h e
d d 6e
d d 6e
d d 6Z d Z d
Z
d Z RS( s
Tests that the given fields match, i.e., are identical. Useful
for password+confirmation fields. Pass the list of field names in
as `field_names`.
::
>>> f = FieldsMatch('pass', 'conf')
>>> f.to_python({'pass': 'xx', 'conf': 'xx'})
{'conf': 'xx', 'pass': 'xx'}
>>> f.to_python({'pass': 'xx', 'conf': 'yy'})
Traceback (most recent call last):
...
Invalid: conf: Fields do not match
R t field_namess) Fields do not match (should be %(match)s)RW s Fields do not matcht invalidNoMatchs Fields should be a dictionaryt notDictc O sC t t | i | | t | i d j o t d n d S( Ni s/ FieldsMatch() requires at least two field names( R R R% R1 R RX ( R, R- R. ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR% }
s c C s= x& | i D] } | i | p d Sq
W| i | | d S( N( R RF R* ( R, t
field_dictR7 R ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyt validate_partial
s
c
C sS y | | i d } WnI t j
o% t | i d | | | n t j
o
d } n Xh } xr | i d D]c } | i | d | j oD | i o | i d | d | | |
s %s: %sR (
R RX R5 R2 R{ R4 t
show_matchRq t sortR3 (
R, R R7 t reft errorsR t
error_listR R6 t
error_message( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR*
s, "
4 N( R s field_names( R R> R? R< R R R R^ R RS R@ RA R% R R* ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR `
s
t CreditCardValidatorc
B s e Z d Z e Z d Z d Z d/ Z h e d d 6e d d 6e d d
6e d d 6Z d
Z
d Z d Z d Z
h d0 d1 g d 6d2 d3 d4 d5 d6 g d 6d7 g d 6d8 d9 g d 6d: d; d< d= d> d? d@ dA g d* 6dB dC dD g d. 6Z RS(E sw
Checks that credit card numbers are valid (if not real).
You pass in the name of the field that has the credit card
type and the field with the credit card number. The credit
card type should be one of "visa", "mastercard", "amex",
"dinersclub", "discover", "jcb".
You must check the expiration date yourself (there is no
relation between CC number/types and expiration dates).
::
>>> cc = CreditCardValidator()
>>> cc.to_python({'ccType': 'visa', 'ccNumber': '4111111111111111'})
{'ccNumber': '4111111111111111', 'ccType': 'visa'}
>>> cc.to_python({'ccType': 'visa', 'ccNumber': '411111111111111'})
Traceback (most recent call last):
...
Invalid: ccNumber: You did not enter a valid number of digits
>>> cc.to_python({'ccType': 'visa', 'ccNumber': '411111111111112'})
Traceback (most recent call last):
...
Invalid: ccNumber: You did not enter a valid number of digits
>>> cc().to_python({})
Traceback (most recent call last):
...
Invalid: The field ccType is missing
t ccTypet ccNumbert
cc_type_fieldt cc_number_fields1 Please enter only the number, no other characterst
notANumbers* You did not enter a valid number of digitst badLengths That number is not validt
invalidNumbers The field %(key)s is missingt missing_keyc C sG | i | i d p | i | i d o d S| i | | d S( N( R4 R R R R* ( R, R R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR
s c C s | i | | } | of | i } | i t d i g } | D] \ } } | d | | f qC ~ | | d | n d S( Ns
s %s: %sR ( t _validateReturnRq R R5 R3 ( R, R R7 R R R R R6 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR*
s
*c
C s xO | i | i f D]; } | | j o( t | i d | d | t | q q W| | i i i } | | i i } | i d d } | i d d } y t | Wn* t j
o h | i d | | i 6SXt
} t
} xf | i | D]W \ } } t | | j o
t
} n t | | j o | i | o t
} Pq q W| p h | i d | | i 6S| p h | i d | | i 6S| i | p h | i d | | i 6Sd S( NR t keyR R R1 R R R ( R R R5 R2 R6 R Rl R t longR R< t _cardInfoR1 R^ R t _validateMod10R (
R, R R7 R R R t
foundValidt validLengtht prefixR ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR
s<
)
c C s d } d } xk t t | d d d D]M } x6 t | d t | | D] } | t | } qN W| d d } q) W| d d j S( s?
This code by Sean Reifschneider, of tummy.com
i i ii i
( R R1 R R ( R, R t doublet sumR t c( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR
s t 4i i
t visat 51t 52t 53t 54t 55t
mastercardt 6011t discovert 34i t 37t amext 300i t 301t 302t 303t 304t 305t 36t 38t
dinersclubt 3t 2131t 1800t jcb( s
cc_type_fields cc_number_field( R i ( R i
( R i ( R i ( R i ( R i ( R i ( R i ( R i ( R i ( R i ( R i ( R i ( R i ( R i ( R i ( R i ( R i ( R i ( R i ( R
i ( R R> R? R^ R R R RS R@ RA R R* R R R ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR
sH
"
t CreditCardExpiresc B sg e Z d Z e Z d Z d Z d Z d
Z h e
d d 6e
d d 6Z d Z d
Z
d Z RS( s
Checks that credit card expiration date is valid relative to
the current date.
You pass in the name of the field that has the credit card
expiration month and the field with the credit card expiration
year.
::
>>> ed = CreditCardExpires()
>>> ed.to_python({'ccExpiresMonth': '11', 'ccExpiresYear': '2250'})
{'ccExpiresYear': '2250', 'ccExpiresMonth': '11'}
>>> ed.to_python({'ccExpiresMonth': '10', 'ccExpiresYear': '2005'})
Traceback (most recent call last):
...
Invalid: ccExpiresMonth: Invalid Expiration Date
ccExpiresYear: Invalid Expiration Date
t ccExpiresMontht
ccExpiresYeart cc_expires_month_fieldt cc_expires_year_fields, Please enter numbers only for month and yearR s Invalid Expiration DateR c C sG | i | i d p | i | i d o d S| i | | d S( N( R4 R R R R* ( R, R R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR E s c C s | i | | } | of | i } | i t d i g } | D] \ } } | d | | f qC ~ | | d | n d S( Ns
s %s: %sR ( R Rq R R5 R3 ( R, R R7 R R R R R6 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR* K s
*c C sQ t | | i i } t | | i i } y t | } t | } t | i } t | } t | | i | i
| i } | d d } | d j o | d } n | } t | | | d }
Wn t j
o4 h | i
d | | i 6| i
d | | i 6St j
o4 h | i
d | | i 6| i
d | | i 6SXd S( Ni i R R ( R R Rl R R R
R R R R R R R R2 t AssertionError( R, R R7 R R R R R t
next_montht next_month_yeart expires_date( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR U s(
( s cc_expires_month_fields cc_expires_year_fieldN( R R> R? R^ R R R RS R R R@ RA R R* R ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR # s
t CreditCardSecurityCodec B s e Z d Z e Z d Z d Z d Z h e d d 6e d d 6Z d Z
d
Z d Z h d d
6d d 6d d 6d d 6Z
RS( sN
Checks that credit card security code has the correct number
of digits for the given credit card type.
You pass in the name of the field that has the credit card
type and the field with the credit card security code.
::
>>> code = CreditCardSecurityCode()
>>> code.to_python({'ccType': 'visa', 'ccCode': '111'})
{'ccType': 'visa', 'ccCode': '111'}
>>> code.to_python({'ccType': 'visa', 'ccCode': '1111'})
Traceback (most recent call last):
...
Invalid: ccCode: Invalid credit card security code length
R t ccCodeR t
cc_code_fields7 Please enter numbers only for credit card security codeR s( Invalid credit card security code lengthR c C sG | i | i d p | i | i d o d S| i | | d S( N( R4 R R R R* ( R, R R7 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s c C s | i | | } | of | i } | i t d i g } | D] \ } } | d | | f qC ~ | | d | n d S( Ns
s %s: %sR ( R Rq R R5 R3 ( R, R R7 R R R R R6 ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR* s
*c C s t | | i i } t | | i i } y t | Wn* t j
o h | i d | | i 6SX| i | } t } t | | j o
t
} n | p h | i d | | i 6Sd S( NR R ( R R Rl R R R R2 R R< R1 R^ ( R, R R7 R R R R ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR s
i R R R i R ( s
cc_type_fields
cc_code_field( R R> R? R^ R R R RS R@ RA R R* R R ( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyR m s
R5 ([ R? R Rg R R R R R t
interfacest apiR R t filterst simplefilterR# R R t NameErrorR R, t fieldstorageR t DiscoverNameServersR^ R R R< R@ R R R
R R R R R$ R RB RR RT RY R\ R` Rb Rn Ro Ru R R R R R R R R R R R R R% R' R) R* R. R= Rp R R R t
StringBooleanR R R R R R t RequireIfPresentR R R R t __all__t globalsRq R R6 R& R# t
issubclasst Validatort append( ( ( s9 /usr/lib/python2.6/site-packages/formencode/validators.pyt s
\A#45 I 8M8y #.b==: K '0A,// :AJH