Skip to content

MLRS/gabra-api

Repository files navigation

API for Ġabra

Ġabra is an open lexicon for Maltese.

This repository contains the source code for the Ġabra API at http:https://mlrs.research.um.edu.mt/resources/gabra-api/

Installation

Web app

  • You need Node.js. After cloning the repo run npm install to install Node packages locally.
  • You will need a file server-config.js containing the relevant details for your host. Start by copying server-config.sample.js.

Database

Running

Use PM2: pm2 start processes.json or just run the file start.sh.

You must set the environment variable NODE_ENV to production if relevant.

Tests

The tests use:

  1. mocha framework (describe, it, etc.)
  2. supertest for high-level HTTP testing (request etc.)
  3. should.js assertion library (x.should.equal(y) etc.)

Run all tests with npm test. Run an individual testsuite with npx mocha --exit test/schema.js or use the --grep flag. To stop on first failure, use --bail

Repository

  • master branch is used for development.
  • production branch is kept in sync with live version on MLRS.

Deploying

Assuming you're on master:

./deploy -wet
git checkout production
git merge master
git push
git checkout master