Fake-DB

What is it ?

Fake-DB reads in a json file and automatically creates various endpoints on an express server. The point of this is for it to be used as an API mock to aid front-end development.

Installation and Start-Up

Install the package with npm i @antoniosbarotsis/fake-db.

Make sure to create a data.json file at the root of your project.

To use it you just have to import it and run start()

1const db = require('@antoniosbarotsis/fake-db')
2
3db.start(8000) // Starts the server

Alternatively you can do the following:

1const { start } = require('@antoniosbarotsis/fake-db')
2
3start(8000)

The start method takes in the port and filename as an arguments. If no port is specified then process.env.PORT will be used. If that is also undefined then 8000 will be picked. The default file name is data.json.

Usage

The package picks up the objects you input at the data.json file and automatically creates endpoints for them.

If we for example have the following in the file:

1{
2  "users": [
3    {
4      "name": "Tony"
5    }
6  ]
7}

Once we run the application endpoints will be generated under the path http://localhost:8000/users.

The file will be modified by now to this:

1{
2  "users": [{
3      "name": "Tony",
4      "id": 1
5  }],
6  "state": {
7      "users": {
8        "counter": 1
9      }
10  }
11}

You'll see that our user has a new generated id attribute. In addition a new state object has appeared which is used to keep track of certain data that is neededbehind the scenes (as of now it only keeps track of the counters needed for id generation).

Endpoints

This might change in the future but for now for every entry in the json file the following endpoints are created (using users as an example):

• GET /users
• GET /users/:id
• POST /users
• PUT /users/:id
• DELETE /users/:id

In other words you can: Get all users, get a specific user by his id, add a new user (needs request body) update a user by id (also requires request body) and delete a user by id.

For now the PUT request needs all of the fields a user normally has (minus the id) but in the future that might change to any number of fields.