1Test::Version(3)      User Contributed Perl Documentation     Test::Version(3)
2
3
4

NAME

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

VERSION

9       version 1.0.0
10

SYNOPSIS

12               use Test::More;
13               use Test::Version 0.04;
14
15               # test blib or lib by default
16               version_all_ok();
17
18               done_testing;
19

DESCRIPTION

21       This module's goal is to be a one stop shop for checking to see that
22       your versions across your dist are sane. Please ensure that you use
23       version 0.04 or later only, as earlier versions are old code and may
24       not work correctly.  Current feature list:
25
26       module has a version
27           Tests to insure that all modules checked have a VERSION defined,
28           Can replace Test::HasVersion
29
30       module has a valid version
31           Tests to insure that all versions are valid, according to the rules
32           of version method "is_lax". To quote:
33
34           The lax criteria corresponds to what is currently allowed by the
35           version parser. All of the following formats are acceptable for
36           dotted-decimal formats strings:
37
38                   v1.2
39                   1.2345.6
40                   v1.23_4
41                   1.2345
42                   1.2345_01
43

METHODS

45       "version_ok( $filename, [ $name ] );"
46           Test a single ".pm" file by passing a path to the function. Checks
47           if the module has a version, and that it is valid with "is_lax".
48
49       "version_all_ok( [ $directory, [ $name ]] );"
50           Test all modules in a directory with "version_ok". By default it
51           will check "blib" or "lib" if you haven't passed it a directory.
52

BUGS AND LIMITATIONS

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

SEE ALSO

58       The goal is to have the functionality of all of these.
59
60       Test::HasVersion
61       Test::ConsistentVersion
62       Test::GreaterVersion
63

ACKNOWLEDGEMENTS

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

AUTHOR

71       Caleb Cushing <xenoterracide@gmail.com>
72

74       This software is Copyright (c) 2011 by Caleb Cushing.
75
76       This is free software, licensed under:
77
78         The Artistic License 2.0 (GPL Compatible)
79
80
81
82perl v5.12.3                      2011-07-01                  Test::Version(3)
Impressum