Betamax：HTTP 请求模拟工具，一次录制永久回放

Betamax：HTTP 请求模拟工具，一次录制永久回放

betamax 在 GitHub 上拿到了 584 Star。

Python 开发者在写测试的时候，经常要面对 HTTP 请求的问题。每次跑测试都要发真实的网络请求，慢，而且不可控。远程服务挂了、网络超时了、API 限流了，测试就会失败。Betamax 解决的就是这个场景。

1、这工具是干什么的

一句话：记录 HTTP 请求和响应，存到本地文件（cassette），下次同样的请求来了直接回放，不再发真实的网络请求。

它是 Ruby 社区知名项目 VCR 的 Python 移植版，专门配合 requests 库使用。第一次跑测试时，Betamax 把真实的请求响应录下来。之后不管网络通不通、远程服务是否在线，测试都能正常跑。

2、为什么要用它

写过 API 测试的人都清楚这种体验：测试用例调了第三方接口，跑一次等好几秒，CI 环境网络不稳定还经常超时。更麻烦的是，你只是在测自己的业务逻辑，结果却要依赖远程服务的状态。

Betamax 把这个问题解决了。第一次跑测试时正常发请求，把请求和响应一起录下来，存成 cassette 文件。之后每次跑测试，Betamax 拦截发出的请求，找到匹配的记录直接返回。断网也能跑。

Cassette 文件是纯文本格式，可以提交到 Git 仓库。团队成员共享同一套 mock 数据，测试结果一致，不会出现本地能过 CI 过不了的情况。

3、怎么用

安装：

pipinstallbetamax

配置 cassette 存放目录，然后在测试代码里用 Betamax 上下文管理器：

frombetamaximportBetamaxfromrequestsimportSessionwithBetamax.configure()asconfig:config.cassette_library_dir='tests/fixtures/cassettes'deftest_user():session=Session()withBetamax(session)asvcr:vcr.use_cassette('user')resp=session.get('https://api.github.com/user',auth=('user','pass'))

Cassette 也可以在上下文声明时直接指定：

deftest_repo():session=Session()withBetamax(session).use_cassette('repo'):resp=session.get('https://api.github.com/repos/sigmavirus24/github3.py')

4、VCR cassette 兼容

Betamax 能直接使用 VCR 录制的 cassette 文件，反过来录制的文件也保持兼容。一个细节差异是 python-requests 的响应对象带 URL 属性，VCR 原生的 cassette 没有存这个字段。不过影响不大。

5、适合谁用

• 用 Python requests 做 API 对接、需要写单元测试的开发者
• CI 环境网络受限、但又需要跑集成测试的团队
• 希望测试稳定可重复、不依赖外部服务的人

做 API 对接、需要写单元测试的开发者

• CI 环境网络受限、但又需要跑集成测试的团队
• 希望测试稳定可重复、不依赖外部服务的人