Ñò
ìÜIc @ s* d Z d d k Z d d k Z d d k Z d d k Z d d k Z d d k l Z d d k l Z l Z l Z d d k
l Z d d k l
Z
d d k l Z d d g Z e i e ƒ Z d
„ Z e e ƒ Z d d d e d d e d e d
„ Z d „ Z d d „ Z d „ Z d e f d „ ƒ YZ d S( sï Pylons Decorators
Common decorators intended for use in controllers. Additional
decorators for use with controllers are in the
:mod:`~pylons.decorators.cache`, :mod:`~pylons.decorators.rest` and
:mod:`~pylons.decorators.secure` modules.
iÿÿÿÿN( t decorator( t apit htmlfillt variabledecode( t UnicodeMultiDict( t
get_pylons( t _t jsonifyt validatec O s… t | ƒ } d | i i d <| | | Ž } t | t t f ƒ o* d } t i | t d ƒ t i
| ƒ n t i d ƒ t i
| ƒ S( s× Action decorator that formats output for JSON
Given a function that will return content, this decorator will turn
the result into JSON, with a content-type of 'application/json' and
output it.
s application/jsons Content-Types JSON responses with Array envelopes are susceptible to cross-site data leak attacks, see http://pylonshq.com/warnings/JSONArrayi s$ Returning JSON wrapped action output( R t responset headerst
isinstancet listt tuplet warningst warnt Warningt logt warningt debugt
simplejsont dumps( t funct argst kwargst pylonst datat msg( ( s> /usr/lib/python2.6/site-packages/pylons/decorators/__init__.pyR s
t .t -c
sK ˆ d j o
t ‰ n ‡ ‡ ‡ ‡ ‡ ‡ ‡ ‡ ‡ ‡ f
d † }
t |
ƒ S( s› Validate input either for a FormEncode schema, or individual
validators
Given a form schema or dict of validators, validate will attempt to
validate the schema or validator list.
If validation was successful, the valid result dict will be saved
as ``self.form_result``. Otherwise, the action will be re-run as if
it was a GET, and the output will be filled by FormEncode's
htmlfill to fill in the form field errors.
``schema``
Refers to a FormEncode Schema object to use during validation.
``form``
Method used to display the form, which will be used to get the
HTML representation of the form for error filling.
``variable_decode``
Boolean to indicate whether FormEncode's variable decode
function should be run on the form input before validation.
``dict_char``
Passed through to FormEncode. Toggles the form field naming
scheme used to determine what is used to represent a dict. This
option is only applicable when used with variable_decode=True.
``list_char``
Passed through to FormEncode. Toggles the form field naming
scheme used to determine what is used to represent a list. This
option is only applicable when used with variable_decode=True.
``post_only``
Boolean that indicates whether or not GET (query) variables
should be included during validation.
.. warning::
``post_only`` applies to *where* the arguments to be
validated come from. It does *not* restrict the form to
only working with post, merely only checking POST vars.
``state``
Passed through to FormEncode for use in validators that utilize
a state object.
``on_get``
Whether to validate on GET requests. By default only POST
requests are validated.
Example::
class SomeController(BaseController):
def create(self, id):
return render('/myform.mako')
@validate(schema=model.forms.myshema(), form='create')
def update(self, id):
# Do something with self.form_result
pass
c si | i i } h } ˆ o% | i d d j o | | | | Ž Sˆ o
| i } n
| i } t | t ƒ } | i ƒ } ˆ o& t i d ƒ t
i | ˆ ˆ ƒ } n | } ˆ oZ t i d ƒ y ˆ i | ˆ ƒ | _
Wq t i j
o } | i ˆ ˆ ˆ ƒ } q Xn ˆ oª t i d ƒ t ˆ t ƒ o‰ t | d ƒ p
h | _
n xi ˆ i ƒ D]W \ }
} y& | i | i |
ƒ ˆ ƒ | i
|
/usr/lib/python2.6/site-packages/pylons/decorators/__init__.pyt wrapperl sˆ
&
N( t Nonet PylonsFormEncodeStateR ( RP RM RQ R- RL RT RS RO RR RN RU ( (
RS RQ RT RN RR RO RL R- RM RP s> /usr/lib/python2.6/site-packages/pylons/decorators/__init__.pyR 0 s :
*dc C s: | i } | d j o t i ƒ } n t i d | ƒ | S( sr Determine the charset of the specified Response object,
returning the default system encoding when none is sets# Determined result charset to be: %sN( t charsetRV t syst getdefaultencodingR R ( R RX ( ( s> /usr/lib/python2.6/site-packages/pylons/decorators/__init__.pyR< Ó s
t strictc C s¿ | d j p t | t ƒ o n› t | t ƒ o | i | | ƒ } nu t | t ƒ o7 xa | i ƒ D]" \ } } t | | | ƒ | | R2 R4 R? ( R& RK t encoding_errorst keyt valuet _[1]RH ( ( s> /usr/lib/python2.6/site-packages/pylons/decorators/__init__.pyR? Ý s
&c C s0 t | ƒ } | | j o t i | ƒ } n | S( sò Translates a string ``value`` using pylons gettext first and if
that fails, formencode gettext.
This allows to "merge" localized error messages from built-in
FormEncode's validators with application-specific validators.
( t pylons_gettextR t _stdtrans( R_ t trans( ( s> /usr/lib/python2.6/site-packages/pylons/decorators/__init__.pyt pylons_formencode_gettextð s
RW c B s e Z d Z e e ƒ Z RS( s A ``state`` for FormEncode validate API that includes smart
``_`` hook.
The FormEncode library used by validate() decorator has some
provision for localizing error messages. In particular, it looks
for attribute ``_`` in the application-specific state object that
gets passed to every ``.to_python()`` call. If it is found, the
``_`` is assumed to be a gettext-like function and is called to
localize error messages.
One complication is that FormEncode ships with localized error
messages for standard validators so the user may want to re-use
them instead of gathering and translating everything from scratch.
To allow this, we pass as ``_`` a function which looks up
translation both in application and formencode message catalogs.
( t __name__t
__module__t __doc__t staticmethodRd R ( ( ( s> /usr/lib/python2.6/site-packages/pylons/decorators/__init__.pyRW ÿ s ( Rg t loggingRY R R/ R R R R R t webobR t pylons.decorators.utilR t pylons.i18nR Ra t __all__t getLoggerRe R R RV R9 R; R R< R? Rd t objectRW ( ( ( s> /usr/lib/python2.6/site-packages/pylons/decorators/__init__.pyt s* ¡