CONTENTS

• NAME
• VERSION
• SYNOPSIS
• DESCRIPTION
• METHODS
  • Class Methods
    • can_handle
    • make_iterator
    • iterator_class
• CONFIGURATION
• SUBCLASSING
• SEE ALSO

#NAME

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

#VERSION

Version 3.23

#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 araw TAP stored in a fileTAP::Parser::SourceHandler - it has 2 jobs:

1. Figure out if theraw source it's given is a file containing raw TAP output. SeeTAP::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 subclassingTAP::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 file0.9 if it has an extension matching any given in user config.

#make_iterator

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

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

#iterator_class

The class of iterator to use, override if you're sub-classing. Defaults toTAP::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

Perldoc Browser is maintained by Dan Book (DBOOK). Please contact him via theGitHub issue tracker oremail regarding any issues with the site itself, search, or rendering of documentation.

The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via thePerl issue tracker, themailing list, orIRC to report any issues with the contents or format of the documentation.