U e{j@sNddlZddlZddlZddlmZddgZGdddZGdddeZdS)N)IORegistryErrorUnifiedReadWriteMethodUnifiedReadWritec@s:eZdZdZd ddZeddZd ddZd d d ZdS)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. NcCs0|dkrddlm}||_||_||_||_dS)Nr)default_registry)Zastropy.io.registry.compatr _registryZ _instance_cls _method_name)selfinstancecls method_nameregistryr\/var/www/html/bwave/python/venv/lib/python3.8/site-packages/astropy/io/registry/interface.py__init__)s  zUnifiedReadWrite.__init__cCs|jS)zUnified I/O registry instance.)r)r rrrr2szUnifiedReadWrite.registryc Cs|j}|j}|dkr|jjn|jj}z|r4|||}Wn.tk rd}zdt|}W5d}~XYnX|r|jd|d|d} |j} n|jd|d} t ||j} t dd| }|| 7}|t dd| 7}|t j 7}| dk r|t| 7}|dkrd dl} | |n ||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) readzERROR: N.z (format='z') documentation z general documentation =r)rr rZ get_readerZ get_writerrstr__name____doc__getattrresuboslinesepinspectcleandocpydocpagerwrite) r formatoutr r Zget_funcZread_write_funcerrZ reader_docheaderdocrrrrhelp7s6     zUnifiedReadWrite.helpcCsR|j|j|j}|d=|dkr4|jdddn|d|jddd|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 ) rZ get_formatsrr capitalizepprintr!joinpformat)r r#Ztblrrr list_formatsms zUnifiedReadWrite.list_formats)N)NN)N) r __module__ __qualname__rrpropertyrr'r0rrrrrs    6c@seZdZdZddZdS)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 cCs |||S)N)fget)r r Z owner_clsrrr__get__szUnifiedReadWriteMethod.__get__N)rr1r2rr5rrrrrs) rrrbaser__all__rr3rrrrrs  r