Test::MinimumVersion(3)

NAME
Test::MinimumVersion - does your code require newer perl than you think?

VERSION
version 0.101082

SYNOPSIS
Example minimum-perl.t:

  #!perl
  use Test::MinimumVersion;
  all_minimum_version_ok('5.008');

FUNCTIONS

  minimum_version_ok
  minimum_version_ok($file, $version);

This test passes if the given file does not seem to require any version of perl newer than $version, which may be given as a version string or a version object.

  all_minimum_version_ok
  all_minimum_version_ok($version, \%arg);

Given either a version string or a version object, this routine produces a test plan (if there is no plan) and tests each relevant file with "minimum_version_ok".

Relevant files are found by File::Find::Rule::Perl.

"\%arg" is optional. Valid arguments are:

  paths   - in what paths to look for files; defaults to (bin, script, t, lib,
            xt/smoke, and any .pm or .PL files in the current working
            directory) if it contains files, they will be checked
  no_plan - do not plan the tests about to be run
  skip    - files to skip; this can be useful in weird cases like gigantic
            files, files falsely detected as Perl, or code that uses
            a source filter; this should be an arrayref of filenames

  all_minimum_version_from_metayml_ok
  all_minimum_version_from_metayml_ok(\%arg);

This routine checks META.yml for an entry in requires for perl. If no META.yml file or no perl version is found, all tests are skipped. If a version is found, the test proceeds as if "all_minimum_version_ok" had been called with that version.

  all_minimum_version_from_metajson_ok
  all_minimum_version_from_metajson_ok(\%arg);

This routine checks META.json for an entry in requires for perl. If no META.json file or no perl version is found, all tests are skipped. If a version is found, the test proceeds as if "all_minimum_version_ok" had been called with that version.

  all_minimum_version_from_mymetayml_ok
  all_minimum_version_from_mymetayml_ok(\%arg);

This routine checks MYMETA.yml for an entry in requires for perl. If no MYMETA.yml file or no perl version is found, all tests are skipped. If a version is found, the test proceeds as if "all_minimum_version_ok" had been called with that version.

  all_minimum_version_from_mymetajson_ok
  all_minimum_version_from_mymetajson_ok(\%arg);

This routine checks MYMETA.json for an entry in requires for perl. If no MYMETA.json file or no perl version is found, all tests are skipped. If a version is found, the test proceeds as if "all_minimum_version_ok" had been called with that version.

AUTHOR
Ricardo Signes

CONTRIBUTORS

•   Ricardo SIGNES <rjbs@codesimply.com>

•   Ricardo SIGNES <rjbs@cpan.org>

•   Steve Hay <steve.m.hay@googlemail.com>

COPYRIGHT AND LICENSE
This software is copyright (c) 2007 by Ricardo Signes.

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