nvim-http is a powerful HTTP client designed specifically for Neovim users, enabling seamless HTTP request execution directly within the text editor. Drawing inspiration from the popular vscode-restclient extension and the IntelliJ HTTP Client, this plugin serves as an advanced alternative to vim-http, providing notable enhancements and capabilities.

Key Features

• Environment Variables Support: Easily manage your API endpoints and authentication tokens using environment variables defined in .env files or JSON format.

• Asynchronous Operations: Utilizing Neovim's async_call mechanism ensures non-blocking requests, allowing for a smooth user experience. Requests can be stopped at any time.

• Extended Syntax for .http Files: The plugin introduces advanced syntax highlighting and parsing for .http files, supporting JSON and HTML blocks, as well as inline comments, making it easier to create and manage complex requests.

• Multi-Request Buffers: Supports executing multiple requests from a single file, recognizing the request context based on the cursor position. This includes visual selection for targeted request execution.

Usage Instructions

After installing the plugin, create a buffer with the body of your HTTP request. When using a .http file, syntax highlighting will occur automatically. To execute a request:

1. Position the cursor within the request body or select the entire body.
2. Execute the :Http command.

By default, the response is displayed in a vertical split but can also be shown in a horizontal split with :Http -h or in a new tab using :Http -t.

A default request timeout of 10 seconds can be adjusted using the -T/--timeout flag, with optional redirection control via the --no-redirects flag.

Multiple Requests Management

Supports multiple requests within the same file leveraging a delimiter format:

### The first request
POST {{base_url}}/api/v1/users HTTP/1.1
Authorization: Bearer {{jwt_token}}

{
  "name": "Alice"
}

### The second request
GET {{base_url}}/api/v1/users?name=Alice HTTP/1.1
Authorization: Bearer {{jwt_token}}

Environment Configuration

The plugin can interpret environment files with the *.env.json pattern, allowing multiple environments to be defined. Usage is effortless:

{
  "dev": {
    "base_url": "http://localhost:3000",
    "jwt_token": null
  },
  "prod": {
    "base_url": "https://foobar.eu-west.some-cloud.com",
    "jwt_token": "SECRET"
  }
}

Additionally, define variables in a .env file and utilize them in requests with a simple syntax: {{varname}}.

Use of Inline Shell Commands

Enhance flexibility by embedding inline shell commands directly within your HTTP requests or environment variables. For instance:

GET {{URL}}/api/v1/users/$(echo $USER)

Through these features, nvim-http empowers developers to streamline their workflow by providing rich HTTP client capabilities directly in Neovim.