man > TAP::Parser::SourceHandler::File

man perldoc info pydoc3 ri search

📛 NAME

TAP::Parser::SourceHandler::File – Stream TAP from a text file.

🚀 Quick Reference

Use Case	Command	Description
🔍 Check if source is a file	$source->assemble_meta; $class->can_handle($source)	Votes 0.9 for .tap files or matching extensions
📦 Create iterator from file	$class->make_iterator($source)	Returns a TAP::Parser::Iterator::Stream for the file
⚙️ Custom iterator class	sub iterator_class { 'My::Iterator' }	Override if subclassing; defaults to TAP::Parser::Iterator::Stream

📌 VERSION

Version 3.43

📝 SYNOPSIS

  use TAP::Parser::Source;
  use TAP::Parser::SourceHandler::File;

  my $source = TAP::Parser::Source->new->raw( \'file.tap' );
  $source->assemble_meta;

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

📖 DESCRIPTION

This is a raw TAP stored in a file TAP::Parser::SourceHandler – it has 2 jobs:

1. 🔍 Figure out if the raw source is a file containing raw TAP output. See TAP::Parser::IteratorFactory for details.
2. 📥 Takes raw TAP from the text file and converts it into an iterator.

Unless you’re writing a plugin or subclassing TAP::Parser, you probably won’t need to use this module directly.

🔧 METHODS

🧰 Class Methods

can_handle

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

Only votes if $source looks like a regular file. Casts the following votes:

• 0.9 if it’s a .tap file
• 0.9 if it has an extension matching any given in user config

make_iterator

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

Returns a new TAP::Parser::Iterator::Stream for the source. croaks on error.

iterator_class

The class of iterator to use; override if you’re subclassing. Defaults to TAP::Parser::Iterator::Stream.

⚙️ CONFIGURATION

{
  extensions => [ @case_insensitive_exts_to_match ]
}

🔄 SUBCLASSING

Please see “SUBCLASSING” in TAP::Parser for a subclassing overview.

👀 SEE ALSO

• TAP::Object
• TAP::Parser
• TAP::Parser::SourceHandler
• TAP::Parser::SourceHandler::Executable
• TAP::Parser::SourceHandler::Perl
• TAP::Parser::SourceHandler::Handle
• TAP::Parser::SourceHandler::RawTAP

---

perl v5.34.0 – 2026-06-23 – TAP::Parser::SourceHandler::File(3perl)

📛 NAME 🚀 Quick Reference 📌 VERSION 📝 SYNOPSIS 📖 DESCRIPTION 🔧 METHODS ⚙️ CONFIGURATION 🔄 SUBCLASSING 👀 SEE ALSO