load_asn

jwst.associations.load_asn(serialized, fmt=None, first=True, validate=True, registry=<class 'jwst.associations.registry.AssociationRegistry'>, **kwargs)[source]

Load an Association from a file or object.

Parameters:

  • serialized (object) – The serialized form of the association.

  • fmt (str or None) – The format to force. If None, try all available.

  • first (bool) – A serialization potentially matches many rules. Only return the first successful load.

  • validate (bool) – Validate against the class’s defined schema, if any.

  • registry (AssociationRegistry or None) – The AssociationRegistry to use. If None, no registry is used. Can be passed just a registry class instead of instance.

  • **kwargs (dict) – Other arguments to pass to the load methods defined in the Association.KeyValueRegistry

Returns:

The loaded association.

Return type:

Association object

Raises:

AssociationNotValidError – Cannot create or validate the association.

Notes

The serialized object can be in any format supported by the registered I/O routines. For example, for json and yaml formats, the input can be either a string or a file object containing the string.

If no registry is specified, the default Association.load method is used.