Fedora + Pythons + Tox Docker镜像

!CI/CD状态

本镜像旨在帮助用户在Docker容器中使用所有可用Python版本运行Tox测试。镜像托管于Docker Hub，每次推送到master分支后自动构建。

Fedora基础镜像版本

我们通常会将最新Python版本添加到所有受支持的Fedora发行版中，同时也会适时移除最旧版本。因此，当Fedora N版本终止支持（EOL）时，本容器镜像会从Fedora N迁移至N+1版本。

已安装软件包

在稳定版Fedora基础上，本Docker镜像包含：

• Python版本：3.6、3.8、3.9、3.10、3.11、3.12、3.13、3.14
• Pypy版本：Pypy2、Pypy3.9、Pypy3.10、Pypy3.11
• python3-pip
• 编译工具：gcc、gcc-c++、git-core、make
• Tox测试工具
• virtualenv

Docker和Podman支持

本镜像完全兼容Docker和Podman，用户可选择偏好的容器管理工具。

使用场景与适用范围

适用于需要在多种Python环境下运行Tox测试的Python项目，支持：

• 本地源代码测试
• 远程GIT仓库代码测试
• 安装系统级依赖包（如C库）
• 指定测试环境或并行运行测试

使用方法与配置说明

本地源代码测试

将当前项目目录挂载到容器中，自动运行Tox测试：

bash
cd example_project
docker run --rm -it -v $PWD:/src -w /src fedorapython/fedora-python-tox

命令参数说明：

• docker run：运行Docker镜像
• --rm：容器退出后自动删除
• -i：保持标准输入（STDIN）打开
• -t：分配伪终端（pseudo-TTY）
• -v $PWD:/src：将当前工作目录挂载到容器内的/src目录
• -w /src：将容器内工作目录设置为/src（挂载点）
• fedorapython/fedora-python-tox：镜像名称

容器会自动运行Tox，输出测试结果。首次运行时会自动拉取镜像：

Unable to find image 'fedorapython/fedora-python-tox:latest' locally
Trying to pull repository docker.io/fedorapython/fedora-python-tox ...
sha256:d4b51931dd86a33552b6a08f39575db336b606f4ccebbc48f390d7f728367a6f: Pulling from docker.io/fedorapython/fedora-python-tox

限制Tox测试环境

通过TOXENV环境变量指定特定测试环境（如仅运行pypy3测试）：

bash
cd example_project
docker run --rm -it -v $PWD:/src -w /src -e TOXENV=pypy3 fedorapython/fedora-python-tox

并行运行测试

通过TOX_PARAMS环境变量传递Tox命令行参数，实现并行测试：

bash
docker run --rm -it -v $PWD:/src -w /src -e TOX_PARAMS="-p auto" fedorapython/fedora-python-tox

从GIT仓库测试

通过GIT_URL环境变量指定远程仓库URL，容器会自动克隆代码并运行测试：

bash
docker run --rm -it -e GIT_URL=[***] fedorapython/fedora-python-tox

安装Fedora RPM软件包

如需系统级依赖（如C库），通过DNF_INSTALL环境变量指定要安装的RPM包：

bash
docker run --rm -it -v $PWD:/src -w /src -e DNF_INSTALL="libyaml-devel libgit2-devel" fedorapython/fedora-python-tox

支持复杂依赖规格，如：

• 包名：libgit2-devel
• pkgconfig名称：pkgconfig(libgit2)
• 命令路径：/usr/bin/cowsay

含空格的规格需用单引号包裹：-e DNF_INSTALL="libyaml-devel 'pytest > 7'"

指定工作目录（WORKDIR）

若tox.ini不在项目根目录，通过WORKDIR环境变量指定测试目录：

bash
docker run --rm -it -e TOXENV=py310-minimal -e GIT_URL=[***] -e WORKDIR=python fedora-python-tox

许可证

MIT