TAP::Parser::SourceHandler::File(3p) Perl Programmers Reference Guide #

TAP::Parser::SourceHandler::File(3p) Perl Programmers Reference Guide

NNAAMMEE #

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

VVEERRSSIIOONN #

 Version 3.44

SSYYNNOOPPSSIISS #

   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 );

DDEESSCCRRIIPPTTIIOONN #

 This is a _r_a_w _T_A_P _s_t_o_r_e_d _i_n _a _f_i_l_e TAP::Parser::SourceHandler - it has 2
 jobs:

 1. Figure out if the _r_a_w source it's given is a file containing raw TAP
 output.  See TAP::Parser::IteratorFactory for more details.

 2. Takes raw TAP from the text file given, and converts into an iterator.

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

MMEETTHHOODDSS #

CCllaassss MMeetthhooddss _"_c_a_n___h_a_n_d_l_e_"

   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.

 _"_m_a_k_e___i_t_e_r_a_t_o_r_"

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

 Returns a new TAP::Parser::Iterator::Stream for the source.  "croak"s on
 error.

 _"_i_t_e_r_a_t_o_r___c_l_a_s_s_"

 The class of iterator to use, override if you're sub-classing.  Defaults
 to TAP::Parser::Iterator::Stream.

CCOONNFFIIGGUURRAATTIIOONN #

   {
    extensions => [ @case_insensitive_exts_to_match ]
   }

SSUUBBCCLLAASSSSIINNGG #

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

SSEEEE AALLSSOO #

 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.36.3 2023-02-15 TAP::Parser::SourceHandler::File(3p)