<!-- GENERATED by docs/sphinx/bin/20-reference (p5) from reference/bundled/TAP/Parser/SourceHandler/Executable.md. Do not edit. -->

```{index} single: TAP::Parser::SourceHandler::Executable
```

# TAP::Parser::SourceHandler::Executable

Stream output from an executable TAP source

## VERSION

Version 3.52

## SYNOPSIS

```perl
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](../SourceHandler.md) - it has 2 jobs:

1\. Figure out if the [TAP::Parser::Source](../Source.md) 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](../../Parser.md), you
probably won't need to use this module directly.

## METHODS

### Class Methods

#### `can_handle`

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

Only votes if $source looks like an executable file. Casts the
following votes:

```text
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`

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

Returns a new [TAP::Parser::Iterator::Process](../Iterator/Process.md) for the source.
`$source->raw` must be in one of the following forms:

```perl
{ exec => [ @exec ] }

[ @exec ]

$file
```

`croak`s on error.

#### `iterator_class`

The class of iterator to use, override if you're sub-classing.  Defaults
to [TAP::Parser::Iterator::Process](../Iterator/Process.md).

## SUBCLASSING

Please see ["SUBCLASSING" in TAP::Parser](../../Parser.md) for a subclassing overview.

### Example

```perl
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](../../Object.md),
[TAP::Parser](../../Parser.md),
[TAP::Parser::IteratorFactory](../IteratorFactory.md),
[TAP::Parser::SourceHandler](../SourceHandler.md),
[TAP::Parser::SourceHandler::Perl](Perl.md),
[TAP::Parser::SourceHandler::File](File.md),
[TAP::Parser::SourceHandler::Handle](Handle.md),
[TAP::Parser::SourceHandler::RawTAP](RawTAP.md)