5 unstable releases
0.3.0 | Jul 20, 2023 |
---|---|
0.2.0 | Jul 16, 2023 |
0.1.7 | Jul 10, 2023 |
0.1.1 | Jun 26, 2023 |
#2670 in Command line utilities
42 downloads per month
54KB
1.5K
SLoC
Usage
See examples of using hat
$ hat --help
hat runs HTTP tests based on a toml configuration file.
The configured tests can check response status, headers, and body
using binary operations such as ==, >, <, !=, etc.
If one or more tests fail, hat will return a failed exit code.
Use --help for more USAGE details.
Project homepage: https://github.com/isaacadams/hat
Usage: hat[EXE] [OPTIONS] <PATH>
Arguments:
<PATH> path to .toml configuration file
Options:
-v, --verbose <VERBOSE> verbose level: DEBUG, INFO, ERROR [default: DEBUG]
-h, --help Print help
-V, --version Print version
.toml
configuration
A .toml
file configured with HTTP requests and assertions can be loaded by the hat
CLI which will then execute the HTTP requests and run the assertions again the HTTP responses.
# see other examples of a hat .toml config file in the example folder
# e.g. example/local/config.toml
# e.g. example/pastebin/pastebin.toml
[environment]
# any variable can be defined here that needs to be used throughout testing
# all environment variables and .env file(s) will be loaded automatically
# <name> = <value>
base = "https://your-api-domain.com/api/v1"
[[tests]]
# http = "<METHOD> <URL>" OR "path/to/file.http"
http = "GET {{base}}/users"
# optional description
description = "get the users"
# each line in assertions is evaluated
# three variables are generated from the HTTP response: status, headers, and body
# status: number
# headers: json
# body: whatever the endpoint returns (e.g. json, xml, plaintext, etc.)
assertions = """
{{ status }} == 200
{{ headers | content-type }} == "application/json"
{{ body | users.0.username }} == "isaacadams"
{{ body | users.#(username=="isaacadams").username }} == "isaacadams"
"""
# using response variables, add new variables to the [environment]
[tests.outputs]
userId = "{{ body | users.#(username==\"isaacadams\").id }}"
# write a follow-up test
[[tests]]
# uses {{userId}} defined from previous steps' output
http = """
GET {{base}}/users/{{userId}}
Accept application/json
"""
assertions = """
{{ status }} == 200
{{ headers | content-type }} == "application/json"
{{ body | username }} == "isaacadams"
"""
.http
files
the example/local/config.toml
uses a create-post.http
file.
this is a file type unique to this CLI tool. Below is an example of how you can use an .http
file. The idea that some requests are complex and the request bodies can become very large, distracting from the flow of the config file. Having the ability to define requests in their own file also opens up the possibility to reuse a request.
POST {{base}}/posts
Content-Type: application/json
[
"I made a new post today"
]
Dependencies
~13–25MB
~331K SLoC