hitt is a command line HTTP testing tool focused on speed and simplicity.
hitt can be installed using Cargo.
cargo install hitt --lockedIf you do not have Cargo installed, you need to install it first.
hitt does not require any external dependencies for Windows and macOS user.
Linux users must install openssl.
sudo apt-get install pkg-config libssl-devsudo pacman -S pkg-config opensslsudo dnf install pkg-config perl-FindBin openssl-develapk add pkgconfig openssl-devsudo zypper in libopenssl-develTo send a request create a file ending in .http.
The syntax of .http files is pretty straightforward:
GET https://mhouge.dk/The file can then be run using the following command:
hitt run PATH_TO_FILEThat is all that is need to send a request.
| Argument | Description |
|---|---|
--var <KEY>=<VALUE> |
Variables to pass to request |
--recursive |
Run all files in directory |
--fail-fast |
Exit on status code 4XX or 5xx |
--hide-headers |
Hide response headers |
--hide-body |
Hide response body |
--timeout <TIMEOUT_MS> |
Request timeout in ms |
Request headers can be added by writing key value pairs (KEY:VALUE) on a new line after the method and URL:
GET https://mhouge.dk/
key:valueLeading spaces in the header value is ignored, so KEY: VALUE and KEY:VALUE will both have the value VALUE.
A body can be sent with the request by creating a blank line, followed by the desired body input.
Please note, hitt does not infer content type. That has to be written as a header.
POST https://mhouge.dk/
content-type:application/json
{
"key": "value"
}Multiple requests can be written in a single file by adding a line with ### as a separator:
GET https://mhouge.dk/
###
GET https://mhouge.dk/hitt has support for request variables.
A variable can be set in a file using the following syntax @name = VALUE. Whitespace is ignored.
Variables are used by wrapping the name in curly brackets ({{ name }}).
@variable_name = localhost
GET {{ variable_name }}/apiIn-file variables are not shared between other files.
Variables can be passed to all requests using the --var <KEY>=<VALUE> argument:
# file.http
GET {{ host }}/apiThe file can the be run:
hitt run --var host=localhost:5000 file.httpA SSE listener can be started using the hitt sse command.
hitt sse https://sse.dev/testShell completions can be generated using mdsf completions <SHELL>.
Add the following to your .bashrc.
eval "$(mdsf completions bash)"Add the following to your .zshrc.
eval "$(mdsf completions zsh)"Add the following to ~/.config/fish/config.fish.
mdsf completions fish | sourceAdd the following to your PowerShell configuration (Can be found by running $PROFILE).
Invoke-Expression (&mdsf completions powershell)Add the following to ~/.elvish/rc.elv.
eval (mdsf completions elvish)hitt can be run directly from Neovim.
Note
The hitt executable must be available in your path for the plugin to work.
local hitt_plugin = {
"hougesen/hitt",
opts = {},
}The plugin exposes a single command :HittSendRequest, which can be bound to a keymap like this:
-- ~/.config/nvim/after/plugin/hitt.lua
local hitt = require("hitt")
vim.keymap.set("n", "<leader>rr", hitt.HittSendRequest, {})
| Name | Default | Description |
|---|---|---|
| window_width | 80 | Window width in percentage |
| window_height | 80 | Window height in percentage |
| fail_fast | false | Enables the --fail-fast options |
Syntax highlighting can be enabled by installing the http treesitter parser (:TSInstall http) and adding a file association for .http files.
vim.filetype.add({
extension = {
http = "http",
},
})hitt is most likely not ready for main stream usage. I (Mads Hougesen) am primarily developing it based on features I believe to be useful, or fun to develop.