Skip to content

metabrainz/bookbrainz-data-js

BookBrainz Node ORM

npm Build Status Coverage Status

bookbrainz-data-js provides a node package to allow manipulation of data in a BookBrainz database using a set of bookshelf.js models. The module is only for accessing data in an existing database - for schema creation, see the sql folder in bookbrainz-site.

Each model has its own source file in the "models" directory. These models can be accessed via index.js, which provides a function returning the models, taking an initialized bookshelf.js instance as a single parameter.

Documentation

The auto-generated documentation is served alongside this repository on Github Pages: https://metabrainz.github.io/bookbrainz-data-js/

Tests

A suite of simple tests is provided in the tests directory, using the Mocha and Chai libraries.

Copy the file test/bookshelf.js.example to test/bookshelf.js and modify it according to your local postgres setup. For instructions on setting up the postgres test database, refer to the testing section of the bookbrainz-site installation docs.

The command for running the tests, following dependency installation, is the standard:

yarn test
- or -
npm test

This will also provide style checking and coverage information.