-spec decode(SchemaName :: atom(), Binary :: binary(), Options :: [parthenon_decode:option()]) ->
          {ok, parthenon_decode:value()} | {error, term()}.

Parse the raw Athena structure with the specified schema and apply the specified options.

The supported options are:

• object_format: Specify the format of the objects.
  • maps (default): return objects as maps
  • proplists: return objects as proplists
  • tuple will return objects in the {[{<key>, <value>}]} format
• key_format: Specify the format of the keys.
  • atom: return the keys as atoms
  • binary will return the keys as binary.
  • existing_atom (default): return the keys as atoms if they already exists or return them into binary if they do not
• schema_options: Specify options to be passed to the schema.
  • null_as: Specify what value to use for null values. Accept atom() or binary()

Example usage:

  %% Register the `point' schema into the registry
  ok = parthenon:add_schema(point, <<"struct<x: int, y: int, z: int>">>).
 
  %% Register the `coordinates' schema into the registry
  ok = parthenon:add_schema(coordinates, <<"array<struct<x: int, y: int, z: int>>">>).
 
  %% Decode the `point' structure into a map with binary keys
  {ok, #{<<"x">> := 3, <<"y">> := 2, <<"z">> := 4}} = parthenon:decode(
      point, <<"{x=3, y=2, z=4}">>, [{key_format, binary}, {object_format, maps}]
  ).
 
  %% Decode the `coordinates' array into a list of maps with binary keys
  {ok, [#{<<"x">> := 3, <<"y">> := 2, <<"z">> := 4}, #{<<"x">> := 5, <<"y">> := 6, <<"z">> := 7}]} = parthenon:decode(
       coordinates, <<"[{x=3, y=2, z=4}, {x=5, y=6, z=7}]">>, [
           {key_format, binary}, {object_format, maps}
       ]
   ).