Skip to content

README.md

Latest commit

 

History

History
110 lines (77 loc) · 3.04 KB

README.md

File metadata and controls

110 lines (77 loc) · 3.04 KB

rest.nvim

License Neovim version

Features • Install • Usage • Contribute

Demo

A fast Neovim http client written in Lua.

rest.nvim makes use of a curl wrapper made in pure Lua by tami5 and implemented in plenary.nvim so, in other words, rest.nvim is a curl wrapper so you don't have to leave Neovim!

IMPORTANT: If you are facing issues, please report them

Notices

  • 2021-07-01: Now for getting syntax highlighting in http files you should add a require('rest-nvim').setup() to your rest.nvim setup, refer to packer.nvim. This breaking change should allow lazy-loading of rest.nvim.

Features

  • Easy to use
  • Fast execution time
  • Run request under cursor
  • Syntax highlight for http files and output
  • Possibility of using environment variables in http files

Install

WARNING: rest.nvim requires Neovim >= 0.5 to work.

Dependencies

  • System-wide
    • curl
    • jq (to format JSON output so it can be human-readable)
  • Other plugins

packer.nvim

use {
    'NTBBloodbath/rest.nvim',
    requires = { 'nvim-lua/plenary.nvim' },
    config = function()
      require("rest-nvim").setup({
        -- Open request results in a horizontal split
        result_split_horizontal = false,
        -- Skip SSL verification, useful for unknown certificates
        skip_ssl_verification = false,
      })
    end
}

Keybindings

By default rest.nvim does not have any key mappings so you will not have conflicts with any of your existing ones.

To run rest.nvim you should map the following commands:

  • <Plug>RestNvim, run the request under the cursor
  • <Plug>RestNvimPreview, preview the request cURL command
  • <Plug>RestNvimLast, re-run the last request

Settings

  • result_split_horizontal opens result on a horizontal split (default opens on vertical)
  • skip_ssl_verification passes the -k flag to cURL in order to skip SSL verification, useful when using unknown certificates

Usage

Create a new http file or open an existing one and place the cursor over the request method (e.g. GET) and run rest.nvim.

NOTES:

  1. rest.nvim follows the RFC 2616 request format so any other http file should work without problems.

  2. You can find examples of use in tests

Contribute

  1. Fork it (https://github.com/NTBBloodbath/rest.nvim/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

License

rest.nvim is MIT Licensed.
⚡