dintero/docker-pytest-bdd

docker-pytest-bdd 镜像文档

镜像概述和主要用途

docker-pytest-bdd 是一个用于使用 pytest-bdd 测试应用程序的 Docker 镜像，旨在简化在 Docker 或 docker-compose 环境中运行 pytest-bdd 的流程。

核心功能和特性

• 集成 pytest-bdd 测试框架，支持行为驱动开发(BDD)测试
• 预装多种用于 REST API 测试的实用库
• 灵活的使用方式：可作为基础镜像构建自定义测试镜像，或通过卷挂载直接运行测试
• 支持 pytest 命令行参数，可自定义测试执行方式

使用场景和适用范围

• 需要使用 pytest-bdd 进行 BDD 测试的项目
• REST API 测试场景
• 希望在 Docker 环境中标准化测试流程的开发和测试团队
• 需要快速启动 pytest-bdd 测试环境，避免本地依赖冲突的场景

使用方法和配置说明

1. 作为基础镜像使用

创建自定义 Dockerfile，将此镜像作为基础镜像，复制测试代码并运行测试：

dockerfile
FROM dintero/docker-pytest-bdd
COPY example /example
WORKDIR /example
CMD pytest

2. 通过卷挂载运行测试

直接挂载本地测试目录，运行测试命令：

bash
docker run \
  -v $(pwd)/example:/example \
  -w /example \
  dintero/docker-pytest-bdd \
    pytest -vv \
      --gherkin-terminal-reporter \
      --cucumberjson-expanded

其他常用命令示例：

• 获取所有 pytest 选项帮助：

  bash
  docker run dintero/docker-pytest-bdd pytest -h
  

• 仅运行匹配给定子字符串表达式的测试：

  bash
  docker run \
    -v $(pwd)/example:/example \
    -w /example \
    dintero/docker-pytest-bdd \
      pytest -vv \
        --gherkin-terminal-reporter \
        --cucumberjson-expanded \
        -k post
  

预装库说明

该镜像安装了许多用于使用 pytest-bdd 测试 REST API 的有用库，包括：

• https://github.com/Yelp/bravado-core: 支持 OpenAPI 规范 v2.0 (Swagger 2)
• PyJWT: Python 中的 JSON Web Token 实现
• Requests: 简洁易用的 HTTP 库（HTTP for Humans）

完整的已安装库列表可查看 https://github.com/dintero/docker-pytest-bdd/blob/master/requirements.txt，镜像构建详情可查看 https://github.com/dintero/docker-pytest-bdd/blob/master/Dockerfile。