31z4/tox

tox的Docker镜像封装

镜像概述和主要用途

tox是一个通用的Python虚拟环境管理和测试命令行工具。本多架构Docker镜像封装了tox v4，同时包含常见构建依赖（如make、gcc等）以及当前活跃的CPython版本：3.9、3.10、3.11、3.12、3.13。镜像安全、经过测试、紧凑且易于使用，目前支持以下平台：linux/arm64/v8、linux/amd64。

核心功能和特性

• 多架构支持：兼容linux/arm64/v8和linux/amd64平台
• 完整Python版本：包含当前所有活跃的CPython版本（3.9至3.13）
• 丰富构建依赖：内置make、gcc等常用构建工具
• 安全可靠：经过严格测试，确保环境稳定性
• 紧凑高效：优化镜像大小，便于快速部署和使用

使用场景和适用范围

适用于需要在多个Python版本环境中测试Python项目的场景，如：

• 开源项目的跨版本兼容性测试
• CI/CD流程中的自动化测试环节
• 本地开发环境的快速搭建与版本隔离

使用方法和配置说明

基本使用

推荐的使用方式是将包含tox配置文件和代码的目录挂载为卷。假设项目位于主机的当前目录，使用以下命令运行不带任何参数的tox：

bash
$ docker run -v `pwd`:/tests -it --rm 31z4/tox

也可以传递子命令和标志：

bash
$ docker run -v `pwd`:/tests -it --rm 31z4/tox run-parallel -e black,py312

注意：镜像的工作目录配置为/tests。

构建衍生镜像

如需安装额外的Python版本/实现或Ubuntu软件包，可创建衍生镜像。确保需要时切换到root用户，操作完成后切换回tox用户：

Dockerfile
FROM 31z4/tox

USER root

RUN set -eux; \
    apt-get update; \
    DEBIAN_FRONTEND=noninteractive \
    apt-get install -y --no-install-recommends \
        python3.7; \
    rm -rf /var/lib/apt/lists/*

USER tox

示例：测试Flask项目

以下演示展示如何使用此镜像测试https://github.com/pallets/flask%EF%BC%9A

!tox演示

可通过以下命令尝试：

bash
$ git clone --depth 1 --branch 3.0.0 https://github.com/pallets/flask.git
$ docker run -v `pwd`/flask:/tests -it --rm 31z4/tox run-parallel --skip-env style

版本控制

镜像标签格式为{tox-version}-{image-version}，其中image-version部分可选，并遵循语义化版本。例如，当发生不兼容变更（如移除已终止支持的Python版本或更改基础镜像）时，镜像主版本号将递增。

生产环境使用时，建议固定tox和镜像版本（例如31z4/tox:4.4.5-2.1.1）。

许可证

查看https://github.com/tox-dev/tox/blob/main/LICENSE%E5%92%8CPython 3的许可证信息。

与所有Docker镜像一样，本镜像可能还包含其他软件，这些软件可能采用其他许可证（如基础发行版中的Bash等，以及所包含主要软件的任何直接或间接依赖项）。