U e»{jµ(ã@shdZddlZddlZzddlmZWn$ek rHdd„Zdd„ZYnXejZej ZGd d „d ƒZ dS) zZ Contains a class that makes it simple to stream out well-formed and nicely-indented XML. éNé)Ú _iterparsercCs(| dd¡}| dd¡}| dd¡}|S)z< Escapes &, < and > in an XML CDATA string. ú&ú&ú<ú<ú>ú>©Úreplace©Ús©rúW/var/www/html/bwave/python/venv/lib/python3.8/site-packages/astropy/utils/xml/writer.pyÚxml_escape_cdatas   rcCs@| dd¡}| dd¡}| dd¡}| dd¡}| d d ¡}|S) zE Escapes &, ', ", < and > in an XML attribute value. rrú'z'ú"z"rrrr r r rrrÚ xml_escapes      rc@s¨eZdZdZdd„Zd#dd„Zifdd „Zejd$d d „ƒZ ejifd d„ƒZ dd„Z dd„Z d%dd„Z dd„Zddifdd„Zdd„Zdd„Zd&dd „Zed!d"„ƒZdS)'Ú XMLWriteraN A class to write well-formed and nicely indented XML. Use like this:: w = XMLWriter(fh) with w.tag('html'): with w.tag('body'): w.data('This is the content') Which produces:: This is the content cCsB|j|_t|dƒr|j|_d|_g|_g|_d|_t|_t|_dS)zQ Parameters ---------- file : writable file-like Úflushrz@ N) ÚwriteÚhasattrrÚ_openÚ_tagsÚ_dataÚ _indentationrr)ÚselfÚfilerrrÚ__init__<s zXMLWriter.__init__TFcCs¤|jr&|r| d¡n | d¡d|_|jr d |j¡}|rŠ| d¡}tj|||d}| d¡| | |¡¡| d¡| | ¡¡n| | |¡¡g|_dS) z) Flush internal buffers. ú> rrÚr)Úinitial_indentÚsubsequent_indentÚ N)rrrÚjoinÚget_indentation_spacesÚtextwrapÚfillr)rÚindentÚwrapÚdatarrrÚ_flushMs(    ÿ  zXMLWriter._flushcKs°| ¡g|_|j |¡| | d¡¡| d|›¡|sB|r | ¡}| |¡t|  ¡ƒ}|  ¡|D]2\}}|dk rl|  |¡}| d|›d|›d¡qld|_ t |jƒS)am Opens a new element. Attributes can be given as keyword arguments, or as a string/string dictionary. The method returns an opaque identifier that can be passed to the :meth:`close` method, to close all open elements up to and including this one. Parameters ---------- tag : str The element name attrib : dict of str -> str Attribute dictionary. Alternatively, attributes can be given as keyword arguments. Returns ------- id : int Returns an element identifier. éÿÿÿÿrNú z="rr)r+rrÚappendrr%ÚcopyÚupdateÚlistÚitemsÚsortrrÚlen)rÚtagÚattribÚextraÚkÚvrrrÚstartfs      zXMLWriter.startÚ escape_xmlc+sŠ|j}|dkrVz ddl‰Wntk r6tdƒ‚YnXˆdkrDi‰‡‡fdd„|_n$|dkrjdd„|_n|d krztd ƒ‚dV||_dS) a[Context manager to control how XML data tags are cleaned (escaped) to remove potentially unsafe characters or constructs. The default (``method='escape_xml'``) applies brute-force escaping of certain key XML characters like ``<``, ``>``, and ``&`` to ensure that the output is not valid XML. In order to explicitly allow certain XML tags (e.g. link reference or emphasis tags), use ``method='bleach_clean'``. This sanitizes the data string using the ``clean`` function of the `bleach `_ package. Any additional keyword arguments will be passed directly to the ``clean`` function. Finally, use ``method='none'`` to disable any sanitization. This should be used sparingly. Example:: w = writer.XMLWriter(ListWriter(lines)) with w.xml_cleaning_method('bleach_clean'): w.start('td') w.data('google.com') w.end() Parameters ---------- method : str Cleaning method. Allowed values are "escape_xml", "bleach_clean", and "none". **clean_kwargs : keyword args Additional keyword args that are passed to the bleach.clean() function. Z bleach_cleanrNzTbleach package is required when HTML escaping is disabled. Use "pip install bleach".csˆj|fˆŽS©N)Úclean©Úx©ÚbleachÚ clean_kwargsrrÚÆóz/XMLWriter.xml_cleaning_method..ÚnonecSs|Sr<rr>rrrrCÈrDr;zEallowed values of method are "escape_xml", "bleach_clean", and "none")rrAÚ ImportErrorÚ ValueError)rÚmethodrBZcurrent_xml_escape_cdatarr@rÚxml_cleaning_method’s&% ÿ  ÿzXMLWriter.xml_cleaning_methodcks$|j||f|ŽdV| |¡dS)aU A convenience method for creating wrapper elements using the ``with`` statement. Examples -------- >>> with writer.tag('foo'): # doctest: +SKIP ... writer.element('bar') ... # is implicitly closed here ... Parameters are the same as to `start`. N)r:Úend)rr5r6r7rrrr5Òsz XMLWriter.tagcCs2| ¡| | ¡¡| d| |¡›d¡dS)z¢ Adds a comment to the output stream. Parameters ---------- comment : str Comment text, as a Unicode string. z N)r+rr%r)rÚcommentrrrrKæs zXMLWriter.commentcCs|j |¡dS)z¦ Adds character data to the output stream. Parameters ---------- text : str Character data, as a Unicode string. N)rr.)rÚtextrrrr*ós zXMLWriter.dataNcCs²|rD|jstd|›dƒ‚||jdkrRtd|jd›d|›ƒ‚n|jsRtdƒ‚|j ¡}|jrp| ||¡n|jrŠd|_| d¡d S|rœ| | ¡¡| d |›d ¡d S) a Closes the current element (opened by the most recent call to `start`). Parameters ---------- tag : str Element name. If given, the tag must match the start tag. If omitted, the current element is closed. zunbalanced end(ú)r,z expected end(z), got zunbalanced end()rz/> Nzsz XMLWriter.get_indentation_spacescCs:i}|D],}t||ƒdk rtt||ƒƒ|| dd¡<q|S)a Converts an object with a bunch of attributes on an object into a dictionary for use by the `XMLWriter`. Parameters ---------- obj : object Any Python object attrs : sequence of str Attribute names to pull from the object Returns ------- attrs : dict Maps attribute names to the values retrieved from ``obj.attr``. If any of the attributes is `None`, it will not appear in the output dictionary. NÚ_ú-)ÚgetattrÚstrr )ÚobjÚattrsÚdÚattrrrrÚ object_attrsEs zXMLWriter.object_attrs)TF)r;)NTF)r)Ú__name__Ú __module__Ú __qualname__Ú__doc__rr+r:Ú contextlibÚcontextmanagerrIr5rKr*rJrPrQrrSr%Ú staticmethodr]rrrrr(s$  , ?     r) rarbr&r rrFrrZescape_xml_cdatar;rrrrrÚs