U  W[Dy@sdZddlmZmZddddddd d d d d dddddgZddlZddlmZddlm Z ddl m Z m Z ddl mZmZddlmZddlmZmZmZmZmZddlmZddlmZdZdZeZGdddeZ Gd d!d!e j!e j"Z#d"d#Z$e eGd$ddeZ%e eGd%ddeZ&e eGd&ddeZ'e(d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;dd?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|d}d~ddddddddddddddddddddddddddddddddgxZ)GdddeZ*e*Z+dddZ,ddl-m.Z.m/Z/ddl0m1Z1m2Z2ddl3Z4dS)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}. )divisionabsolute_importTEMPLATE_NAMESPACEVALID_HTML_TAG_NAMESElement TagLoader XMLStringXMLFilerendererflatten flattenStringtagsCommentCDATATagslotCharRef renderElementN) OrderedDict) implementer) make_parserhandler)NativeStringIOitems)FilePath)rrrrr)ITemplateLoader)Loggerz4http://twistedmatrix.com/ns/twisted.web.template/0.1c@s4eZdZdZd ddZd ddZddZd d ZdS) _NSContextzL A mapping from XML namespaces onto their prefixes in the document. NcCs*||_|dk rt|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)parentrnss)selfrr"6/usr/lib/python3/dist-packages/twisted/web/template.py__init__>sz_NSContext.__init__cCs|j||S)z\ Get a prefix for a namespace. @param d: The default prefix value. )r get)r!kdr"r"r#r%Jsz_NSContext.getcCs|j||dS)zH Proxy through to setting the prefix for the namespace. N)r __setitem__)r!r&vr"r"r#r(Ssz_NSContext.__setitem__cCs |j|S)zH Proxy through to getting the prefix for the namespace. )r __getitem__)r!r&r"r"r#r*Zsz_NSContext.__getitem__)N)N)__name__ __module__ __qualname____doc__r$r%r(r*r"r"r"r#r9s  rc@seZdZdZddZddZddZdd Zd d Zd d Z ddZ ddZ ddZ ddZ ddZddZddZddZddZd S)!_ToStanzd A SAX parser which converts an XML document to the Twisted STAN Document Object Model. cCs||_t|_d|_dS)zM @param sourceFilename: the filename to load the XML out of. FN)sourceFilenamer prefixMapinCDATA)r!r0r"r"r#r$hsz_ToStan.__init__cCs ||_dS)zY Set the document locator, which knows about line and character numbers. N)locator)r!r3r"r"r#setDocumentLocatorqsz_ToStan.setDocumentLocatorcCsg|_|j|_g|_g|_dS)z* Initialise the document. N)documentcurrentstack xmlnsAttrsr!r"r"r# startDocumentxsz_ToStan.startDocumentcCsdS)z! Document ended. Nr"r9r"r"r# endDocumentsz_ToStan.endDocumentcCsdS)z6 Processing instructions are ignored. Nr")r!targetdatar"r"r#processingInstructionsz_ToStan.processingInstructioncCsTt|j|_||j|<|tkr"dS|dkr<|jd|fn|jd||fdS)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)rr1rr8append)r!prefixZurir"r"r#startPrefixMappings  z_ToStan.startPrefixMappingcCs|jj|_dS)zb "Pops the stack" on the prefix mapping. Gets called after endElementNS. N)r1r)r!r@r"r"r#endPrefixMappingsz_ToStan.endPrefixMappingcCsB|j}|j}|j}|\}}|tkr|dkr8d}nh|dkrz |d} Wntk rdd} YnXt|d| |||d} |j| |j | | j |_ dSd} t |}t |D],\} } | \}}|tkrq|dkr| } || =qt }t |D]<\\}}} |j |}|dkr|}n d ||f}| ||<q|tkr|d kr|jsXtd tfd |krptd tftd| |||d} | |jdj|d <|j| | j |_ dS|jr|t |jg|_|tkr|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. transparentr)NdefaultN)Nname)rEfilename lineNumber columnNumberrenderz%s:%sattrz<{%s}attr> as top-level elementrFz$<{%s}attr> requires a name attribute)rJrGrHrI) attributesrJrGrHrI)r0r3Z getLineNumberZgetColumnNumberrKeyErrorrr7r?r6childrenrrr1r%AssertionErrorrrMr8update)r!ZnamespaceAndNameqnameZattrsrGrHrInsrFrEZelrJr&r)ZattrNSZ justTheNameZnonTemplateAttrsZattrNsZattrNameZnsPrefixZattrKeyr@r"r"r#startElementNSs                  z_ToStan.startElementNScCs*|jr|jd|dS|j|dS)z Called when we receive some characters. CDATA characters get passed through as is. @type ch: C{string} rLN)r2r7r?r6)r!Zchr"r"r# characterssz_ToStan.characterscCs,|j|jr |jdj|_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. rLN)r7poprOr6r5)r!rFrRr"r"r# endElementNSs z_ToStan.endElementNScCsdSz# DTDs are ignored. Nr")r!rFZpublicIdZsystemIdr"r"r#startDTD*sz_ToStan.startDTDcGsdSrXr")r!argsr"r"r#endDTD0sz_ToStan.endDTDcCsd|_|jgdS)zO We're starting to be in a CDATA element, make a note of this. TN)r2r7r?r9r"r"r# startCDATA6sz_ToStan.startCDATAcCs*d|_d|j}|jt|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. FrDN)r2joinr7rVr6r?r)r!commentr"r"r#endCDATA>sz_ToStan.endCDATAcCs|jt|dS)z= Add an XML comment which we've encountered. N)r6r?r)r!Zcontentr"r"r#r^Hsz_ToStan.commentN)r+r,r-r.r$r4r:r;r>rArBrTrUrWrYr[r\r_r^r"r"r"r#r/bs    c   r/cCst}|tjd|tjd|tjd|tjdtt|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. rrrFN)rZ setFeaturerZfeature_validationZfeature_namespacesZfeature_external_gesZfeature_external_pesr/getattrZsetContentHandlerZsetEntityResolverZ setPropertyZproperty_lexical_handlerparser5)Zflparsersr"r"r# _flatsaxParsePs    rdc@s eZdZdZddZddZdS)rz An L{ITemplateLoader} that loads existing L{IRenderable} providers. @ivar tag: The object which will be loaded. @type tag: An L{IRenderable} provider. cCs ||_dS)zm @param tag: The object which will be loaded. @type tag: An L{IRenderable} provider. Ntag)r!rfr"r"r#r$rszTagLoader.__init__cCs|jgSNrer9r"r"r#loadzszTagLoader.loadNr+r,r-r.r$rhr"r"r"r#risc@s eZdZdZddZddZdS)rz An L{ITemplateLoader} that loads and parses XML from a string. @ivar _loadedTemplate: The loaded document. @type _loadedTemplate: a C{list} of Stan objects. cCs&t|ts|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) isinstancestrdecoderdr_loadedTemplate)r!rcr"r"r#r$s  zXMLString.__init__cCs|jS)zx Return the document. @return: the loaded document. @rtype: a C{list} of Stan objects. )rnr9r"r"r#rhszXMLString.loadNrir"r"r"r#rs c@s0eZdZdZddZddZddZdd 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. cCs*t|tstjdtddd|_||_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)rkrwarningswarnDeprecationWarningrn_path)r!pathr"r"r#r$s zXMLFile.__init__c CsBt|jtst|jS|jd}t|W5QRSQRXdS)z{ Read and parse the XML. @return: the loaded document. @rtype: a C{list} of Stan objects. rN)rkrurrdopen)r!fr"r"r#_loadDocs  zXMLFile._loadDoccCs d|jfS)Nz)rur9r"r"r#__repr__szXMLFile.__repr__cCs|jdkr||_|jS)z Return the document, first loading it if necessary. @return: the loaded document. @rtype: a C{list} of Stan objects. N)rnrzr9r"r"r#rhs  z XMLFile.loadN)r+r,r-r.r$rzr{rhr"r"r"r#r s  aZabbrZacronymZaddressZappletZareaZarticleZasideZaudiobbaseZbasefontZbdiZbdoZbigZ blockquoteZbodybrZbuttonZcanvasZcaptioncenterZcitecodecolZcolgroupZcommandZdatalistZdddelZdetailsZdfndirZdivZdlZdtZemZembedZfieldsetZ figcaptionZfigureZfontZfooterZformframeZframesetZh1Zh2Zh3Zh4Zh5Zh6headheaderZhgroupZhrZhtmliZiframeZimginputZinsZisindexZkeygenZkbdZlabelZlegendZlilinkmapZmarkZmenumetaZmeterZnavZnoframesZnoscriptobjectZolZoptgroupZoptionoutputpZparamZpreZprogressqZrpZrtZrubyrcZsampZscriptZsectionZselectZsmallsourcespanZstrikeZstrongZstylesubZsummaryZsuptableZtbodyZtdZtextareaZtfootZthZtheadtimetitleZtrZttuZulvarZvideoZwbrc@seZdZdZddZdS) _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} cCs8|dkrtdS|d}|tkr0td|ft|S)NrCrD_zunknown tag %r)rrstriprAttributeError)r!ZtagNamer"r"r# __getattr__s  z_TagFactory.__getattr__N)r+r,r-r.rr"r"r"r#rs rcsj|dk r|ddkr.tjjjt|j}fdd}|||fddtS)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{''}. @returns: NOT_DONE_YET @since: 12.1 N cs<tjd|djjr.t|jdSddS)Nz/An error occurred while rendering the response.failurerjsr
An error occurred while rendering the response.
) _moduleLogrZsiteZdisplayTracebacksr writeencoder _failElementrequestr"r#eb(s zrenderElement..ebcsSrg)Zfinish)r)rr"r#8zrenderElement..) rtwistedZwebutilZFailureElementr Z addErrbackZaddBoth NOT_DONE_YET)relementZdoctyperr'rr"rr#rs    )rr )r r )rN)5r.Z __future__rr__all__rr collectionsrZzope.interfacerZxml.saxrrZtwisted.python.compatrrZtwisted.python.filepathrZtwisted.web._stanrrrrrZtwisted.web.iwebrZtwisted.loggerrrrrrrZContentHandlerZEntityResolverr/rdrrr setrrr rZtwisted.web._elementrr Ztwisted.web._flattenr r Ztwisted.web.utilrr"r"r"r#sT      )o > .