Test2::Harness::Runner::DepTracer(3pm) User Contributed Perl Documentation Test2::Harness::Runner::DepTracer(3pm)

Test2::Harness::Runner::DepTracer - Tool for tracing module dependencies as they are loaded.

This tool is used by Test2::Harness to build a graph of dependancies which can then be used to blacklist modified modules (and anything thatuses them) when they change under a preloaded runner.

    use Test2::Harness::Runner::DepTracer;
    my $dt = Test2::Harness::Runner::DepTracer->new();
    $dt->start();
    require Some::Thing;
    # You can always check for and retrieve an active DepTrace this way:
    my $dt_reference = Test2::Harness::Runner::DepTracer->ACTIVE;
    $dt->stop();
    my $dep_map = $dt->dep_map;
    my $loaded_by = $dep_map->{'Some/Thing.pm'};
    print "Some::Thing was directly or indirectly loaded by:\n" . join("\n" => @$loaded_by) . "\n";

These can be specified at construction, and will be populated during use.

$hashref = $dt->exclude
A hashref of files/modules to exclude from dep tracking. By default "strict" and "warnings" are excluded.
$hashref = $dt->dep_map
Every file which is loaded while the tool is started will have an entry in this hash, each value is an array of all files which loaded the key file directly or indirectly.
$hashref = $dt->loaded
How many times each file was directly loaded.

$dt->start
Start tracking modules which are loaded.
$dt->stop
Stop tracking moduels that are loaded.

$dt_or_undef = Test2::Harness::Runner::DepTracer->ACTIVE();
Get the currently active DepTracer, if any.

The source code repository for Test2-Harness can be found at http://github.com/Test-More/Test2-Harness/.

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/

2023-10-04 perl v5.36.0