The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.


TAP::Harness::Restricted - Skip some test files


version 0.004


    # command line
    $ HARNESS_SUBCLASS=TAP::Harness::Restricted make test

    # bashrc file
    export HARNESS_SUBCLASS=TAP::Harness::Restricted


This module is a trivial subclass of TAP::Harness. It overrides the aggregate_tests function to filter out tests that I didn't want getting in the way of module installation.

The current criteria include:

  • File names that look like pod.t or pod-coverage.t, with optional leading numbers

  • Files matching any of the space-separated glob patterns in $ENV{HARNESS_SKIP}

  • Files that look like author tests based on the modules they use or require

The list of modules to exclude is:

  • Test::CleanNamespaces

  • Test::DependentModules

  • Test::EOL

  • Test::Kwalitee

  • Test::Mojibake

  • Test::NoTabs

  • Test::Perl::Critic

  • Test::Pod

  • Test::Portability::Files

  • Test::Spelling

  • Test::Vars

Suggestions for other annoying things to filter out are welcome.

If someone is inclined to make this extensible so people can put their own criteria into configuration files, please email the author with ideas before sending a patch.


Bugs / Feature Requests

Please report any bugs or feature requests through the issue tracker at You will be notified automatically of any progress on your issue.

Source Code

This is open source software. The code repository is available for public review and contribution under the terms of the license.

  git clone


David Golden <>


  • Dagfinn Ilmari Mannsåker <>

  • grr <>


This software is Copyright (c) 2013 by David Golden.

This is free software, licensed under:

  The Apache License, Version 2.0, January 2004