D7net
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
lib
/
python3
/
dist-packages
/
twisted
/
web
/
__pycache__
/
Filename :
_element.cpython-312.pyc
back
Copy
� Ϫ�f� � � � d dl Z d dlmZmZmZmZmZmZmZm Z d dl m Z d dl m Z mZmZ d dlmZmZmZ erd dlmZmZ ed� Z eded ef � � Z G d � d � Zd ed ef defd�Zedd�� Z e e� G d� d� � Z y)� N)� TYPE_CHECKING�Any�Callable�List�Optional�TypeVar�Union�overload)� implementer)�MissingRenderMethod�MissingTemplateLoader�UnexposedMethodError)� IRenderable�IRequest�ITemplateLoader)� Flattenable�Tag�T�_Tc.)�boundc � � e Zd ZdZdededef defd�Z e� Ze dede dede f fd �� Z e dede d e deede f e f fd �� Z efdede d edefd �Z y )�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. �f�funcObjs.�returnc � � t j |g|� D ]- }t |dg � }|j | � t |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}. �exposedThrough)� itertools�chain�getattr�append�setattr)�selfr r �fObjr s �6/usr/lib/python3/dist-packages/twisted/web/_element.py�__call__zExpose.__call__, sQ � �8 �O�O�Q�C��2� <�D�+2�4�9I�2�+N�N� � !� !�$� '� �D�*�N� ;� <� �� �instance� methodNamec � � y �N� )r# r( r) s r% �getz Expose.getP s � � r' �defaultc � � y r+ r, )r# r( r) r. s r% r- z Expose.getT s � � r' c �z � t ||d� }t |dg � }| |vr || j u r t | |� �|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 s r% r- z Expose.getZ sL � � ��:�t�4�� ��)9�2�>�� �~� %��$�/�/�)�*�4��<�<��N�� r' N)�__name__� __module__� __qualname__�__doc__r r �objectr& r1 r �strr r- r r r, r' r% r r " s� � �� �#� �X�c�6�k�-B� �s� �D ��J� � �F� �� ���c��8J� � � � � � � �,/� �:;� � �x��S��!�1�$� %� � � � DN�� ��,/��:@�� �r' r �thunkr c �< � t � }| j |_ |S r+ )r r6 )r9 �exposes r% �exposerr< o s � � �X�F��]�]�F�N� �Mr' c � � y)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.') <div xmlns:t="http://twistedmatrix.com/ns/twisted.web.template/0.1"> <span t:render="twiddle" /> </div> Will result in this final output:: <div> <span>Hello, world.</span> </div> Nr, r, r' r% �rendererr> u s � r' c �t � e Zd ZU dZdZee ed< d dee fd�Zde de ee dgdf fd �Z d ee ddfd �Z y) �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 � � |�|| _ y y r+ )rA )r# rA s r% �__init__zElement.__init__� s � � � � �D�K� r' �namer r r c �P � t j | |d� }|� t | |� �|S )z= Look up and return the named render method. N)r> r- r )r# rD r2 s r% �lookupRenderMethodzElement.lookupRenderMethod� s- � � � � �d�D�$�/�� �>�%�d�D�1� 1�� r' �requestc �T � | j }|� t | � �|j � 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}.) )rA r �load)r# rG rA s r% �renderzElement.render� s) � � ���� �>�'��-� -��{�{�}� r' r+ )r3 r4 r5 r6 rA r r �__annotations__rC r8 r r rF rJ r, r' r% r@ r@ � sj � ��4 )-�F�H�_� %�,�!�x�� 8� !� �� � �8�H�%�u�-�}�<� =� � �h�x� 0� �]� r' r@ )r N) r �typingr r r r r r r r �zope.interfacer �twisted.web.errorr r r �twisted.web.iwebr r r �twisted.web.templater r r r7 r r r< r> r@ r, r' r% �<module>rQ s� �� � � � � '�� � D� C��5� �C�L�� �e�8�C��K�0�1��J� J�Z�8�C��K�(� �V� � �� ��. �[��: � : � �: r'