logo
0
0
WeChat Login
Initial commit: pytest 中文文档镜像网站

pytest 中文文档

本项目是 pytest 官方文档的中文镜像站点,帮助中文开发者更好地理解和使用 pytest 测试框架。

📚 项目介绍

pytest 是一个成熟的全功能 Python 测试框架,使编写简单测试变得容易,同时支持复杂的应用程序和库功能测试。

本项目将 pytest 官方文档翻译成中文,并提供一个美观、易读的中文文档网站。

🚀 快速开始

本地预览

  1. 克隆或下载本项目
  2. 直接在浏览器中打开 index.html 文件
# 在浏览器中打开 open index.html # 或 xdg-open index.html

使用本地服务器(推荐)

# 使用 Python 3 python -m http.server 8000 # 使用 Python 2 python -m SimpleHTTPServer 8000 # 使用 Node.js http-server npx http-server -p 8000

然后在浏览器中访问:http://localhost:8000

📖 文档结构

pytest-docs-zh/ ├── index.html # 首页(包含主要内容) ├── get-started.html # 入门指南 ├── how-to-invoke.html # 如何调用 pytest ├── how-to-use-fixtures.html # 如何使用 fixtures ├── how-to-parametrize.html # 如何参数化测试 ├── api-reference.html # API 参考 ├── configuration.html # 配置 ├── styles.css # 样式文件 └── README.md # 本文件

📚 文档内容

快速开始

  • 入门指南 - 20 分钟掌握 pytest 基础知识
  • 安装和配置
  • 第一个测试
  • 异常处理
  • 测试分组

操作指南

  • 如何调用 pytest
  • 如何编写测试断言
  • 如何使用 fixtures(核心概念)
  • 如何标记测试函数
  • 如何参数化测试
  • 如何使用临时目录
  • 如何使用 monkeypatch
  • 如何捕获输出
  • 如何处理警告
  • 如何使用插件

参考文档

  • API 参考
  • Fixtures 参考
  • 配置选项
  • 退出码
  • 插件列表

深入理解

  • 测试结构解析
  • 关于 Fixtures
  • 导入机制
  • 类型提示
  • CI 流水线
  • 不稳定的测试

🎯 主要特性翻译

Fixtures

  • 模块化设计
  • 依赖注入
  • 作用域控制(function/class/module/session)
  • 参数化 fixtures
  • 自动清理(yield 和 finalizer)

参数化测试

  • 测试函数参数化
  • 测试类参数化
  • Fixture 参数化
  • 参数组合
  • 动态生成测试

断言

  • 基本断言
  • 异常断言
  • 警告断言
  • 浮点数比较
  • 自定义断言消息

标记

  • 内置标记
  • 自定义标记
  • 标记组合
  • 标记选择

🛠️ 技术栈

  • HTML5 - 页面结构
  • CSS3 - 样式和响应式设计
  • 纯静态网站 - 无需服务器端渲染

📝 翻译说明

翻译原则

  • 保持技术术语的准确性
  • 中文表达自然流畅
  • 代码示例保持英文
  • 保持原文的格式和结构

术语对照表

英文中文
fixture固件/测试夹具
test测试
assertion断言
parametrize参数化
marker标记
hook钩子
coverage覆盖率
teardown拆解/清理

🔗 相关链接

🤝 贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目!

如何贡献

  1. Fork 本项目
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

📄 许可证

本项目基于 pytest 官方文档翻译,遵循以下许可:

  • pytest 文档使用 MIT 许可证
  • 本翻译项目也采用 MIT 许可证

🙏 致谢

  • pytest 开发团队
  • pytest 社区
  • 所有贡献者

📞 联系方式

如有问题或建议,欢迎:

  • 提交 Issue
  • 发送邮件
  • 加入讨论组

注意:本项目是 pytest 官方文档的中文翻译,仅供学习和参考使用。如有冲突,请以官方文档为准。