Skip to content
Permalink
0c8c9f3e28
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

bookshop/README.md

Go to file
 
 
Cannot retrieve contributors at this time
Bookshop API Documentation Installation Environment Variables Using the API
67 lines (51 sloc) 2.05 KB
Raw Blame

Bookshop API

Documentation

Installation

Installation is simple and straightforward. The first step is to ensure that the latest version of Node Version Manager (NVM) is installed then use this to install the latest version of NodeJS.

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash
source ~/.bashrc
nvm list-remote
  ...
  v7.4.0
  v7.5.0
nvm install 7.5.0
node -v
  v7.5.0

Next we need to clone the repository and install all the dependencies, the --production flag means only the dependencies will be installed (no devDependencies).

git clone https://github.com/covcom/bookshop.git
cd bookshop
npm install --production

Finally the API can be run.

node index

To stop the script press ctrl+C

Environment Variables

The server will need to provide the following environment variables. Instructions on setting environment variables was in the deployment lab:

  1. PORT The port at which the API will be served
  2. MONGO_USER The username of your Mongo database
  3. MONGO_PASS The password of the Mongo database
  4. MONGO_HOST The server name or IP address
  5. MONGO_PORT The Mongo Database server port
  6. MONGO_DB The name of the Mongo database (bookshop)

Using the API

by studying the index.js file which contains the routes, it should be clear how to use the API. The book search requires a URL parameter called q.

/books?q=security

Installing devDependencies

npm install jasmine-node --save-dev

Running jasmine locally

./node_modules/.bin/jasmine-node spec/

Install the Typescript Definition Language tool and use it to install the NodeJS definitions. This will add node to the autocomplete.

npm install tsd -g
tsd query -r -o -a install node jasmine