Make REST API testing easy with a JSON file pipeline

A simple command-line endpoint testing library made entirely out of JavaScript

About • Installation • Usage • Authors • License

Execute endpoint tests with a simple JSON file.

Pipe-test is an automatic testing solution for REST APIs, easy to configure and easy to use.

Use your favorite JavaScript package manager!

$ npm install @danilo_pereira/pipe-test

$ yarn add @danilo_pereira/pipe-test

Likewise, the p-iteration dependency must be installed manually for the project to work.

$ npm install p-iteration

$ yarn add p-iteration

After installed, the pipe-test command will be available. The command accepts 2 arguments, both of which must be valid JSON files:

1. The pipeline file
2. The configuration file (optional)

pipe-test pipeline.json options.json

If no configuration file is provided, the default configuration will be used.

Upon each execution, 2 output files are generated on the configured output path:

1. A JSON file

The JSON output is only generated at the end of the pipeline execution - it contains every stage's information and its respective result, SUCCESS or FAIL.

2. A log file

The log file is updated real-time during the pipeline execution, and includes extra information such as the complete request with all global values replaced and the request return information, with timestamps. This file should be the most important for debugging in case of request failure.

The pipeline consists of a JSON file with a single array that contains the test objects, and each object represents a stage in the test pipeline.

If a test passes, the pipeline sleeps for the configured delay time before starting the next stage. In case of a test failure, the pipeline stops execution.

Below is a table description of each valid object property and how it works.

A global variable is available to use throughout the pipeline, to facilitate the use of common values in multiple requests, such as an ID. The global variable consists of a JavaScript object with any properties, each property being a global value in it of itself:

const global = {
  name: "Lorem Ipsum",
  age: 40,
}

In order to access these values in the pipeline, you must use $global.<property> e.g. $global.name.

Only the following pipeline properties able to replace global values: path, config and data.

"request": {
  "type": "GET",
  "path": "/user/$global.user_id",
  "config": {
    "headers": {
      "Authorization": "$global.user_token"
    }
  }
}

"result": {
  "allow": [
    200,
    404
  ],
  "deny": [
    "*"
  ]
}

"result": {
  "allow": [
    "*"
  ]
}

"funcs": [
  "global = {...global, user_data: response.data};"
]

Another example can also be found in the example folder of the project.

[
  {
    "description": "Define global variables and destination URL",
    "type": "SET_GLOBAL",
    "variables": {
      "baseUrl": "http://your-url/api",
      "config": {
        "headers": {
          "Content-Type": "application/json; charset=utf-8"
        }
      },
      "user_id": "abc",
      "user_email": "user123@test.com",
      "user_password": "12345"
    }
  },
  {
    "description": "Perform user login",
    "type": "CRUD", // Can be removed as it's the default value
    "request": {
      "type": "POST",
      "path": "/login/$global.user_id",
      "data": {
        "username": "$global.user_email",
        "password": "$global.user_password"
      }
    },
    "result": {
      "allow": [
        200,
        404
      ],
      "deny": [
        "*"
      ]
    },
    "funcs": [
      "if (response.status === 200) global = {...global, user_token: response.data};"
    ]
  }
 ]

The configuration file is a simple JSON with the following properties:

{
  "delay": 1500,
  "path": "./tests/output/",
  "name_mode": "BY_DATE"
}

Danilo Pereira Author

Letícia Vigna Co-Author

This project is under the GNU General Public License.

Made by Letícia Vigna.