Ñò
Tã·Jc @ s¼ d Z d d k Z d d k Z d d k l Z d d k Z d d k l Z e i e ƒ Z
d d g Z d d „ Z
d e f d „ ƒ YZ e ƒ i Z e i d
e i e i Bƒ Z d „ Z d S( s1
.. testoutput::
:hide:
>>> # This is so the doctests start from a clean state
>>> from tw.core.util import install_framework; install_framework(True)
ToscaWidgets can inject resources that have been registered for injection in
the current request.
Usually widgets register them when they're displayed and they have instances of
:class:`tw.api.Resource` declared at their :attr:`tw.api.Widget.javascript` or
:attr:`tw.api.Widget.css` attributes.
Resources can also be registered manually from a controller or template by
calling their :meth:`tw.api.Resource.inject` method.
When a page including widgets is rendered, Resources that are registered for
injection arre collected in request-local
storage area (this means any thing stored here is only visible to one single
thread of execution and that its contents are freed when the request is
finished) where they can be rendered and injected in the resulting html.
ToscaWidgets' middleware can take care of injecting them automatically (default)
but they can also be injected explicitly, example::
>>> from tw.api import JSLink, inject_resources
>>> JSLink(link="http://example.com").inject()
>>> html = ""
>>> inject_resources(html)
''
Once resources have been injected they are popped from request local and
cannot be injected again (in the same request). This is useful in case
:class:`injector_middleware` is stacked so it doesn't inject them again.
Injecting them explicitly is neccesary if the response's body is being cached
before the middleware has a chance to inject them because when the cached
version is served no widgets are being rendered so they will not have a chance
to register their resources.
iÿÿÿÿN( t Request( t MultipleReplacert inject_resourcest injector_middlewarec s ‡ ‡ f d † } | S( sE
Middleware that injects resources (if any) into the page whenever the
output is html (peeks into Content-Type header).
Normally you don't have to stack thi yourself because
:class:`tw.core.middleware.ToscaWidgetsMiddleware` does it when it is
passed the ``inject_resources`` flag as True (default).
c s t | ƒ } | i ˆ ƒ } | i i d d ƒ i ƒ } d | j o? t i i ƒ } | o% t | i | | i
d ˆ ƒ| _ q‚ n | | | ƒ S( Ns Content-Types
text/plaint htmlt
render_filter( R t get_responset headerst gett lowert twt frameworkt
pop_resourcesR t bodyt charset( t environt start_responset reqt respt content_typet resources( R t app( s= /usr/lib/python2.6/site-packages/tw/core/resource_injector.pyt _injectorB s
)( ( R R R ( ( R R s= /usr/lib/python2.6/site-packages/tw/core/resource_injector.pyR 9 s t _ResourceInjectorc B s2 e Z d „ Z e d „ Z d d d d d „ Z RS( c C sc t i | h | i d ƒ d 6| i d t ƒ d 6| i d ƒ d 6| i d t ƒ d 6t i t i Bƒ S( Nt heads t
headbottoms
t bodytops t
bodybottoms
( R t __init__t _injector_for_locationt Falset ret It M( t self( ( s= /usr/lib/python2.6/site-packages/tw/core/resource_injector.pyR T s c s ‡ ‡ f d † } | S( Nc s€ | d j o
d „ } n d i g } | i ˆ g ƒ D] } | | | | ƒ q7 ~ ƒ } | i | ƒ } ˆ o | | S| | S( Nc S s
| i ƒ S( N( t render( t _environt resource( ( s= /usr/lib/python2.6/site-packages/tw/core/resource_injector.pyR _ s u
( t Nonet joinR t encode( t groupR t encodingR R t _[1]t rt inj( t keyt after( s= /usr/lib/python2.6/site-packages/tw/core/resource_injector.pyt inject] s
? ( ( R" R. R/ R0 ( ( R/ R. s= /usr/lib/python2.6/site-packages/tw/core/resource_injector.pyR \ s c C sm | d j o t i i ƒ } n | oB | p t | ƒ p d } t i | | | | d | d d ƒ} n | S( s— Injects resources, if any, into html string when called.
.. note::
Ignore the ``self`` parameter if seeing this as
:func:`tw.core.resource_injector.inject_resources` docstring
since it is an alias for an instance method of a private class.
``html`` must be a ``encoding`` encoded string. If ``encoding`` is not
given it will be tried to be derived from a .
Resources for current request can be obtained by calling
``tw.framework.pop_resources()``. This will remove resources
from request and a further call to ``pop_resources()`` will return an
empty dict.
t asciiR R N( R& R
R R t find_charsetR t __call__( R" R R R* R R ( ( s= /usr/lib/python2.6/site-packages/tw/core/resource_injector.pyR3 h s
(N( t __name__t
__module__R t TrueR R& R3 ( ( ( s= /usr/lib/python2.6/site-packages/tw/core/resource_injector.pyR S s s) charset\s*=\s*(?P[\w-]+)([^\>])*c C s. t i | ƒ } | o | i d ƒ i ƒ Sd S( NR ( t _charset_ret searchR) R ( t stringt m( ( s= /usr/lib/python2.6/site-packages/tw/core/resource_injector.pyR2 Œ s ( t __doc__R t loggingt webobR R
t tw.core.utilR t getLoggerR4 t logt __all__R& R R R3 R t compileR R! R7 R2 ( ( ( s= /usr/lib/python2.6/site-packages/tw/core/resource_injector.pyt * s 4