Module...raTests(3pm)

📦
version 0.008 · 7 versions
, in debian bookworm, ubuntu noble

💖 Module::Install::ExtraTests — bestie edition 💖

okay so this is Module::Install::ExtraTests, a 3pm manual page, and it's all about contextual tests that the harness can ignore ✨. literally the whole point is "run these tests only when the vibes are right" and honestly? iconic. 🎀

🌸 VERSION 🌸

0.008 — that's the number, don't @ me 💅

👑 COMMANDS 👑

so this plugin adds exactly one Module::Install command. one. singular. main character energy fr fr.

✨ extra_tests ✨

extra_tests;

the way that this declares the test files chillin' in the ./xt directory should only run in certain instances 🦋. like, not always. contextual. iykyk.

here's the breakdown, bestie:

  • ./xt/author — runs when the tests are being run in an author's working copy 🧚
  • ./xt/smoke — runs when the dist is being smoked (AUTOMATED_TESTING=1) 🔥
  • ./xt/release — runs during make disttest 💜

these directories get recursively scanned for *.t files. like, it's digging through everything, no cap.

⚠️ and if any directories or files exist in ./xt that are not recognized, the Makefile.PL will die. 💀 not a cute little warning, not a vibe check, it just dies. so keep that directory tidy, okay?

Achtung! 🙈 this is pretty scary, experimental code. mostly because it relies on the pretty scary, non-experimental-but-seriously-sketchy underlying customization system for ExtUtils::MakeMaker. 😭 the author says they may remove this warning when they've decided this is stable enough, but until then:

HIC SUNT DRACONES

(yes that means dragons. yes it's serious. 🐉)

🌈 AUTHOR TESTS 🌈

so "is this being run by an author?" — that question gets determined internally by Module::Install. but at the time of the writing of this version, it's determined by the existence of a directory called .author in ./inc. 👑

(and on VMS, it's _author instead. little platform moment. 💅)

this directory gets created when Module::Install's Makefile.PL is run in a directory where no ./inc directory exists. slay. 🫶

😭 BUGS 😭

please please please report any bugs or feature requests through the web interface at <http://rt.cpan.org> 🍓. the author will be notified, and then you'll automatically be notified of progress on your bug as changes get made. so like, you're in the loop. bestie privileges. 💖

Copyright 2008, Ricardo SIGNES. this program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 🌸

and that's the whole page, bestie!! this was perl v5.36.0, dated 2022-12-06, straight out of the Module...raTests(3pm) manual. go run your tests contextually, stay hydrated, and don't put unrecognized files in ./xt unless you want the dragons. 🐉✨💅

📦 where this page comes from