ó šßÈ[c@`sãdZddlmZmZmZmZddlmZddlZddl Z yddl Z e Z Wne k reZ nXyddlmZWn#e k r¹d„Zd „ZnXejZejZd d d „ƒYZdS( uZ Contains a class that makes it simple to stream out well-formed and nicely-indented XML. i(tabsolute_importtdivisiontprint_functiontunicode_literalsi(tsixNi(t _iterparsercC`s:|jddƒ}|jddƒ}|jddƒ}|S(u< Escapes &, < and > in an XML CDATA string. u&u&uu>(treplace(ts((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pytxml_escape_cdatascC`s^|jddƒ}|jddƒ}|jddƒ}|jddƒ}|jd d ƒ}|S( uE Escapes &, ', ", < and > in an XML attribute value. u&u&u'u'u"u"uu>(R(R((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pyt xml_escape s t XMLWritercB`sÈeZdZd„Zeed„Zid„Zej dd„ƒZ ej id„ƒZ d„Z d„Z deed „Zd „Zdeid „Zd „Zd „Zdd„Zed„ƒZRS(uN 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 cC`sh|j|_t|dƒr*|j|_nd|_g|_g|_dd|_t|_t|_dS(uY Parameters ---------- file : writable file-like object. uflushiu i@N( twritethasattrtflusht_opent_tagst_datat _indentationRR (tselftfile((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pyt__init__Cs      cC`sï|jr8|r|jdƒn |jdƒd|_n|jrëdj|jƒ}|rÉ|jdƒ}tj|d|d|ƒ}|jdƒ|j|j|ƒƒ|jdƒ|j|jƒƒn|j|j|ƒƒg|_nd S( u) Flush internal buffers. u> u>iuitinitial_indenttsubsequent_indentu N(RR Rtjointget_indentation_spacesttextwraptfillR(Rtindenttwraptdata((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pyt_flushTs&       cK`sú|jƒg|_|jj|ƒ|j|jdƒƒ|jdj|ƒƒ|s[|rä|jƒ}|j|ƒt t j |ƒƒ}|j ƒxN|D]C\}}|dk rš|j|ƒ}|jdj||ƒƒqšqšWnd|_t|jƒS(um 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. iÿÿÿÿu<{}u {}="{}"iN(RRRtappendR RtformattcopytupdatetlistRt iteritemstsorttNoneR Rtlen(Rttagtattribtextratktv((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pytstartns        # u escape_xmlc+`sœ|j}|dkrTtrEˆdkr0i‰n‡fd†|_qŠtdƒ‚n6|dkrod„|_n|dkrŠtdƒ‚ndV||_dS( uYContext 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 `http://bleach.readthedocs.io/en/latest/clean.html `_ 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. u bleach_cleanc`stj|ˆS(N(tbleachtclean(tx(t clean_kwargs(s7lib/python2.7/site-packages/astropy/utils/xml/writer.pytÅsuTbleach package is required when HTML escaping is disabled. Use "pip install bleach".unonecS`s|S(N((R0((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pyR2Êsu escape_xmluEallowed values of method are "escape_xml", "bleach_clean", and "none"N(Rt HAS_BLEACHR&t ValueError(RtmethodR1tcurrent_xml_escape_cdata((R1s7lib/python2.7/site-packages/astropy/utils/xml/writer.pytxml_cleaning_methodšs%      ck`s)|j|||dV|j|ƒdS(uU 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-tend(RR(R)R*((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pyR(ÒscC`s@|jƒ|j|jƒƒ|jdj|j|ƒƒƒdS(u¢ Adds a comment to the output stream. Parameters ---------- comment : str Comment text, as a Unicode string. u N(RR RR R(Rtcomment((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pyR9æs cC`s|jj|ƒdS(u¦ Adds character data to the output stream. Parameters ---------- text : str Character data, as a Unicode string. N(RR(Rttext((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pyRós cC`sû|r_|js'tdj|ƒƒ‚n||jdkrwtdj|jd|ƒƒ‚qwn|jswtdƒ‚n|jjƒ}|jr¢|j||ƒn#|jrÅd|_|jdƒdS|rá|j|jƒƒn|jdj|ƒƒdS( u 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. uunbalanced end({})iÿÿÿÿuexpected end({}), got {}uunbalanced end()iu/> Nu ( RR4R tpopRRRR R(RR(RR((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pyR8þs$        cC`s*x#t|jƒ|kr%|jƒqWdS(uð Closes open elements, up to (and including) the element identified by the given identifier. Parameters ---------- id : int Element identifier, as returned by the `start` method. N(R'RR8(Rtid((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pytcloses cK`sC|j||||r)|j|ƒn|jdtd|ƒdS(u¤ Adds an entire element. This is the same as calling `start`, `data`, and `end` in sequence. The ``text`` argument can be omitted. RRN(R-RR8tFalse(RR(R:RR)R*((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pytelement*scC`sdS(N((R((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pyR 5scC`s t|jƒS(u\ Returns the number of indentation levels the file is currently in. (R'R(R((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pytget_indentation8sicC`s|jt|jƒ| S(u` Returns a string of spaces that matches the current indentation level. (RR'R(Rtoffset((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pyR?scC`s[i}xN|D]F}t||ƒdk r tjt||ƒƒ||jddƒRR-t contextlibtcontextmanagerR7R(R9RR&R8R=R?R R@Rt staticmethodRH(((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pyR /s"  ,7     ((RKt __future__RRRRtexternRRMRR.RLR3t ImportErrorR>tRRR tescape_xml_cdatat escape_xmlR (((s7lib/python2.7/site-packages/astropy/utils/xml/writer.pyts""