Alcaeus (pronounced AL-SEE-UHS
) is a Node.js/browser library for consuming Hydra APIs.
Alcaeus is the birth name of Heracles. The demigod who defeated Hydra.
Use npm or yarn:
npm i alcaeus
Alcaues v3
is implemented only as ES Modules. It will work in recent versions on node and modern browsers.
Since v3
Alcaeus is configured using an RDF/JS Environment factory. This decouples the library from any specific RDF/JS implementation.
It is recommended to use the implementation provided by @zazuko/env
which allows to easily reuse extend existing environments.
import create from 'alcaeus'
import Environment from '@zazuko/env/Environment.js'
import rdf from '@zazuko/env'
const env = new Environment(create(), { parent: rdf })
const { response, representation } = await env.hydra.loadResource('http://example.com/resource');
const rootResource = representation.root;
// contains supported classes, operations, etc.
const apiDocs = Hydra.apiDocumentations[0];
const id = rootResource.id;
To learn more, head to http://alcaeus.hydra.how.
MIT