Verb HTTP 客户端使用教程

Verb HTTP 客户端使用教程

verb HTTP client for Emacs 项目地址: https://gitcode.com/gh_mirrors/verb/verb

1. 项目介绍

Verb 是一个为 Emacs 编辑器设计的 HTTP 客户端。该软件包引入了一种新的次要模式 —— Verb 模式，作为 Org 模式的扩展。Verb 的核心思想是利用 Org 的树状结构来组织 HTTP 请求规范。子标题中定义的属性可以扩展或覆盖父标题中定义的属性，这样可以避免在多个请求中重复设置如 URL、端口、头部等信息。使用 Verb 不需要预先了解 Org 模式。

Verb 至少需要 Emacs 版本 26 才能运行。

2. 项目快速启动

安装

在 Emacs 中，你可以使用 package-install 命令来安装 Verb（确保你的包源中包含了 MELPA 或 MELPA Stable）：

M-x package-install RET verb RET

安装完成后，将以下内容添加到你的 init.el 文件中：

(with-eval-after-load 'org
  (define-key org-mode-map (kbd "C-c C-r") verb-command-map))

如果你使用 use-package，你需要修改你的 org 配置条目。如果没有，创建一个新的，并在 :config 键下添加绑定 Verb 命令映射到某个键的代码。最终结果应该看起来像这样：

(use-package org
  :mode ("\\.org\\'" . org-mode)
  :config
  (define-key org-mode-map (kbd "C-c C-r") verb-command-map))

这将设置 C-c C-r 作为所有 Verb 命令的前缀键。

使用

以下是一个快速启动的示例，你可以在 Org 模式缓冲区中放置以下内容：

* Quick Start                            :verb:
get https://api.ipify.org?format=json
Accept: application/json

然后，按下 C-c C-r C-r 发送 HTTP 请求。

3. 应用案例和最佳实践

以下是一个更完整的示例，它定义了两个请求，它们共享相同的基 URL 和 Accept 头部：

* Extended Quick Start                   :verb:
template https://reqres.in/api
Accept: application/json

** Create a new user
post /users
Content-Type: application/json; charset=utf-8
{
  "name": "Jane Smith",
  "city": "Berlin"
}

** Fetch a product
get /products/{{(read-number "Product ID: ")}}

你可以通过将光标移动到其中一个级别 2 标题上，然后按下 C-c C-r C-r 来发送这两个请求中的任何一个。

4. 典型生态项目

Verb 的设计使其易于集成到其他 Emacs 功能和模式中，例如 Babel 和 EWW。它支持文件上传，并且拥有超过 200 个单元测试。Verb 没有任何依赖性，易于使用，是 Emacs 用户处理 HTTP 请求的一个优秀选择。

verb HTTP client for Emacs 项目地址: https://gitcode.com/gh_mirrors/verb/verb