Serialization

braket.jobs.serialization.serialize_values(data_dictionary, data_format)

Serializes the data_dictionary values to the format specified by data_format.

Parameters:

• data_dictionary (dict[str, Any]) – Dict whose values are to be serialized.

• data_format (PersistedJobDataFormat) – The data format used to serialize the values. Note that for PICKLED data formats, the values are base64 encoded after serialization, so that they represent valid UTF-8 text and are compatible with PersistedJobData.json().

Return type:

dict[str, Any]

Returns:

dict[str, Any] – Dict with same keys as data_dictionary and values serialized to the specified data_format.

braket.jobs.serialization.deserialize_values(data_dictionary, data_format, allow_pickle=False)

Deserializes the data_dictionary values from the format specified by data_format.

Parameters:

• data_dictionary (dict[str, Any]) – Dict whose values are to be deserialized.

• data_format (PersistedJobDataFormat) – The data format that the data_dictionary values are currently serialized with.

• allow_pickle (bool) – Whether to allow deserialization of pickled data. Pickle deserialization can execute arbitrary code and is unsafe on untrusted data. Default: False.

Return type:

dict[str, Any]

Returns:

dict[str, Any] – Dict with same keys as data_dictionary and values deserialized from the specified data_format to plaintext.

Raises:

RuntimeError – If data format is PICKLED_V4 and allow_pickle is False.