你应该立刻放下curl,拿起httpie来高效干活
背景
本文作者长期从事微服务开发,在实践中,httpie给我提效不少。
如果你还在使用curl,那么这篇文章就是给你的。
python有一个给人类使用的requests库,非常的简单方便。httpie就是基于requests开发的,给人类用的命令行工具,取代curl的绝佳工具。
什么叫“给人类用的”
经过长期的理解,我的总结如下:
给人类用的,需要满足如下:
- 将常见场景、大概率行为变成了默认值
- 只需人类输入最核心的业务信息,多余的语法格式由程序自己分析判断
给机器用的,就是所有的行为,不管是常见还是不常见的,都需要具体命令告知它。
最开始的技术,都是给机器用的。在长期的实践中,人类出现了很多常见行为或场景,将这些行为、场景变成默认值等方式,可以在大概率场景中,节省人类的工作量。
参考资料
httpie应用精华
httpie VS curl
curl
curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{ \
"send_type": "wechat", \
"to": [ \
"xn080xxx", \
], \
"content": "this is xxx alert" \
}' 'http://aaa.xxx.com/api/v1/alert'
http
http aaa.xxx.com/api/v1/alert send_type=tts to:='["xn080xxx"]' content="this is alert"
可以看到,http版本比curl简单了很多,主要原因如下:
- 将常见场景、大概率行为变成了默认值
- 只需人类输入最核心的业务信息,多余的语法格式由程序自己分析判断
具体为:
1. get和post是大概率行为,人类执行get时,一般不带request data,带request data的基本都是post行为。因此,httpie将这两个常见大概率行为变成默认值。—— 如果http命令不带request data,默认行为是get;如果带了request data,默认行为是post
2. 采用json交互基本是当今人类的最常见的场景,因此,header的两个地方默认设置为application/json,可以在大概率场景中节省人工输入
3. json交互作为大概率事件,简化json数据输入可以节省很多人工。curl采用json的raw的格式输入,不是很高效。httpie用=代表request data,:代表header data,==代表query data,自动识别,无需呆板的完整定义各个数据体,将多余的人工操作尽可能自动化
4. 字符串输入是大概率行为,因此字符串的赋值,无需双引号,除非里面有空格等特殊字符。将其他较小概率的数据类型采用:=进行输入(raw格式,如整形数,数组)
5. 不加http://也是可以的,这是默认行为
从以上分析可以看出,httpie将大概率的人工操作进行了简化设计,因此,人工操作可以节省很多时间。
安装
这么好的东西赶紧安装
pip install httpie
使用时,是用http ,不是httpie
再简单一些
见下面这个常见指令,往一个https网站post一个json数据,而且需要认证。
http https://aaa.xxx.com/api/v1/alert send_type=tts to:='["xn080xxx"]' content="this is alert -a username:password"
简化https
在你的~/.bashrc等类似文件加入:
alias https='http --default-scheme=https'
这样,可以简化为:
https aaa.xxx.com/api/v1/alert send_type=tts to:='["xn080xxx"]' content="this is alert -a username:password"
这样的alias非常方便,http和https非常形象直观
简化认证并隐藏密码信息
session方法
第一次执行
https aaa.xxx.com/api/v1/alert send_type=tts to:='["xn080xxx"]' content="this is alert" -a username:password --session=your-session-name
这样,就会产生一个session文件,里面包含了header,认证,cookie等信息(默认在~/.httpie/sessions/your_url/your_sesssion_name里)
以后执行,直接使用该session文件即可,无需再加-a username:password
https aaa.xxx.com/api/v1/alert send_type=tts to:='["xn080xxx"]' content="this is alert" --session=your-session-name
.netrc方法(更简单)
在~/.netrc中加入
machine url_you_want_to_visit
login your_username
password your_password
这样,程序会自动带上这个认证,语句简化为:
https aaa.xxx.com/api/v1/alert send_type=tts to:='["xn080xxx"]' content="this is alert"
~/.netrc是一种通用方法,支持该文件的其他网络操作都可以采用这种方法。
简化json数据
我们会发现,在开发测试中,经常需要重复类似指令,能否把json数据也简化输入呢
简化麻烦输入的非字符串部分
上面的语句最麻烦,且经常记错的就是 to:=’[“xn080xxx”]’,单引号,双引号不能搞错,最外面是单引号,里面的元素是双引号,我用了N多次,一段时间没用就又容易忘记。
简化它
httpie支持文件输入
新增一个例如to.json文件,里面内容
["xn080xxx"]
这样,上面语句简化为:
https aaa.xxx.com/api/v1/alert send_type=tts to:[email protected] content="this is alert"
@后面跟的就是文件
全部数据来自文件(最简单)
采用重定向即可
新增文件,例如send.json
{
"send_type": "tts",
"to": ["xn080xxx"],
"content": "this is alert"
}
上面语句简化为:
https aaa.xxx.com/api/v1/alert < send.json"
是的,这已经极其精简了!
httpie在脚本中应用的注意事项
httpie在脚本中使用,需要注意几点(易错点):
http默认不理会返回的状态码,如果需要区分2xx,4xx等,需要加入 –check-status
https --check-status aaa.xxx.com/api/v1/alert < send.json"
这样,当2XX返回时, echo $?得到是0;当4xx返回时,echo $? 得到的是4
in输入管道的问题
这个坑被坑过,脚本中,in输入管道被重定向,会被输入一些数据,产生不可预料的行为。
应该–ignore-stdin
例如:
https --check-status --ignore-stdin aaa.xxx.com/api/v1/alert < send.json"
课外:有趣的http-prompt
pip install http-prompt 后
你可以体验用全新的理念来操作httpie的方法
http-prompt
解疑
- 当使用环境变量时,无法正常使用,如:
export phone=1862030xxxx
https aaa.xxx.com/api/v1/alert send_type=tts to:='["${phone}"]' content="this is alert"
解答
本质是单引号内的变量不会被正常解析,后端收到的to的value实际是${phone}。
单引号内如果需要解析变量,多加一层单引号即可,如下:
https aaa.xxx.com/api/v1/alert send_type=tts to:='["'${phone}'"]' content="this is alert"
实际上,如果shell有语法高亮,也会发现单引号里面其实是不会翻译变量的。
(提高:对于很多语言,也是遵循这个规则,单引号内的变量不翻译,双引号内才翻译变量,例如groovy语言等)