HR-ehddlZddlZddlZddlmZddgZGddZGddeZdS)N)IORegistryErrorUnifiedReadWriteMethodUnifiedReadWritec@eZdZdZddZedZddZddZdS) raBase class for the worker object used in unified read() or write() methods. This lightweight object is created for each `read()` or `write()` call via ``read`` / ``write`` descriptors on the data object class. The key driver is to allow complete format-specific documentation of available method options via a ``help()`` method, e.g. ``Table.read.help('fits')``. Subclasses must define a ``__call__`` method which is what actually gets called when the data object ``read()`` or ``write()`` method is called. For the canonical example see the `~astropy.table.Table` class implementation (in particular the ``connect.py`` module there). Parameters ---------- instance : object Descriptor calling instance or None if no instance cls : type Descriptor calling class (either owner class or instance class) method_name : str Method name, e.g. 'read' or 'write' registry : ``_UnifiedIORegistryBase`` or None, optional The IO registry. NcN|ddlm}||_||_||_||_dS)Nr)default_registry)astropy.io.registry.compatr _registry _instance_cls _method_name)selfinstancecls method_nameregistrys =lib/python3.11/site-packages/astropy/io/registry/interface.py__init__zUnifiedReadWrite.__init__)s=   O O O O O O!! 'c|jS)zUnified I/O registry instance.)r )rs rrzUnifiedReadWrite.registry2s ~rcd|j}|j}|dkr |jjn |jj} |r |||}|r|jd|d|d}|j}n"|jd|d}t||j}tj dd|} | |z } | tj dd|z } | tj z } || tj |z } n)#t$r} dt| z} Yd} ~ nd} ~ wwxYw|d dl} | | dS|| dS) aOutput help documentation for the specified unified I/O ``format``. By default the help output is printed to the console via ``pydoc.pager``. Instead one can supplied a file handle object as ``out`` and the output will be written to that handle. Parameters ---------- format : str Unified I/O format name, e.g. 'fits' or 'ascii.ecsv' out : None or path-like Output destination (default is stdout via a pager) read.z (format='z') documentation z general documentation =NzERROR: r)r rr get_reader get_writer__name____doc__getattrresuboslinesepinspectcleandocrstrpydocpagerwrite) rformatoutrrget_funcread_write_funcheaderdoc reader_docerrr(s rhelpzUnifiedReadWrite.help7si' f$$ N % %*   4 8"*(63"7"7 8|VVkVVFVVV&- LPP;PPPc;//7S&11J & J "&c622 2J "* $Jg.s333 ' . . ."SXX-JJJJJJ .* ; LLL KK # # # # # IIj ! ! ! ! !sC C;C66C;c(|j|j|j}|d=||ddn=|d|dd|S)zPrint a list of available formats to console (or ``out`` filehandle). out : None or file handle object Output destination (default is stdout via a pager) z Data classN) max_lines max_width ) r get_formatsr r capitalizepprintr*joinpformat)rr,tbls r list_formatszUnifiedReadWrite.list_formatsms n((D4E4P4P4R4RSS   ; JJrJ 2 2 2 2 IIdii bB G GHH I I I rN)NN) r __module__ __qualname__rrpropertyrr3r?rrrrsv2((((X4"4"4"4"lrceZdZdZdZdS)raDescriptor class for creating read() and write() methods in unified I/O. The canonical example is in the ``Table`` class, where the ``connect.py`` module creates subclasses of the ``UnifiedReadWrite`` class. These have custom ``__call__`` methods that do the setup work related to calling the registry read() or write() functions. With this, the ``Table`` class defines read and write methods as follows:: read = UnifiedReadWriteMethod(TableRead) write = UnifiedReadWriteMethod(TableWrite) Parameters ---------- func : `~astropy.io.registry.UnifiedReadWrite` subclass Class that defines read or write functionality c.|||Sr@)fget)rr owner_clss r__get__zUnifiedReadWriteMethod.__get__syy9---rN)rrArBrrIrDrrrrs-2.....r) r%r#r!baser__all__rrCrrDrrrLs !!!!!! #%7 8 lllllllld.....X.....r