https://github.com/raquentin/raquest
🏓 A domain-specific language for repeatable HTTP requests.
https://github.com/raquentin/raquest
cpp curl dsl http
Last synced: about 2 months ago
JSON representation
🏓 A domain-specific language for repeatable HTTP requests.
- Host: GitHub
- URL: https://github.com/raquentin/raquest
- Owner: raquentin
- License: mit
- Created: 2024-08-10T16:20:18.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-03-05T21:42:55.000Z (3 months ago)
- Last Synced: 2025-04-02T13:06:37.795Z (about 2 months ago)
- Topics: cpp, curl, dsl, http
- Language: C++
- Homepage:
- Size: 404 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# 🏓 raquest
Raquest is a batteries-excluded command-line HTTP client. No monthly subscriptions or two minute ads to send requests, just run `raq .raq` and move on with your life.
## Features
### `.raq` files
Requests are stored written in `'.raq'` files and resemble `curl` commands in bash scripts. The files consist of sections defining the request, its headers, its json payload, and assertions, which assert certain attributes of the repsonse. View these sections in action in the [examples](/examples) or conceptually below:
#### [request]
```
[request]
POST https://jsonplaceholder.typicode.com/posts
```
The `[request]` section is generally found at the top of the file and defines the HTTP method and the target url.
#### [headers]
```
[headers]
Authorization: Bearer exampletoken12345
Content-Type: application/json
Custom-Header: custom_value
```
The `[headers]` section defines key-value header pairs.
#### [body]
```
[body]
{
"title": "foo",
"age": 30,
"isActive": true,
"description": "here is the description"
}
```
The `[body]` section contains the request payload; its type is inferred from the `Content-Type` header in the `[headers]` section.
#### [assertions]
```
[assertions]
status: 201, 303
json_field: title ^foo$
json_field: age 30
json_field: isActive true
json_field: description here is the description
```
`[assertions]` is an optional section that allows you to assert certain attributes of your request's response.
## Development
### Dependencies
- cmake 3.24
- clang 18 and/or gcc 14
### Commands
Before anything, build and enter the development environment with `nix develop`.
#### Run CMake
```bash
cmake -G Ninja -S . -B build
```
#### Build
```bash
ninja -C build
```
#### Run Tests
```bash
ninja runtests -C build
ninja memcheck -C build
ninja valgrind -C build
```
#### Clangd Setup
I'm using the Clangd C++ LSP. Run the command below to make it aware of your linked libraries.
```bash
cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug -DCMAKE_EXPORT_COMPILE_COMMANDS=1
```