HttpRepl 互操作的 RESTful HTTP 服务调试命令行工具

今天早上曽根セイラ告诉我一个好用的工具 HttpRepl 这是一个可以在命令行里面对 RESTful 的 HTTP 服务进行路由跳转和访问的命令行工具。可以使用 cd 这个命令和像文件跳转已经跳转到下一级的路由，也可以通过 dir 命令找到同一级的路由，同时支持集成到 VisualStudio 和 VisualStudio Code 里面

最近 ASP.NET 团队创建了一个叫 HttpRepl 的命令行工具，通过这个命令行工具可以像访问文件或文件夹一样访问 HTTP 服务。通过在命令行给一个入口的地址，然后就可以执行 dir 和 cd 两个命令分别用于枚举和跳转的功能

使用方法是先通过 dotnet tool install 安装这个工具，安装代码如下

dotnet tool install -g Microsoft.dotnet-httprepl --version “3.0.0-*”

安装完成之后，则可以使用如下命令指定入口

dotnet httprepl 入口URL

如官方的例子知道了访问 http://localhost:65369/ 链接

dotnet httprepl http://localhost:65369/

如果在执行以上命令的时候提示没有安装足够的 .NET Core 框架版本，那么请自行从官方下载最新版本和最新预览版本安装

It was not possible to find any compatible framework version
The specified framework 'Microsoft.NETCore.App', version '3.0.0-preview6-27804-01' was not found

设置之后则可以通过 dir 查看同一级的路由里面有哪些可访问的链接

通过输入 get 命令就可以直接拉取，用起来十分简单，详细使用方法请下载安装之后输入以下命令就可以看到

dotnet httprepl http://blog.lindexi.com
help

看到的控制台输出大概如下

C:\Users\lindexi>dotnet httprepl http://blog.lindexi.com
(Disconnected)~ set base "http://blog.lindexi.com"

http://blog.lindexi.com/~ help

HTTP Commands:
Use these commands to execute requests against your application.

GET            get - Issues a GET request
POST           post - Issues a POST request
PUT            put - Issues a PUT request
DELETE         delete - Issues a DELETE request
PATCH          patch - Issues a PATCH request
HEAD           head - Issues a HEAD request
OPTIONS        options - Issues a OPTIONS request

set header     Sets or clears a header for all requests. e.g. `set header content-type application/json`

Navigation Commands:
The REPL allows you to navigate your URL space and focus on specific APIs that you are working on.

set base       Set the base URI. e.g. `set base http://locahost:5000`
set swagger    Sets the swagger document to use for information about the current server
ls             Show all endpoints for the current path
cd             Append the given directory to the currently selected path, or move up a path when using `cd ..`

Shell Commands:
Use these commands to interact with the REPL shell.

clear          Removes all text from the shell
echo [on/off]  Turns request echoing on or off, show the request that was made when using request commands
exit           Exit the shell

REPL Customization Commands:
Use these commands to customize the REPL behavior.

pref [get/set] Allows viewing or changing preferences, e.g. 'pref set editor.command.default 'C:\\Program Files\\Microsoft VS Code\\Code.exe'`
run            Runs the script at the given path. A script is a set of commands that can be typed with one command per line
ui             Displays the Swagger UI page, if available, in the default browser