尧图网站建设 
开发工具CLI【免费下载链接】postingThe modern API client that lives in your terminal.项目地址https://gitcode.com/gh_mirrors/po/posting点击查看免费下载Posting 是一款运行在终端中的现代 API 客户端。在实际调试接口时你可能希望用自己熟悉的编辑器如vim、VSCode来编辑请求体或借助less、fx等分页器在大屏上浏览 JSON 响应——本篇指南将围绕 docs/guide/external_tools.md 系统讲解 Posting 与外部编辑器和分页器的集成方式以及如何一键将当前请求导出为 cURL 命令。读完本文你将掌握editor、pager、pager_json、curl_export_extra_args等全部相关配置项并能根据实际场景自由组合出最适合自己的终端调试工作流。概述为什么需要外部工具Posting 内置了基于 Textual 的多行文本区域TextArea用于编辑请求体和查看响应但对于复杂内容终端内的编辑体验终究有限。Posting 允许你在 Posting 与外部编辑器、分页器之间快速切换例如用vim编辑请求体然后用less或fx浏览 JSON 响应体甚至可以为 JSON 单独配置一个专用分页器。这一能力全部围绕多行文本区域展开且每一项都可以通过配置文件、环境变量两种方式设置。从源码角度看这一功能的核心实现在 widgets/text_area.py 中BINDINGS [ Binding(f3,ctrlP, open_in_pager, Pager, idopen-in-pager), Binding(f4,ctrlE, open_in_editor, Editor, idopen-in-editor), ]也就是说当多行文本区域获得焦点时按 f4 或 ctrle 调用外部编辑器按 f3 或 ctrlp 调用外部分页器。完整的按键绑定说明可参考 docs/guide/keymap.md。配置优先级config.yaml 与环境变量Posting 的所有配置都遵循统一的加载优先级参见 docs/guide/configuration.md配置文件config.yaml环境变量POSTING_前缀.env文件因此本文涉及的所有设置项都可以等价地用POSTING_EDITOR、POSTING_PAGER、POSTING_PAGER_JSON、POSTING_CURL_EXPORT_EXTRA_ARGS这几个环境变量覆盖。配置文件的位置可通过posting locate config命令查看。外部编辑器External Editors当焦点位于多行文本区域时按 f4 即可将当前内容以临时文件的形式在外部编辑器中打开。配置方式外部编辑器的命令通过config.yaml中的editor键设置editor: vim也可以使用POSTING_EDITOR环境变量export POSTING_EDITORvim如果两者都未设置Posting 会回退到系统标准的EDITOR环境变量。从源码看这一回退逻辑是在配置模型定义时直接完成的——config.py 中editor字段的默认值即取自os.getenv(EDITOR)editor: str | None Field(defaultos.getenv(EDITOR)) The command to use for editing.!!! tip 使用 VSCode 或 Cursor 如果你希望在外部编辑器中用 VSCode 或 Cursor 打开内容请将POSTING_EDITOR设置为code -w或cursor -w其中的-wwait参数会让编辑器在关闭文件之前一直阻塞等待从而保证 Posting 能正确读回你的修改。底层实现原理当触发编辑操作时PostingTextArea.action_open_in_editor 会读取SETTINGS.get().editor若未配置则弹出警告通知No editor configured。随后调用_open_as_tempfile完成以下流程text_area.py用shlex.split(command)解析命令字符串支持带参数的编辑器命令如code -w根据文本区域的当前语言推断临时文件后缀json/html/yaml使用对应扩展名python使用.py其他内容无后缀确保外部编辑器能获得正确的语法高亮把当前文本写入一个临时文件通过self.app.suspend()挂起 Posting 的 TUI然后subprocess.call(editor_args)阻塞执行外部命令此时可以自由操作外部编辑器外部程序退出后如果是可写文本区域会把编辑后的文件内容读回 Posting只读区域则不写回删除临时文件并刷新界面。若命令本身无法执行例如编辑器路径不存在会抛出OSError并在 Posting 内弹出错误通知不会导致应用崩溃。这一机制也适用于请求脚本在 request_scripts.py 中脚本路径输入框绑定了 ctrle打开编辑器与 ctrlp打开分页器且脚本路径支持path/to/script.py:function_name语法并相对于 collection 根目录解析。编辑完脚本返回 Posting 后还会调用uncache_module清除模块缓存确保修改立即生效request_scripts.py。外部分页器External Pagers当焦点位于多行文本区域时按 f3 即可在外部分页器中查看当前内容。分页器天然适合只读浏览例如在less中查看较长的响应体。配置方式外部分页器通过config.yaml中的pager键设置pager: less也可以使用POSTING_PAGER环境变量export POSTING_PAGERless与编辑器类似pager的默认值同样取自系统环境变量PAGERconfig.pypager: str | None Field(defaultos.getenv(PAGER)) The command to use for paging.JSON 专用分页器pager_json针对 JSON 内容Posting 提供了专门的pager_json设置。当文本区域的语言被识别为 JSON例如响应内容类型是 JSON时会优先使用该分页器pager_json: fx对应的环境变量为POSTING_PAGER_JSONexport POSTING_PAGER_JSONfx从 config.py 的字段注释可知JSON 分页器会在从 TextArea 内打开分页器、且内容可被推断为 JSON时生效例如编辑器语言被设置为 JSON或响应内容类型标明是 JSON。若pager_json未设置则回退到上文所述的通用pager查找规则。选择 JSON 分页器的判定逻辑位于 action_open_in_pager只有当self.language json且settings.pager_json已配置时才使用 JSON 分页器否则一律走通用pager。这意味着一处配置即可为所有 JSON 响应启用fx等结构化浏览工具而普通文本仍交给less。分页器的只读语义与编辑器不同分页器打开的是只读场景。在_open_as_tempfile中分页后的文件不会被读回因为read_only区域不做写回操作这也符合分页器用于浏览的定位。导出为 cURL 命令Exporting to curl该功能自 Posting 2.4.0 起提供。Posting 可以将当前正在编辑的请求一键转换为 cURL 命令并复制到剪贴板方便分享给同事、粘贴到文档或在其他脚本中复现请求。操作方式打开命令面板Command Palette选择export: copy as curl即可。Posting 会基于当前界面上的请求状态即使尚未保存构建请求模型、转换成 cURL 命令并复制到剪贴板。从 commands.py 可以看到命令面板中实际提供了两个入口export: copy as curl复制请求为 cURL 命令默认会运行请求上绑定的 setup 脚本以便先解析出变量export: copy as curl (no setup scripts)跳过 setup 脚本直接导出。后者的存在是为了解决导出命令依赖运行时变量的问题如果你希望导出的命令不包含任何变量替换副作用可以使用无脚本版本。实现流程command_export_to_curl 的完整流程如下从当前 UI 状态构建RequestModel若启用 setup 脚本且请求配置了 setup 脚本先执行脚本失败会弹出Error in script通知获取环境变量并执行apply_template做变量替换存在未定义变量时会提示Undefined variable调用request_model.to_curl(extra_args...)生成命令复制到剪贴板。在 Apple Terminal 中会改用pyperclip因为 macOS 的 Terminal 不支持 OSC 52 剪贴板协议其他终端则通过 Posting 内置的copy_to_clipboard写入。附加 curl 参数curl_export_extra_args你可以在config.yaml中通过curl_export_extra_args设置需要附加到 cURL 命令中的额外参数curl_export_extra_args: --verbose -w %{time_total} %{http_code}对应的环境变量为POSTING_CURL_EXPORT_EXTRA_ARGS默认值为空字符串config.py。这些参数会被直接插入到剪贴板命令中curl之后最终生成形如下面的命令curl --verbose -w %{time_total} %{http_code} -X POST ...这一用法非常适合一次性附加调试类参数如--verbose或性能测量参数如-w %{time_total} %{http_code}而无需在 Posting 界面中逐项配置。导出命令的生成细节RequestModel.to_curl 展示了 cURL 命令的完整拼装逻辑理解它有助于预判导出结果先追加额外参数若配置了curl_export_extra_args非 GET 方法输出-X METHOD逐条输出启用的请求头-H Name: valueURL 中已有的查询参数会与请求中配置的查询参数合并后再拼装 URL请求体内容输出为-d ...form_data逐项输出-d namevalue认证信息Basic 认证输出-u user:passDigest 认证输出--digest -u user:passCookie 输出为--cookie namevalue未开启重定向时追加--no-location未验证 SSL 时追加--insecure超时时间非默认值5.0 秒时追加--max-time timeout配置了代理时追加--proxy ...最终以反斜杠换行拼接所有片段提高可读性。这些行为在 tests/test_curl_export.py 中有对应的单元测试验证例如简单的 GET 请求导出为curl \换行https://example.com/apiPOST 请求则包含-X POST与-d ...。这意味着你可以放心依赖该功能的输出格式。实践建议编辑器组合日常调试时把editor设为vim或code -w在请求体编辑框中按 f4 即可获得完整的外部编辑体验保存并退出后修改会自动同步回 Posting。响应浏览组合把pager设为less、pager_json设为fx响应体聚焦后按 f3普通文本用less翻页、JSON 用fx展开折叠两种浏览体验互不干扰。命令导出需要把当前请求发给同事或写入自动化脚本时使用export: copy as curl若请求依赖 setup 脚本注入的变量而你又想导出原始形态使用export: copy as curl (no setup scripts)再配合curl_export_extra_args附加--verbose等调试参数。团队一致化将这些配置写入config.yaml随仓库版本管理或通过.env文件按 dev/prod 环境切换具体配置格式可参考 docs/guide/configuration.md 与 tests/sample-configs/general.yaml。赞分享开发工具CLI【免费下载链接】postingThe modern API client that lives in your terminal.项目地址https://gitcode.com/gh_mirrors/po/posting点击查看免费下载相关推荐MySQL数据库监控终极指南mysqld_exporter从零到精通MySQL数据库监控终极指南mysqld_exporter从零到精通 在当今数据驱动的时代MySQL数据库监控已成为每个运维工程师和开发者的必备技能。mys运维yn编辑器中的自定义工具集成外部命令行工具yn编辑器中的自定义工具集成外部命令行工具 yn编辑器GitHub推荐项目精选是一款高度可扩展的Markdown编辑器支持版本控制、AI补全、思维导图、桌面应用代码编辑器如何快速解决Windows HEIC格式转换难题终极解决方案如何快速解决Windows HEIC格式转换难题终极解决方案 你是否曾在Windows电脑上收到iPhone朋友发来的照片却发现无法打开或者在处理大量苹果桌面应用图像处理创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Posting 外部工具集成指南：外部编辑器、分页器与 curl 导出实战
开发工具CLI【免费下载链接】postingThe modern API client that lives in your terminal.项目地址https://gitcode.com/gh_mirrors/po/posting点击查看免费下载Posting 是一款运行在终端中的现代 API 客户端。在实际调试接口时你可能希望用自己熟悉的编辑器如vim、VSCode来编辑请求体或借助less、fx等分页器在大屏上浏览 JSON 响应——本篇指南将围绕 docs/guide/external_tools.md 系统讲解 Posting 与外部编辑器和分页器的集成方式以及如何一键将当前请求导出为 cURL 命令。读完本文你将掌握editor、pager、pager_json、curl_export_extra_args等全部相关配置项并能根据实际场景自由组合出最适合自己的终端调试工作流。概述为什么需要外部工具Posting 内置了基于 Textual 的多行文本区域TextArea用于编辑请求体和查看响应但对于复杂内容终端内的编辑体验终究有限。Posting 允许你在 Posting 与外部编辑器、分页器之间快速切换例如用vim编辑请求体然后用less或fx浏览 JSON 响应体甚至可以为 JSON 单独配置一个专用分页器。这一能力全部围绕多行文本区域展开且每一项都可以通过配置文件、环境变量两种方式设置。从源码角度看这一功能的核心实现在 widgets/text_area.py 中BINDINGS [ Binding(f3,ctrlP, open_in_pager, Pager, idopen-in-pager), Binding(f4,ctrlE, open_in_editor, Editor, idopen-in-editor), ]也就是说当多行文本区域获得焦点时按 f4 或 ctrle 调用外部编辑器按 f3 或 ctrlp 调用外部分页器。完整的按键绑定说明可参考 docs/guide/keymap.md。配置优先级config.yaml 与环境变量Posting 的所有配置都遵循统一的加载优先级参见 docs/guide/configuration.md配置文件config.yaml环境变量POSTING_前缀.env文件因此本文涉及的所有设置项都可以等价地用POSTING_EDITOR、POSTING_PAGER、POSTING_PAGER_JSON、POSTING_CURL_EXPORT_EXTRA_ARGS这几个环境变量覆盖。配置文件的位置可通过posting locate config命令查看。外部编辑器External Editors当焦点位于多行文本区域时按 f4 即可将当前内容以临时文件的形式在外部编辑器中打开。配置方式外部编辑器的命令通过config.yaml中的editor键设置editor: vim也可以使用POSTING_EDITOR环境变量export POSTING_EDITORvim如果两者都未设置Posting 会回退到系统标准的EDITOR环境变量。从源码看这一回退逻辑是在配置模型定义时直接完成的——config.py 中editor字段的默认值即取自os.getenv(EDITOR)editor: str | None Field(defaultos.getenv(EDITOR)) The command to use for editing.!!! tip 使用 VSCode 或 Cursor 如果你希望在外部编辑器中用 VSCode 或 Cursor 打开内容请将POSTING_EDITOR设置为code -w或cursor -w其中的-wwait参数会让编辑器在关闭文件之前一直阻塞等待从而保证 Posting 能正确读回你的修改。底层实现原理当触发编辑操作时PostingTextArea.action_open_in_editor 会读取SETTINGS.get().editor若未配置则弹出警告通知No editor configured。随后调用_open_as_tempfile完成以下流程text_area.py用shlex.split(command)解析命令字符串支持带参数的编辑器命令如code -w根据文本区域的当前语言推断临时文件后缀json/html/yaml使用对应扩展名python使用.py其他内容无后缀确保外部编辑器能获得正确的语法高亮把当前文本写入一个临时文件通过self.app.suspend()挂起 Posting 的 TUI然后subprocess.call(editor_args)阻塞执行外部命令此时可以自由操作外部编辑器外部程序退出后如果是可写文本区域会把编辑后的文件内容读回 Posting只读区域则不写回删除临时文件并刷新界面。若命令本身无法执行例如编辑器路径不存在会抛出OSError并在 Posting 内弹出错误通知不会导致应用崩溃。这一机制也适用于请求脚本在 request_scripts.py 中脚本路径输入框绑定了 ctrle打开编辑器与 ctrlp打开分页器且脚本路径支持path/to/script.py:function_name语法并相对于 collection 根目录解析。编辑完脚本返回 Posting 后还会调用uncache_module清除模块缓存确保修改立即生效request_scripts.py。外部分页器External Pagers当焦点位于多行文本区域时按 f3 即可在外部分页器中查看当前内容。分页器天然适合只读浏览例如在less中查看较长的响应体。配置方式外部分页器通过config.yaml中的pager键设置pager: less也可以使用POSTING_PAGER环境变量export POSTING_PAGERless与编辑器类似pager的默认值同样取自系统环境变量PAGERconfig.pypager: str | None Field(defaultos.getenv(PAGER)) The command to use for paging.JSON 专用分页器pager_json针对 JSON 内容Posting 提供了专门的pager_json设置。当文本区域的语言被识别为 JSON例如响应内容类型是 JSON时会优先使用该分页器pager_json: fx对应的环境变量为POSTING_PAGER_JSONexport POSTING_PAGER_JSONfx从 config.py 的字段注释可知JSON 分页器会在从 TextArea 内打开分页器、且内容可被推断为 JSON时生效例如编辑器语言被设置为 JSON或响应内容类型标明是 JSON。若pager_json未设置则回退到上文所述的通用pager查找规则。选择 JSON 分页器的判定逻辑位于 action_open_in_pager只有当self.language json且settings.pager_json已配置时才使用 JSON 分页器否则一律走通用pager。这意味着一处配置即可为所有 JSON 响应启用fx等结构化浏览工具而普通文本仍交给less。分页器的只读语义与编辑器不同分页器打开的是只读场景。在_open_as_tempfile中分页后的文件不会被读回因为read_only区域不做写回操作这也符合分页器用于浏览的定位。导出为 cURL 命令Exporting to curl该功能自 Posting 2.4.0 起提供。Posting 可以将当前正在编辑的请求一键转换为 cURL 命令并复制到剪贴板方便分享给同事、粘贴到文档或在其他脚本中复现请求。操作方式打开命令面板Command Palette选择export: copy as curl即可。Posting 会基于当前界面上的请求状态即使尚未保存构建请求模型、转换成 cURL 命令并复制到剪贴板。从 commands.py 可以看到命令面板中实际提供了两个入口export: copy as curl复制请求为 cURL 命令默认会运行请求上绑定的 setup 脚本以便先解析出变量export: copy as curl (no setup scripts)跳过 setup 脚本直接导出。后者的存在是为了解决导出命令依赖运行时变量的问题如果你希望导出的命令不包含任何变量替换副作用可以使用无脚本版本。实现流程command_export_to_curl 的完整流程如下从当前 UI 状态构建RequestModel若启用 setup 脚本且请求配置了 setup 脚本先执行脚本失败会弹出Error in script通知获取环境变量并执行apply_template做变量替换存在未定义变量时会提示Undefined variable调用request_model.to_curl(extra_args...)生成命令复制到剪贴板。在 Apple Terminal 中会改用pyperclip因为 macOS 的 Terminal 不支持 OSC 52 剪贴板协议其他终端则通过 Posting 内置的copy_to_clipboard写入。附加 curl 参数curl_export_extra_args你可以在config.yaml中通过curl_export_extra_args设置需要附加到 cURL 命令中的额外参数curl_export_extra_args: --verbose -w %{time_total} %{http_code}对应的环境变量为POSTING_CURL_EXPORT_EXTRA_ARGS默认值为空字符串config.py。这些参数会被直接插入到剪贴板命令中curl之后最终生成形如下面的命令curl --verbose -w %{time_total} %{http_code} -X POST ...这一用法非常适合一次性附加调试类参数如--verbose或性能测量参数如-w %{time_total} %{http_code}而无需在 Posting 界面中逐项配置。导出命令的生成细节RequestModel.to_curl 展示了 cURL 命令的完整拼装逻辑理解它有助于预判导出结果先追加额外参数若配置了curl_export_extra_args非 GET 方法输出-X METHOD逐条输出启用的请求头-H Name: valueURL 中已有的查询参数会与请求中配置的查询参数合并后再拼装 URL请求体内容输出为-d ...form_data逐项输出-d namevalue认证信息Basic 认证输出-u user:passDigest 认证输出--digest -u user:passCookie 输出为--cookie namevalue未开启重定向时追加--no-location未验证 SSL 时追加--insecure超时时间非默认值5.0 秒时追加--max-time timeout配置了代理时追加--proxy ...最终以反斜杠换行拼接所有片段提高可读性。这些行为在 tests/test_curl_export.py 中有对应的单元测试验证例如简单的 GET 请求导出为curl \换行https://example.com/apiPOST 请求则包含-X POST与-d ...。这意味着你可以放心依赖该功能的输出格式。实践建议编辑器组合日常调试时把editor设为vim或code -w在请求体编辑框中按 f4 即可获得完整的外部编辑体验保存并退出后修改会自动同步回 Posting。响应浏览组合把pager设为less、pager_json设为fx响应体聚焦后按 f3普通文本用less翻页、JSON 用fx展开折叠两种浏览体验互不干扰。命令导出需要把当前请求发给同事或写入自动化脚本时使用export: copy as curl若请求依赖 setup 脚本注入的变量而你又想导出原始形态使用export: copy as curl (no setup scripts)再配合curl_export_extra_args附加--verbose等调试参数。团队一致化将这些配置写入config.yaml随仓库版本管理或通过.env文件按 dev/prod 环境切换具体配置格式可参考 docs/guide/configuration.md 与 tests/sample-configs/general.yaml。赞分享开发工具CLI【免费下载链接】postingThe modern API client that lives in your terminal.项目地址https://gitcode.com/gh_mirrors/po/posting点击查看免费下载相关推荐MySQL数据库监控终极指南mysqld_exporter从零到精通MySQL数据库监控终极指南mysqld_exporter从零到精通 在当今数据驱动的时代MySQL数据库监控已成为每个运维工程师和开发者的必备技能。mys运维yn编辑器中的自定义工具集成外部命令行工具yn编辑器中的自定义工具集成外部命令行工具 yn编辑器GitHub推荐项目精选是一款高度可扩展的Markdown编辑器支持版本控制、AI补全、思维导图、桌面应用代码编辑器如何快速解决Windows HEIC格式转换难题终极解决方案如何快速解决Windows HEIC格式转换难题终极解决方案 你是否曾在Windows电脑上收到iPhone朋友发来的照片却发现无法打开或者在处理大量苹果桌面应用图像处理创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考