hoppscotch/packages/hoppscotch-cli
2023-04-18 23:14:06 +05:30
..
bin
src docs: fixed broken documentation links (#2997) 2023-04-18 23:14:06 +05:30
.gitignore
.prettierrc
CODE_OF_CONDUCT.md
CONTRIBUTING.md
jest.config.ts
jest.setup.ts
LICENSE
package.json chore: set web and common versions to 2023.4.0 and remove workspace package version specifiers 2023-04-09 21:42:25 +05:30
README.md docs: update package description [skip ci] 2023-02-08 18:50:32 +05:30
tsconfig.json
tsup.config.ts

Hoppscotch CLI ALPHA

A CLI to run Hoppscotch test scripts in CI environments.

Commands:

  • hopp test [options] [file]: testing hoppscotch collection.json file

Usage:

hopp [options or commands] arguments

Options:

  • -v, --ver: see the current version of the CLI
  • -h, --help: display help for command

Command Descriptions:

  1. hopp -v / hopp --ver

    • Prints out the current version of the Hoppscotch CLI
  2. hopp -h / hopp --help

    • Displays the help text
  3. hopp test [options] <file_path>

    • Interactive CLI to accept Hoppscotch collection JSON path
    • Parses the collection JSON and executes each requests
    • Executes pre-request script.
    • Outputs the response of each request.
    • Executes and outputs test-script response.

    Options:

    -e <file_path> / --env <file_path>
    • Accepts path to env.json with contents in below format:

      {
          "ENV1":"value1",
          "ENV2":"value2"
      }
      
    • You can now access those variables using pw.env.get('<var_name>')

        Taking the above example, `pw.env.get("ENV1")` will return `"value1"`
      

Install

Install @hoppscotch/cli from npm by running:

npm i -g @hoppscotch/cli

Developing:

  1. Clone the repository, make sure you've installed latest pnpm.
  2. pnpm install
  3. cd packages/hoppscotch-cli
  4. pnpm run build
  5. sudo pnpm link --global
  6. Test the installation by executing hopp

Contributing:

To get started contributing to the repository, please read CONTRIBUTING.md