View Source RDF.Serialization.Decoder behaviour (RDF.ex v2.0.0)

A behaviour for decoders of strings encoded in a specific RDF.Serialization format.

Summary

Callbacks

Decodes a serialized RDF.Graph or RDF.Dataset from a string.

Decodes a serialized RDF.Graph or RDF.Dataset from a string.

Decodes a serialized RDF.Graph or RDF.Dataset from a string.

Decodes a serialized RDF.Graph or RDF.Dataset from a string.

Decodes a serialized RDF.Graph or RDF.Dataset from a stream.

Decodes a serialized RDF.Graph or RDF.Dataset from a stream.

Callbacks

@callback decode(String.t()) :: {:ok, RDF.Graph.t() | RDF.Dataset.t()} | {:error, any()}

Decodes a serialized RDF.Graph or RDF.Dataset from a string.

It returns an {:ok, data} tuple, with data being the deserialized graph or dataset, or {:error, reason} if an error occurs.

@callback decode(
  String.t(),
  keyword()
) :: {:ok, RDF.Graph.t() | RDF.Dataset.t()} | {:error, any()}

Decodes a serialized RDF.Graph or RDF.Dataset from a string.

It returns an {:ok, data} tuple, with data being the deserialized graph or dataset, or {:error, reason} if an error occurs.

@callback decode!(String.t()) :: RDF.Graph.t() | RDF.Dataset.t()

Decodes a serialized RDF.Graph or RDF.Dataset from a string.

As opposed to decode/2, it raises an exception if an error occurs.

Note: The __using__ macro automatically provides an overridable default implementation based on the non-bang decode function.

@callback decode!(
  String.t(),
  keyword()
) :: RDF.Graph.t() | RDF.Dataset.t()

Decodes a serialized RDF.Graph or RDF.Dataset from a string.

As opposed to decode/2, it raises an exception if an error occurs.

Note: The __using__ macro automatically provides an overridable default implementation based on the non-bang decode function.

Link to this callback

decode_from_stream(t, keyword)

View Source (optional)
@callback decode_from_stream(
  Enumerable.t(),
  keyword()
) :: {:ok, RDF.Graph.t() | RDF.Dataset.t()} | {:error, any()}

Decodes a serialized RDF.Graph or RDF.Dataset from a stream.

It returns an {:ok, data} tuple, with data being the deserialized graph or dataset, or {:error, reason} if an error occurs.

Link to this callback

decode_from_stream!(t, keyword)

View Source (optional)
@callback decode_from_stream!(
  Enumerable.t(),
  keyword()
) :: RDF.Graph.t() | RDF.Dataset.t()

Decodes a serialized RDF.Graph or RDF.Dataset from a stream.

As opposed to decode_from_stream/2, it raises an exception if an error occurs.

Note: The __using__ macro automatically provides an overridable default implementation based on the non-bang decode function.