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.
The auto-generated documentation is served alongside this repository on Github Pages: https://metabrainz.github.io/bookbrainz-data-js/
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.