SeldomQA/seldom 开源项目教程

1. 项目介绍

SeldomQA/seldom 是一个基于Python的自动化测试框架，专注于Web应用程序的接口测试。该项目提供了一种简洁易懂的方式来编写测试脚本，支持数据驱动测试和断言库，帮助开发者高效地进行接口验证和回归测试。

2. 项目快速启动

安装依赖

在你的终端中使用以下命令安装 seldom：

pip install seldom

编写测试脚本

创建一个名为 test_sample.py 的文件，然后添加以下代码来编写一个简单的测试示例：

from seldom import Seldom, post, get
from json import loads


class TestSampleApi(Seldom):
    @get("http://httpbin.org/get")
    def test_get(self):
        self.assertEqual(self.response.status_code, 200)

    @post("http://httpbin.org/post", data={"key": "value"})
    def test_post(self):
        response_json = loads(self.response.text)
        self.assertIn("form", response_json)


if __name__ == "__main__":
    Seldom.run()

运行测试

在终端中执行测试：

python test_sample.py

你将看到测试结果输出，包括请求状态码、响应时间和断言结果。

3. 应用案例和最佳实践

数据驱动测试

通过导入CSV或Excel文件来进行数据驱动测试，可以提高测试覆盖率：

import csv
from seldom import Seldom, post, get

class DataDrivenTest(Seldom):
    @get("http://httpbin.org/get")
    def test_with_data(self):
        with open('data.csv', newline='') as csvfile:
            reader = csv.DictReader(csvfile)
            for row in reader:
                self.assertEqual(self.response.status_code, int(row['status']))

    # ...其他数据驱动的测试用例...

if __name__ == "__main__":
    Seldom.run()

断言库的灵活运用

充分利用 seldom 提供的断言库，确保所有关键业务逻辑得到正确验证：

self.assertNotIn("error", self.response.text)
self.assertTrue("success" in self.response.json())

4. 典型生态项目

• requests: Seldom 基于 requests 库实现网络请求，你可以查看其文档以了解更多高级特性：Requests 文档
• json: 处理JSON响应时使用，用于解析和构建JSON对象：Python JSON 模块
• unittest: 虽然Seldom内置了测试运行器，但也可以结合使用 unittest 进行更复杂的测试组织和报告：unittest 文档

完成上述步骤后，你应该对如何使用 Seldom 进行接口自动化测试有了基本了解。继续探索 Seldom 提供的各种功能，优化你的测试工作流程。