Skip to content
Mock HTTP calls without coding. Designed specially for testing and testers.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode
functional-tests
lib
man
spec
tasks
.codeclimate.yml
.gitignore
.npmignore
.travis.yml
CONTRIBUTING.md
LICENSE
README.md
index.js
init.js
package-lock.json
package.json
response.yaml
yarn.lock

README.md

Stubmatic

Mock HTTP calls without coding. Designed specially for testing and testers.

NPM quality Travis ci Build Status Gitter Known Vulnerabilities Coverage Status

Become a Patron! Stubmatic donate button

Stubmatic logo

  1. Installation : $npm install stubmatic -g
  2. Set up repo : $stubmatic init [repo-name]
  3. Start server : $stubmatic [-d <repo-name>]
  4. Help : $stubmatic --help

Important links : Video Tutorial, Wiki, NPM, Demo application, issues, changelogs Stubmatic donate button

Main features

  • Mock HTTP(s) calls. (Hence can mock REST/SOAP web services)
  • Inspect HTTP calls from CLI or log them for more detail.
  • No code. Designed specially for testing and testers.
  • Mock messagepack or Nimn (निम्न) response easily. Write in JSON parse in desirable format.
  • Support SSL certificates.
  • Optional configuration
  • Dynamic response
    • Use Regular Expressions to match a request, capture some part of the request, to decide response file at runtime, to change contents of response at runtime etc.
    • Use Expressions (functions and markers) to display dynamic dates, random number etc.
    • Devide your response into multiple files (called dumps) for readability, reusability, and consistency.
    • Create a response skeleton with DB sets and fill data as per matched request.
    • Delay response for fixed or random time.
  • Send response as a stream (downloadable file)
  • Compress response automatically.
  • Route requests to other server using proxy.
  • Memory and CPU efficient
  • Ready to be used in performance environment
  • And much more like short notations, multiple mapping files, file strategy etc.

Configuration

To install stubmatic, you need to install nodejs and npm first. It is recommanded to be on latest version of both. npm is bundeled with nodejs. Now follow above commands to install stubmatic and to set up a repo.

How to start

Stubmatic works on request response mappings specified in a yaml file. Response contents can be read from body or file attribute of a maping.

-  request:
      url: /stubs/(admin|staff|customer|security)/([0-9]+)/2

   response:
      body: >
        multiple line response
        another line

When a request reaches to stubmatic server, it matches the request against all mappings. Whichever mapping matches first(top to bottom), will be used to serve the response. A complete response can be built with multiple files. It can also have some placeholder to show dynamic data, like date, or some random number or some part from request itself. Stubmatic first process and build complete response then respond back to any HTTP(s) request.

Using regular expression, single mapping can be used to match multiple requests and serve response from different files.

Sample SOAP request mapping

-  request:
     method: POST
     url: /soap-simulator/services/ServiceName
     post: actionName[\s\S]*mobile.([0-9]+)
  response:
     headers:
           content-type: text/xml
     strategy: "first-found"
     files: ["stubs/<% post.1 %>/response.xml","stubs/ServiceName/actionName/default.xml"]

Sample REST request mapping

-  request:
     method: GET
     url: /rest-simulator/services/ServiceName/actionName/([0-9]+)
  response:
     headers:
           content-type: text/xml
     strategy: "first-found"
     files: ["stubs/<% url.1 %>/response.xml","stubs/ServiceName/actionName/default.xml"]

Worth to mention

  • BigBit standard : A standard to reprent any number in the universe in comparitively less space and without precision loss. A standard to save space to represent any text string in comparision of UTF encoding.
  • अनुमार्गक (anumargak) : The fastest router for node web servers.
  • imglab : Web based tool to label images for object. So that they can be used to train dlib or other object detectors. You can integrate 3rd party libraries for fast labeling.
  • fast-xml-parser: Transform XML to JS/JSON objects, or Nimn rapidly. Transform back JSON to XML. Work in browser, node package, or CLI. Many options to customize parsing.
  • fast-lorem-ipsum : Generate lorem ipsum words, sentences, paragraph very quickly.
  • Grapes : Flexible Regular expression engine (for java) which can be applied on char stream. (maintainers are needed)

Helpful articles and tutorials

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.