ProPeler
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
usr
/
lib
/
python3
/
dist-packages
/
twisted
/
web
/
__pycache__
/
Filename :
template.cpython-38.pyc
back
Copy
U W[�D � y @ s� d Z ddlmZmZ ddddddd d d d d dddddgZddlZddlmZ ddlm Z ddl m Z m Z ddl mZmZ ddlmZ ddlmZmZmZmZmZ ddlmZ ddlmZ d Z d Z e� Z G d d � d e �Z G d d!� d!e j!e j"�Z#d"d#� Z$e e�G d$d� de ��Z%e e�G d%d� de ��Z&e e�G d&d� de ��Z'e(d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|d}d~dd�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�gx�Z)G d�d�� d�e �Z*e*� Z+d�d�d�Z,dd�l-m.Z.m/Z/ dd�l0m1Z1m2Z2 ddl3Z4dS )�a0 HTML rendering for twisted.web. @var VALID_HTML_TAG_NAMES: A list of recognized HTML tag names, used by the L{tag} object. @var TEMPLATE_NAMESPACE: The XML namespace used to identify attributes and elements used by the templating system, which should be removed from the final output document. @var tags: A convenience object which can produce L{Tag} objects on demand via attribute access. For example: C{tags.div} is equivalent to C{Tag("div")}. Tags not specified in L{VALID_HTML_TAG_NAMES} will result in an L{AttributeError}. � )�division�absolute_import�TEMPLATE_NAMESPACE�VALID_HTML_TAG_NAMES�Element� TagLoader� XMLString�XMLFile�renderer�flatten� flattenString�tags�Comment�CDATA�Tag�slot�CharRef� renderElementN)� OrderedDict)� implementer)� make_parser�handler)�NativeStringIO�items)�FilePath)r r r r r )�ITemplateLoader)�Loggerz4http://twistedmatrix.com/ns/twisted.web.template/0.1� c @ s4 e Zd ZdZd dd�Zd dd�Zdd� Zd d � ZdS ) � _NSContextzL A mapping from XML namespaces onto their prefixes in the document. Nc C s* || _ |dk r t|j�| _n ddi| _dS )ze Pull out the parent's namespaces, if there's no parent then default to XML. Nz$http://www.w3.org/XML/1998/namespaceZxml)�parentr �nss)�selfr � r" �6/usr/lib/python3/dist-packages/twisted/web/template.py�__init__> s z_NSContext.__init__c C s | j �||�S )z\ Get a prefix for a namespace. @param d: The default prefix value. )r �get)r! �k�dr" r" r# r% J s z_NSContext.getc C s | j �||� dS )zH Proxy through to setting the prefix for the namespace. N)r � __setitem__)r! r& �vr" r" r# r( S s z_NSContext.__setitem__c C s | j �|�S )zH Proxy through to getting the prefix for the namespace. )r � __getitem__)r! r& r" r" r# r* Z s z_NSContext.__getitem__)N)N)�__name__� __module__� __qualname__�__doc__r$ r% r( r* r" r" r" r# r 9 s r c @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd� Zd d � Zd d � Zd S )!�_ToStanzd A SAX parser which converts an XML document to the Twisted STAN Document Object Model. c C s || _ t� | _d| _dS )zM @param sourceFilename: the filename to load the XML out of. FN)�sourceFilenamer � prefixMap�inCDATA)r! r0 r" r" r# r$ h s z_ToStan.__init__c C s || _ dS )zY Set the document locator, which knows about line and character numbers. N)�locator)r! r3 r" r" r# �setDocumentLocatorq s z_ToStan.setDocumentLocatorc C s g | _ | j | _g | _g | _dS )z* Initialise the document. N)�document�current�stack� xmlnsAttrs�r! r" r" r# � startDocumentx s z_ToStan.startDocumentc C s dS )z! Document ended. Nr" r9 r" r" r# � endDocument� s z_ToStan.endDocumentc C s dS )z6 Processing instructions are ignored. Nr" )r! �target�datar" r" r# �processingInstruction� s z _ToStan.processingInstructionc C sT t | j�| _|| j|< |tkr"dS |dkr<| j�d|f� n| j�d| |f� dS )z� Set up the prefix mapping, which maps fully qualified namespace URIs onto namespace prefixes. This gets called before startElementNS whenever an C{xmlns} attribute is seen. NZxmlnszxmlns:%s)r r1 r r8 �append)r! �prefixZurir" r" r# �startPrefixMapping� s z_ToStan.startPrefixMappingc C s | j j| _ dS )zb "Pops the stack" on the prefix mapping. Gets called after endElementNS. N)r1 r )r! r@ r" r" r# �endPrefixMapping� s z_ToStan.endPrefixMappingc C sB | j }| j�� }| j�� }|\}}|tkr�|dkr8d}nh|dkr�z |d } W n tk rd d} Y nX t|d | |||d�} | j�| � | j �| � | j | _ dS d} t |�}t |�D ],\} } | \}}|tkr�q�|dkr�| } || = q�t � }t |�D ]<\\}}} | j �|�}|dk�r|}n d ||f }| ||< q�|tk�r�|d k�r�| j�sXtd tf ��d |k�rptd tf ��td| |||d�} | | jd j|d < | j�| � | j | _ dS | j�r�|�t | j�� g | _|tk�r|dk �r| j | }|dk �rd | j | |f }t|t |�| |||d�} | j�| � | j �| � | j | _ dS )a] Gets called when we encounter a new xmlns attribute. @param namespaceAndName: a (namespace, name) tuple, where name determines which type of action to take, if the namespace matches L{TEMPLATE_NAMESPACE}. @param qname: ignored. @param attrs: attributes on the element being started. � transparent� r )N�defaultN)N�name)rE �filename� lineNumber� columnNumber�renderz%s:%s�attrz <{%s}attr> as top-level elementrF z$<{%s}attr> requires a name attribute)rJ rG rH rI ���)� attributesrJ rG rH rI )r0 r3 Z getLineNumberZgetColumnNumberr �KeyErrorr r7 r? r6 �childrenr r r1 r% �AssertionErrorr rM r8 �update)r! ZnamespaceAndName�qnameZattrsrG rH rI �nsrF rE ZelrJ r& r) ZattrNSZ justTheNameZnonTemplateAttrsZattrNsZattrNameZnsPrefixZattrKeyr@ r" r" r# �startElementNS� s� � � � � � z_ToStan.startElementNSc C s* | j r| jd �|� dS | j�|� dS )z� Called when we receive some characters. CDATA characters get passed through as is. @type ch: C{string} rL N)r2 r7 r? r6 )r! Zchr" r" r# � characters s z_ToStan.charactersc C s, | j �� | j r | j d j| _n| j| _dS )z� A namespace tag is closed. Pop the stack, if there's anything left in it, otherwise return to the document's namespace. rL N)r7 �poprO r6 r5 )r! rF rR r" r" r# � endElementNS s z_ToStan.endElementNSc C s dS �z# DTDs are ignored. Nr" )r! rF ZpublicIdZsystemIdr" r" r# �startDTD* s z_ToStan.startDTDc G s dS rX r" )r! �argsr" r" r# �endDTD0 s z_ToStan.endDTDc C s d| _ | j�g � dS )zO We're starting to be in a CDATA element, make a note of this. TN)r2 r7 r? r9 r" r" r# � startCDATA6 s z_ToStan.startCDATAc C s* d| _ d�| j�� �}| j�t|�� dS )z� We're no longer in a CDATA element. Collect up the characters we've parsed and put them in a new CDATA object. FrD N)r2 �joinr7 rV r6 r? r )r! �commentr" r" r# �endCDATA> s z_ToStan.endCDATAc C s | j �t|�� dS )z= Add an XML comment which we've encountered. N)r6 r? r )r! Zcontentr" r" r# r^ H s z_ToStan.commentN)r+ r, r- r. r$ r4 r: r; r> rA rB rT rU rW rY r[ r\ r_ r^ r" r" r" r# r/ b s c r/ c C s� t � }|�tjd� |�tjd� |�tjd� |�tjd� tt| dd��}|� |� |� |� |� tj |� |� | � |jS )z� Perform a SAX parse of an XML document with the _ToStan class. @param fl: The XML document to be parsed. @type fl: A file object or filename. @return: a C{list} of Stan objects. r r rF N)r Z setFeaturer Zfeature_validationZfeature_namespacesZfeature_external_gesZfeature_external_pesr/ �getattrZsetContentHandlerZsetEntityResolverZ setPropertyZproperty_lexical_handler�parser5 )Zfl�parser�sr" r" r# � _flatsaxParseP s rd c @ s e Zd ZdZdd� Zdd� ZdS )r z� An L{ITemplateLoader} that loads existing L{IRenderable} providers. @ivar tag: The object which will be loaded. @type tag: An L{IRenderable} provider. c C s || _ dS )zm @param tag: The object which will be loaded. @type tag: An L{IRenderable} provider. N��tag)r! rf r" r" r# r$ r s zTagLoader.__init__c C s | j gS �Nre r9 r" r" r# �loadz s zTagLoader.loadN�r+ r, r- r. r$ rh r" r" r" r# r i s c @ s e Zd ZdZdd� Zdd� ZdS )r z� An L{ITemplateLoader} that loads and parses XML from a string. @ivar _loadedTemplate: The loaded document. @type _loadedTemplate: a C{list} of Stan objects. c C s& t |t�s|�d�}tt|��| _dS )z� Run the parser on a L{NativeStringIO} copy of the string. @param s: The string from which to load the XML. @type s: C{str}, or a UTF-8 encoded L{bytes}. �utf8N)� isinstance�str�decoderd r �_loadedTemplate)r! rc r" r" r# r$ � s zXMLString.__init__c C s | j S )zx Return the document. @return: the loaded document. @rtype: a C{list} of Stan objects. )rn r9 r" r" r# rh � s zXMLString.loadNri r" r" r" r# r s c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) r a3 An L{ITemplateLoader} that loads and parses XML from a file. @ivar _loadedTemplate: The loaded document, or L{None}, if not loaded. @type _loadedTemplate: a C{list} of Stan objects, or L{None}. @ivar _path: The L{FilePath}, file object, or filename that is being loaded from. c C s* t |t�stjdtdd� d| _|| _dS )z� Run the parser on a file. @param path: The file from which to load the XML. @type path: L{FilePath} zhPassing filenames or file objects to XMLFile is deprecated since Twisted 12.1. Pass a FilePath instead.� )�category� stacklevelN)rk r �warnings�warn�DeprecationWarningrn �_path)r! �pathr" r" r# r$ � s �zXMLFile.__init__c C sB t | jt�st| j�S | j�d��}t|�W 5 Q R � S Q R X dS )z{ Read and parse the XML. @return: the loaded document. @rtype: a C{list} of Stan objects. �rN)rk ru r rd �open)r! �fr" r" r# �_loadDoc� s zXMLFile._loadDocc C s d| j f S )Nz<XMLFile of %r>)ru r9 r" r" r# �__repr__� s zXMLFile.__repr__c C s | j dkr| �� | _ | j S )z� Return the document, first loading it if necessary. @return: the loaded document. @rtype: a C{list} of Stan objects. N)rn rz r9 r" r" r# rh � s z XMLFile.loadN)r+ r, r- r. r$ rz r{ rh r" r" r" r# r � s �aZabbrZacronymZaddressZappletZareaZarticleZasideZaudio�b�baseZbasefontZbdiZbdoZbigZ blockquoteZbody�brZbuttonZcanvasZcaption�centerZcite�code�colZcolgroupZcommandZdatalistZdd�delZdetailsZdfn�dirZdivZdlZdtZemZembedZfieldsetZ figcaptionZfigureZfontZfooterZform�frameZframesetZh1Zh2Zh3Zh4Zh5Zh6�head�headerZhgroupZhrZhtml�iZiframeZimg�inputZinsZisindexZkeygenZkbdZlabelZlegendZli�link�mapZmarkZmenu�metaZmeterZnavZnoframesZnoscript�objectZolZoptgroupZoption�output�pZparamZpreZprogress�qZrpZrtZrubyrc ZsampZscriptZsectionZselectZsmall�source�spanZstrikeZstrongZstyle�subZsummaryZsup�tableZtbodyZtdZtextareaZtfootZthZthead�time�titleZtrZtt�uZul�varZvideoZwbrc @ s e Zd ZdZdd� ZdS )� _TagFactorya� A factory for L{Tag} objects; the implementation of the L{tags} object. This allows for the syntactic convenience of C{from twisted.web.html import tags; tags.a(href="linked-page.html")}, where 'a' can be basically any HTML tag. The class is not exposed publicly because you only ever need one of these, and we already made it for you. @see: L{tags} c C s8 |dkrt d�S |�d�}|tkr0td|f ��t |�S )NrC rD �_zunknown tag %r)r �rstripr �AttributeError)r! ZtagNamer" r" r# � __getattr__ s z_TagFactory.__getattr__N)r+ r, r- r. r� r" r" r" r# r� � s r� � <!DOCTYPE html>c sj |dk r �� |� �� d� � dkr.tjjj� t�|�j �}� �fdd�}|�|� |��fdd�� tS )a� Render an element or other C{IRenderable}. @param request: The C{Request} being rendered to. @param element: An C{IRenderable} which will be rendered. @param doctype: A C{bytes} which will be written as the first line of the request, or L{None} to disable writing of a doctype. The C{string} should not include a trailing newline and will default to the HTML5 doctype C{'<!DOCTYPE html>'}. @returns: NOT_DONE_YET @since: 12.1 N� c s< t jd| d� �jjr.t�� | ��j��d�S ��d� d S )Nz/An error occurred while rendering the response.��failurerj sr <div style="font-size:800%;background-color:#FFF;color:#F00">An error occurred while rendering the response.</div>)� _moduleLogr� ZsiteZdisplayTracebacksr �write�encoder� �� _failElement�requestr" r# �eb( s � ���zrenderElement.<locals>.ebc s � � � S rg )Zfinish)r� )r� r" r# �<lambda>8 � z renderElement.<locals>.<lambda>) r� �twistedZweb�utilZFailureElementr Z addErrbackZaddBoth� NOT_DONE_YET)r� �elementZdoctyper� r' r� r" r� r# r s )r r )r r )r� N)5r. Z __future__r r �__all__rr � collectionsr Zzope.interfacer Zxml.saxr r Ztwisted.python.compatr r Ztwisted.python.filepathr Ztwisted.web._stanr r r r r Ztwisted.web.iwebr Ztwisted.loggerr r r� r� r� r ZContentHandlerZEntityResolverr/ rd r r r �setr r� r r Ztwisted.web._elementr r Ztwisted.web._flattenr r Ztwisted.web.utilr� r" r" r" r# �<module> sT � ) o > � � .