A tool to make requests using Hypertext Transfer Protocol (you know, HTTP) within neovim.
- nvim-lua/plenary.nvim is required.
Install using your package manager of choice.
Example using lazy.nvim:
{
'wet-sandwich/hyper.nvim',
dependencies = { 'nvim-lua/plenary.nvim' }
}
Use the command :Hyper
to open the main window, or add a custom mapping using Lua:
vim.keymap.set('n', '<leader>hy', require('hyper.view').show, {})
Type <c-c>
to close the main window and to close menus without saving changes. Type <cr>
while in normal mode to save and close a menu or to make a selection.
Type the letters displayed in brackets to open menus or to perform the corresponding action.
After navigating to another screen, type <c-o>
to return to the main
request/response screen.
The body menu appears when a method that supports a body has been selected. The content entered must be valid JSON.
Hyper will search the current working directory (and up to four levels deep) for any .env files (including those with prefixes or suffixes), and will try to auto-select one for you. If multiple files are found you can select which one to use, and you can edit the selected file from within Hyper. Use <c-n>
and <c-p>
to move to different files and preview their contents. Type <Tab>
to select a file to be used to fill in variables when making a request. The current selected file is marked with a check mark.
Enter variables as key=value
pairs. To use your variables in other places, wrap the key in double braces: {{key}}
.
Enter parameters as key=value
pairs.
Enter headers as Header-Name: value
pairs.
Hyper will track your 25 previous unique requests. Use <c-n>
and <c-p>
to
cycle through the list and preview the full request. Type <cr>
to select a
previous request and copy its contents to the active request.
Repeating a previous request moves it to the top of the list with an updated timestamp instead of creating a new entry.
Hyper supports collections via .http files. Navigate to the collections page and hyper will automatically search recursively within your current directory for any .http files and then parse them to create a list of requests. Use <Tab>
to switch between the collection list and request list windows. Use j
and k
to move between items in the windows, and use <cr>
in the request list window to select a request to use.
For any tokens not filled in by the parser with the available variables found in the .http file, hyper will attempt to replace the remaining tokens using values from the selected .env file (this allows sensitive information to stay out of the collection).