Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sethetter/reqq

Something like insomnia or postman, but a CLI.
https://github.com/sethetter/reqq

hacktoberfest

Last synced: 12 days ago
JSON representation

Something like insomnia or postman, but a CLI.

Awesome Lists containing this project

README

        

# reqq

A cli for making HTTP requests from predefined request files.

Expects available requests to be in a local `.reqq` folder.

Environments can be configured with arbitrary variables that can be embedded in request
files inside of an `.reqq/envs/` folder.

## Install

```
cargo install reqq
```

## Usage

Request file at `.reqq/create-user.reqq`.

```
POST {{ baseUrl }}/api/v1/users
X-Secret-Header: {{ secret }}
{ "username": "yep", "password": "nope" }
```

Env config at `.reqq/envs/test.json`.

```
{ "baseUrl": "https://example.com", "secret": "lolol" }
```

Then this command will issue the request!

```
reqq --env=test create-user
```

Env config can also be provided through extra arguments CLI command. Env args provided on the CLI will override varibles of the same name in the env config file.

```
reqq -a arg1=val1 -a arg2=val2 create-user
```

If you provide no environment, it will attempt to load `.reqq/envs/default.json`.

## `.reqq` files

Reqq uses [handlebars](https://docs.rs/handlebars/3.4.0/handlebars/) as the templating
engine, so anything that's fair game there is fair game in `.reqq` files.

## Commands

- `reqq [--env=] `, executes a request.
- `reqq list`, lists all available requests.
- `reqq envs`, lists available envs.