Schemathesis 多线程测试进度显示优化方案

在 API 测试工具 Schemathesis 中，当使用多线程（worker）模式进行测试时，测试进度显示存在一个明显的用户体验问题。本文将深入分析这个问题，并介绍即将推出的改进方案。

问题背景

Schemathesis 是一个基于 OpenAPI/Swagger 规范的 API 测试工具，能够自动生成测试用例并执行。在单线程模式下运行时，它会清晰地显示每个 API 端点的测试进度，例如：

GET /trees E   [ 20%]
POST /trees E  [ 40%]
GET /trees/{treeId} E  [ 60%]
PUT /trees/{treeId} E  [ 80%]
DELETE /trees/{treeId} E [100%]

这种直观的进度显示让用户能够清楚地了解测试的执行情况。然而，当用户启用多线程模式（通过 -w auto 或 -w 2 等参数）时，这种详细的端点级进度显示就消失了，只剩下 pytest 的基本状态信息。

技术分析

这个问题的根源在于 Schemathesis 最初的设计遵循了 pytest 的显示模式。在单线程环境下，测试是按顺序执行的，因此可以简单地逐个显示每个端点的进度。但在多线程环境下，多个测试会并行执行，传统的线性进度显示方式就不再适用。

实现多线程环境下的详细进度显示面临几个技术挑战：

1. 并发更新问题：多个线程需要同时更新显示内容，必须处理好并发控制
2. 显示空间限制：终端空间有限，需要合理组织多个并行测试的显示
3. 性能考量：频繁的显示更新不能影响测试本身的性能

解决方案

Schemathesis 开发团队已经设计了一个新的显示方案，即将在后续版本中推出。新方案具有以下特点：

1. 并行进度显示：能够同时显示所有 worker 正在执行的测试端点
2. 实时更新：每个端点的测试进度会实时更新
3. 清晰布局：使用类似表格的布局，使并行执行的测试状态一目了然

这个改进将显著提升多线程测试时的用户体验，让用户能够像单线程模式一样清楚地了解测试执行情况。

实现技术

新方案可能会采用以下技术实现：

1. 终端UI库：考虑使用像 rich 这样的高级终端UI库来处理复杂的显示需求
2. 线程安全更新：实现线程安全的显示更新机制
3. 自适应布局：根据终端大小自动调整显示内容

总结

Schemathesis 对多线程测试进度显示的改进，体现了对用户体验的持续关注。这个改进不仅解决了当前的问题，还为未来更复杂的并行测试场景奠定了基础。对于频繁使用多线程模式进行大规模API测试的用户来说，这将是一个值得期待的功能升级。