perl-toolkit

My personal toolkit for perl + CI/CD.

Almost everything here is built on the Open Build Service in Project: home:josegomezr:perl-toolkit.

Everything it built on top of opensuse/tumbleweed

TOC

• Container Images
• Workflows
  • github workflows perl tidyall yml tidyall workflow
    • Usage
  • github workflows perl prove yml prove workflow
    • Usage
  • github workflows perl critic yml perlcritic workflow
    • Usage

Container Images

• base-perl/Dockerfile: A base image with the bare-minimum perl requirements.
• tester-perl/Dockerfile: An image with the a big test toolkit to speedup CI/CD pipelines.

Workflows

.github/workflows/perl-tidyall.yml: tidyall workflow

• Inputs:

  • working-directory: Current working directory. Defaults to ..

  • tidyall-args: Args for tidyall invocation. Defaults to --check --all.

  • prepend-perl5lib-env: Extra load paths to add for tidyall invocation.

  • tidyall-executable: Name/location of the tidyall command, useful for projects where tidyall calls are wrapped into other script (like a make command).

Usage

# in: .github/workflows/%your-workflow%.yml
#
# [... snip ...]
jobs:
  prove:
    uses: josegomezr/perl-toolkit/.github/workflows/perl-tidyall.yml@v1
    name: "TidyAll"
# [... snip ...]

.github/workflows/perl-prove.yml: prove workflow

• Inputs:

  • working-directory: Current working directory. Defaults to ..

  • prove-args: Args for prove invocation. Defaults to -lm.

  • prepend-perl5lib-env: Extra load paths to add for prove invocation.

  • prove-executable: Name/location of the prove command, useful for projects where prove calls are wrapped into other script (like a make command).

Usage

# in: .github/workflows/%your-workflow%.yml
#
# [... snip ...]
jobs:
  prove:
    uses: josegomezr/perl-toolkit/.github/workflows/perl-prove.yml@v1
    name: "Prove"
# [... snip ...]

.github/workflows/perl-critic.yml: perlcritic workflow

• Inputs:

  • working-directory: Current working directory. Defaults to ..

  • perl-critic-args: Args for perlcritic invocation. Defaults to --quiet ..

  • prepend-perl5lib-env: Extra load paths to add for perlcritic invocation.

  • perlcritic-executable: Name/location of the perlcritic command, useful for projects where perlcritic calls are wrapped into other script (like a make command).

Usage

# in: .github/workflows/%your-workflow%.yml
#
# [... snip ...]
jobs:
  prove:
    uses: josegomezr/perl-toolkit/.github/workflows/perl-critic.yml@v1
    name: "Perlcritic"
# [... snip ...]