greaterweb / loopback-workspace

Manage a directory of Loopback Projects for a user, team, or organization

LoopBack Workspace 3.0

About

The loopback-workspace module provides node.js and REST APIs for interacting with a set of loopback components. Components are organized in the following basic directory structure:

  /my-workspace
    /my-component-a
    /my-component-b
    /my-component-c
    package.json

Each component has the following basic structure:

  /my-component
    config.json
    datasources.json
    model-config.json
    /models
      my-model.json
      my-model.js

Usage

Basic

The loopback-workspace itself if a loopback component. The following will load the workspace in the current working directory (process.cwd()).

// workspace is a loopback `app` object
var workspace = require('loopback-workspace');

Custom Workspace Directory

To start the workspace in a specific directory, you must specify the WORKSPACE_DIR env variable.

REST

In order to use the REST api, you must mount the app on an existing express app or call workspace.listen(PORT).

Test

To run end-to-end tests, you will need a local MySQL instance. Once you have that running, you can run the MySQL setup script to autoconfigure your database. Finally, use the npm test command to run the tests.