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!