Dist::...::Test(3pm)

💖 Dist::Inkt::Role::Test 💖

okay bestie, welcome to the manual page for Dist::Inkt::Role::Test, straight out of the User Contributed Perl Documentation collection (you'll see it filed under Dist::...::Test(3pm) if you go looking). buckle up, it's short and sweet. 🎀

---

✨ NAME ✨

Dist::Inkt::Role::Test — run various tests on a distribution at build time 🧪

---

🌸 SYNOPSIS 🌸

here's the vibe, copy-paste girlies:

package Dist::Inkt::Profile::JOEBLOGGS;

use Moose;
extends qw(Dist::Inkt);
with (
   ...,
   "Dist::Inkt::Role::Test",
   ...,
);

after BUILD => sub {
   my $self = shift;

   # Run a test before attempting to build
   # the dist dir.
   #
   $self->setup_prebuild_test(sub {
      die "rude!" if $self->name =~ /Arse/;
   });

   # Run a test after building the dist dir.
   #
   $self->setup_build_test(sub {
      die "missing change log" unless -f "Changes";
   });

   # Run a test after tarballing the dist dir.
   #
   $self->setup_tarball_test(sub {
      my $tarball = $_[1]
      die "too big" if $tarball->stat->size > 1_000_000;
   });
};

1;

like… the way you just consume the role and then stack your own little after BUILD checks on top? iconic. 👑

---

💅 DESCRIPTION 💅

so what even is this. this role exists to give hooks to Dist::Inkt subclasses and to other roles, so they can run tests. that's it. that's the whole job. hooks for tests. slay.

and bundled with this role are a few other roles that consume it in useful ways — so it's giving main-character role with a lil entourage. ✨

---

🦋 BUGS 🦋

found something cursed? pls report any bugs here, bestie:

<http://rt.cpan.org/Dist/Display.html?Queue=Dist-Inkt-Role-Test>

---

👑 SEE ALSO 👑

• Dist::Inkt. — the parent vibe, go read it.

---

🌈 AUTHOR 🌈

Toby Inkster <tobyink@cpan.org>.

---

🎀 COPYRIGHT AND LICENCE 🎀

This software is copyright (c) 2014 by Toby Inkster.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. no cap, it's open like that. 🫶

---

💀 DISCLAIMER OF WARRANTIES 💀

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

translating that for you fr fr: no promises, no guarantees, you're on your own. 😭

---

okay that's the whole page, you ate that. this was perl v5.40.1, dated 2025-08-06, coming at you from the User Contributed Perl Documentation section of the manual. mwah. 💖✨🌸🦋💅