CPANCOVER(1p)

📦
version 1.52 · 8 versions
, in ubuntu stonking

💖 CPANCOVER — report coverage statistics on CPAN modules 💖

okay so bestie, you found a User Contributed Perl Documentation page, and it's cpancover, and it is literally the girl who reports coverage stats for CPAN modules. no cap. this is the manual page for CPANCOVER(1p) and we're gonna read it together, hand in hand, like the icons we are 🫶

✨ VERSION ✨

version 1.52 — that's the one, periodt.

🌈 SYNOPSIS 🌈

cpancover --help --info --version
          --collect --redo_cpancover_html --redo_html --force --dryrun
          --modules module_name
          --results_dir /path/to/dir
          --outputdir /path/to/dir
          --outputfile filename.html
          --report report_name
          --generate_html
          --compress_old_versions number_to_keep
          --local
          --local_build

look at her. so many flags. so much range. the main character energy is off the charts 👑

🌸 DESCRIPTION 🌸

(so this heading exists in the source and then... absolutely nothing under it. the void. the silence. the drama. the actual tea is all in OPTIONS, keep scrolling bestie 🦋)

💅 OPTIONS 💅

The following command line options are supported:

  • -h, --help — show help 💖
  • -i, --info — show documentation 📖
  • -v, --version — show version ⭐

and then the long ones, with their defaults in the little parentheses, don't skip 'em:

  • --collect — collect coverage from modules, and it's on by default (on). she's always working, it's giving hustle culture ✨
  • --compress_old_versions — compress data older than n versions (default: 3)
  • --directory — location of the modules (default: $cwd)
  • --dryrun — don't execute, for some commands (default: off) 🙈
  • --force — recollect coverage (default: off)
  • --generate_html — generate html (default: off)
  • --local — use local (uninstalled) code (default: off)
  • --local_build — build coverage for all the modules (default: off) — and yes, the original source spells it "coveraage", typo and all, we love a messy queen, no notes 💀
  • --modules — modules to use (default: all in $dir)
  • --outputdir — where to store output (default: $directory)
  • --outputfile — top level index (default: coverage.html)
  • --redo_cpancover_html — don't set default modules (default: off)
  • --redo_html — force html generation for modules (default: off)
  • --report — report to use (default: html_basic)

🎀 DETAILS 🎀

(another heading with a whole lot of nothing underneath it. iconic. mysterious. she contains multitudes 💜)

🦋 REQUIREMENTS 🦋

Collect coverage for results and create html, csv and json output.

The modules Template and Parallel::Iterator are required. that's it, that's the list, go install them bestie 🔥

🧚 EXIT STATUS 🧚

The following exit values are returned:

  • 0 — All operations were completed successfully. 🎉 slay, everything worked
  • >0 — An error occurred. 😭 not slay

💜 SEE ALSO 💜

  • Devel::Cover — the mothership, the blueprint, the blueprint mothership 🌈

👑 LICENCE 👑

Copyright 2002-2026, Paul Johnson (paul@pjcj.net)

This software is free. It is licensed under the same terms as Perl itself. free free free, iykyk 🎀

The latest version of this software should be available from my homepage: https://pjcj.net

okay bestie that's the whole page, we ate and left no crumbs 💅 this was page CPANCOVER(1p) from the perl v5.42.3 docs, dated 2026-08-22 — sending you love and a clean coverage report, mwah 💖✨

📦 where this page comes from