NAME
    Test::Version - Check to see that version's in modules are sane

VERSION
    version 1.001002

SYNOPSIS
            use Test::More;
            use Test::Version 1.001001 qw( version_ok ), {
                            is_strict   => 0,
                            has_version => 1,
                    };

            # test blib or lib by default
            version_all_ok();

            done_testing;

DESCRIPTION
    This module's goal is to be a one stop shop for checking to see that
    your versions across your dist are sane. Please ensure that you use
    version 0.04 or later only, as earlier versions are old code and may not
    work correctly. Current feature list:

    module has a version
        Tests to insure that all modules checked have a VERSION defined, Can
        replace Test::HasVersion

    module has a valid version
        Tests to insure that all versions are valid, according to the rules
        of version method "is_lax". To quote:

        *The lax criteria corresponds to what is currently allowed by the
        version parser. All of the following formats are acceptable for
        dotted-decimal formats strings:*

                v1.2
                1.2345.6
                v1.23_4
                1.2345
                1.2345_01

        *If you want to limit yourself to a much more narrow definition of
        what a version string constitutes, is_strict() is limited to version
        strings like the following list:*

                v1.234.5
                2.3456

        you can cause your tests to fail if not strict by setting is_strict
        to 1

FUNCTIONS
  version_ok
            version_ok( $filename, [ $name ] );

    Test a single ".pm" file by passing a path to the function. Checks if
    the module has a version, and that it is valid with "is_lax".

  version_all_ok
            version_all_ok( [ $directory, [ $name ]] );

    Test all modules in a directory with "version_ok". By default it will
    check "blib" or "lib" if you haven't passed it a directory.

CONFIGURATION AND ENVIRONMENT
  has_version
            use Test::Version qw( version_all_ok ), { has_version => 0 };

    Allows disabling whether a module has to have a version. If set to 0
    version tests will be skipped in any module where no version is found.

    really doesn't make sense to use with just version_ok

  is_strict
            use Test::Version { is_strict => 1 };

    this allows enabling of versions "is_strict" checks to ensure that your
    version is strict.

LIMITATIONS
    Will not test Perl 5.12 "package" version declarations because
    Module::Extract::VERSION can't extract them yet.

SEE ALSO
    The goal is to have the functionality of all of these.

    Test::HasVersion
    Test::ConsistentVersion
    Test::GreaterVersion

ACKNOWLEDGEMENTS
    Special thanks to particle "<particle at cpan dot org"> for the original
    "Test::Version" and letting me maintain it further. Thanks to Mike
    Doherty "<doherty at cs dot dal dot ca">, and Michael G. Schwern
    "<schwern at pobox dot com"> for their patches.

BUGS
    Please report any bugs or feature requests on the bugtracker website
    https://github.com/gitpan/Test-Version/issues

    When submitting a bug or request, please include a test-file or a patch
    to an existing test-file that illustrates the bug or desired feature.

AUTHOR
    Caleb Cushing <xenoterracide@gmail.com>

COPYRIGHT AND LICENSE
    This software is Copyright (c) 2011 by Caleb Cushing.

    This is free software, licensed under:

      The Artistic License 2.0 (GPL Compatible)

