NAME

Devel::App::Test::Generator::LCSAJ::Runtime - Debugger backend for LCSAJ coverage

SYNOPSIS

PERL5OPT='-d:App::Test::Generator::LCSAJ::Runtime -Mblib' prove -l t

DESCRIPTION

This module is loaded as a Perl debugger backend using the -d:Module flag.

When Perl sees -d:App::Test::Generator::LCSAJ::Runtime it prepends Devel:: and loads Devel/App/Test/Generator/LCSAJ/Runtime.pm from @INC. The file must therefore live at that path — typically lib/Devel/App/Test/Generator/LCSAJ/Runtime.pm.

Perl automatically calls DB::DB before executing each statement while the debugger is active. We record (file, line) pairs to build runtime hit data for later LCSAJ analysis.

The results are written to cover_html/lcsaj_hits.json at process exit.

ENVIRONMENT

LCSAJ_TARGETS

Optional colon-separated list of absolute paths (as produced by realpath) to restrict recording to specific source files. When empty or unset every non-internal file is recorded.

OUTPUT FORMAT

cover_html/lcsaj_hits.json is a JSON object of the form:

{
  "lib/Foo/Bar.pm": { "12": 3, "15": 1, ... },
  ...
}

Keys are lib-relative paths (lib/...); values are objects mapping line numbers (as strings) to hit counts.

NOTES ON FILE PLACEMENT

The -d:App::Test::Generator::LCSAJ::Runtime flag causes Perl to load Devel::App::Test::Generator::LCSAJ::Runtime, which it finds at:

lib/Devel/App/Test/Generator/LCSAJ/Runtime.pm

Ensure this path is on @INC (-Mblib or -Ilib in PERL5OPT).

SEE ALSO

Devel::Cover, App::Test::Generator

AUTHOR

Nigel Horne