tavern 0.30.0

快速启动

首次运行pip install tavern

然后，让我们创建一个基本测试， test_minimal.tavern.yaml ：

---# Every test file has one or more tests...test_name:Get some fake data from the JSON placeholder API# ...and each test has one or more stages (e.g. an HTTP request)stages:-name:Make sure we have the right ID# Define the request to be made...request:url:https://jsonplaceholder.typicode.com/posts/1method:GET# ...and the expected response code and bodyresponse:status_code:200body:id:1

此文件可以有任何名称，但如果要将pytest与 酒馆，它只接收名为 test*.tavern.yaml的文件

然后可以这样运行：

$ pip install tavern[pytest]
$ py.test test_minimal.tavern.yaml  -v
===================================test session starts===================================
platform linux -- Python 3.5.2, pytest-3.4.2, py-1.5.2, pluggy-0.6.0 -- /home/taverntester/.virtualenvs/tavernexample/bin/python3
cachedir: .pytest_cache
rootdir: /home/taverntester/myproject, inifile:
plugins: tavern-0.7.2
collected 1 item

test_minimal.tavern.yaml::Get some fake data from the JSON placeholder API PASSED   [100%]================================1 passed in 0.14 seconds=================================

强烈建议您使用酒馆和pytest-不仅 它有很多实用程序来控制测试的发现和执行， 有大量的插件可以改进你的开发 经验。如果出于某种原因您绝对不能使用pytest，请使用 酒馆ci 命令行界面：

$ pip install tavern
$ tavern-ci --stdout test_minimal.tavern.yaml
2017-11-08 16:17:00,152 [INFO]: (tavern.core:55) Running test : Get some fake data from the JSON placeholder API
2017-11-08 16:17:00,153 [INFO]: (tavern.core:69) Running stage : Make sure we have the right ID
2017-11-08 16:17:00,239 [INFO]: (tavern.core:73) Response: '<Response [200]>'({"userId": 1,
  "id": 1,
  "title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
  "body": "quia et suscipit\nsuscipit recusandae consequuntur expedita et cum\nreprehenderit molestiae ut ut quas totam\nnostrum rerum est autem sunt rem eveniet architecto"})2017-11-08 16:17:00,239 [INFO]: (tavern.printer:9) PASSED: Make sure we have the right ID [200]

为什么不邮递员，失眠或发热等？

酒馆是一个专注的工具，它能很好地完成一件事：自动化测试 API. < /P>

邮递员 和 失眠症 是覆盖范围广泛的优秀工具 restfulapi的一系列用例，实际上我们在 邮递员。然而，特别是在自动化测试方面，酒馆 比邮递员有几个优点：功能齐全的蟒蛇 编写易于重用的自定义验证函数的环境- 与restfulapi一起测试基于mqtt的系统。-无缝 与pytest集成，将所有测试放在一个地方—更简单， 更加简洁明了的测试语言

酒馆邮递员和失眠症患者做的事情不多。为了 例如，酒馆没有gui，也不进行api监控或 模拟服务器。另一方面，tavern是免费的、开源的 开发人员自动化测试的更强大工具。

pyresttest 是一个类似于tavern的测试restfulapi的工具，但是 不再积极发展。在mqtt测试之上，tavern有 与PyrestTest相比的其他几个优点是 更好的开发人员体验：

• 更清晰的测试语法，更直观，尤其是 非开发商
• 验证功能更灵活，更易于使用
• 更好地解释考试失败的原因

黑酒馆

如果你想给酒馆增加一个特色或者只是随便玩玩 在本地，首先创建本地开发项目是个好计划 环境（ 第 页有 很好的使用python开发环境的入门知识。 在您创建了开发环境之后， pip安装tox 并运行 tox 以运行单元测试。如果你想要 要运行集成测试，请确保 安装并运行docker tox -c tox integration.ini （记住这可能需要一段时间。） 就这么简单！

如果你想在酒馆里开发东西，请输入virtualenv并运行 pip install -r requirements.txt 要安装库，任何要求， 以及其他有用的开发选项。

酒馆使用[黑]（ https://github.com/ambv/black ）保存所有代码 格式一致。有一个预提交钩子可以运行black 通过运行预提交来启用

如果您想添加一个功能以合并回主线酒馆：

• 添加所需功能
< DL>
为您的功能添加一些测试：
> UL>
• 如果您正在添加一些实用程序功能，例如改进验证 在响应中，添加一些单元测试可能是最好的。这些在 tests/unit/ 文件夹，并使用pytest编写。
• 如果要添加更高级的功能，如额外验证 函数，或直接依赖于 输入yaml，还可以添加一些集成测试。在 在编写本文时，可以通过在 tests/integration/server.py 和 相同的目录。一旦我们找到合适的 插件系统已实现。

致谢

Tavern利用了几个优秀的开源项目：

• pytest ，测试 框架酒馆与
• http的请求 请求
• yaml 和 测试语法的pyyaml
• pykwalify ，用于yaml模式 验证
• pyjwt ，用于解码杰森韦伯 令牌
• 颜色日志 格式化终端输出
• paho mqtt ，用于 发送MQTT消息

维护

酒馆目前由

• @迈克尔伯尔顿
• @本豪斯