perlessentials/perl-essentials repository overview

⁠perl-essentials

perl-essentials extends the official Perl images with a curated, production-oriented CPAN stack commonly required for automation, data processing, reporting, database access, testing, profiling, and web integrations.

Source and complete documentation: https://github.com/M-M-M-M/perl-essentials⁠

⁠Included module families

• Database: DBI, DBD::Pg, DBD::SQLite
• JSON: JSON, JSON::XS, Cpanel::JSON::XS, JSON::MaybeXS
• XML: XML::LibXML, XML::Hash, XML::XML2JSON
• HTTP/Web: LWP::UserAgent, REST::Client, HTTP::Cookies
• Spreadsheet: Excel::Writer::XLSX, Spreadsheet::XLSX
• Testing: Test::More, Test::MockModule
• Quality: Perl::Critic, Perl::Tidy
• Profiling: Devel::NYTProf
• Concurrency: threads, threads::shared, Thread::Queue
• Date/Time: DateTime, Date::Calc

⁠Usage examples

docker run --rm perlessentials/perl-essentials:5.42 \
  perl -MDBI -MJSON -e 'print "ready\n"'

docker run --rm -it \
  -v "$PWD":/work \
  perlessentials/perl-essentials:5.42

docker run --rm -it \
  -v "$PWD":/work \
  -v "$PWD/codex-auth":/codex \
  perlessentials/perl-essentials:codex zsh -l

docker run --rm perlessentials/perl-essentials:5.26 perl -e 'print "$^V\n"'

⁠Perl development tools

The image includes perltidy, perlcritic, prove, cpanm, rg, and the GNU-prefixed commands gcat, gfind, ggrep, and gsed.

Perl::Tidy uses /etc/perltidyrc by default. A project-local .perltidyrc under /work takes precedence. Use -pro=/work/custom.perltidyrc to select a specific profile, or -npro to ignore all profiles.

Preview formatting without modifying the mounted file:

docker run --rm -v "$PWD":/work \
  perlessentials/perl-essentials:5.42 \
  perltidy -st -se /work/path/to/script.pl

Format in place without creating a backup, using the host user to preserve file ownership:

docker run --rm --user "$(id -u):$(id -g)" -v "$PWD":/work \
  perlessentials/perl-essentials:5.42 \
  perltidy -b -bext='/' /work/path/to/script.pl

⁠Available targets

⁠Codex target

A codex target is also available, based on the Perl 5.43.9 development image:

⁠Included Perl modules

Versions captured on 2026-06-19 10:11:10 (UTC).

This inventory was captured from the default development image at the timestamp above. Module versions may differ between publication runs. For an exact image, see /opt/perl-essentials/module-versions.txt.