Barb is a file-based API query tool that works nicely with version control and fits into UNIX terminal usage.
barb <file 1> <file 2> ... <file n>
-a, --all-headers: Print all headers, request and response-b, --body: Only print the response body-h, --headers: Only print the response headers-r, --raw: Don't format the response body-V, --version: Print the software versionBarb uses a custom file format to perform requests. Each file contains one request and is started by a request preamble. Example:
```
{ "title": "A post", "content": "My pretty blog post" }
```
The preamble contains the directives relevant to performing the request, such as the method, URL and headers. The preamble must end with an empty line.
The verb line indicates to barb what sort of request to perform and where to. It follows this rigid format:
```
```
The URL supports variable substitution, but METHOD does not.
Supported methods are:
Headers are formatted as follows:
```
```
The HEADER VALUE supports variable substitution, HEADER NAME does not.
There can be none or many headers.
!!! Not operational at this time
Barb will support JQ filtering of the response body. This has the following format:
```
```
The JQ FILTER supports variable substitution.
Anything after the preamble is considered as a body and will be send in the request for the following methods:
Body does not support variable substitution.
Barb can include environment variable values into the requests with the following placeholder format:
{VARIABLE NAME}
Which allows to do the following:
``` $ export BASE_URL="http://127.0.0.1:8000" $ cat api-status.barb
$ barb api-status.barb 200 OK GET http://127.0.0.1:8000/api/v1/status { "status": "OK" } ```