RDF.ex v0.7.0 RDF.Serialization View Source

A known format might not be available in an application, when the format is implemented in an external library and this not specified as a Mix dependency of this application.

Examples

iex> RDF.Serialization.available_formats
[RDF.Turtle, RDF.NTriples, RDF.NQuads]

format(name)

Returns the RDF.Serialization.Format with the given name, if available.

Examples

iex> RDF.Serialization.format(:turtle)
RDF.Turtle
iex> RDF.Serialization.format("turtle")
RDF.Turtle
iex> RDF.Serialization.format(:jsonld)
nil  # unless json_ld is defined as a dependency of the application

format_by_extension(extension)

Returns the proper RDF.Serialization.Format for the given file extension, if available.

Examples

iex> RDF.Serialization.format_by_extension("ttl")
RDF.Turtle
iex> RDF.Serialization.format_by_extension(".ttl")
RDF.Turtle
iex> RDF.Serialization.format_by_extension("jsonld")
nil  # unless json_ld is defined as a dependency of the application

format_by_media_type(media_type)

Returns the RDF.Serialization.Format with the given media type, if available.

Examples

iex> RDF.Serialization.format_by_media_type("text/turtle")
RDF.Turtle
iex> RDF.Serialization.format_by_media_type("application/ld+json")
nil  # unless json_ld is defined as a dependency of the application

formats()

The list of all known RDF.Serialization.Formats in the RDF.ex eco-system.

Note: Not all known formats might be available to an application, see available_formats/0.

Examples

iex> RDF.Serialization.formats
[RDF.Turtle, JSON.LD, RDF.NTriples, RDF.NQuads]

read_file(file, opts \\ [])

Reads and decodes a serialized graph or dataset from a file.

The format can be specified with the format option and a format name or the media_type option and the media type of the format. If none of these are given, the format gets inferred from the extension of the given file name.

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

read_file!(file, opts \\ [])

Reads and decodes a serialized graph or dataset from a file.

As opposed to read_file, it raises an exception if an error occurs.

read_string(content, opts)

Reads and decodes a serialized graph or dataset from a string.

The format must be specified with the format option and a format name or the media_type option and the media type of the format.

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

read_string!(content, opts)

Reads and decodes a serialized graph or dataset from a string.

The format must be specified with the format option and a format name or the media_type option and the media type of the format.

As opposed to read_string, it raises an exception if an error occurs.

write_file(data, path, opts \\ [])

Encodes and writes a graph or dataset to a file.

Other available serialization-independent options:

:force - If not set to true, an error is raised when the given file already exists (default: false)
:file_mode - A list with the Elixir File.open modes to be used for writing (default: [:utf8, :write])

It returns :ok if successful or {:error, reason} if an error occurs.

write_file!(data, path, opts \\ [])

Encodes and writes a graph or dataset to a file.

See write_file for a list of other available options.

As opposed to write_file, it raises an exception if an error occurs.

write_string(data, opts)

Encodes and writes a graph or dataset to a string.

The format must be specified with the format option and a format name or the media_type option and the media type of the format.

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

write_string!(data, opts)

Encodes and writes a graph or dataset to a string.

The format must be specified with the format option and a format name or the media_type option and the media type of the format.

As opposed to write_string, it raises an exception if an error occurs.