thekevjames/coveralls

Coveralls for Python Docker镜像

镜像概述

该Docker镜像是coveralls-python（PyPI上的"coveralls"包）的最小化运行环境，用于将Python项目的代码覆盖率统计结果无缝上传至https://coveralls.io/服务。coveralls.io是一个在线发布代码覆盖率统计的平台，本镜像集成了https://coverage.readthedocs.io/en/latest/，支持与`pytest`、`nosetests`等主流Python测试框架配合使用。

测试状态

版本信息

兼容性

下载量

核心功能与特性

• 与coverage.py无缝集成，支持生成Python项目代码覆盖率报告
• 兼容主流Python测试框架（pytest、nosetests等）
• 最小化镜像设计，减少资源占用
• 支持将覆盖率报告直接上传至coveralls.io服务

使用场景

• Python项目在CI/CD流程中自动化生成并上传代码覆盖率报告
• 需要容器化环境运行coveralls命令的场景
• 希望快速集成coveralls.io服务的Python项目

使用方法

基本用法

1. 准备环境变量：需设置COVERALLS_REPO_TOKEN（从coveralls.io项目设置中获取）

2. 运行容器：

   bash
   docker run --rm \
     -v $(pwd):/app \
     -e COVERALLS_REPO_TOKEN=your_repo_token \
     docker.xuanyuan.run/thekevjames/coveralls \
     coveralls
   

配合coverage.py使用

在项目中生成覆盖率数据后上传：

bash
# 本地生成覆盖率数据（需先在项目中运行测试）
coverage run --source=your_package -m pytest tests/

# 使用Docker镜像上传报告
docker run --rm \
  -v $(pwd):/app \
  -e COVERALLS_REPO_TOKEN=your_repo_token \
  docker.xuanyuan.run/thekevjames/coveralls \
  coveralls

版本兼容性

• 2.0及以上版本：已不再支持生命周期结束（EOL）的Python版本及过旧的coverage版本，仅对非EOL环境提供最佳支持。
• 旧环境兼容：若运行在过时环境且包管理器支持版本检查，会自动安装最新兼容版本；若环境更旧，需固定版本为coveralls<2，可通过指定Docker镜像旧标签实现（如thekevjames/coveralls:1.x）。

更多信息

完整使用说明及文档，请参阅http://coveralls-python.readthedocs.io/en/latest/。