Thanks to visit codestin.com
Credit goes to perldoc.perl.org

You are viewing the version of this documentation from Perl blead. This is the main development branch of Perl. (git commit c6eefb23e2b9ac302175c6585e0cce5f0c413410)

CONTENTS

NAME

TAP::Parser::SourceHandler::Executable - Stream output from an executable TAP source

VERSION

Version 3.52

SYNOPSIS

use TAP::Parser::Source;
use TAP::Parser::SourceHandler::Executable;

my $source = TAP::Parser::Source->new->raw(['/usr/bin/ruby', 'mytest.rb']);
$source->assemble_meta;

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

DESCRIPTION

This is an executable TAP::Parser::SourceHandler - it has 2 jobs:

1. Figure out if the TAP::Parser::Source it's given is an executable command ("can_handle").

2. Creates an iterator for executable commands ("make_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 an executable file. Casts the following votes:

0.9  if it's a hash with an 'exec' key
0.8  if it's a .bat file
0.75 if it's got an execute bit set

make_iterator

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

Returns a new TAP::Parser::Iterator::Process for the source. $source->raw must be in one of the following forms:

{ exec => [ @exec ] }

[ @exec ]

$file

croaks on error.

iterator_class

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

SUBCLASSING

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

Example

package MyRubySourceHandler;

use strict;

use Carp qw( croak );
use TAP::Parser::SourceHandler::Executable;

use base 'TAP::Parser::SourceHandler::Executable';

# expect $handler->(['mytest.rb', 'cmdline', 'args']);
sub make_iterator {
  my ($self, $source) = @_;
  my @test_args = @{ $source->test_args };
  my $rb_file   = $test_args[0];
  croak("error: Ruby file '$rb_file' not found!") unless (-f $rb_file);
  return $self->SUPER::raw_source(['/usr/bin/ruby', @test_args]);
}

SEE ALSO

TAP::Object, TAP::Parser, TAP::Parser::IteratorFactory, TAP::Parser::SourceHandler, TAP::Parser::SourceHandler::Perl, TAP::Parser::SourceHandler::File, TAP::Parser::SourceHandler::Handle, TAP::Parser::SourceHandler::RawTAP