o
¯b7 ã @ s¼ d dl mZmZmZmZmZmZmZ d dlm Z d dl
m Z m Z m
Z
d dlmZmZmZ er6d dlmZmZ edƒZG dd„ dƒZd ed
efd d „Zeddd„ƒZe eƒG dd„ dƒƒZd
S )é )Ú
TYPE_CHECKINGÚCallableÚListÚOptionalÚTypeVarÚUnionÚoverload)Ú implementer)ÚMissingRenderMethodÚMissingTemplateLoaderÚUnexposedMethodError)Ú IRenderableÚIRequestÚITemplateLoader)Ú FlattenableÚTagÚTc @ s† e Zd ZdZdedefdd„Zeƒ Zedede defdd „ƒZ
edede d
e de ee f fd d „ƒZ
efdede d
edefd d „Z
d
S )ÚExposea/
Helper for exposing methods for various uses using a simple decorator-style
callable.
Instances of this class can be called with one or more functions as
positional arguments. The names of these functions will be added to a list
on the class object of which they are methods.
ÚfuncObjsÚreturnc G s@ |st dƒ‚|D ]}t|dg ƒ}| | ¡ t|d|ƒ q|d S )a;
Add one or more functions to the set of exposed functions.
This is a way to declare something about a class definition, similar to
L{zope.interface.implementer}. Use it like this::
magic = Expose('perform extra magic')
class Foo(Bar):
def twiddle(self, x, y):
...
def frob(self, a, b):
...
magic(twiddle, frob)
Later you can query the object::
aFoo = Foo()
magic.get(aFoo, 'twiddle')(x=1, y=2)
The call to C{get} will fail if the name it is given has not been
exposed using C{magic}.
@param funcObjs: One or more function objects which will be exposed to
the client.
@return: The first of C{funcObjs}.
z,expose() takes at least 1 argument (0 given)ÚexposedThroughr )Ú TypeErrorÚgetattrÚappendÚsetattr)Úselfr ÚfObjr © r ú6/usr/lib/python3/dist-packages/twisted/web/_element.pyÚ__call__" s
zExpose.__call__ÚinstanceÚ
methodNamec C ó d S ©Nr )r r r! r r r ÚgetH ó z
Expose.getÚdefaultc C r" r# r )r r r! r& r r r r$ L r% c C s< t ||dƒ}t |dg ƒ}| |vr || ju rt| |ƒ‚|S |S )aB
Retrieve an exposed method with the given name from the given instance.
@raise UnexposedMethodError: Raised if C{default} is not specified and
there is no exposed method with the given name.
@return: A callable object for the named method assigned to the given
instance.
Nr )r Ú
_nodefaultr )r r r! r& Úmethodr r r r r$ P s
N)
Ú__name__Ú
__module__Ú __qualname__Ú__doc__r r Úobjectr' r Ústrr$ r r r r r r r s$ $$ÿÿÿÿþr Úthunkr c C s t ƒ }| j|_|S r# )r r, )r/ Úexposer r r Úexposere s r1 Nc C s dS )aâ
Decorate with L{renderer} to use methods as template render directives.
For example::
class Foo(Element):
@renderer
def twiddle(self, request, tag):
return tag('Hello, world.')
Will result in this final output::
Hello, world.
Nr r r r r Úrendererk s r2 c @ sn e Zd ZU dZdZee ed< ddee fdd„Zde de
ee dgd f fd
d „Z d ee dd fd
d„Z
dS )ÚElementaª
Base for classes which can render part of a page.
An Element is a renderer that can be embedded in a stan document and can
hook its template (from the loader) up to render methods.
An Element might be used to encapsulate the rendering of a complex piece of
data which is to be displayed in multiple different contexts. The Element
allows the rendering logic to be easily re-used in different ways.
Element returns render methods which are registered using
L{twisted.web._element.renderer}. For example::
class Menu(Element):
@renderer
def items(self, request, tag):
....
Render methods are invoked with two arguments: first, the
L{twisted.web.http.Request} being served and second, the tag object which
"invoked" the render method.
@ivar loader: The factory which will be used to load documents to
return from C{render}.
NÚloaderc C s |d ur || _ d S d S r# )r4 )r r4 r r r Ú__init__¡ s
ÿzElement.__init__Únamer r r c C s$ t | |d¡}|du rt| |ƒ‚|S )z=
Look up and return the named render method.
N)r2 r$ r
)r r6 r( r r r ÚlookupRenderMethod¥ s
zElement.lookupRenderMethodÚrequestc C s | j }|du r t| ƒ‚| ¡ S )aê
Implement L{IRenderable} to allow one L{Element} to be embedded in
another's template or rendering output.
(This will simply load the template from the C{loader}; when used in a
template, the flattening engine will keep track of this object
separately as the object to lookup renderers on and call
L{Element.renderer} to look them up. The resulting object from this
method is not directly associated with this L{Element}.)
N)r4 r Úload)r r8 r4 r r r Úrender° s zElement.renderr# )r) r* r+ r, r4 r r Ú__annotations__r5 r. r r r7 r: r r r r r3 ƒ s
ÿ
þ r3 )r N)Útypingr r r r r r r Úzope.interfacer Útwisted.web.errorr
r r Útwisted.web.iwebr
r r Útwisted.web.templater r r r r1 r2 r3 r r r r Ú s $ M