ó šßÈ[c @`súddlmZmZmZmZddlZddlZddlZddlm Z ddl m Z ddl Z ddlmZddlmZdd d d d d dddddg Zd gZe ƒZe ƒZe ƒZejZyddlZWnek reZnXeZeejf7Zdefd„ƒYZ e!ƒZ"ej#d„ƒZ$ddd„Z&d„Z'ed„Z(d„Z)ed„Z*d„Z+ed„Z,d„Z-d„Z.d„Z/d „Z0d!„Z1d"„Z2d#„Z3d$„Z4d%„Z5dS(&i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(t OrderedDict(t itemgetteri(tsix(tzipuregister_readeruregister_writeruregister_identifieruidentify_formatu get_readeru get_writerureaduwriteu get_formatsuIORegistryErrorudelay_doc_updatestIORegistryErrorcB`seZdZRS(u'Custom error for registry clashes. (t__name__t __module__t__doc__(((s2lib/python2.7/site-packages/astropy/io/registry.pyR(scc`s=tj|ƒdVtj|ƒt|dƒt|dƒdS(uÔContextmanager to disable documentation updates when registering reader and writer. The documentation is only built once when the contextmanager exits. .. versionadded:: 1.3 Parameters ---------- cls : class Class for which the documentation updates should be delayed. Notes ----- Registering mutliple readers and writers can cause significant overhead because the documentation of the corresponding ``read`` and ``write`` methods are build every time. .. warning:: This contextmanager is experimental and may be replaced by a more general approach. Examples -------- see for example the source code of ``astropy.table.__init__``. Nureaduwrite(t_delayed_docs_classestaddtdiscardt_update__doc__(tcls((s2lib/python2.7/site-packages/astropy/io/registry.pytdelay_doc_updates4s    c C`sddlm}tttƒttƒBdtdƒƒ}g}xÙ|D]Ñ}|dk rtt||d|ƒ rtqEn|tkr†dnd}|tkrždnd}|t kr¶dnd}d|d|df} | |krædnd } |j |dj |d|||| fƒqEW|dk r¥|d kr^g|D]} | ddkr9| ^q9}q¥|d kr–g|D]} | d dkrq| ^qq}q¥t d ƒ‚n|rØt tt|dtdddƒƒŒƒ} nd} || ddƒ} tj| ddkƒs| jdƒn| S(uä Get the list of registered I/O formats as a Table. Parameters ---------- data_class : classobj, optional Filter readers/writer to match data class (default = all classes). readwrite : str or None, optional Search only for readers (``"Read"``) or writers (``"Write"``). If None search for both. Default is None. .. versionadded:: 1.3 Returns ------- format_table : Table Table of available I/O formats. i(tTabletkeyiiuYesuNouascii.uuReaduWriteiuQunrecognized value for "readwrite": {0}. Allowed are "Read" and "Write" and None.itnamesu Data classuFormatu Auto-identifyu DeprecatedN(u Data classuFormatuReaduWriteu Auto-identifyu Deprecated(ttableRtsortedtsett_readerst_writersRtNonet_is_best_matcht _identifierstappendR t ValueErrortlistRtnptanyt remove_column(t data_classt readwriteRtformat_classestrowst format_classthas_readt has_writet has_identifytascii_format_classt deprecatedtrowtdatat format_table((s2lib/python2.7/site-packages/astropy/io/registry.pyt get_formatsXs8(   , ,-  cC`sçd}t||ƒ}t|jtjƒs.dS|jjƒ}gt|ƒD]\}}||krJ|^qJ}|r‹|d}|| }ng|dD]}tjd|ƒ^q–} dt d„| Dƒƒ} t ||j ƒƒ} | j dƒ| j d d d d ƒ} tjd d| dƒ} | | d<| jd| ƒ| j| ƒd| jkrp| jdddgƒn|dg| } |jg| D]}| |^qƒydj|ƒ|_Wn&tk râdj|ƒ|j_nXdS(uŸ Update the docstring to include all the available readers / writers for the ``data_class.read`` or ``data_class.write`` functions (respectively). u#The available built-in formats are:Niiu(\S)u cs`s!|]}|r|jƒVqdS(N(tstart(t.0tmatch((s2lib/python2.7/site-packages/astropy/io/registry.pys ¶su Data classt max_linesiÿÿÿÿt max_widthiPu-u=u DeprecateduuZDeprecated format names like ``aastex`` will be removed in a future version. Use the full u%name (e.g. ``ascii.aastex``) instead.u (tgetattrt isinstanceR Rt string_typest splitlinest enumeratetretsearchtminR0t capitalizeR"tpformattsubtinsertRtcolnamestextendtjointAttributeErrort__func__(R#R$t FORMATS_TEXTtclass_readwrite_functlinestiitlinet sep_indicest chop_indextmatchest left_indentR/t new_linest table_rst_sep((s2lib/python2.7/site-packages/astropy/io/registry.pyRœs81  )     $ cC`sf||ftks|r+|t||f>> def my_identifier(*args, **kwargs): ... return (isinstance(args[0], basestring) and ... args[0].endswith('.tbl')) >>> register_identifier('ipac', Table, my_identifier) u>Identifier for format '{0}' and class '{1}' is already definedN(RRRRR (RSR#t identifierRU((s2lib/python2.7/site-packages/astropy/io/registry.pytregister_identifier=s . cC`sG||ftkr(tj||fƒntdj||jƒƒ‚dS(uØ Unregister an identifier function Parameters ---------- data_format : str The data format identifier. data_class : classobj The class of the object that can be read/written. u6No identifier defined for format '{0}' and class '{1}'N(RRWRRRR (RSR#((s2lib/python2.7/site-packages/astropy/io/registry.pytunregister_identifierss  c C`shg}x[tD]S\}}t||tƒr t||f|||||Žr`|j|ƒq`q q W|S(u­Loop through identifiers to see which formats match. Parameters ---------- origin : str A string ``"read`` or ``"write"`` identifying whether the file is to be opened for reading or writing. data_class_required : object The specified class for the result of `read` or the class that is to be written. path : str, other path object or None The path to the file or None. fileobj : File object or None. An open file object to read the file's contents, or ``None`` if the file could not be opened. args : sequence Positional arguments for the `read` or `write` function. Note that these must be provided as sequence. kwargs : dict-like Keyword arguments for the `read` or `write` function. Note that this parameter must be `dict`-like. Returns ------- valid_formats : list List of matching formats. (RRR( torigintdata_class_requiredtpathtfileobjtargstkwargst valid_formatsRSR#((s2lib/python2.7/site-packages/astropy/io/registry.pytidentify_format†s cC`s>t|d|ƒ}|jdƒdj|jddƒƒ}|S(NR$u Data classu R4iÿÿÿÿ(R0R"RDR?(R#R$R/tformat_table_str((s2lib/python2.7/site-packages/astropy/io/registry.pyt_get_format_table_str¬s cC`s™gtD]$\}}||kr||f^q}xa|D],\}}t|||ƒr8t||fSq8Wt|dƒ}tdj||j|ƒƒ‚dS(u”Get reader for ``data_format``. Parameters ---------- data_format : str The data format identifier. This is the string that is used to specify the data type when reading/writing. data_class : classobj The class of the object that can be written. Returns ------- reader : callable The registered reader function for this format and class. uReaduRNo reader defined for format '{0}' and class '{1}'. The available formats are: {2}N(RRRgRRRR (RSR#tfmtRtreaderst reader_formatt reader_classRf((s2lib/python2.7/site-packages/astropy/io/registry.pyt get_reader³s1cC`s™gtD]$\}}||kr||f^q}xa|D],\}}t|||ƒr8t||fSq8Wt|dƒ}tdj||j|ƒƒ‚dS(u”Get writer for ``data_format``. Parameters ---------- data_format : str The data format identifier. This is the string that is used to specify the data type when reading/writing. data_class : classobj The class of the object that can be written. Returns ------- writer : callable The registered writer function for this format and class. uWriteuRNo writer defined for format '{0}' and class '{1}'. The available formats are: {2}N(RRRgRRRR (RSR#RhRtwriterst writer_formatt writer_classRf((s2lib/python2.7/site-packages/astropy/io/registry.pyt get_writerÏs1c O`s|jdd ƒ}d }zÜ|d krZd }d }t|ƒr<t|dtƒrddlm}trœt|dtj ƒrœt |dƒf|d}n|d}y&||dddƒ}|j ƒ}Wn*t k râ‚q9t k rød }q9X|gt|dƒ}q<t|ddƒr<d }|d}q<ntd|||||ƒ}nt||ƒ}|||Ž} t| |ƒsót|| jƒrØy|| ƒ} Wqðt k rÔtd j|jƒƒ‚qðXqótd j|jƒƒ‚nWd |d k r|jtjƒŒnX| S( uV Read in data. The arguments passed to this method depend on the format. uformatii(tget_readable_fileobjitencodingubinaryureadu-could not convert reader output to {0} class.u#reader should return a {0} instanceN(RWRtlenR7t PATH_TYPESt utils.dataRqt HAS_PATHLIBtpathlibtPathtstrt __enter__tIOErrort ExceptionRthasattrt_get_valid_formatRlt issubclasst __class__t TypeErrorRRR t__exit__tsystexc_info( RRbRcRRtctxR`RaRqtreaderR.((s2lib/python2.7/site-packages/astropy/io/registry.pytreadësN          cO`s|jddƒ}|dkràd}d}t|ƒr¿t|dtƒr–trƒt|dtjƒrƒt|dƒf|d}n|d}d}q¿t |ddƒr¿d}|d}q¿nt d|j ||||ƒ}nt ||j ƒ}||||ŽdS(uX Write out data. The arguments passed to this method depend on the format. uformatiiureaduwriteN( RWRRsR7RtRvRwRxRyR}R~R€Rp(R.RbRcRRR`Ratwriter((s2lib/python2.7/site-packages/astropy/io/registry.pytwrite)s"    cC`sZt||ƒrVd„|Dƒ}x4|jD]&}||kr?tS||kr)tSq)WntS(ud Determine if class2 is the "best" match for class1 in the list of classes. It is assumed that (class2 in classes) is True. class2 is the the best match if: - ``class1`` is a subclass of ``class2`` AND - ``class2`` is the nearest ancestor of ``class1`` that is in classes (which includes the case that ``class1 is class2``) cS`sh|]\}}|’qS(((R2RhR((s2lib/python2.7/site-packages/astropy/io/registry.pys Ss (Rt__mro__tTruetFalse(tclass1tclass2R%tclassestparent((s2lib/python2.7/site-packages/astropy/io/registry.pyRHs    cC`s§t||||||ƒ}t|ƒdkrZt||jƒƒ}tdj|ƒƒ‚nEt|ƒdkrŸtdjdjt|dtdƒƒƒƒƒ‚n|dS(uˆ Returns the first valid format that can be used to read/write the data in question. Mode can be either 'read' or 'write'. iu>Format could not be identified. The available formats are: {0}iu&Format is ambiguous - options are: {0}u, R( ReRsRgR>RRRRDRR(tmodeRR`RaRbRcRdRf((s2lib/python2.7/site-packages/astropy/io/registry.pyR~\s *(6t __future__RRRRt contextlibR;Rƒt collectionsRtoperatorRtnumpyR texternRtextern.six.movesRt__all__t__doctest_skip__RRRR8RtRwt ImportErrorRŒRvR‹RxR|RRR tcontextmanagerRRR0RRVRXRYRZR\R]ReRgRlRpR‡R‰RR~(((s2lib/python2.7/site-packages/astropy/io/registry.pytsR"             $D ;     6  &    >