docker-perl-tester

镜像概述和主要用途

本仓库提供预安装了多个常用CPAN模块的Perl Docker镜像。包含aspell和aspell-en包、cpanminus、App::cpm、Devel::Cover、各种测试模块，以及带有部分常用插件的Dist::Zilla（适用于Perl >= 5.14）。

镜像目前每日更新（若未来出现问题可能调整频率），确保您能测试最新的CPAN栈。注意：若某个依赖安装失败，镜像将不会发布，因此不会对您造成影响。

核心功能和特性

Perl模块列表

所有Perl版本可用

• Code::TidyAll::Plugin::SortLines::Naturally
• Code::TidyAll::Plugin::UniqueLines
• Devel::Cover
• Devel::Cover::Report::Codecov
• Devel::Cover::Report::Coveralls
• File::Temp
• List::MoreUtils
• Module::Build
• Pod::Coverage::TrustPod
• Test2::Bundle::Extended
• Test2::Plugin::NoWarnings
• Test2::Suite
• Test2::Tools::Explain
• Test::Builder
• Test::CPAN::Meta
• Test::Deep
• Test::Differences
• Test::EOL
• Test::Fatal
• Test::MinimumVersion
• Test::MockModule
• Test::Mojibake
• Test::More
• Test::Needs
• Test::Pod
• Test::Pod::Coverage
• Test::Portability::Files
• Test::RequiresInternet
• Test::Spelling
• Test::Synopsis
• Test::Version
• Test::Warnings

仅Perl 5.10及更高版本可用

• Code::TidyAll::Plugin::Test::Vars
• Pod::Readme
• Test::Vars

使用场景和适用范围

适用于Perl项目的测试与持续集成场景，可在不同Perl版本下快速搭建包含常用测试模块的环境，简化测试流程，确保代码在多种Perl版本中兼容。

使用方法和配置说明

镜像获取

镜像可在Docker Hub获取，仓库地址：[***]

可用标签：5.30、5.28、5.26、5.24、5.22、5.20、5.18、5.16、5.14、5.12、5.10、5.8、latest

基础使用示例

通过以下命令启动镜像：

docker run -it perldocker/perl-tester:latest

持续集成配置（GitHub Workflow示例）

以下是在Linux环境下针对Perl 5.8至最新版本的测试工作流配置，可保存为.github/workflow/linux.yml。

注：示例使用cpm从cpanfile安装依赖，支持的Perl版本也可使用Dist::Zilla。

name: linux

on:
  push:
    branches:
      - '*'
    tags-ignore:
      - '*'
  pull_request:

jobs:
  perl:
    env:
      # 部分插件运行测试时仍需要此环境变量
      PERL_USE_UNSAFE_INC: 0
      AUTHOR_TESTING: 1
      AUTOMATED_TESTING: 1
      RELEASE_TESTING: 1

    runs-on: ubuntu-latest

    strategy:
      fail-fast: false
      matrix:
        perl-version:
          - 'latest'
          - '5.28'
          - '5.26'
          - '5.24'
          - '5.22'
          - '5.20'
          - '5.18'
          - '5.16'
          - '5.14'
          - '5.12'
          - '5.10'
          - '5.8'

    container:
      image: perldocker/perl-tester:${{ matrix.perl-version }}

    steps:
      - uses: actions/checkout@v1
      - name: 查看Perl版本信息
        run: perl -V
      - name: 安装依赖
        run: cpm install -g --no-test --show-build-log-on-failure --cpanfile cpanfile
      - name: 生成Makefile
        run: perl Makefile.PL
      - name: 运行测试
        run: make test

GitHub仓库

[***]

作者

@oalders发起了该项目，@atoomic致力于提高其公共可见性，欢迎志愿者和想法来改进项目。