GitHub - federicotdn/verb:用于 Emacs 的 HTTP 客户端

Verb 简介

  • 是 Emacs 的 HTTP 客户端,引入新的次要模式 Verb 模式,作为Org 模式的扩展。
  • 核心思想是使用 Org 的树结构来组织 HTTP 请求的规范,子标题中定义的属性可扩展或覆盖父标题中定义的属性,无需重复 URL 主机、标头、端口等。
  • 至少需要 Emacs 26 版本才能工作。

主要功能

  • 从 Emacs 发送 HTTP 和 HTTPS 请求。
  • 使用 Org 模式将请求规范组织成树。
  • 轻松为许多请求定义公共属性(URL、查询字符串、标头等)。
  • 正确处理请求和响应的文本编码(字符集)。
  • 显示 PDF、PNG、JPEG、BMP、GIF 和 SVG 响应。
  • 在规范中嵌入 Emacs Lisp 表达式(带代码完成!)。
  • 可将请求导出为curl和其他外部工具。
  • 与 Babel 和 EWW 集成。
  • 包括鼠标支持(菜单栏和模式行)。
  • 支持文件上传。
  • 有 200 多个单元测试。
  • 针对 Go 的net/http服务器实现进行了测试。
  • 无依赖!易使用!

安装方法

  • Emacs 26+:使用package-install命令安装(确保 MELPA 或 MELPA Stable 在包源中),安装后添加到init.el中并设置快捷键(默认 C-c C-r),或使用use-package并在:config中设置快捷键。也可将.el文件添加到load-path
  • Spacemacs:在 Spacemacs 的develop分支中可用,阅读文档启用,查看Verb 模式绑定表查看默认键绑定。

快速开始示例

  • 最小示例:在 Org 模式缓冲区中放置* Quick Start :verb:get https://api.ipify.org?format=json Accept: application/json,按 C-c C-r C-r 发送请求。
  • 更完整示例:包含定义两个请求,共享相同的基本 URL 和Accept标头,通过移动点到二级标题并按 C-c C-r C-r 发送请求。

其他内容

  • 有截图展示界面。
  • 有使用指南,包括编写请求规范、在 Org 缓冲区中启用 Verb、发送请求、响应体缓冲区、重新发送请求、显示相应请求、响应头缓冲区、指定 HTTP 标头、添加主体、扩展和覆盖请求、发送前修改请求、Emacs Lisp 代码标签、代码完成、实用函数、Verb 变量、Verb 标题属性、从前奏中获取 Verb 变量、内联前奏、最后响应、按键存储响应、请求映射函数、响应映射函数、以*开头的主体行、文件上传、URL 编码表单提交、多部分表单提交、基本标头、导出请求、长行、Cookies、Babel 集成(发送请求、部分检索发送、导出请求)、重定向、代理、自定义、Verb 日志等详细内容。
  • examples/目录展示不同功能的示例。
  • 有 Troubleshooting 部分解决常见问题,如“无请求规范找到”“URL 元素下划线显示为下标”等。
  • 有 Changelog 在CHANGELOG.md
  • 有 Contributing 部分说明目前不接受 pull 请求,可打开 issue,介绍了运行测试、检查等的方法和相关注意事项。
  • 有 Related Packages 部分介绍可扩展 Verb 功能的相关包,如impostman
  • 有 Similar Packages 部分介绍类似的 HTTP 客户端包,如restclient等。
  • 有 Contributors 部分列出贡献者。
  • 遵循 GNU General Public License 版本 3 分发。
阅读 39
0 条评论