App::Y...:Cover(3pm)

📦
version 1.000172 · 8 versions
, in ubuntu stonking

💖 App::Y...:Cover 💖

okay bestie, gather round, because we're talking about App::Yath::Plugin::Cover — a plugin from the User Contributed Perl Documentation ✨ (the manual's literally called App::Y...:Cover(3pm) if you're being formal about it, iykyk).

🌸 NAME 🌸

App::Yath::Plugin::Cover — the plugin that collects and reports your basic coverage data 🫶

✨ DESCRIPTION ✨

So like… it does simple coverage data, okay? File and sub coverage only. That's the whole vibe. 💅

If you want the deep coverage stats, the messy detailed ones, the ones that cost you everything — you go use Devel::Cover instead. No cap. This plugin is giving "quick vibe check," not "full forensic investigation." 🕵️‍♀️

🎀 PROVIDED OPTIONS 🎀

👑 COMMAND OPTIONS 👑

🦋 Cover Options 🦋

  • --cover-aggregator ByTest, --cover-aggregator ByRun, --cover-aggregator +Custom::Aggregator, --cover-agg ByTest, --cover-agg ByRun, --cover-agg +Custom::Aggregator, --no-cover-aggregator — pick a custom aggregator subclass, bestie, you get to choose 🎀. (--cover-agg is literally just the short little nickname for --cover-aggregator, they're the same thing, obsessed.)
  • --cover-class ARG, --cover-class=ARG, --no-cover-class — choose a Test2::Plugin::Cover subclass 💜.
  • --cover-dirs ARG, --cover-dirs=ARG, --cover-dir ARG, --cover-dir=ARG, --no-cover-dirs — NO DESCRIPTION - FIX ME 😭 (not me reading the manpage and it just says that, iconic honesty though fr fr)

Can be specified multiple times.

  • --cover-exclude-private, --no-cover-exclude-private, --cover-files, --no-cover-files — use Test2::Plugin::Cover to collect coverage data for what files are touched by what tests ✨. Unlike Devel::Cover, this has very little performance impact (like, about 4% difference). Four percent!! That's basically nothing, main character energy for real 💅.
  • --cover-from path/to/log.jsonl, --cover-from http://example.com/coverage, --cover-from path/to/coverage.jsonl, --no-cover-from — this can be a test log, a coverage dump (old style json OR new jsonl format), or a url pointing at any of the previous ones 🫶.
⚠️ Heads up: Tests will not be run if the file/url is invalid. Periodt.
  • --cover-from-type json, --cover-from-type jsonl, --cover-from-type log, --no-cover-from-type — the file type for your coverage source 🎀. Usually it can just detect it on its own (she's smart like that), but when it cannot, you gotta specify, bestie. Here's the tea:
    • "json" is old style single-blob coverage data
    • "jsonl" is the new by-test style
    • "log" is a logfile from a previous run
  • --cover-manager My::Coverage::Manager, --no-cover-manager — the coverage 'from' manager to use when the coverage data doesn't provide one 💜.
  • --cover-maybe-from path/to/log.jsonl, --cover-maybe-from http://example.com/coverage, --cover-maybe-from path/to/coverage.jsonl, --no-cover-maybe-from — same deal as --cover-from: a test log, a coverage dump (old style json or new jsonl format), or a url to any of those ✨. The difference? Tests will coninue if even if the coverage file/url is invalid. 🙈 (yes, "coninue" — that's literally what the manpage says, I am NOT fixing it, we respect the source ✋)
  • --cover-maybe-from-type json, --cover-maybe-from-type jsonl, --cover-maybe-from-type log, --no-cover-maybe-from-type — same as "from_type" but for "maybe_from" 🦋. Defaults to "from_type" if that's specified, otherwise it auto-detects 👑.
  • --cover-metrics, --no-cover-metrics, --cover-types ARG, --cover-types=ARG, --cover-type ARG, --cover-type=ARG, --no-cover-types — NO DESCRIPTION - FIX ME 😭 again, sorry bestie, that's all she gives us

Can be specified multiple times.

  • --cover-write, --cover-write=coverage.jsonl, --cover-write=coverage.json, --no-cover-write — create a json or jsonl file of all coverage data seen during the run 🎀✨🔥. (This implies --cover-files.) So good. So thorough. Slay.

🌈 SOURCE 🌈

The source code repository for Test2-Harness can be found at http://github.com/Test-More/Test2-Harness/ — go peek, go star it, go be nosy 🫶

👑 MAINTAINERS 👑

  • Chad Granum <exodist@cpan.org>

💜 AUTHORS 💜

  • Chad Granum <exodist@cpan.org>

Copyright 2020 Chad Granum <exodist7@gmail.com> ⭐.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself 💅.

See http://dev.perl.org/licenses/

and that's the whole page, bestie 🦋✨ ty for coming to my ted talk, no notes, she ate. this was perl v5.40.1, dated 2026-05-10, from App::Y...:Cover(3pm) 💖 mwah 🫶🌸🍓

📦 where this page comes from