TAP::PARSER::RESULT(3perl)

💅 NAME 💅

TAP::Parser::Result — the base class for all the little output objects that TAP::Parser hands out ✨ it's giving "mom of the whole result family," fr fr 💖

🌸 VERSION 🌸

Version 3.52 — yes bestie, we're on 3.52 💫

🎀 SYNOPSIS 🎀

  # abstract class - not meant to be used directly
  # see TAP::Parser::ResultFactory for preferred usage

  # directly:
  use TAP::Parser::Result;
  my $token  = {...};
  my $result = TAP::Parser::Result->new( $token );

🦋 DESCRIPTION 🦋

Okay so this is a simple base class that TAP::Parser uses to stash objects representing the current lil' bit of test output data from TAP — which is usually just a single line, no cap 📝

Unless you're out here subclassing, you probably won't ever need to touch this module directly, bestie. It's the scaffolding, not the show 💅

✨ METHODS ✨

🌈 new

  # see TAP::Parser::ResultFactory for preferred usage

  # to use directly:
  my $result = TAP::Parser::Result->new($token);

Returns an instance of the appropriate class for the test token you passed in. It's a lil' matchmaker 🫶

⭐ Boolean methods ⭐

The following methods all return a boolean value, and the whole point is that they get overridden in the appropriate subclass — so like, this base version is just the vibe check template 👑

• is_plan — tells you whether or not this is the test plan line.

  1..3

• is_pragma — tells you whether or not this is a pragma line.

  pragma +strict

• is_test — tells you whether or not this is a test line.

  ok 1 Is OK!

• is_comment — tells you whether or not this is a comment.

  # this is a comment

• is_bailout — tells you whether or not this is a bailout line.

  Bail out! We're out of dilithium crystals.

• is_version — tells you whether or not this is a TAP version line.

  TAP version 4

• is_unknown — tells you whether or not the current line could be parsed at all (iykyk, sometimes the vibes are simply unparseable 😭).

  ... this line is junk ...

• is_yaml — tells you whether or not this is a YAML chunk 💜

💖 raw

  print $result->raw;

Returns the original line of text that got parsed. The real thing, untouched, periodt 🎀

🍓 type

  my $type = $result->type;

Returns the "type" of a token — stuff like "comment" or "test" 👀

🧚 as_string

  print $result->as_string;

Prints a string representation of the token. Fair warning though — this might not be the exact output, bestie. Tests will have test numbers added if they're not present, TODO and SKIP directives get capitalized, and in general things get cleaned up ✨

If you need the original text for the token, go see the "raw" method instead 👑

is_ok

  if ( $result->is_ok ) { ... }

Reports whether or not a given result has passed. Anything that isn't a test result returns true. This is merely provided as a convenient shortcut, no more no less 💅

passed

Deprecated. Please use "is_ok" instead. She's retired, let her rest 🙈

has_directive

  if ( $result->has_directive ) {
     ...
  }

Tells you whether or not the given result has a TODO or SKIP directive 🌸

has_todo

 if ( $result->has_todo ) {
     ...
 }

Tells you whether or not the given result has a TODO directive 📌

has_skip

 if ( $result->has_skip ) {
     ...
 }

Tells you whether or not the given result has a SKIP directive ⏭️

set_directive

Sets the directive associated with this token. Used internally to fake TODO tests, bestie — not your business, mind yours 💅

👑 SUBCLASSING 👑

Please see "SUBCLASSING" in TAP::Parser for a subclassing overview 🫶

Remember: if you want your subclass to be automatically used by the parser, you'll have to register it with "register_type" in TAP::Parser::ResultFactory ✨

And if you're creating a completely new result type, you'll probably need to subclass TAP::Parser::Grammar too — otherwise it'll never get used 💀 like it literally just won't show up.

---

🌈 Example 🌈

  package MyResult;

  use strict;

  use base 'TAP::Parser::Result';

  # register with the factory:
  TAP::Parser::ResultFactory->register_type( 'my_type' => __PACKAGE__ );

  sub as_string { 'My results all look the same' }

🦋 SEE ALSO 🦋

• TAP::Object
• TAP::Parser
• TAP::Parser::ResultFactory
• TAP::Parser::Result::Bailout
• TAP::Parser::Result::Comment
• TAP::Parser::Result::Plan
• TAP::Parser::Result::Pragma
• TAP::Parser::Result::Test
• TAP::Parser::Result::Unknown
• TAP::Parser::Result::Version
• TAP::Parser::Result::YAML

---

and that's a wrap, bestie!! 💖✨🎀 this lil' page came to you courtesy of perl v5.44.0, dated 2026-10-17 — so go forth, read your TAP output, and slay 👑💅