Module::Install::AuthorTests(3pm)

Module::Install::AuthorTests3pm

Designate tests only run by module authors

Version

0.002

Commands

This plugin adds the following Module::Install commands:

author_tests

  author_tests('xt');

This declares that the test files found in the directory ./xt should be run only if the module is being built by an author. For an explanation, see below.

You may declare multiple test directories by passing a list of tests. Since tests are not recursive by default, it should be safe to use a subdirectory of ./t for author tests, like:

  author_tests('t/author');

recursive_author_tests

  recursive_author_tests('xt');

This acts like "author_tests", but will look for tests in directories below ./xt as well as in the directory itself.

How it works

"Is this being run by an author?" is determined internally by Module::Install, but at the time of the writing of this version it's determined by the existence of a directory called .author in ./inc. (On VMS, it's _author.) This directory is created when Module::Install's Makefile.PL is run in a directory where no ./inc directory exists.

Releases

6 releases since Debian 8 (Jessie); the text changed 4 times.

  1. 8
  2. 9–10
  3. 11
  4. 12
  5. 13

Bugs

Please report any bugs or feature requests through the web interface at <http://rt.cpan.org>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

From libmodule-install-authortests-perl 0.002-4 in Debian 13 (Trixie). Parsed by carta from the page's man source.