delay_doc_updates

astropy.io.registry.delay_doc_updates(cls)[source]

Contextmanager to disable documentation updates when registering reader and writer. The documentation is only built once when the contextmanager exits.

New in version 1.3.

Parameters
clsclass

Class for which the documentation updates should be delayed.

Notes

Registering multiple 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__.