2019-04-02 22:12:42 +00:00
|
|
|
# Changelog
|
2017-06-25 18:33:45 +00:00
|
|
|
|
|
|
|
All notable changes to this project will be documented in this file.
|
|
|
|
This project adheres to [Semantic Versioning](http://semver.org/) and
|
|
|
|
[Keep a CHANGELOG](http://keepachangelog.com).
|
|
|
|
|
2020-09-25 14:07:37 +00:00
|
|
|
|
2020-10-21 10:59:20 +00:00
|
|
|
## Unreleased
|
|
|
|
|
|
|
|
### Added
|
|
|
|
|
|
|
|
- `RDF.PrefixMap.put/3` for adding a prefix mapping and overwrite an existing one
|
|
|
|
|
|
|
|
### Changed
|
|
|
|
|
2020-10-28 10:36:43 +00:00
|
|
|
- more compact Inspect form for `RDF.PrefixMap`
|
|
|
|
- the `RDF.Turtle.Encoder` accepts `RDF.Vocabulary.Namespace` modules as `base`
|
2020-10-21 10:59:20 +00:00
|
|
|
|
|
|
|
|
|
|
|
[Compare v0.9.0...HEAD](https://github.com/rdf-elixir/rdf-ex/compare/v0.9.0...HEAD)
|
|
|
|
|
|
|
|
|
|
|
|
|
2020-10-13 14:09:43 +00:00
|
|
|
## 0.9.0 - 2020-10-13
|
2020-07-03 22:21:01 +00:00
|
|
|
|
2020-09-30 14:38:29 +00:00
|
|
|
The API of the all three RDF datastructures `RDF.Dataset`, `RDF.Graph` and
|
|
|
|
`RDF.Description` were changed, so that the functions taking input data consist only
|
|
|
|
of one field in order to open the possibility of introducing options on these
|
|
|
|
functions. The supported ways with which RDF statements can be passed to the
|
|
|
|
RDF data structures were extended and unified to be supported across all functions
|
|
|
|
accepting input data. This includes also the way in which patterns for BGP queries
|
2020-10-13 14:09:43 +00:00
|
|
|
are specified. Also the performance for adding data has been improved.
|
|
|
|
|
|
|
|
For an introduction on the new data structure API and the commonly supported input formats
|
|
|
|
read the updated [page on the RDF data structures in the guide](https://rdf-elixir.dev/rdf-ex/data-structures.html).
|
|
|
|
For more details on how to migrate from an earlier version read [this wiki page](https://github.com/rdf-elixir/rdf-ex/wiki/Upgrading-to-RDF.ex-0.9).
|
2020-09-30 14:38:29 +00:00
|
|
|
|
|
|
|
|
2020-07-28 12:45:12 +00:00
|
|
|
### Added
|
|
|
|
|
2020-10-09 14:32:24 +00:00
|
|
|
- `RDF.PropertyMap` which allow definition of atoms for RDF properties.
|
|
|
|
Such property maps can be provided to all RDF data structure functions
|
2020-10-13 08:43:05 +00:00
|
|
|
accepting input data and BGP query patterns with the `:context` opt,
|
|
|
|
allowing the use of the atoms from the property map in the input data.
|
2020-10-13 14:09:43 +00:00
|
|
|
- on `RDF.Description`
|
2020-09-28 09:22:46 +00:00
|
|
|
- `RDF.Description.subject/1`
|
|
|
|
- `RDF.Description.change_subject/2`
|
2020-10-13 14:09:43 +00:00
|
|
|
- on `RDF.Graph`
|
2020-09-28 09:22:46 +00:00
|
|
|
- `RDF.Graph.name/1`
|
|
|
|
- `RDF.Graph.change_name/2`
|
|
|
|
- `RDF.Graph.base_iri/1`
|
|
|
|
- `RDF.Graph.prefixes/1`
|
2020-10-09 14:32:24 +00:00
|
|
|
- `RDF.Graph.put_properties/3`
|
2020-10-13 14:09:43 +00:00
|
|
|
- on `RDF.Dataset`
|
2020-09-28 18:48:10 +00:00
|
|
|
- `RDF.Dataset.name/1`
|
|
|
|
- `RDF.Dataset.change_name/2`
|
2020-10-09 14:32:24 +00:00
|
|
|
- `RDF.Dataset.put_properties/3`
|
2020-10-08 09:45:34 +00:00
|
|
|
- `RDF.IRI.append/2`
|
2020-07-28 12:45:12 +00:00
|
|
|
|
2020-07-08 20:02:58 +00:00
|
|
|
### Changed
|
|
|
|
|
2020-09-30 14:38:29 +00:00
|
|
|
- the format for the specification of BGP queries with `RDF.Graph.query/2`,
|
2020-10-04 14:31:41 +00:00
|
|
|
`RDF.Graph.query_stream/2` and `RDF.Query.bgp/1` has been changed to be consistent
|
|
|
|
with the supported formats for input data in the rest of the library
|
2020-09-30 08:47:02 +00:00
|
|
|
- `RDF.Description.new` now requires the `subject` to be passed always as first argument;
|
|
|
|
if you want to add some initial data this must be done with the `:init` option
|
2020-10-04 14:31:41 +00:00
|
|
|
- The `put/3` functions on `RDF.Graph` and `RDF.Dataset` now overwrite all
|
|
|
|
statements with same subject. Previously only statements with the same subject
|
|
|
|
AND predicate were overwritten, which was probably not the expected behaviour,
|
2020-10-09 14:32:24 +00:00
|
|
|
since it's not inline with the common `put` semantics in Elixir.
|
|
|
|
A function with the previous behaviour was added on `RDF.Graph` and `RDF.Dataset`
|
|
|
|
with the `put_properties/3` function.
|
2020-10-04 14:31:41 +00:00
|
|
|
- **CAUTION: This means the `RDF.Graph.put/2` and `RDF.Dataset.put/2` function have become more destructive now when not specified otherwise.**
|
|
|
|
- Note: Although one could argue, that following this route `RDF.Dataset.put/3`
|
|
|
|
would consequently have to overwrite whole graphs, this was not implemented
|
|
|
|
for practical reasons. It's probably not what's wanted in most cases.
|
|
|
|
- The `Access` protocol implementation of `get_and_update/3` on `RDF.Graph` and
|
|
|
|
`RDF.Dataset` previously relied on the `put/2` functions with the old behaviour
|
|
|
|
of overwriting only statements with the same subject and predicate, which was
|
|
|
|
almost never the expected behaviour. This is fixed now by relying on the new
|
|
|
|
`put/2` behaviour.
|
2020-10-10 13:45:25 +00:00
|
|
|
- the `values/2` functions of `RDF.Statement`, `RDF.Triple`, `RDF.Quad`, `RDF.Description`,
|
|
|
|
`RDF.Graph` and `RDF.Dataset` now accept on their second argument an optional
|
|
|
|
`RDF.PropertyMap`which will be used to map predicates accordingly; the variant of
|
|
|
|
these `values/2` functions to provide a custom mapping function was extracted into
|
|
|
|
a new function `map/2` on all of these modules
|
2020-07-08 20:02:58 +00:00
|
|
|
- for consistency reasons the internal `:id` struct field of `RDF.BlankNode` was renamed
|
2020-10-07 14:01:51 +00:00
|
|
|
to `:value`
|
|
|
|
- allow the `base_iri` of `RDF.Vocabulary.Namespace`s to end with a `.` to support
|
2020-10-09 14:32:24 +00:00
|
|
|
vocabularies which use dots in the IRIs for further structuring (eg. CIM-based formats like CGMES)
|
|
|
|
- `RDF.Triple.new/1` now also accepts four-element tuples and simple ignores fourth element
|
|
|
|
- `RDF.Quad.new/1` now also accepts three-element tuples and simple assumes the fourth
|
|
|
|
element to be `nil`
|
2020-09-30 08:47:02 +00:00
|
|
|
|
|
|
|
### Fixed
|
|
|
|
|
2020-09-30 14:38:29 +00:00
|
|
|
- the `put` functions on `RDF.Description`, `RDF.Graph` and `RDF.Dataset` didn't add all
|
|
|
|
statements properly under certain circumstances
|
2020-09-30 08:47:02 +00:00
|
|
|
- `RDF.Graph.put/2` ignores empty descriptions; this should be the final piece to ensure
|
|
|
|
that `RDF.Graph`s never contain empty descriptions, which would distort results of
|
|
|
|
functions like `RDF.Graph.subjects/1`, `RDF.Graph.subject_count/1`, `RDF.Graph.descriptions/1`
|
2020-09-25 14:07:37 +00:00
|
|
|
|
|
|
|
|
2020-10-13 14:09:43 +00:00
|
|
|
[Compare v0.8.2...v0.9.0](https://github.com/rdf-elixir/rdf-ex/compare/v0.8.2...v0.9.0)
|
2020-09-25 14:07:37 +00:00
|
|
|
|
|
|
|
|
2020-07-08 20:02:58 +00:00
|
|
|
|
2020-09-21 12:54:54 +00:00
|
|
|
## 0.8.2 - 2020-09-21
|
2020-07-03 22:21:01 +00:00
|
|
|
|
2020-09-13 20:16:12 +00:00
|
|
|
### Added
|
|
|
|
|
2020-09-13 23:09:46 +00:00
|
|
|
- the Turtle encoder can now produce partial Turtle documents with the `:only` option
|
|
|
|
and any combination of the following values: `:triples`, `:directives`, `:base`, `:prefixes`
|
2020-09-13 20:16:12 +00:00
|
|
|
- the style of the Turtle directives produced by the Turtle encoder can be
|
2020-09-14 13:50:32 +00:00
|
|
|
switched to SPARQL style with the option `:directive_style` and the value `:sparql`
|
|
|
|
- the most common conflict resolution strategies on `RDF.PrefixMap.merge/3` can now
|
|
|
|
be chosen directly with the atoms `:ignore` and `:overwrite`
|
2020-09-15 22:38:56 +00:00
|
|
|
- `RDF.PrefixMap.prefixed_name/2` to convert an IRI to a prefixed name
|
|
|
|
- `RDF.PrefixMap.prefixed_name_to_iri/2` to convert a prefixed name to an IRI
|
2020-09-13 20:16:12 +00:00
|
|
|
|
2020-09-14 14:41:41 +00:00
|
|
|
### Changed
|
|
|
|
|
|
|
|
- when serializing a `RDF.Dataset` with the Turtle encoder the prefixes of all of its graphs
|
2020-09-15 22:38:56 +00:00
|
|
|
are used now
|
2020-07-08 20:02:58 +00:00
|
|
|
|
2020-07-03 22:21:01 +00:00
|
|
|
### Fixed
|
|
|
|
|
|
|
|
- adding an empty `RDF.Description` with a subject to an empty `RDF.Graph` resulted in
|
|
|
|
an invalid non-empty graph ([@pukkamustard](https://github.com/pukkamustard))
|
|
|
|
|
|
|
|
|
2020-09-21 12:54:54 +00:00
|
|
|
[Compare v0.8.1...v0.8.2](https://github.com/rdf-elixir/rdf-ex/compare/v0.8.1...v0.8.2)
|
2020-07-03 22:21:01 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2020-06-16 19:13:21 +00:00
|
|
|
## 0.8.1 - 2020-06-16
|
|
|
|
|
|
|
|
### Added
|
|
|
|
|
|
|
|
- query functions for basic graph pattern matching (incl. streaming-support)
|
|
|
|
|
|
|
|
|
|
|
|
[Compare v0.8.0...v0.8.1](https://github.com/rdf-elixir/rdf-ex/compare/v0.8.0...v0.8.1)
|
|
|
|
|
|
|
|
|
|
|
|
|
2020-06-01 19:33:07 +00:00
|
|
|
## 0.8.0 - 2020-06-01
|
2020-05-08 22:09:31 +00:00
|
|
|
|
2020-06-01 19:33:07 +00:00
|
|
|
RDF literals and their datatypes were completely redesigned to support derived XSD datatypes and
|
|
|
|
allow for defining custom datatypes.
|
2020-06-01 14:43:25 +00:00
|
|
|
For an introduction on how literals work now read the updated [page on literals in the guide](https://rdf-elixir.dev/rdf-ex/literals.html).
|
2020-06-01 15:34:49 +00:00
|
|
|
For more details on how to migrate from an earlier version read [this wiki page](https://github.com/rdf-elixir/rdf-ex/wiki/Upgrading-to-RDF.ex-0.8).
|
2020-06-01 14:43:25 +00:00
|
|
|
|
|
|
|
### Added
|
|
|
|
|
|
|
|
- a lot of new datatypes like `xsd:float`, `xsd:byte` or `xsd:anyURI` -- all numeric XSD datatypes
|
|
|
|
are now available; see [this page of the API documentation](https://hexdocs.pm/rdf/RDF.XSD.Datatype.html#module-builtin-xsd-datatypes)
|
|
|
|
for an up-to-date list of all supported and missing XSD datatypes
|
|
|
|
- an implementation of XSD facet system now makes it easy to define own custom datatypes via
|
|
|
|
restriction of the existing XSD datatypes
|
|
|
|
- `RDF.Literal.update/2` updates the value of a `RDF.Literal` without changing anything else,
|
|
|
|
eg. the language or datatype
|
|
|
|
|
2020-05-08 22:09:31 +00:00
|
|
|
### Changed
|
|
|
|
|
2020-06-01 14:43:25 +00:00
|
|
|
- the `RDF.Literal` struct now consists entirely of a datatype-specific structs in the `literal` field,
|
|
|
|
which besides being more memory-efficient (since literals no longer consist of all possible fields a literal might have),
|
|
|
|
allows pattern matching now on the datatype of literals.
|
|
|
|
- RDF XSD datatypes are now defined in the `RDF.XSD` namespace
|
|
|
|
- alias constructor functions for the XSD datatypes are now defined on `RDF.XSD`
|
|
|
|
- `matches?`, `less_than?`, `greater_than` as higher level functions were removed from the
|
|
|
|
`RDF.Literal.Datatype` modules
|
|
|
|
- `less_than?`, `greater_than?` now always return a boolean and no longer `nil` when incomparable;
|
|
|
|
you can still determine if two terms are comparable by checking if `compare/2` returns `nil`
|
|
|
|
- the `language` option is not supported on the `RDF.XSD.String.new/2` constructor
|
|
|
|
- the `language` option on `RDF.Literal.new/2` is no longer ignored if it's empty (`nil` or `""`),
|
|
|
|
so this either produces an invalid `RDF.LangString` now or, if another `datatype` is provided will
|
|
|
|
fail with an `ArgumentError`
|
|
|
|
- `canonical` now performs implicit coercions when passed plain Elixir values
|
|
|
|
- the inspect format for literals was changed and is now much more informative and uniform, since
|
|
|
|
you now always see the value, the lexical form and if the literal is valid
|
2020-05-08 22:09:31 +00:00
|
|
|
- `RDF.Namespace.resolve_term/1` now returns ok or error tuples, but a new function
|
|
|
|
`RDF.Namespace.resolve_term!/1` with the old behaviour was added
|
2020-06-01 14:43:25 +00:00
|
|
|
- Elixir versions < 1.8 are no longer supported
|
2020-05-08 22:09:31 +00:00
|
|
|
|
2020-05-16 22:01:18 +00:00
|
|
|
### Fixed
|
|
|
|
|
2020-05-19 22:32:20 +00:00
|
|
|
- numeric operations on invalid numeric literals no longer fail, but return `nil` instead
|
2020-06-01 14:43:25 +00:00
|
|
|
- Datetimes preserve the original lexical form of the timezone when casting from a date
|
2020-05-16 22:01:18 +00:00
|
|
|
- BEAM error warnings when trying to use top-level modules as vocabulary terms
|
|
|
|
|
|
|
|
|
2020-06-01 19:33:07 +00:00
|
|
|
[Compare v0.7.1...v0.8.0](https://github.com/rdf-elixir/rdf-ex/compare/v0.7.1...v0.8.0)
|
2020-05-08 22:09:31 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2020-03-11 00:06:12 +00:00
|
|
|
## 0.7.1 - 2020-03-11
|
|
|
|
|
|
|
|
### Added
|
|
|
|
|
|
|
|
- proper typespecs so that Dialyzer passes without warnings ([@rustra](https://github.com/rustra))
|
|
|
|
|
2020-02-14 07:56:14 +00:00
|
|
|
|
|
|
|
### Fixed
|
|
|
|
|
|
|
|
- `RDF.XSD.Time` didn't handle 24h overflows with an offset correctly
|
|
|
|
|
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
[Compare v0.7.0...v0.7.1](https://github.com/rdf-elixir/rdf-ex/compare/v0.7.0...v0.7.1)
|
2020-02-14 07:56:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2019-11-22 15:24:52 +00:00
|
|
|
## 0.7.0 - 2019-11-22
|
2019-10-14 07:13:56 +00:00
|
|
|
|
|
|
|
### Added
|
|
|
|
|
2019-11-19 21:49:00 +00:00
|
|
|
- `RDF.Diff` data structure for diffs between RDF graphs and descriptions
|
2019-10-23 15:31:21 +00:00
|
|
|
- `RDF.Description.update/4` updates the objects of a predicate in a description
|
|
|
|
with a custom update function
|
2019-10-24 20:03:05 +00:00
|
|
|
- `RDF.Graph.update/4` updates the descriptions of a subject in a graph
|
|
|
|
with a custom update function
|
2019-10-14 07:13:56 +00:00
|
|
|
- `RDF.Description.take/2` creates a description from another one by limiting
|
|
|
|
its statements to a set of predicates
|
2019-10-15 15:29:46 +00:00
|
|
|
- `RDF.Graph.take/3` creates a graph from another one by limiting
|
|
|
|
its statements to a set of subjects and optionally also a set of predicates
|
2019-11-02 00:35:09 +00:00
|
|
|
- `RDF.Graph.clear/1` removes the triples from a graph
|
2019-10-14 07:13:56 +00:00
|
|
|
- Mix formatter configuration for using `defvocab` without parens
|
|
|
|
|
|
|
|
|
2019-11-21 21:06:09 +00:00
|
|
|
### Changed
|
|
|
|
|
|
|
|
- `RDF.Serialization.Writer.write_file/4` which is the basis used by all the
|
|
|
|
`write_file/3` and `write_file!/3` functions of all serialization format modules
|
|
|
|
like `RDF.NTriples`, `RDF.Turtle`, `JSON.LD` etc. now opens file in a different
|
|
|
|
mode: it no longer opens them with the [`:utf8` option](https://hexdocs.pm/elixir/File.html#open/2).
|
2019-11-22 15:24:52 +00:00
|
|
|
First, this by default slowed down the writing, but more importantly could lead
|
|
|
|
to unexpected encoding issues.
|
|
|
|
This is a **breaking change**: If your code relied on this file mode, you can
|
|
|
|
get the old behaviour, by specifying the `file_mode` on these functions
|
|
|
|
accordingly as `[:utf8, :write, :exclusive]`. For example, to write a Turtle
|
2019-11-21 21:06:09 +00:00
|
|
|
file with the old behaviour, you can do it like this:
|
|
|
|
|
|
|
|
```elixir
|
|
|
|
RDF.Turtle.write_file!(some_data, some_path, file_mode: ~w[utf8 write exclusive]a)
|
|
|
|
```
|
|
|
|
|
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
[Compare v0.6.2...v0.7.0](https://github.com/rdf-elixir/rdf-ex/compare/v0.6.2...v0.7.0)
|
2019-10-14 07:13:56 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2019-09-08 16:12:10 +00:00
|
|
|
## 0.6.2 - 2019-09-08
|
2019-08-02 22:10:47 +00:00
|
|
|
|
|
|
|
### Added
|
|
|
|
|
|
|
|
- field `base_iri` on `RDF.Graph` structure which can be set via new `base_iri`
|
2020-05-08 22:09:31 +00:00
|
|
|
option on `RDF.Graph.new` or the new functions `RDF.Graph.set_base_iri/2`
|
2019-08-02 22:10:47 +00:00
|
|
|
and `RDF.Graph.clear_base_iri/1`
|
|
|
|
- `RDF.Graph.clear_metadata/1` which clears the base IRI and the prefixes
|
2019-08-08 20:26:07 +00:00
|
|
|
- `RDF.IRI.coerce_base/1` which coerces base IRIs; as opposed to `RDF.IRI.new/1`
|
|
|
|
it also accepts bare `RDF.Vocabulary.Namespace` modules
|
2019-08-02 22:10:47 +00:00
|
|
|
|
|
|
|
|
2019-08-02 22:41:06 +00:00
|
|
|
### Changed
|
|
|
|
|
2019-08-02 23:33:47 +00:00
|
|
|
- `RDF.Turtle.Decoder` saves the base IRI in the `RDF.Graph` now
|
2019-08-03 22:13:13 +00:00
|
|
|
- `RDF.Turtle.Encoder` now takes the base IRI to be used during serialization in
|
|
|
|
the following order of precedence:
|
2020-05-08 22:09:31 +00:00
|
|
|
- from the `base` option or its new alias `base_iri`
|
2019-08-03 22:13:13 +00:00
|
|
|
- from the `base_iri` field of the given graph
|
|
|
|
- from the `RDF.default_base_iri` returning the one from the application
|
|
|
|
configuration
|
2019-09-06 13:05:40 +00:00
|
|
|
- `RDF.PrefixMap.new` and `RDF.PrefixMap.add` now also accepts terms from
|
2019-08-08 20:26:07 +00:00
|
|
|
`RDF.Vocabulary.Namespace`s as namespaces
|
2019-08-02 22:41:06 +00:00
|
|
|
|
|
|
|
|
2019-09-06 13:05:40 +00:00
|
|
|
### Fixed
|
|
|
|
|
|
|
|
- Vocabulary namespace modules weren't always detected properly
|
|
|
|
|
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
[Compare v0.6.1...v0.6.2](https://github.com/rdf-elixir/rdf-ex/compare/v0.6.1...v0.6.2)
|
2019-08-02 22:10:47 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2019-07-14 23:16:16 +00:00
|
|
|
## 0.6.1 - 2019-07-15
|
2019-04-20 21:33:09 +00:00
|
|
|
|
|
|
|
### Added
|
|
|
|
|
2019-04-29 18:55:36 +00:00
|
|
|
- `RDF.IRI.to_string/1` returns the string representation of an `RDF.IRI`
|
|
|
|
(implicitly resolving vocabulary namespace terms)
|
2019-04-20 21:33:09 +00:00
|
|
|
- `RDF.Literal.matches?/3` for XQuery regex pattern matching
|
2019-04-22 09:17:16 +00:00
|
|
|
- `RDF.Decimal.digit_count/1` and `RDF.Decimal.fraction_digit_count/1` for
|
|
|
|
determining the number of digits of decimal literals
|
2019-04-20 21:33:09 +00:00
|
|
|
|
|
|
|
|
2019-04-27 22:35:23 +00:00
|
|
|
### Fixed
|
|
|
|
|
2019-05-04 12:59:33 +00:00
|
|
|
- language literals were not properly unescaped during Turtle parsing
|
|
|
|
- `RDF.Literal.new/1` can take decimals and infers the datatype `xsd:decimal`
|
2019-06-08 20:56:22 +00:00
|
|
|
correctly
|
|
|
|
- `true` and `false` with capital letters are no longer valid `RDF.Boolean`s
|
|
|
|
following the XSD specification; the same applies for booleans in Turtle
|
2019-07-06 00:32:31 +00:00
|
|
|
- `+INF` is no longer a valid `RDF.Double` (positive infinity doesn't expect a sign)
|
|
|
|
- slightly improve output of errors during parsing of Turtle, N-Triples and N-Quads
|
2019-04-27 22:35:23 +00:00
|
|
|
|
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
[Compare v0.6.0...v0.6.1](https://github.com/rdf-elixir/rdf-ex/compare/v0.6.0...v0.6.1)
|
2019-04-20 21:33:09 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2019-04-06 01:04:18 +00:00
|
|
|
## 0.6.0 - 2019-04-06
|
2019-03-25 23:31:43 +00:00
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
see [here](https://github.com/rdf-elixir/rdf-ex/wiki/Upgrading-to-RDF.ex-0.6) for
|
2019-07-14 23:14:40 +00:00
|
|
|
upgrading notes to RDF.ex 0.6
|
|
|
|
|
2019-03-25 23:31:43 +00:00
|
|
|
### Added
|
|
|
|
|
|
|
|
- `RDF.PrefixMap`
|
2019-03-31 00:15:56 +00:00
|
|
|
- prefix management of `RDF.Graph`s:
|
2019-04-02 22:12:42 +00:00
|
|
|
- the structure now has a `prefixes` field with an optional `RDF.PrefixMap`
|
2019-03-31 00:15:56 +00:00
|
|
|
- new functions `add_prefixes/2`, `delete_prefixes/2` and `clear_prefixes/1`
|
2019-03-31 03:07:34 +00:00
|
|
|
- configurable `RDF.default_prefixes`
|
2019-04-03 23:55:34 +00:00
|
|
|
- `RDF.Description.equal?/2`, `RDF.Graph.equal?/2`, `RDF.Dataset.equal?/2` and
|
|
|
|
`RDF.Data.equal?/2`
|
2019-03-25 23:31:43 +00:00
|
|
|
|
|
|
|
|
2019-03-28 23:34:22 +00:00
|
|
|
### Changed
|
|
|
|
|
2019-03-29 00:29:24 +00:00
|
|
|
- the constructor functions for `RDF.Graph`s and `RDF.Dataset`s now take the
|
|
|
|
graph name resp. dataset name through a `name` option, instead of the first
|
|
|
|
argument
|
2019-03-31 00:15:56 +00:00
|
|
|
- `RDF.Graph.new` supports an additional `prefixes` argument to initialize the
|
|
|
|
`prefixes` field
|
|
|
|
- when `RDF.Graph.add` and `RDF.Graph.put` are called with another graph, its
|
|
|
|
prefixes are merged
|
2019-03-31 03:07:34 +00:00
|
|
|
- `RDF.Turtle.Decoder` saves the prefixes now
|
2019-04-01 00:44:12 +00:00
|
|
|
- `RDF.Turtle.Encoder` now takes the prefixes to be serialized in the following
|
|
|
|
order of precedence:
|
|
|
|
- from the `prefixes` option (as before)
|
|
|
|
- from the `prefixes` field of the given graph
|
|
|
|
- from the `RDF.default_prefixes`
|
2019-03-31 03:24:44 +00:00
|
|
|
- drop support for OTP < 20, since prefixes can consist of UTF characters which
|
|
|
|
are not supported in atoms on these versions
|
2019-03-28 23:34:22 +00:00
|
|
|
|
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
[Compare v0.5.4...v0.6.0](https://github.com/rdf-elixir/rdf-ex/compare/v0.5.4...v0.6.0)
|
2019-03-25 23:31:43 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2019-01-17 19:19:07 +00:00
|
|
|
## 0.5.4 - 2019-01-17
|
2018-11-18 20:19:11 +00:00
|
|
|
|
|
|
|
### Fixed
|
|
|
|
|
2019-01-17 19:19:07 +00:00
|
|
|
- issue with Elixir 1.8
|
2018-11-18 20:19:11 +00:00
|
|
|
- `RDF.write_file` and `RDF.write_file!` delegators had wrong signatures
|
|
|
|
|
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
[Compare v0.5.3...v0.5.4](https://github.com/rdf-elixir/rdf-ex/compare/v0.5.3...v0.5.4)
|
2018-11-18 20:19:11 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2018-11-11 12:21:00 +00:00
|
|
|
## 0.5.3 - 2018-11-11
|
2018-11-11 01:30:25 +00:00
|
|
|
|
|
|
|
### Added
|
|
|
|
|
|
|
|
- `RDF.Triple.valid?/1`, `RDF.Quad.valid?/1` and `RDF.Statement.valid?/1`, which
|
|
|
|
validate if a tuple is a valid RDF triple or RDF quad
|
|
|
|
|
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
[Compare v0.5.2...v0.5.3](https://github.com/rdf-elixir/rdf-ex/compare/v0.5.2...v0.5.3)
|
2018-11-11 01:30:25 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2018-11-04 21:41:53 +00:00
|
|
|
## 0.5.2 - 2018-11-04
|
2018-10-04 22:58:34 +00:00
|
|
|
|
|
|
|
### Added
|
|
|
|
|
|
|
|
- `RDF.Term.value/1` returning the native Elixir value of a RDF term
|
2018-10-21 22:52:22 +00:00
|
|
|
- `RDF.Statement.values/1`, `RDF.Triple.values/1` and `RDF.Quad.values/1`
|
|
|
|
returning a tuple of `RDF.Term.value/1` converted native Elixir values from a
|
|
|
|
tuple of RDF terms
|
2018-10-28 02:50:48 +00:00
|
|
|
- `RDF.Description.values/1`, `RDF.Graph.values/1`, `RDF.Dataset.values/1` and
|
|
|
|
`RDF.Data.values/1` returning a map of `RDF.Term.value/1` converted native
|
|
|
|
Elixir values from the respective structure of RDF terms
|
2018-11-04 21:27:25 +00:00
|
|
|
- for all of aforementioned `values/1` functions a variant `values/2` which
|
|
|
|
allows to specify custom mapping function to be applied when creating the resp.
|
|
|
|
structure
|
2018-11-02 21:00:48 +00:00
|
|
|
- `RDF.Literal.compare/2`, `RDF.Literal.less_than?/2` and `RDF.Literal.greater_than?/2`
|
|
|
|
for `RDF.Datatype` aware comparisons of `RDF.Literal`s
|
2018-10-04 22:58:34 +00:00
|
|
|
|
2018-10-25 22:57:30 +00:00
|
|
|
|
|
|
|
### Fixed
|
|
|
|
|
2018-11-04 14:54:49 +00:00
|
|
|
- `RDF.DateTime.equal_value?/2` and `RDF.Date.equal_value?/2` did not handle
|
|
|
|
timezones correctly
|
2018-11-04 03:02:36 +00:00
|
|
|
- `-00:00` is a valid timezone offset on `RDF.DateTime`
|
2018-10-25 22:57:30 +00:00
|
|
|
|
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
[Compare v0.5.1...v0.5.2](https://github.com/rdf-elixir/rdf-ex/compare/v0.5.1...v0.5.2)
|
2018-10-04 22:58:34 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2018-09-17 13:10:44 +00:00
|
|
|
## 0.5.1 - 2018-09-17
|
|
|
|
|
|
|
|
### Fixed
|
|
|
|
|
|
|
|
- generated Erlang output files of Leex and Yecc are excluded from Hex package
|
|
|
|
|
2018-10-25 22:57:30 +00:00
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
[Compare v0.5.0...v0.5.1](https://github.com/rdf-elixir/rdf-ex/compare/v0.5.0...v0.5.1)
|
2018-09-17 13:10:44 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2018-09-17 01:32:45 +00:00
|
|
|
## 0.5.0 - 2018-09-17
|
2018-04-07 20:59:03 +00:00
|
|
|
|
|
|
|
### Added
|
|
|
|
|
2018-09-17 01:28:12 +00:00
|
|
|
- Possibility to execute simple SPARQL queries against `RDF.Graph`s with
|
2020-06-01 15:34:49 +00:00
|
|
|
[SPARQL 0.2](https://github.com/rdf-elixir/sparql-ex/blob/master/CHANGELOG.md)
|
2018-09-17 01:28:12 +00:00
|
|
|
- New `RDF.Term` protocol implemented for all structs representing RDF nodes and
|
|
|
|
all native Elixir datatypes which are coercible to those modules. For now, it
|
|
|
|
mainly offers, besides the coercion, just the function `RDF.Term.equal?/2` and
|
|
|
|
`RDF.Term.equal_value?/2` for term- and value comparisons.
|
|
|
|
- New `RDF.Decimal` datatype for `xsd:decimal` literals and support for decimal
|
|
|
|
literals in Turtle encoder
|
|
|
|
- `RDF.Numeric` module with a list of all numeric datatypes and shared functions
|
|
|
|
for all numeric literals, eg. arithmetic functions
|
|
|
|
- Various new `RDF.Datatype` function
|
|
|
|
- `RDF.Datatype.cast/1` for casting between `RDF.Literal`s as specified in the
|
|
|
|
XSD spec on all `RDF.Datatype`s
|
|
|
|
- logical operators and the Effective Boolean Value (EBV) coercion algorithm
|
|
|
|
from the XPath and SPARQL specs on `RDF.Boolean`
|
|
|
|
- various functions on the `RDF.DateTime` and `RDF.Time` datatypes
|
|
|
|
- `RDF.LangString.match_language?/2`
|
|
|
|
- Many new convenience functions on the top-level `RDF` module
|
|
|
|
- constructors for all of the supported `RDF.Datatype`s
|
|
|
|
- constant functions `RDF.true` and `RDF.false` for the two boolean `RDF.Literal` values
|
|
|
|
- `RDF.Literal.Guards` which allow pattern matching of common literal datatypes
|
|
|
|
- `RDF.BlankNode.Generator`
|
|
|
|
- Possibility to configure an application-specific default base IRI; for now it
|
2018-08-16 23:31:08 +00:00
|
|
|
is used only on reading of RDF serializations (when no `base` specified)
|
2018-04-07 20:59:03 +00:00
|
|
|
|
|
|
|
|
2018-06-03 21:35:01 +00:00
|
|
|
### Changed
|
|
|
|
|
2018-09-04 18:53:14 +00:00
|
|
|
- Elixir versions < 1.6 are no longer supported
|
2018-07-09 21:04:25 +00:00
|
|
|
- `RDF.String.new/2` and `RDF.String.new!/2` produce a `rdf:langString` when
|
|
|
|
given a language tag
|
2018-09-09 22:27:40 +00:00
|
|
|
- Some of the defined structs now enforce keys on compile-time (via Elixirs
|
2018-09-17 01:28:12 +00:00
|
|
|
`@enforce_keys` feature) when not setting the corresponding fields would lead
|
2018-09-09 22:27:40 +00:00
|
|
|
to invalid structs, namely the following fields:
|
|
|
|
- `RDF.IRI.value`
|
|
|
|
- `RDF.BlankNode.id`
|
|
|
|
- `RDF.Description.subject`
|
|
|
|
- `RDF.List.head`
|
|
|
|
|
2018-06-03 21:35:01 +00:00
|
|
|
|
2018-06-03 21:21:14 +00:00
|
|
|
### Fixed
|
|
|
|
|
2018-09-17 01:28:12 +00:00
|
|
|
- `RDF.resource?/1` does not fail anymore when called with unresolvable atoms
|
|
|
|
but returns `false` instead
|
|
|
|
- `RDF.IRI.absolute/2` does not fail with a `FunctionClauseError` when the given
|
|
|
|
base is not absolute, but returns `nil` instead
|
2018-09-14 21:08:36 +00:00
|
|
|
- `RDF.DateTime` and `RDF.Time` store microseconds
|
2018-06-03 21:21:14 +00:00
|
|
|
- `RDF.DateTime`: '24:00:00' is a valid time in a xsd:dateTime; the dateTime
|
|
|
|
value so represented is the first instant of the following day
|
2018-07-09 19:49:25 +00:00
|
|
|
- `RDF.LangString`: non-strings or the empty string as language produce invalid
|
|
|
|
literals
|
2018-06-03 21:21:14 +00:00
|
|
|
|
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
[Compare v0.4.1...v0.5.0](https://github.com/rdf-elixir/rdf-ex/compare/v0.4.1...v0.5.0)
|
2018-04-07 20:59:03 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2018-03-19 00:52:42 +00:00
|
|
|
## 0.4.1 - 2018-03-19
|
2018-03-14 09:42:41 +00:00
|
|
|
|
2018-03-14 10:46:11 +00:00
|
|
|
### Added
|
|
|
|
|
|
|
|
- `RDF.Literal.new!/2` which fails when creating an invalid literal
|
|
|
|
|
|
|
|
|
2018-03-14 09:42:41 +00:00
|
|
|
### Changed
|
|
|
|
|
2018-03-14 10:46:11 +00:00
|
|
|
- `RDF.Literal.new/2` can create `rdf:langString` literals without failing, they
|
|
|
|
are simply invalid; if you want to fail without a language tag use the new
|
|
|
|
`RDF.Literal.new!/2` function
|
2018-03-14 09:42:41 +00:00
|
|
|
|
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
[Compare v0.4.0...v0.4.1](https://github.com/rdf-elixir/rdf-ex/compare/v0.4.0...v0.4.1)
|
2018-03-14 09:42:41 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2018-03-10 00:47:04 +00:00
|
|
|
## 0.4.0 - 2018-03-10
|
2018-03-07 09:16:00 +00:00
|
|
|
|
2018-03-07 09:33:09 +00:00
|
|
|
### Changed
|
|
|
|
|
2018-03-08 16:33:20 +00:00
|
|
|
- renamed `RDF.Serialization` behaviour to `RDF.Serialization.Format`; the new
|
2018-03-08 00:57:38 +00:00
|
|
|
`RDF.Serialization` module contains just simple RDF serialization related functions
|
2020-06-01 14:43:25 +00:00
|
|
|
- renamed `RDF.Serialization.Format` function `content_type/0` to `media_type/0`
|
2018-03-08 16:33:20 +00:00
|
|
|
- moved `RDF.Reader` and `RDF.Writer` into `RDF.Serialization` module
|
2018-03-09 20:26:15 +00:00
|
|
|
- removed the limitation to serialization formats defined in the core RDF.ex package
|
|
|
|
for use as a source of `RDF.Vocabulary.Namespace`s; so you can now also define
|
|
|
|
vocabulary namespaces from JSON-LD files for example, provided that the corresponding
|
|
|
|
Hex package is defined as a dependency
|
2018-03-07 09:33:09 +00:00
|
|
|
|
|
|
|
|
2018-03-07 09:16:00 +00:00
|
|
|
### Added
|
|
|
|
|
2018-03-08 00:57:38 +00:00
|
|
|
- `RDF.Serialization.Format`s define a `name` atom
|
2018-03-09 20:15:43 +00:00
|
|
|
- all `RDF.Serialization.Reader` and `RDF.Serialization.Writer` functions are now
|
|
|
|
available on the `RDF.Serialization` module (or aliased on the top-level `RDF`
|
|
|
|
module) and the format can be specified instead of a `RDF.Serialization.Format`
|
|
|
|
argument, via the `format` or `media_type` option or in case of `*_file`
|
|
|
|
functions, without explicit specification of the format, but inferred from file
|
|
|
|
name extension instead; see the updated README section about RDF serializations
|
|
|
|
- the following functions to access available `RDF.Serialization.Format`s:
|
2018-03-08 00:57:38 +00:00
|
|
|
- `RDF.Serialization.formats/0`
|
|
|
|
- `RDF.Serialization.available_formats/0`
|
|
|
|
- `RDF.Serialization.format/1`
|
2018-03-08 01:14:49 +00:00
|
|
|
- `RDF.Serialization.format_by_media_type/1`
|
2018-03-08 00:57:38 +00:00
|
|
|
- `RDF.Serialization.format_by_extension/1`
|
2018-03-07 09:16:00 +00:00
|
|
|
|
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
[Compare v0.3.1...v0.4.0](https://github.com/rdf-elixir/rdf-ex/compare/v0.3.1...v0.4.0)
|
2018-03-07 09:16:00 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2018-01-19 21:49:17 +00:00
|
|
|
## 0.3.1 - 2018-01-19
|
2017-10-30 10:40:44 +00:00
|
|
|
|
|
|
|
### Added
|
|
|
|
|
|
|
|
- `Collectable` implementations for all `RDF.Data` structures so they can be
|
|
|
|
used as destinations of `Enum.into` and `for` comprehensions
|
|
|
|
|
2018-01-19 21:49:17 +00:00
|
|
|
### Fixed
|
2017-10-30 10:40:44 +00:00
|
|
|
|
2018-03-01 12:16:31 +00:00
|
|
|
- Fix `unescape_map` in `parse_helper` for Elixir 1.6 ([@ajkeys](https://github.com/ajkeys))
|
2017-10-30 10:40:44 +00:00
|
|
|
|
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
[Compare v0.3.0...v0.3.1](https://github.com/rdf-elixir/rdf-ex/compare/v0.3.0...v0.3.1)
|
2018-01-19 21:49:17 +00:00
|
|
|
|
2017-10-30 10:40:44 +00:00
|
|
|
|
|
|
|
|
2017-08-24 16:33:36 +00:00
|
|
|
## 0.3.0 - 2017-08-24
|
2017-08-20 20:35:14 +00:00
|
|
|
|
|
|
|
### Added
|
|
|
|
|
|
|
|
- `RDF.IRI` as a more suitable URI/IRI representation for RDF, bringing enormous
|
2020-06-01 15:34:49 +00:00
|
|
|
performance and memory consumption benefits (see [here](https://github.com/rdf-elixir/rdf-ex/issues/1)
|
2017-08-22 21:31:16 +00:00
|
|
|
for the details about the improvements)
|
2017-08-20 20:35:14 +00:00
|
|
|
|
|
|
|
### Changed
|
|
|
|
|
|
|
|
- use `RDF.IRI` instead of Elixirs `URI` everywhere
|
|
|
|
- use the term _iri_ instead of _uri_ consistently, leading to the following
|
|
|
|
function renamings:
|
|
|
|
- `base_iri` instead of `base_uri` for the definition of `RDF.Vocabulary.Namespace`s
|
|
|
|
- `__base_iri__` instead of `__base_uri__` in all `RDF.Vocabulary.Namespace`s
|
|
|
|
- `__iris__` instead of `__uris__` in all `RDF.Vocabulary.Namespace`s
|
|
|
|
- `RDF.IRI.InvalidError` instead of `RDF.InvalidURIError`
|
|
|
|
- `RDF.Literal.InvalidError` instead of `RDF.InvalidLiteralError`
|
|
|
|
- `RDF.Namespace.InvalidVocabBaseIRIError` instead of `RDF.Namespace.InvalidVocabBaseURIError`
|
2017-08-21 19:24:05 +00:00
|
|
|
- show compilation message of vocabulary namespaces always to be able to relate
|
|
|
|
resp. errors and warnings
|
2017-08-20 20:35:14 +00:00
|
|
|
|
2017-08-21 19:06:57 +00:00
|
|
|
### Fixed
|
|
|
|
|
|
|
|
- when trying to resolve a term from an undefined module a `RDF.Namespace.UndefinedTermError`
|
|
|
|
exception
|
|
|
|
|
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
[Compare v0.2.0...v0.3.0](https://github.com/rdf-elixir/rdf-ex/compare/v0.2.0...v0.3.0)
|
2017-08-20 20:35:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2017-08-12 10:42:07 +00:00
|
|
|
## 0.2.0 - 2017-08-12
|
2017-06-25 19:15:55 +00:00
|
|
|
|
2017-07-05 21:27:55 +00:00
|
|
|
### Added
|
|
|
|
|
2017-08-09 21:24:37 +00:00
|
|
|
- full Turtle support
|
|
|
|
- `RDF.List` structure for the representation of RDF lists
|
|
|
|
- `describes?/1` on `RDF.Data` protocol and all RDF data structures which checks
|
2017-07-23 21:59:50 +00:00
|
|
|
if statements about a given resource exist
|
2017-07-21 22:21:28 +00:00
|
|
|
- `RDF.Data.descriptions/1` which returns all descriptions within a RDF data structure
|
2017-07-23 21:59:50 +00:00
|
|
|
- `RDF.Description.first/2` which returns a single object to a predicate of a `RDF.Description`
|
2017-08-09 21:24:37 +00:00
|
|
|
- `RDF.Description.objects/2` now supports a custom filter function
|
2017-07-21 22:21:28 +00:00
|
|
|
- `RDF.bnode?/1` which checks if the given value is a blank node
|
2017-07-05 21:27:55 +00:00
|
|
|
|
2017-06-25 19:15:55 +00:00
|
|
|
### Changed
|
|
|
|
|
2017-08-11 20:22:27 +00:00
|
|
|
- Rename `RDF.Statement.convert*` functions to `RDF.Statement.coerce*`
|
|
|
|
- Don't support Elixir versions < 1.4
|
2017-06-25 19:15:55 +00:00
|
|
|
|
2017-07-02 17:48:38 +00:00
|
|
|
### Fixed
|
|
|
|
|
2017-07-31 23:24:36 +00:00
|
|
|
- `RDF.uri/1` and URI parsing of N-Triples and N-Quads decoders preserve empty fragments
|
2017-08-11 20:22:27 +00:00
|
|
|
- booleans weren't recognized as coercible literals on object positions
|
2017-07-09 20:21:07 +00:00
|
|
|
- N-Triples and N-Quads decoder didn't handle escaping properly
|
2017-07-02 17:48:38 +00:00
|
|
|
|
2017-06-25 19:15:55 +00:00
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
[Compare v0.1.1...v0.2.0](https://github.com/rdf-elixir/rdf-ex/compare/v0.1.1...v0.2.0)
|
2017-08-12 10:42:07 +00:00
|
|
|
|
2017-08-09 21:24:37 +00:00
|
|
|
|
2017-06-25 19:15:55 +00:00
|
|
|
|
2017-06-25 18:33:45 +00:00
|
|
|
## 0.1.1 - 2017-06-25
|
|
|
|
|
|
|
|
### Fixed
|
|
|
|
|
|
|
|
- Add `src` directory to package files.
|
|
|
|
|
2020-06-01 15:34:49 +00:00
|
|
|
[Compare v0.1.0...v0.1.1](https://github.com/rdf-elixir/rdf-ex/compare/v0.1.0...v0.1.1)
|
2017-06-25 18:33:45 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 0.1.0 - 2017-06-25
|
|
|
|
|
|
|
|
Initial release
|
|
|
|
|
|
|
|
Note: This version is not usable, since the `src` directory is not part of the
|
|
|
|
package, which has been immediately fixed on version 0.1.1.
|