delay_doc_updates

astropy.io.registry.delay_doc_updates(cls)[source] [edit on github]

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:
cls : class

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