/ 
Test-Which-0.01
/ Test::Which

NAME

Test::Which - Skip tests if external programs are missing from PATH (with version checks)

SYNOPSIS

use Test::Which 'ffmpeg' => '>=6.0', 'convert' => '>=7.1';

# At runtime in a subtest or test body
use Test::Which qw(which_ok);

subtest 'needs ffmpeg' => sub {
    which_ok 'ffmpeg' => '>=6.0' or return;
    ... # tests that use ffmpeg
};

DESCRIPTION

Test::Which mirrors Test::Needs but checks for executables in PATH. It can also check simple version constraints using a built-in heuristic (tries --version, -version, -v, -V and extracts a dotted-number). If a version is requested but cannot be determined, the requirement fails.

FUNCTIONS

which_ok @programs_or_pairs

Checks the named programs (with optional version constraints). If any requirement is not met the current test or subtest is skipped via Test::Builder.

SUPPORT

This module is provided as-is without any warranty.

AUTHOR

Nigel Horne, <njh at nigelhorne.com>

LICENCE AND COPYRIGHT

Copyright 2025 Nigel Horne.

Usage is subject to licence terms.

The licence terms of this software are as follows:

  • Personal single user, single computer use: GPL2

  • All other users (including Commercial, Charity, Educational, Government) must apply in writing for a licence for use from Nigel Horne at the above e-mail.