U  W[&*@sxdZddlmZmZddlmZGdddeZGdddeZdZ Gd d d eZ Gd d d eZ Gd ddeZ dS)aC An s-expression-like syntax for expressing xml in pure python. Stan tags allow you to build XML documents using Python. Stan is a DOM, or Document Object Model, implemented using basic Python types and functions called "flatteners". A flattener is a function that knows how to turn an object of a specific type into something that is closer to an HTML string. Stan differs from the W3C DOM by not being as cumbersome and heavy weight. Since the object model is built using simple python types such as lists, strings, and dictionaries, the API is simpler and constructing a DOM less cumbersome. @var voidElements: the names of HTML 'U{void elements}'; those which can't have contents and can therefore be self-closing in the output. )absolute_importdivision) iteritemsc@s"eZdZdZdddZddZdS)slota} Marker for markup insertion in a template. @type name: C{str} @ivar name: The name of this slot. The key which must be used in L{Tag.fillSlots} to fill it. @type children: C{list} @ivar children: The L{Tag} objects included in this L{slot}'s template. @type default: anything flattenable, or L{None} @ivar default: The default contents of this slot, if it is left unfilled. If this is L{None}, an L{UnfilledSlot} will be raised, rather than L{None} actually being used. @type filename: C{str} or L{None} @ivar filename: The name of the XML file from which this tag was parsed. If it was not parsed from an XML file, L{None}. @type lineNumber: C{int} or L{None} @ivar lineNumber: The line number on which this tag was encountered in the XML file from which it was parsed. If it was not parsed from an XML file, L{None}. @type columnNumber: C{int} or L{None} @ivar columnNumber: The column number at which this tag was encountered in the XML file from which it was parsed. If it was not parsed from an XML file, L{None}. NcCs(||_g|_||_||_||_||_dSN)namechildrendefaultfilename lineNumber columnNumber)selfrr r r r r3/usr/lib/python3/dist-packages/twisted/web/_stan.py__init__=s z slot.__init__cCs d|jfS)Nzslot(%r))rr rrr__repr__Gsz slot.__repr__)NNNN__name__ __module__ __qualname____doc__rrrrrrrs  rc@s\eZdZdZdZdZdZdZdddZddZ ddZ d d Z dd d Z ddZ ddZdS)Taga A L{Tag} represents an XML tags with a tag name, attributes, and children. A L{Tag} can be constructed using the special L{twisted.web.template.tags} object, or it may be constructed directly with a tag name. L{Tag}s have a special method, C{__call__}, which makes representing trees of XML natural using pure python syntax. @ivar tagName: The name of the represented element. For a tag like C{
}, this would be C{"div"}. @type tagName: C{str} @ivar attributes: The attributes of the element. @type attributes: C{dict} mapping C{str} to renderable objects. @ivar children: The child L{Tag}s of this C{Tag}. @type children: C{list} of renderable objects. @ivar render: The name of the render method to use for this L{Tag}. This name will be looked up at render time by the L{twisted.web.template.Element} doing the rendering, via L{twisted.web.template.Element.lookupRenderMethod}, to determine which method to call. @type render: C{str} @type filename: C{str} or L{None} @ivar filename: The name of the XML file from which this tag was parsed. If it was not parsed from an XML file, L{None}. @type lineNumber: C{int} or L{None} @ivar lineNumber: The line number on which this tag was encountered in the XML file from which it was parsed. If it was not parsed from an XML file, L{None}. @type columnNumber: C{int} or L{None} @ivar columnNumber: The column number at which this tag was encountered in the XML file from which it was parsed. If it was not parsed from an XML file, L{None}. @type slotData: C{dict} or L{None} @ivar slotData: The data which can fill slots. If present, a dictionary mapping slot names to renderable values. The values in this dict might be anything that can be present as the child of a L{Tag}; strings, lists, L{Tag}s, generators, etc. NcCsf||_||_|dkri|_n||_|dkr2g|_n||_|dk rF||_|dk rT||_|dk rb||_dSr)tagNamerender attributesrr r r )r rrrrr r r rrrrsz Tag.__init__cKs |jdkri|_|j||S)a@ Remember the slots provided at this position in the DOM. During the rendering of children of this node, slots with names in C{slots} will be rendered as their corresponding values. @return: C{self}. This enables the idiom C{return tag.fillSlots(...)} in renderers. N)slotDataupdate)r slotsrrr fillSlotss  z Tag.fillSlotscOsT|j|t|D]:\}}|ddkr4|dd}|dkrD||_q||j|<q|S)a Add children and change attributes on this tag. This is implemented using __call__ because it then allows the natural syntax:: table(tr1, tr2, width="100%", height="50%", border="1") Children may be other tag instances, strings, functions, or any other object which has a registered flatten. Attributes may be 'transparent' tag instances (so that C{a(href=transparent(data="foo", render=myhrefrenderer))} works), strings, functions, or any other object which has a registered flattener. If the attribute is a python keyword, such as 'class', you can add an underscore to the name, like 'class_'. There is one special keyword argument, 'render', which will be used as the name of the renderer and saved as the 'render' attribute of this instance, rather than the DOM 'render' attribute in the attributes dictionary. _Nr)rextendrrr)r rkwkvrrr__call__s    z Tag.__call__cs>t|dr|St|ttfr6fdd|DS|SdS)ad Clone an arbitrary object; used by L{Tag.clone}. @param obj: an object with a clone method, a list or tuple, or something which should be immutable. @param deep: whether to continue cloning child objects; i.e. the contents of lists, the sub-tags within a tag. @return: a clone of C{obj}. clonecsg|]}|qSr_clone.0xdeepr rr szTag._clone..N)hasattrr' isinstancelisttuple)r objr.rr-rr)s  z Tag._cloneTc s|rfddjD}njdd}j}|D]}||d||<q:d}jrj}|D]}||d||<qltj||jj j j d}||_|S)z Return a clone of this tag. If deep is True, clone all of this tag's children. Otherwise, just shallow copy the children list without copying the children themselves. csg|]}|dqS)Tr(r*rrrr/szTag.clone..NT)rrrr r r ) rrcopykeysr)rrrrr r r )r r.Z newchildrenZnewattrskeyZ newslotdataZnewtagrrrr's,   z Tag.clonecCs g|_|S)z< Clear any existing children from this tag. )rrrrrclearsz Tag.clearcCs:d}|jr|d|j7}|jr,|d|j7}d|j|fS)Nz, attributes=%rz , children=%rz Tag(%r%s))rrr)r Zrstrrrrrs z Tag.__repr__)NNNNNN)T)rrrrrr r r rrr&r)r'r8rrrrrrLs - & !r)ZimgbrZhrbasemetalinkZparamZareainputcolZbasefontZisindexframeZcommandZembedZkeygensourceZtrackZwbsc@s eZdZdZddZddZdS)CDATAa A C{} block from a template. Given a separate representation in the DOM so that they may be round-tripped through rendering without losing information. @ivar data: The data between "C{}". @type data: C{unicode} cCs ||_dSrdatar rDrrrrszCDATA.__init__cCs d|jfS)Nz CDATA(%r)rCrrrrr"szCDATA.__repr__NrrrrrrBsrBc@s eZdZdZddZddZdS)Commenta  A C{} comment from a template. Given a separate representation in the DOM so that they may be round-tripped through rendering without losing information. @ivar data: The data between "C{}". @type data: C{unicode} cCs ||_dSrrCrErrrr1szComment.__init__cCs d|jfS)Nz Comment(%r)rCrrrrr5szComment.__repr__NrrrrrrF's rFc@s eZdZdZddZddZdS)CharRefa% A numeric character reference. Given a separate representation in the DOM so that non-ASCII characters may be output as pure ASCII. @ivar ordinal: The ordinal value of the unicode character to which this is object refers. @type ordinal: C{int} @since: 12.0 cCs ||_dSrordinal)r rIrrrrEszCharRef.__init__cCs d|jfS)Nz CharRef(%d)rHrrrrrIszCharRef.__repr__NrrrrrrG:s rGN) rZ __future__rrZtwisted.python.compatrobjectrrZ voidElementsrBrFrGrrrrs .E