内容

名称

TAP::Parser::SourceHandler::Executable - 可执行 TAP 源的流输出

版本

版本 3.44

概要

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

说明

这是一个可执行 TAP::Parser::SourceHandler - 它有 2 个工作

1. 确定给定的 TAP::Parser::Source 是否是一个可执行命令 ("can_handle").

2. 为可执行命令创建一个迭代器 ("make_iterator").

除非你正在编写插件或对 TAP::Parser 进行子类化，否则你可能不需要直接使用此模块。

方法

类方法

can_handle

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

仅当 $source 看起来像可执行文件时才投票。投出以下选票

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

为源返回一个新的 TAP::Parser::Iterator::Process。$source->raw 必须采用以下形式之一

{ exec => [ @exec ] }

[ @exec ]

$file

在错误时croak。

iterator_class

要使用的迭代器类，如果您是子类，请覆盖。默认为 TAP::Parser::Iterator::Process。

子类化

有关子类化的概述，请参阅 TAP::Parser 中的“SUBCLASSING”。

示例

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

另请参阅

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