Module...rTests(3pm)

💖 Module::Install::AuthorTests 💖

okay bestie, so this is a perl manpage — specifically one from the User Contributed Perl Documentation corner of the universe, filed under section 3pm. Let's get into it 💅

✨ NAME ✨

Module::Install::AuthorTests — the plugin that designates tests only run by module authors 🎀

🌸 VERSION 🌸

0.002 — yes she's smol, but she's iconic 💜

---

👑 COMMANDS 👑

This plugin adds the following Module::Install commands, and honestly? obsessed:

🧚 author_tests

author_tests('xt');

So this one declares that the test files found in the directory ./xt should be run only if the module is being built by an author. The whole "why tho" of it all is explained below, keep reading bestie 🫶

You may declare multiple test directories by passing a list of tests — like, as many as you want, she's flexible ✨

And since tests are not recursive by default, it should be safe to use a subdirectory of ./t for author tests, like:

author_tests('t/author');

no cap, that's the move 🔥

🦋 recursive_author_tests

recursive_author_tests('xt');

This acts like author_tests, but it will look for tests in directories below ./xt as well as in the directory itself. it's giving thorough. it's giving main character energy. 🌈

---

💀 HOW IT WORKS 💀

okay so the question "Is this being run by an author?" is 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. (On VMS, it's _author.) 🙈

That directory gets created when Module::Install's Makefile.PL is run in a directory where no ./inc directory exists. so like, that's the vibe check ✅

---

😭 BUGS 😭

Please report any bugs or feature requests through the web interface at <http://rt.cpan.org>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. bestie we're in this together fr fr 🫂

---

⭐ COPYRIGHT ⭐

Copyright 2008, Ricardo SIGNES. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. slay, generous king 👑

---

and that's the whole page, no notes 💖

sign-off szn: this absolute gem comes to you courtesy of perl v5.36.0, dated 2022-12-12, and it lives in the Module...rTests(3pm) manual. mwah 💋✨