Guile-RDF
============

Guile RDF is an implementation of the RDF format defined by the W3C for
GNU Guile.  RDF stands for Resource Description Framework and it is a way
to represent information.  RDF structures include triples (facts with a
subject, a predicate and an object), graphs which are sets of triples, and
datasets, which are collections of graphs.

Each node in the graph represents a "thing", a concept or concrete object,
and edges represent relations between them.  Each node and relation is either
an IRI, a blank node or an RDF literal. An RDF literal itself has a type,
represented by an IRI.

RDF specifications include the specification of concrete syntaxes and of
operations on graphs.  This library is not yet complete, but already has some
basic functionalities: an internal representation of RDF datasets, some
predicates and an initial parser for turtle files.

Installing
----------

In order to install, your best option is to use the [Guix](https://guix.gnu.org)
package manager.  It can run on any existing Linux distribution, and is guaranteed
to not interact with its host distribution.  Installing Guix is as simple
as running the
[installation script](https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh).
Once installed, you can run:

```bash
guix install guile guile-rdf
```

Otherwise, your package manager might have guile-jsonld available.  You can also
build it from source, like so:

```bash
git clone https://framagit.org/tyreunom/guile-rdf
autoreconf -fiv
./configure
make
sudo make install
```

You will need guile and guile-json for it to work.  Again, the best way to obtain
the dependencies is to use Guix from this repository:

```bash
guix environment -l guix.scm
```

`guix.scm` is a file that is provided with this repository. You can use it to
setup a development environment, as shown above, or to build the package, using
maybe a different source, like this:

```bash
guix build --with-sources=guile-rdf=$(PWD) -f guix.scm
```

Testing
-------

The tests include running the official
[test suite](https://w3c.github.io/json-ld-api/tests/).  It requires network
access.  To run it, use:

```bash
make check
```

Please [report](https://framagit.org/tyreunom/guile-jsonld/issues) any failure!