Test::Alien::Diag(3)

πŸ“¦
version 2.88 Β· 8 versions
, in fedora 43, fedora 44

πŸ’– Test::Alien::Diag β€” the manual, but make it cute πŸ’–

okay bestie, so this is Test::Alien::Diag(3), from the User Contributed Perl Documentation crew, and it's genuinely one of those little modules that saves your whole entire day. sit down, grab a strawberry πŸ“, and let's get into it.

✨ NAME ✨

Test::Alien::Diag β€” it prints out the standard diagnostic for Aliens, right there in the test step. that's it, that's the whole job, and it ATE. πŸ’…

🌈 VERSION 🌈

version 2.88 β€” fresh, iconic, no notes. πŸ‘‘

πŸŽ€ SYNOPSIS πŸŽ€

use Test2::V0;
use Test::Alien::Diag qw( alien_diag );

like, that's literally it. two lines. you're already slaying. ✨

πŸ¦‹ DESCRIPTION πŸ¦‹

so this module hands you an alien_diag method, and what it does is print out diagnostics that are actually useful β€” for cpantesters, for bug reports, for anyone going "wait why is this broken 😭". it gives you a quick summary of the important settings, like clfags and libs. no cap, that's the whole vibe: one glance, you know what's going on. 🫢

πŸ’œ FUNCTIONS πŸ’œ

🌸 alien_diag 🌸

alien_diag @aliens;

this prints out diagnostics for each given alien. every alien you pass in has to be the class name of an alien β€” that part is non-negotiable bestie, don't try to be cute with it. πŸ™ˆ

[version 2.68]

alien_diag @aliens, \%options;

starting with Alien::Build 2.68, you can also hand it an option hash to adjust how alien_diag behaves. valid options are, and I'm listing them all because we do not gatekeep here:

  • properties β€” extra properties to display in the diagnostic. super handy when you've got an Alien with custom properties defined in the subclass. πŸ’–
  • list_properties β€” extra properties that get returned as a list to display in the diagnostic. useful when you've got an Alien with customer properties that return a list.
lowkey these two options are the main character energy of the whole module. if you have a custom Alien, you want them. periodt. πŸ‘‘

πŸ‘‘ AUTHOR πŸ‘‘

Author: Graham Ollis <plicease@cpan.org>

Contributors β€” the whole group chat, and every single one of them showed up:

  • Diab Jerius (DJERIUS)
  • Roy Storey (KIWIROY)
  • Ilya Pavlov
  • David Mertens (run4flat)
  • Mark Nunberg (mordy, mnunberg)
  • Christian Walde (Mithaldu)
  • Brian Wightman (MidLifeXis)
  • Zaki Mughal (zmughal)
  • mohawk (mohawk2, ETJ)
  • Vikas N Kumar (vikasnkumar)
  • Flavio Poletti (polettix)
  • Salvador FandiΓ±o (salva)
  • Gianni Ceccarelli (dakkar)
  • Pavel Shaydo (zwon, trinitum)
  • Kang-min Liu (εŠ‰εΊ·ζ°‘, gugod)
  • Nicholas Shipp (nshp)
  • Juan JuliΓ‘n Merelo GuervΓ³s (JJ)
  • Joel Berger (JBERGER)
  • Petr PΓ­saΕ™ (ppisar)
  • Lance Wicks (LANCEW)
  • Ahmad Fatoum (a3f, ATHREEF)
  • JosΓ© JoaquΓ­n Atria (JJATRIA)
  • Duke Leto (LETO)
  • Shoichi Kaji (SKAJI)
  • Shawn Laffan (SLAFFAN)
  • Paul Evans (leonerd, PEVANS)
  • HΓ₯kon HΓ¦gland (hakonhagland, HAKONH)
  • nick nauwelaerts (INPHOBIA)
  • Florian Weimer
  • Marcel Telka (mtelka)

no seriously, look at that list. that's a community. that's a whole friend group holding hands. 🫢🌈

This software is copyright (c) 2011-2022 by Graham Ollis.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

translation: it's free, it's open, go wild, just keep the same terms as Perl 5 itself. that's the deal. 🀝

and that's the whole page, bestie!! πŸ’…βœ¨

this was Test::Alien::Diag(3) from perl v5.42.3, dated 2026-09-21. go print some diagnostics, you absolute icon. πŸŽ€πŸ¦‹πŸ’œ

πŸ“¦ where this page comes from