1.0.1 • Published 8 years ago
fixture-middleware v1.0.1
Motivation
Sometimes I want to mock certain paths of my API made with Express. Therefore, I created fixture-middleware which will use fixture data (mock) for any URL that matches a file inside the configured fixture directory.
Installation
npm install fixture-middleware --save-devyarn add fixture-middleware --devUsage
const path = require('path')
const express = require('express')
const fixtureMiddleware = require('fixture-middleware')
const app = express()
const fixtureDirectory = path.resolve(__dirname, './fixtures')
app.use(fixtureMiddleware(fixtureDirectory))Matching URLs with fixture files
All URLs are normalized (all / will be replaced by --) and if a Accept headers is present it will be used to determine the file extension, otherwise the first matching file will be returned.
Example
Suppose we have the following files in the configured fixture directory:
`-- fixtures
|-- users.json
|-- users.html
`-- users--active.jsonThe following request will match those files as follows
| Request | Response |
|---|---|
URL: /users Headers: (no accept header) | File: users.html |
URL: /users Headers: accept=application.json | File: users.json |
URL: /users Headers: accept=application.html | File: users.html |
URL: /users/active Headers: (no accept header) | File: users--active.json |
URL: /users/active Headers: accept=application.json | File: users--active.json |
Important: Any unmatched request will be delegated to the next middleware.
Development
- Clone and fork this repo.
- Install dependencies: yarn or npm install.
- Run tests.
- Prepare a pull request.
Test
yarn test– to run all tests.yarn test -- --watch– to run all tests in watch mode.
Publish
- Bump package version:
yarn version --new-version x.x.x -m 'Version %s.'. - Publish to NPM registry:
npm publish. - Push new tag:
git push origin --tags.
Made with :heart: by Rubens Mariuzzo.