TAP/Parser/SourceHandler/pgTAP version 3.37

This module adds support for executing pgTAP PostgreSQL tests under Test::Harness and `prove. This is useful for executing your Perl tests and your PostgreSQL tests together, and analyzing their results.

Most likely. you'll want to use it with prove to execute your Perl and pgTAP tests:

prove --source Perl \
      --ext .t --ext .pg \
      --source pgTAP --pgtap-option dbname=try \
                     --pgtap-option username=postgres \
                     --pgtap-option suffix=.pg

Or in Build.PL for your application with pgTAP tests in t/*.pg:

Module::Build->new(
    module_name        => 'MyApp',
    test_file_exts     => [qw(.t .pg)],
    use_tap_harness    => 1,
    tap_harness_args   => {
        sources => {
            Perl  => undef,
            pgTAP => {
                dbname   => 'try',
                username => 'root',
                suffix   => '.pg',
            },
        }
    },
    build_requires     => {
        'Module::Build'                     => '0.30',
        'TAP::Parser::SourceHandler::pgTAP' => '3.18',
    },
)->create_build_script;

Installation

To install this module, type the following:

perl Build.PL
./Build
./Build test
./Build install

To run it from a Docker image:

docker pull itheory/pg_prove
curl -L https://git.io/JUdgg -o pg_prove && chmod +x pg_prove
./pg_prove --help

Dependencies

TAP::Parser::SourceHandler::pgTAP requires TAP::Parser::SourceHandler.

Copyright and License

Copyright (c) 2018-2025 David E. Wheeler. Some Rights Reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.