# mock-restful-express

> A RESTful mock server powered by Express.js

Latest version **0.0.2** (published 2015-05-19) · Apache v2.0 license · 0 weekly downloads

## Install

```sh
npm install mock-restful-express
pnpm add mock-restful-express
yarn add mock-restful-express
bun add mock-restful-express
```

Provides the command `mock-server`.

## Health

**Score 5/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: insecure dependencies; abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.2 |
| Published | 2015-05-19 |
| First published | 2015-05-13 |
| Weekly downloads | 0 |
| License | Apache v2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=0.8.0 |
| Dependencies | 8 |
| Known vulnerabilities | 0 (+11 in 3 direct dependencies) |
| Install scripts | no |
| GitHub stars | 3 |
| Author | Felipe Knappe |
| Maintainers | fknappe |
| Keywords | express, mock, restful, app |

## Links

- npm: https://www.npmjs.com/package/mock-restful-express
- Repository: https://github.com/fknappe/mock-restful-express
- Issues: https://github.com/fknappe/mock-restful-express/issues
- npm.io page: https://npm.io/package/mock-restful-express

## Dependencies (8)

- [fs](https://npm.io/package/fs.md) ~0.0.2
- [glob](https://npm.io/package/glob.md) ~4.4.0
- [lodash](https://npm.io/package/lodash.md) ~1.3.1
- [express](https://npm.io/package/express.md) ~3.4.0
- [pkginfo](https://npm.io/package/pkginfo.md) ~0.3.0
- [commander](https://npm.io/package/commander.md) ~2.7.1
- [dynamic-routes](https://npm.io/package/dynamic-routes.md) git+https://github.com/fknappe/dynamic-routes
- [node-http-error](https://npm.io/package/node-http-error.md) ~0.2.0

## Alternatives

- [pagerjs](https://npm.io/package/pagerjs.md) — 60 weekly downloads
- [whistle.savefor-mock](https://npm.io/package/whistle.savefor-mock.md) — 4 weekly downloads
- [@versini/auth0-auth-js-stub](https://npm.io/package/@versini/auth0-auth-js-stub.md) — 0 weekly downloads
- [@loutre-run/core](https://npm.io/package/@loutre-run/core.md) — 0 weekly downloads
- [@crvouga/mockingbird-service-prism](https://npm.io/package/@crvouga/mockingbird-service-prism.md) — 0 weekly downloads

## Recent versions

- 0.0.2 (latest) — 2015-05-19
- 0.0.1 — 2015-05-13

## README

[![Build Status](https://travis-ci.org/fknappe/mock-restful-express.svg)](https://travis-ci.org/fknappe/mock-restful-express)

# mock-restful-express

A RESTful mock server powered by Express.js

## Table of Contents

1. [Purpouse](#Purpouse)
2. [Usage](#Usage)

## Purpouse

The purpose of this project is to provide a generic RESTful API server based on mocked responses, defined programatically and with support to many features like: 

- Basic Auth
- Cookies
- HTTP endpoints with support to GET, POST, PUT and DELETE actions

## Usage

### Project Routes

This project is based on the concepts of [Express.js routing](http://expressjs.com/guide/routing.html). Those features are provided by a library called [dynamic-routes](https://github.com/OneOfOne/dynamic-routes), and all routes can be defined programatically with support to all HTTP methods (GET, POST, PUT and DELETE) within the **routes** folder.

To know better these routes conventions, take a look on the project examples to understand the concepts. 

### Project Mocks

This project is also based on mocked responses, defined programatically in a convetional manner, within the **mocks** folder. 

#### Examples

The **/examples** folder within this project contains all the references explained below. To see them in practice, make the mock-server install through npm, as explained below:

```bash
npm install mock-restful-express -g
```

This command make a installation of this library within node global dependencies folder. To run the mock server, within the **examples** folder, run the following on the terminal:

```bash
mock-server
```

This should initiate a new instance of the server on the default port (8880).

#### Mocks path structure

The mocks path structure are the defined based on routes path. For example, suppose we have an **/foo** route defined on the project, with support to GET action. The respective mocked reponse of this route is structured as follows:

```
- mocks
|-- foo
|--- get
|---- 1.json
|---- all.json
|---- foo=bar.json
```

This structure is also adaptive to define mocked responses for POST, PUT and DELETE actions whenever necessary.

#### Mock response structure

All mock responses also are based on some conventions, defined in a structure as follows:

```json
{
	"code": 200,
	"content" : { 
		"bar" 
	}
}
```

This structure defines a response HTTP code (with support to all [HTTP codes](http://en.wikipedia.org/wiki/List_of_HTTP_status_codes)) and payload, represented by **content** node.

#### Response for Path Param Request

A GET request on a route path with path param like **/foo/1** is conventionally mapped to *1.json* file, defined in a structure like shown below:

```
- mocks
|-- foo
|--- get
|---- 1.json
```

#### Response for Query Param Request

A GET request on a route path with query param like **/foo/?foo=bar&bar=foo**, its convetionally mapped to a *foo=bar&bar=foo.json* file, defined in a structure like shown below:

```
- mocks
|-- foo
|--- get
|---- foo=bar&bar=foo.json
```

#### Response for Subresource Request

A GET request on a route path defined for a subresource like **/foo/1/bar/2**, its convetionally mapped to a *1_2.json* file, defined in a structure like shown below:

```
- mocks
|-- foo
|--- bar
|---- get
|---- 1_2.json
```

#### Default responses with MockHTTP

All requests received from your project routes could be conventioned to have a defined mocked response. For GET methods like **/foo**, its expected to have a *all.json* file defined to response for the request. In case of PUT or DELETE actions, the default response is agreed to be defined with HTTP Code 204 without any body. In case of POST requests, the default response is defined to have HTTP Code 200 without any body.

In case of some route doesn´t have its respective mocked response, a message will be sent with HTTP Code 404 and body with a descriptive error message.

This behavior could be easily supported by your project's routes through a library MockHTTP, defined on this project. To know better this libray usage, take a look at this project example section.

---
_Source: https://npm.io/package/mock-restful-express · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._