Test::S...ebugInfo(3)

📦
version 1.302027 · 2 versions
, in fedora 43

💖 NAME 💖

Test::Stream::DebugInfo — bestie, this is the debug information for events, and it's literally the receipts of where stuff happened 🫶

😭 DEPRECATED 😭

okay so this distribution is DEPRECATED — no cap, it's been retired in favor of Test2, Test2::Suite, and Test2::Workflow. it's giving "moving on, we've grown" 💅

there's a whole conversion guide waiting for you in Test::Stream::Manual::ToTest2 if you need to migrate. go look, bestie, don't leave your code stranded 🙈

✨ DESCRIPTION ✨

so every single event needs to know where it was born — like, which file, which line, the whole origin story 🦋 and also whether it's a todo, or part of a skipped test. this object is literally that info. it's the event's little ID card 💖

🌸 SYNOPSIS 🌸

use Test::Stream::DebugInfo;

my $dbg = Test::Stream::DebugInfo->new(
    frame => [$package, $file, $line, $subname],
);

look at her go ✨

👑 METHODS 👑

  • $dbg->set_todo($reason)
  • $reason = $dbg->todo

get / set / unset the todo for the current debug-info. it's giving "we'll deal with this later" energy 💅

  • $dbg->set_skip($reason)
  • $reason = $dbg->skip

get / set / unset the skip for the current debug-info. main character decided to sit this one out 🎀

  • $dbg->set_detail($msg)
  • $msg = $dbg->detail

used to get/set a custom trace message — and here's the tea 🍓 — it gets used INSTEAD of "at <FILE> line <LINE>" when you call $dbg->trace. so like, it replaces the default. not adds to it. replaces. periodt.

  • $dbg->trace

typically returns the string "at <FILE> line <LINE>". but if "detail" is set, then its value will be returned instead. simple as that, no notes 💖

  • $dbg->alert($MESSAGE)

this issues a warning at the frame — and by frame we mean the filename and line number where errors should be reported 👀

  • $dbg->throw($MESSAGE)

this throws an exception at the frame — again, filename and line number where errors should be reported. it's throwing hands, technically 💀

  • $frame = $dbg->frame()

get the call frame arrayref. that's it, that's the vibe.

  • ($package, $file, $line, $subname) = $dbg->call()

get the caller details for the debug-info. this is where errors should be reported 🫶

  • $pkg = $dbg->package

get the debug-info package 🎀

  • $file = $dbg->file

get the debug-info filename 📁

  • $line = $dbg->line

get the debug-info line number 🔢

  • $subname = $dbg->subname

get the debug-info subroutine name ✨

🔥 SOURCE 🔥

the source code repository for Test::Stream can be found at http://github.com/Test-More/Test-Stream/ — go lurk, bestie, it's iconic 👑

💜 MAINTAINERS 💜

Chad Granum <exodist@cpan.org>

🌈 AUTHORS 🌈

Chad Granum <exodist@cpan.org>

Copyright 2015 Chad Granum <exodist7@gmail.com>.

this program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://dev.perl.org/licenses/

okay bestie that's the whole page 💖 this was perl v5.42.0, dated 2025-07-25, straight from Test::S...ebugInfo(3) — the manual name's right there in the title, the version and date are right here in the sign-off, and we ate, no crumbs. slay 🌟🦋✨

📦 where this page comes from