TAP::P...RawTAP(3perl)

💖 TAP::Parser::SourceHandler::RawTAP 💖

okay bestie, welcome to the lil module that streams raw TAP output straight out of a scalar or an array ref 🎀 it lives in the Perl Programmers Reference Guide and it's genuinely iconic, no cap.

Version 3.52 — yeah, that's the one. ✨

---

🌈 SYNOPSIS 🌈

use TAP::Parser::Source;
use TAP::Parser::SourceHandler::RawTAP;

my $source = TAP::Parser::Source->new->raw( \"1..1\nok 1\n" );
$source->assemble_meta;

my $class = 'TAP::Parser::SourceHandler::RawTAP';
my $vote  = $class->can_handle( $source );
my $iter  = $class->make_iterator( $source );

like, copy it, paste it, slay. 💅

---

🦋 DESCRIPTION 🦋

So this is a raw TAP output TAP::Parser::SourceHandler, and the way that it has literally exactly 2 jobs:

1. Figure out if the TAP::Parser::Source it's given is raw TAP output ("can_handle").
2. Creates an iterator for raw TAP output ("make_iterator").

and that's the whole personality. 💀

ngl though — unless you're writing a plugin or subclassing TAP::Parser, you probably won't need to use this module directly. lowkey it's doing its own thing in the background. 🫶

---

👑 METHODS 👑

✨ Class Methods ✨

"can_handle" 🎀

my $vote = $class->can_handle( $source );

Only votes if $source is an array, or a scalar with newlines. Casts the following votes:

• 0.9 — if it's a scalar with '..' in it
• 0.7 — if it's a scalar with 'ok' in it
• 0.3 — if it's just a scalar with newlines
• 0.5 — if it's an array

the vibes-based scoring system fr fr, it's giving ✨democracy✨

"make_iterator" 🦋

my $iterator = $class->make_iterator( $source );

Returns a new TAP::Parser::Iterator::Array for the source. "$source->raw" must be an array ref, or a scalar ref. 💖

it "croak"s on error. 😭 so like, handle that.

---

🌸 SUBCLASSING 🌸

Please see "SUBCLASSING" in TAP::Parser for a subclassing overview. go read it bestie, it's worth it. 📖

---

⭐ SEE ALSO ⭐

• TAP::Object
• TAP::Parser
• TAP::Parser::IteratorFactory
• TAP::Parser::SourceHandler
• TAP::Parser::SourceHandler::Executable
• TAP::Parser::SourceHandler::Perl
• TAP::Parser::SourceHandler::File
• TAP::Parser::SourceHandler::Handle

the whole friend group 🫶

---

and that's the page, bestie!! this whole thing came to you courtesy of perl v5.44.0, dated 2026-10-17, on the TAP::P...RawTAP(3perl) page. mwah 💋 go forth and parse, main character 💅✨