1.0.3-Canary.1 • Published 11 months ago

postman-to-cypress v1.0.3-Canary.1

Weekly downloads
-
License
MIT
Repository
github
Last release
11 months ago

Header Image Build CI Status Build CI Release CodeQL

Postman to Cypress Converter

This tool converts Postman collections and environments into Cypress test files. It reads a Postman collection and environment JSON file, processes the items and variables, and generates Cypress test files in a specified output directory.

Features

  • Converts Postman collections to Cypress tests
  • Saves the converted environment variables to a cypress.env.json file.
  • Resolves environment variables in requests
  • Supports custom output directories and file naming conventions.

Usage

Prepping your collection and environment files

DON'Ts

!CAUTION

  • Nesting of collections into multiple directory as shown below
  • Naming request as endpoint complete path or uri
  • Refrain from complex request chaining
folder
├── folder
│   ├── collection
│   └── collection
└── folder
    ├── collection
    ├── collection
    └── folder
        ├── collection
        ├── collection
        ├── collection
        └── folder
            ├── collection
            ├── collection
            └── collection

DOs

!TIP

  • Nest collection in the single directory/folder as shown below
  • Name request/collection as intended functionality wish
folder (testsuite name: "Suite for Sales Endpoint")
├── collection (testcase name: "Get Address")
├── collection
└── collection

Converting Postman Collection/Environment to Cypress Test/Cypress.env.json

:coffee: Installation

npm i -g postman-to-cypress

:point_right: Help

pcy -h

:point_right: To Convert Collection/Collection Variables

pcy convert -c /user/collection -cy

:point_right: To Convert Collection/Collection Variables and Providing a Directory

pcy convert -c /user/collection -cy --output [directory]

:point_right: To Convert Collection with Default Output Directory (Cypress/Integration)

pcy convert -c /user/collection -e /user/environment -cy

:point_right: To Convert Collection and Providing a Directory

pcy convert -c /user/collection -e /user/environment -cy --output [directory]

:point_right: To Generate Cypress.env.json from Environment File

pcy generate-env -e /user/environment --output [directory]

For more information on how to use Cypress.env() for API testing see

Contribution guidelines for this project

Requirements

  • Node.js (>= 20.x)
  • npm (>= 10.x)

License

postman-to-cypress is MIT Licensed

1.0.3-Canary.1

11 months ago

1.0.2-beta.2

11 months ago

1.0.1

11 months ago

0.1.0

11 months ago

1.0.0

11 months ago