Dist::...aTests(3pm)

📦
version 0.029 · 2 versions
  • 0.029 · debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking (latest)
  • 0.029 · ubuntu jammy
, in debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 Dist::Zilla::Plugin::RunExtraTests — the manual, but make it make sense 💖

User Contributed Perl Documentation · Dist::...aTests(3pm)

okay bestie, welcome to the Dist::Zilla::Plugin::RunExtraTests page 💅 this is the lil plugin that makes your xt tests actually run when you ask dzil test to do its thing. no cap, it's giving "the tests you forgot about finally get their moment."

✨ NAME ✨

Dist::Zilla::Plugin::RunExtraTests — support running xt tests via dzil test

🌸 VERSION 🌸

version 0.029

🎀 SYNOPSIS 🎀

In your dist.ini:

[RunExtraTests]

that's it. that's the whole vibe. one line and you're slaying 🫶

🦋 DESCRIPTION 🦋

So here's the tea, bestie: this plugin runs your xt tests whenever the test phase runs — think dzil test, dzil release, all of that. ✨

And here's the part that's actually iconic: xt/release, xt/author, and xt/smoke get tested based on the values of the appropriate environment variables — RELEASE_TESTING, AUTHOR_TESTING, and AUTOMATED_TESTING — which are set by dzil test. So the plugin peeks at those env vars and goes "oh we're doing author testing today? say less." 💅

Additionally — and this is the bonus round — all other xt files and directories will always be run. Every single one. Always. No env var check, no gatekeeping, they just go. 🔥

One lil heads-up though: if RunExtraTests is listed after one of the normal test-running plugins (like MakeMaker or ModuleBuild), then the dist will not be rebuilt between running the normal tests and the extra tests. So ordering in your dist.ini is lowkey doing something. iykyk 👀

🌈 SEE ALSO 🌈

  • Dist::Zilla — the mothership, the moment, the whole reason we're here 👑

👑 AUTHORS 👑

  • David Golden <dagolden@cpan.org>
  • Jesse Luehrs <doy@cpan.org>

two legends, fr fr 🫶

This software is Copyright (c) 2016 by David Golden.

This is free software, licensed under:

The Apache License, Version 2.0, January 2004

and that's the whole page, bestie!! 🎀✨ this one's from perl v5.36.0, dated 2022-12-06, filed under Dist::...aTests(3pm) — go forth and run those extra tests, you absolute main character 🌸🦋💖

📦 where this page comes from