UnifiedOutputRegistry#

class astropy.io.registry.UnifiedOutputRegistry[source]#

Bases: _UnifiedIORegistryBase

Write-only Registry.

Added in version 5.0.

Methods Summary

get_writer(data_format, data_class)

Get writer for data_format.

register_writer(data_format, data_class, ...)

Register a table writer function.

unregister_writer(data_format, data_class)

Unregister a writer function.

write(data, *args[, format])

Write out data.

Methods Documentation

get_writer(data_format, data_class)[source]#

Get writer for data_format.

Parameters:
data_formatstr

The data format identifier. This is the string that is used to specify the data type when reading/writing.

data_classclass

The class of the object that can be written.

Returns:
writercallable()

The registered writer function for this format and class.

register_writer(data_format, data_class, function, force=False, priority=0)[source]#

Register a table writer function.

Parameters:
data_formatstr

The data format identifier. This is the string that will be used to specify the data type when writing.

data_classclass

The class of the object that can be written.

functionfunction

The function to write out a data object.

forcebool, optional

Whether to override any existing function if already present. Default is False.

priorityint, optional

The priority of the writer, used to compare possible formats when trying to determine the best writer to use. Higher priorities are preferred over lower priorities, with the default priority being 0 (negative numbers are allowed though).

unregister_writer(data_format, data_class)[source]#

Unregister a writer function.

Parameters:
data_formatstr

The data format identifier.

data_classclass

The class of the object that can be written.

write(data, *args, format=None, **kwargs)[source]#

Write out data.

Parameters:
dataobject

The data to write.

*args

The arguments passed to this method depend on the format.

formatstr or None
**kwargs

The arguments passed to this method depend on the format.

Returns:
object or None

The output of the registered writer. Most often None.

Added in version 4.3.