This app requires that Docker be installed on your machine. You can download Docker from https://www.docker.com/get-docker

Note that if your machine is running on Windows 10 home and previous versions of windows, you will need to use docker toolbox instead. Docker toolbox can be downloaded from https://docs.docker.com/toolbox/toolbox_install_windows/

Once docker has been successfully installed, you can run the app by cloning this repository. After the files have been downloaded, navigate to the application's root directory and then launch the app by typing the following command in the terminal program on your machine.

To launch app, type

`docker-compose up --build`

Note that if you have not previously used Docker Node image and Mongo image available from Dockerhub, it could take a while for the app to start running for the first time. This is dependent on the speed of your internet connection.

User Manager

This repository contains a simple demo API built with NodeJS. The API is used to manage users in a MongoDB database.

Development

This application was developed using ExpressJS. MongoDB was used for persisting data with Mongoose as ORM.

Installation

• Start up your terminal (or Command Prompt on Windows OS).
• Ensure that you've node installed on your PC.
• Clone the repository by entering the command git clone https://github.com/andela-bolajide/UserManager in the terminal.
• Navigate to the project folder using cd UserManager on your terminal (or command prompt)
• After cloning, install the application's dependencies with the command npm install.
• Create a .env file in your root directory as described in .env.sample file. Variables such as DB_URL (which must be a mongoDB URL) and PORT are defined in the .env file and it is essential you create this file before running the application.

PORT=3000
DB_URL='mongodb://john:doe@localhost:27017/databaseName'

• After this, you can then start the server with the command: npm start.

Testing

To ensure that your installation is successful you'll need to run tests. The command: npm test makes this possible. It isn't functional right now, but once it's done you'll be notified via the README.

API Documentation

The API only has one endpoint which is the /users endpoint for saving users to the database. The endpoint works with the HTTP verbs: POST, GET, PUT, DELETE.

POST HTTP Request

• POST /users
• INPUT:

name: John Doe
email: [email protected]
password: johndoe

HTTP Response

• HTTP Status: 201: created
• JSON data

{
  "_id": "59071791b0lkscm2325794",
  "name": "John Doe",
  "email": "[email protected]",
  "password": "johndoe",
  "__v": 0
}

GET HTTP Response

• GET /users

[
    {
        "_id": "59071791b0lkscm2325794",
        "name": "John Doe",
        "email": "[email protected]",
        "password": "johndoe",
        "__v": 0
    }
]

GET HTTP Response

• GET /users/:id

{
    "_id": "59071791b0lkscm2325794",
    "name": "John Doe",
    "email": "[email protected]",
    "password": "johndoe",
    "__v": 0
}

DELETE HTTP Response

• DELETE /users/:id

User John Doe was deleted

POST HTTP Request

• PUT /users/:id
• INPUT:

name: Jane Doe
email: [email protected]
password: janedoe

HTTP Response

• HTTP Status: 200: OK
• JSON data

{
  "_id": "59071791b0lkscm2325794",
  "name": "Jane Doe",
  "email": "[email protected]",
  "password": "janedoe",
  "__v": 0
}

Author

Olajide Bolaji 'Nuel - Software Developer at Andela