themattrix/tox

Tox镜像

Docker Hub地址：https://registry.hub.docker.com/u/themattrix/tox/

镜像概述

本镜像旨在提供支持多Python版本（2.6、2.7、3.3-3.8、PyPy、PyPy3）的tox运行环境，帮助开发者快速验证代码在不同Python版本下的兼容性。镜像内置ONBUILD命令，可自动处理项目依赖和测试初始化。

核心功能

1. 多版本覆盖：支持Python 2.6至3.8及PyPy系列版本，满足多样化测试需求；
2. 自动环境初始化：通过ONBUILD命令自动复制requirements*.txt、tox.ini等文件，执行预安装脚本；
3. 分阶段测试：构建阶段仅初始化依赖，运行阶段直接测试代码，节省重复构建时间；
4. 灵活配置：支持SKIP_TOX参数跳过构建阶段的tox执行，适配不同场景。

使用场景

• Python项目的多版本兼容性验证；
• 持续集成（CI）流程中的自动化测试环节；
• 隔离环境下的代码质量检测。

配置说明

必要文件

项目需包含tox.ini文件，定义测试环境和命令。

可选文件

• install-prereqs.sh：安装项目依赖的前置系统库；
• requirements*.txt：项目依赖清单。

参数说明

• SKIP_TOX：构建时指定--build-arg SKIP_TOX=true可跳过构建阶段的tox初始化。

TOXBUILD环境变量

• 构建阶段（TOXBUILD=true）：仅安装依赖，不执行代码测试；
• 运行阶段：执行代码测试。

示例tox.ini配置：

ini
[tox]
envlist = py26,py27,py33,py34,py35,py36,py37,py38,pypy,pypy3
skipsdist = {env:TOXBUILD:false}

[testenv]
passenv = LANG
whitelist_externals = true
deps =
    -rrequirements_test_runner.txt
    -rrequirements_static_analysis.txt
    -rrequirements_test.txt
commands = {env:TOXBUILD:./tests.sh --static-analysis}

部署示例

构建镜像

bash
docker build --build-arg SKIP_TOX=true -t my-tox-project .

运行测试

bash
docker run my-tox-project