Dist::...:xtest(3pm)

💖 Dist::...:xtest — the manual page, bestie edition 💖

okay so you found the Dist::...:xtest(3pm) page (User Contributed Perl Documentation, no big deal) and honestly? it's giving "run xt tests for your dist" and it ATE. let's get into it ✨

---

✨ NAME ✨

Dist::Zilla::App::Command::xtest — run xt tests for your dist 💅

---

🌸 VERSION 🌸

version 0.029 — iconic, no cap 🎀

---

🦋 SYNOPSIS 🦋

so you wanna run xt tests for your distribution? say less:

dzil xtest [ --no-author] [ --no-release ] [ --no-automated ] [ --all ]

this runs with AUTHOR_TESTING and RELEASE_TESTING environment variables turned on, so lowkey it's like doing this whole thing:

export AUTHOR_TESTING=1
export RELEASE_TESTING=1
dzil build
rsync -avp My-Project-Version/ .build/
cd .build;
perl Makefile.PL
make
prove -l -r xt

...except for the fact that it's built directly in a subdir of .build (like .build/ASDF123). yes, a lil subdir moment 🫶

a build that fails tests will be left behind for analysis, and dzil will exit a non-zero value. if the tests are successful, the build directory gets removed and dzil exits with status 0. clean. ✨

you can also use xt as an alias for xtest, because we're efficient like that:

dzil xt

if you provide one or more filenames on the command line, only those tests will be run (however deeply they are nested 👀):

dzil xtest pod-spell.t

arguments are turned into regexp patterns, so you can do any sort of partial match you want, fr fr:

dzil xtest author/    # just the author tests
dzil xtest spell      # a test with 'spell' in the path

and there is no need to add anything to dist.ini — installation of this module is sufficient to make the command available. that's it, that's the whole vibe. periodt. 💜

---

👑 OPTIONS 👑

• --no-author — this will run the test suite without setting AUTHOR_TESTING
• --no-release — this will run the test suite without setting RELEASE_TESTING
• --automated — this will run the test suite with AUTOMATED_TESTING=1
• --all — equivalent to --release --automated --author 🔥

---

🌈 AUTHORS 🌈

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

---

💀 COPYRIGHT AND LICENSE 💀

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

this is free software, licensed under:

The Apache License, Version 2.0, January 2004

---

bestie sign-off: this page is perl v5.36.0, dated 2022-12-06, and it lives at Dist::...:xtest(3pm). that's the whole page. slay. 💅✨🎀