@danilo_pereira/pipe-test v1.0.1

About

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.

Installation

Use your favorite JavaScript package manager!

$ npm install @danilo_pereira/pipe-test

$ yarn add @danilo_pereira/pipe-test

Dependencies

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

$ npm install p-iteration

$ yarn add p-iteration

Usage

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.

Output

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

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.

🌎 Global variables

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.

🏗️ Object structures

Request

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

Result

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

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

Funcs

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

📌 Pipeline example

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};"
    ]
  }
 ]

⚙️ Custom configuration

The configuration file is a simple JSON with the following properties: | Attribute | Options | Description | |-----------|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | delay | - | Milliseconds to wait between the execution of each individual test (number data type, not string) | | path | - | By default, the output files are generated in the same directory where the command was executed. Therefore, use this property if you would like to change the output path. If the provided output directory does not exist, it will be created Note: In order for the files to be created correctly in the desired directory, you must add a forward slash at the end of the path, e.g. ./output/ instead of ./output | | name_mode | BY_DATE, CUSTOM | BY_DATE ⇒ Default value, saves both JSON and log output files with the ISO 8601 datetime format i.e. "YYYY-MM-DDThh:mm:ss", e.g 2021-06-22T14:00:00.json. Because of this, this option creates 2 new output files on each execution CRUD ⇒ Saves output files with a custom name, provided by the name property. With this option, the log file appends new content and the JSON file is overwritten on each new execution | | name | - | Custom output file name (the same name will be used for both JSON and log files) Note: This name will only be considered if name_mode is CUSTOM |

📌 Example

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

Authors

License

This project is under the GNU General Public License.

Made by Letícia Vigna.