Apache::TestRun(3pm)

💖 Apache::TestRun 💖

okay bestie, so this is Apache::TestRun, straight out of the User Contributed Perl Documentation section of the manual pages. she's a Perl module, she's here to run your test suite, and honestly? she's kind of a big deal. ✨

---

🌸 NAME 🌸

Apache::TestRun — Run the test suite

like... that's literally her whole thing. running the test suite. iconic behavior. 👑

---

🎀 SYNOPSIS 🎀

so. um. there is no synopsis here bestie. the manpage said nothing. silence. the void. 💀 nothing to copy, nothing to show. moving on!! 🫶

---

🦋 DESCRIPTION 🦋

The Apache::TestRun package is the one holding the aux cord — she controls the configuration and running of the test suite. everything test-suite-related goes through her. main character energy fr fr. 🔥

---

✨ METHODS ✨

Several of these methods are sub-classable, if you wanna change up the default behavior and make it your own. like, go off, customize her. 💅

🐛 "bug_report" 🐛

so the bug_report() method fires when t/TEST gets run with the -bugreport option, and then make test (or just t/TEST) fails. 😭

Normally this is a callback — a lil spot where you get to tell the user how to deal with the problem. Like, suggesting they read some document, or email some details to someone who can Actually Take Care Of It. By default? nothing is executed. literally nothing. she's just standing there.

Now, why does the -bugreport option exist at all? because otherwise this feature would become annoying to developers themselves. no cap. It's automatically added to the run_tests target in Makefile. So if you're repeatedly testing your code (and bestie, you know you are), just don't use make test — run t/TEST directly instead. 🏃♀️

Here's an example of a custom t/TEST:

  My::TestRun->new->run(@ARGV);

  package My::TestRun;
  use base 'Apache::TestRun';

  sub bug_report {
      my $self = shift;

      print <<EOI;
  +--------------------------------------------------------+
  | Please file a bug report: http://perl.apache.org/bugs/ |
  +--------------------------------------------------------+
  EOI
  }

look at that little box. adorable. 10/10 would file a bug. 📮

🧚 "pre_configure" 🧚

the pre_configure() method runs before the configuration for Apache::Test is generated. so if you need to adjust the setup before httpd.conf and other files get autogenerated? this is the right place to do that. it's giving "get in before the printer starts printing". 🖨️✨

Example time — say you don't want to inherit a LoadModule directive for mod_apreq.so, you want to make sure the local version is used instead. You can sub-class Apache::TestRun and override this method in t/TEST.PL:

  package My::TestRun;
  use base 'Apache::TestRun';
  use Apache::TestConfig;
  __PACKAGE__->new->run(@ARGV);

  sub pre_configure {
      my $self = shift;
      # Don't load an installed mod_apreq
      Apache::TestConfig::autoconfig_skip_module_add('mod_apreq.c');

      $self->SUPER::pre_configure();
  }

⚠️ heads up bestie: notice that the extension is .c, and not .so. that detail matters. don't be the person who writes .so. 🙈

💜 also: don't forget to run the super class' pre_configure() method. seriously. call your mom. call SUPER. 🫶

🫧 "new_test_config" 🫧

META: to be completed

that's it. that's the whole thing. she's unfinished, she's mysterious, she's a WIP and we respect her journey. 🦋 tbd era.

---

💌 and that's the vibe

that was Apache::TestRun(3pm) from the User Contributed Perl Documentation, and this gorgeous girl has been living in the perl v5.42.3 world since 2026-08-20. mwah. 💋 thanks for reading bestie, now go run your tests. periodt. 👑🌈⭐