How to Serialize and Deserialize a Spec

Lets start with an example Spec.

>>> from scanspec.specs import Line, Spec
>>> spec = Line("y", 4, 5, 6) * Line("x", 1, 2, 3)

This Spec has a repr that shows its parameters it was instantiated with:

>>> spec
Product(outer=Line(axis='y', start=4, stop=5, num=6), inner=Line(axis='x', start=1, stop=2, num=3))

How to Serialize

We can recursively serialize it to a dictionary:

>>> spec.serialize()
{'Product': {'outer': {'Line': {'axis': 'y', 'start': 4, 'stop': 5, 'num': 6}}, 'inner': {'Line': {'axis': 'x', 'start': 1, 'stop': 2, 'num': 3}}}}

How to Deserialize

We can turn this back into a spec using Spec.deserialize:

>>> Spec.deserialize({'Product': {'outer': {'Line': {'axis': 'y', 'start': 4, 'stop': 5, 'num': 6}}, 'inner': {'Line': {'axis': 'x', 'start': 1, 'stop': 2, 'num': 3}}}})
Product(outer=Line(axis='y', start=4.0, stop=5.0, num=6), inner=Line(axis='x', start=1.0, stop=2.0, num=3))

How to send it over GraphQL

Every Spec lists in its documentation a list of parameters and types. The GraphQL representation is the dictionary of these parameters, wrapped in a dictionary with a single element whose key is the classname. This allows the deserialization code to pick the correct class to deserialize to. For example:

{Line: {axis: "y", start: 4, stop: 5, num: 6}}

You can use Spec.to_gql_input to produce this from an existing spec:

>>> spec.to_gql_input()
'{Product: {outer: {Line: {axis: "y", start: 4, stop: 5, num: 6}}, inner: {Line: {axis: "x", start: 1, stop: 2, num: 3}}}}'