\d7ddlmZmZmZmZmZmZmZddlm Z ddl m Z m Z m Z ddlmZmZmZerddlmZmZedZGddZd ed efd Zedd Ze eGddZd S)) TYPE_CHECKINGCallableListOptionalTypeVarUnionoverload) implementer)MissingRenderMethodMissingTemplateLoaderUnexposedMethodError) IRenderableIRequestITemplateLoader) FlattenableTagTc eZdZdZdedefdZeZedede defdZ edede de de ee ffd Z efdede dedefd 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. funcObjsreturnc|std|D]9}t|dg}||t|d|:|dS)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) TypeErrorgetattrappendsetattr)selfrfObjrs 4lib/python3.11/site-packages/twisted/web/_element.py__call__zExpose.__call__"sq8 LJKK K < > ~ % %$/))*4<<<N r"N) __name__ __module__ __qualname____doc__rr!objectr-r strr(rrr'r"r rrs"("x""""HJ  F     X  F  a E(TU+DV   X DN,/:@ r"rthunkrc:t}|j|_|Sr&)rr2)r5exposes r exposerr8es XXF]FN Mr"NcdS)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 rendererr:ksr"ceZdZUdZdZeeed<d deefdZde de ee dgdffd Z d ee ddfd 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}. Nloaderc| ||_dSdSr&)r=)rr=s r __init__zElement.__init__s   DKKK  r"namerrrcbt||d}|t|||S)z= Look up and return the named render method. N)r:r(r )rr@r.s r lookupRenderMethodzElement.lookupRenderMethods3 dD$// >%dD11 1 r"requestcZ|j}|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}.) )r=r load)rrCr=s r renderzElement.renders, >'-- -{{}}r"r&)r/r0r1r2r=rr__annotations__r?r4rrrBrFr'r"r r<r<s4)-FH_ %,,,!!x8!!!!   8H%u-}< =    hx0]r"r<)rN)typingrrrrrrr zope.interfacer twisted.web.errorr r r twisted.web.iwebrrrtwisted.web.templaterrrrr8r:r<r'r"r rMs UTTTTTTTTTTTTTTTTT&&&&&& DCCCCCCCCC655555555 GCLLJJJJJJJJZ8   . [::::::::::r"