89 lines
3.6 KiB
Markdown
89 lines
3.6 KiB
Markdown
# RDF.ex
|
|
|
|
[![Travis](https://img.shields.io/travis/marcelotto/rdf-ex.svg?style=flat-square)](https://travis-ci.org/marcelotto/rdf-ex)
|
|
[![Hex.pm](https://img.shields.io/hexpm/v/rdf.svg?style=flat-square)](https://hex.pm/packages/rdf)
|
|
[![Inline docs](http://inch-ci.org/github/marcelotto/rdf-ex.svg)](http://inch-ci.org/github/marcelotto/rdf-ex)
|
|
|
|
|
|
An implementation of the [RDF](https://www.w3.org/TR/rdf11-primer/) data model in Elixir.
|
|
|
|
For more about RDF.ex and it's related projects, go to <https://rdf-elixir.dev>.
|
|
|
|
## Features
|
|
|
|
- fully compatible with the RDF 1.1 specification
|
|
- in-memory data structures for RDF descriptions, RDF graphs and RDF datasets
|
|
- ability to execute SPARQL queries against the in-memory data structures via the [SPARQL.ex] package or against any SPARQL endpoint via the [SPARQL.Client] package
|
|
- support for RDF vocabularies via Elixir modules for safe, i.e. compile-time checked and concise usage of IRIs
|
|
- XML schema datatypes for RDF literals (not yet all supported)
|
|
- sigils for the most common types of nodes, i.e. IRIs, literals, blank nodes and lists
|
|
- a description DSL resembling Turtle in Elixir
|
|
- implementations for the [N-Triples], [N-Quads] and [Turtle] serialization formats
|
|
- [JSON-LD] is implemented in the separate [JSON-LD.ex] package
|
|
|
|
|
|
## Upgrading to RDF.ex 0.6
|
|
|
|
#### `RDF.Graph.new` and `RDF.Dataset.new`
|
|
|
|
The arguments of the constructor functions of `RDF.Graph` and `RDF.Dataset` have changed. They now take the name of the graph resp. dataset as a `name` option. So, for example this
|
|
|
|
```elixir
|
|
RDF.Graph.new(EX.GraphName, data)
|
|
```
|
|
|
|
now has to be written like this
|
|
|
|
```elixir
|
|
RDF.Graph.new(data, name: EX.GraphName)
|
|
```
|
|
|
|
An option argument was needed for the new `prefixes` option and was impossible to provide in a maintainable way with the old interface.
|
|
|
|
See [this section of the guide](https://rdf-elixir.dev/rdf-ex/serializations.html#managing-prefixes) for more on the new prefix management features.
|
|
|
|
#### Equality of graphs and datasets
|
|
|
|
With prefixes being added to the `RDF.Graph` data structure, you can no longer rely on `==` for equality comparisons between graphs and datasets, since graphs with the same data but different prefixes will be unequal in terms of `==`. You should use the new `RDF.Graph.equal?/2` and `RDF.Dataset.equal?/2` functions instead.
|
|
|
|
See [this section of the guide](https://rdf-elixir.dev/rdf-ex/data-structures.html#equality) for more on that.
|
|
|
|
|
|
|
|
## Contributing
|
|
|
|
There's still much to do for a complete RDF ecosystem for Elixir, which means there are plenty of opportunities for you to contribute. Here are some suggestions:
|
|
|
|
- more serialization formats
|
|
- [RDFa]
|
|
- [RDF-XML]
|
|
- [N3]
|
|
- et al.
|
|
- more XSD datatypes
|
|
- improve documentation
|
|
|
|
see [CONTRIBUTING](CONTRIBUTING.md) for details.
|
|
|
|
|
|
## Consulting and Partnership
|
|
|
|
If you need help with your Elixir and Linked Data projects, just contact: <info@cokron.com> or <https://www.cokron.com/kontakt>
|
|
|
|
|
|
|
|
## License and Copyright
|
|
|
|
(c) 2017-2018 Marcel Otto. MIT Licensed, see [LICENSE](LICENSE.md) for details.
|
|
|
|
|
|
[RDF.ex]: https://hex.pm/packages/rdf
|
|
[JSON-LD.ex]: https://hex.pm/packages/json_ld
|
|
[SPARQL.ex]: https://hex.pm/packages/sparql
|
|
[SPARQL.Client]: https://hex.pm/packages/sparql_client
|
|
[N-Triples]: https://www.w3.org/TR/n-triples/
|
|
[N-Quads]: https://www.w3.org/TR/n-quads/
|
|
[Turtle]: https://www.w3.org/TR/turtle/
|
|
[N3]: https://www.w3.org/TeamSubmission/n3/
|
|
[JSON-LD]: http://www.w3.org/TR/json-ld/
|
|
[RDFa]: https://www.w3.org/TR/rdfa-syntax/
|
|
[RDF-XML]: https://www.w3.org/TR/rdf-syntax-grammar/
|