σ šίΘ[c@`sϋdZddlmZmZmZmZddlmZddlZddl Z ddl Z ddl m Z dd d gZ ejd „ƒZdd „ZeZyddl mZejZWnek rΟnXejed„ƒZd„Zd„ZdS(u8 This module includes a fast iterator-based XML parser. i(tabsolute_importtdivisiontprint_functiontunicode_literalsi(tsixNi(tdatauget_xml_iteratoruget_xml_encodingu xml_readlinescc`s€tj|ƒr|VdStj|ddƒq}tjjdƒrM|jVnMtjrxt |t ƒrm|Vqš|jVn"t |t j ƒr’|Vn|jVWdQXdS(uμ Returns a function suitable for streaming input, or a file object. This function is only useful if passing off to C code where: - If it's a real file object, we want to use it as a real C file object to avoid the Python overhead. - If it's not a real file object, it's much handier to just have a Python function to call. This is somewhat quirky behavior, of course, which is why it is private. For a more useful version of similar behavior, see `astropy.utils.misc.get_readable_fileobj`. Parameters ---------- fd : object May be: - a file object. If the file is uncompressed, this raw file object is returned verbatim. Otherwise, the read method is returned. - a function that reads from a stream, in which case it is returned verbatim. - a file path, in which case it is opened. Again, like a file object, if it's uncompressed, a raw file object is returned, otherwise its read method. - an object with a :meth:`read` method, in which case that method is returned. Returns ------- fd : context-dependent See above. Ntencodingubinaryuwin( RtcallableRtget_readable_fileobjtsystplatformt startswithtreadtPY2t isinstancetfiletiotFileIO(tfdtnew_fd((s;lib/python2.7/site-packages/astropy/utils/xml/iterparser.pyt_convert_to_fd_or_read_functions)   i c #`s+ddlm}tj|ƒs+|j}n|}g‰g‰‡‡‡fd†}‡‡‡fd†}|jƒ‰tjrˆtˆ_ntˆ_ |ˆ_ |ˆ_ ˆj ˆ_ ˆj}||ƒ}x=|r||tƒxˆD] }|VqαWˆ2||ƒ}qΗW|dtƒxˆD] }|VqWdS(Ni(texpatc`s-ˆjt||ˆjˆjffƒˆ2dS(N(tappendtTruetCurrentLineNumbertCurrentColumnNumber(tnametattr(tparsertqueuettext(s;lib/python2.7/site-packages/astropy/utils/xml/iterparser.pytstart]sc`s8ˆjt|djˆƒjƒˆjˆjffƒdS(Nu(RtFalsetjointstripRR(R(RRR(s;lib/python2.7/site-packages/astropy/utils/xml/iterparser.pytendbsu(t xml.parsersRRRR t ParserCreateR Rtreturns_unicodetspecified_attributestStartElementHandlertEndElementHandlerRtCharacterDataHandlertParseR ( Rt buffersizeRR RR#R+Rtelem((RRRs;lib/python2.7/site-packages/astropy/utils/xml/iterparser.pyt_fast_iterparseRs4                i(t _iterparsercc`sEt|ƒ3}|r$t|ƒ}n t|ƒ}t|ƒVWdQXdS(u– Returns an iterator over the elements of an XML file. The iterator doesn't ever build a tree, so it is much more memory and time efficient than the alternative in ``cElementTree``. Parameters ---------- fd : readable file-like object or read function Returns ------- parts : iterator The iterator returns 4-tuples (*start*, *tag*, *data*, *pos*): - *start*: when `True` is a start element event, otherwise an end element event. - *tag*: The name of the element - *data*: Depends on the value of *event*: - if *start* == `True`, data is a dictionary of attributes - if *start* == `False`, data is a string containing the text content of the element - *pos*: Tuple (*line*, *col*) indicating the source of the event. N(Rt_slow_iterparseR.titer(tsourcet_debug_python_based_parserRtcontext((s;lib/python2.7/site-packages/astropy/utils/xml/iterparser.pytget_xml_iterator†s " cC`set|ƒD}tj|ƒ\}}}}| s=|dkrLtdƒ‚nWdQX|jdƒpddS(uΣ Determine the encoding of an XML file by reading its header. Parameters ---------- source : readable file-like object, read function or str path Returns ------- encoding : str uxmluInvalid XML fileNuencodinguutf-8(R5RtnexttIOErrortget(R2titeratorRttagRtpos((s;lib/python2.7/site-packages/astropy/utils/xml/iterparser.pytget_xml_encoding°s cC`sGt|ƒ}tj|d|ƒ }|jdƒ|jƒ}WdQX|S(u Get the lines from a given XML file. Correctly determines the encoding and always returns unicode. Parameters ---------- source : readable file-like object, read function or str path Returns ------- lines : list of unicode RiN(R<RRtseekt readlines(R2Rtinputt xml_lines((s;lib/python2.7/site-packages/astropy/utils/xml/iterparser.pyt xml_readlinesΕs  i(t__doc__t __future__RRRRtexternRt contextlibRR tRt__all__tcontextmanagerRR.R0R/t IterParsert ImportErrorR R5R<RA(((s;lib/python2.7/site-packages/astropy/utils/xml/iterparser.pyts&"   = ,  )