#! /usr/local/perl -w
package main;
require Test::Harness;
*Verbose = \$Test::Harness::Verbose;
use Data::Dumper;
use File::Temp qw/tempfile/;
use File::Basename;
if ($Test::More::VERSION < 0.48) { # Fix for RT#48268
local $^W;
*main::use_ok = sub ($;@) {
my ($pkg, $req, @args) = @_;
eval "use $pkg $req ".join(' ',@args);
is ${"$pkg\::VERSION"}, $req, 'Had to manually use version';
# If we made it this far, we are ok.
};
}
sub BaseTests {
my ($CLASS, $method, $qv_declare) = @_;
my $warning;
local $SIG{__WARN__} = sub { $warning = $_[0] };
# Insert your test code below, the Test module is use()ed here so read
# its man page ( perldoc Test ) for help writing this test script.
# Test bare number processing
diag "tests with bare numbers" unless $ENV{PERL_CORE};
$version = $CLASS->$method(5.005_03);
is ( "$version" , "5.00503" , '5.005_03 eq 5.00503' );
$version = $CLASS->$method(1.23);
is ( "$version" , "1.23" , '1.23 eq "1.23"' );
# Test quoted number processing
diag "tests with quoted numbers" unless $ENV{PERL_CORE};
$version = $CLASS->$method("5.005_03");
is ( "$version" , "5.005_03" , '"5.005_03" eq "5.005_03"' );
$version = $CLASS->$method("v1.23");
is ( "$version" , "v1.23" , '"v1.23" eq "v1.23"' );
# Test stringify operator
diag "tests with stringify" unless $ENV{PERL_CORE};
$version = $CLASS->$method("5.005");
is ( "$version" , "5.005" , '5.005 eq "5.005"' );
$version = $CLASS->$method("5.006.001");
is ( "$version" , "5.006.001" , '5.006.001 eq v5.6.1' );
unlike ($warning, qr/v-string without leading 'v' deprecated/, 'No leading v');
$version = $CLASS->$method("v1.2.3_4");
is ( "$version" , "v1.2.3_4" , 'alpha version 1.2.3_4 eq v1.2.3_4' );
# test illegal formats
diag "test illegal formats" unless $ENV{PERL_CORE};
eval {my $version = $CLASS->$method("1.2_3_4")};
like($@, qr/multiple underscores/,
"Invalid version format (multiple underscores)");
eval {my $version = $CLASS->$method("1.2_3.4")};
like($@, qr/underscores before decimal/,
"Invalid version format (underscores before decimal)");
eval {my $version = $CLASS->$method("1_2")};
like($@, qr/alpha without decimal/,
"Invalid version format (alpha without decimal)");
eval { $version = $CLASS->$method("1.2b3")};
like($@, qr/non-numeric data/,
"Invalid version format (non-numeric data)");
eval { $version = $CLASS->$method("-1.23")};
like($@, qr/negative version number/,
"Invalid version format (negative version number)");
# from here on out capture the warning and test independently
{
eval{$version = $CLASS->$method("99 and 44/100 pure")};
like($@, qr/non-numeric data/,
"Invalid version format (non-numeric data)");
eval{$version = $CLASS->$method("something")};
like($@, qr/non-numeric data/,
"Invalid version format (non-numeric data)");
# reset the test object to something reasonable
$version = $CLASS->$method("1.2.3");
# Test boolean operator
ok ($version, 'boolean');
# Test class membership
isa_ok ( $version, $CLASS );
# Test comparison operators with self
diag "tests with self" unless $ENV{PERL_CORE};
is ( $version <=> $version, 0, '$version <=> $version == 0' );
ok ( $version == $version, '$version == $version' );
# Test Numeric Comparison operators
# test first with non-object
$version = $CLASS->$method("5.006.001");
$new_version = "5.8.0";
diag "numeric tests with non-objects" unless $ENV{PERL_CORE};
ok ( $version == $version, '$version == $version' );
ok ( $version < $new_version, '$version < $new_version' );
ok ( $new_version > $version, '$new_version > $version' );
ok ( $version != $new_version, '$version != $new_version' );
# now test with existing object
$new_version = $CLASS->$method($new_version);
diag "numeric tests with objects" unless $ENV{PERL_CORE};
ok ( $version < $new_version, '$version < $new_version' );
ok ( $new_version > $version, '$new_version > $version' );
ok ( $version != $new_version, '$version != $new_version' );
# now test with actual numbers
diag "numeric tests with numbers" unless $ENV{PERL_CORE};
ok ( $version->numify() == 5.006001, '$version->numify() == 5.006001' );
ok ( $version->numify() <= 5.006001, '$version->numify() <= 5.006001' );
ok ( $version->numify() < 5.008, '$version->numify() < 5.008' );
#ok ( $version->numify() > v5.005_02, '$version->numify() > 5.005_02' );
# test with long decimals
diag "Tests with extended decimal versions" unless $ENV{PERL_CORE};
$version = $CLASS->$method(1.002003);
ok ( $version == "1.2.3", '$version == "1.2.3"');
ok ( $version->numify == 1.002003, '$version->numify == 1.002003');
$version = $CLASS->$method("2002.09.30.1");
ok ( $version == "2002.9.30.1",'$version == 2002.9.30.1');
ok ( $version->numify == 2002.009030001,
'$version->numify == 2002.009030001');
# now test with alpha version form with string
$version = $CLASS->$method("1.2.3");
$new_version = "1.2.3_4";
diag "numeric tests with alpha-style non-objects" unless $ENV{PERL_CORE};
ok ( $version < $new_version, '$version < $new_version' );
ok ( $new_version > $version, '$new_version > $version' );
ok ( $version != $new_version, '$version != $new_version' );
$version = $CLASS->$method("1.2.4");
diag "numeric tests with alpha-style non-objects"
unless $ENV{PERL_CORE};
ok ( $version > $new_version, '$version > $new_version' );
ok ( $new_version < $version, '$new_version < $version' );
ok ( $version != $new_version, '$version != $new_version' );
# now test with alpha version form with object
$version = $CLASS->$method("1.2.3");
$new_version = $CLASS->$method("1.2.3_4");
diag "tests with alpha-style objects" unless $ENV{PERL_CORE};
ok ( $version < $new_version, '$version < $new_version' );
ok ( $new_version > $version, '$new_version > $version' );
ok ( $version != $new_version, '$version != $new_version' );
ok ( !$version->is_alpha, '!$version->is_alpha');
ok ( $new_version->is_alpha, '$new_version->is_alpha');
$version = $CLASS->$method("1.2.4");
diag "tests with alpha-style objects" unless $ENV{PERL_CORE};
ok ( $version > $new_version, '$version > $new_version' );
ok ( $new_version < $version, '$new_version < $version' );
ok ( $version != $new_version, '$version != $new_version' );
$version = $CLASS->$method("1.2.3.4");
$new_version = $CLASS->$method("1.2.3_4");
diag "tests with alpha-style objects with same subversion"
unless $ENV{PERL_CORE};
ok ( $version > $new_version, '$version > $new_version' );
ok ( $new_version < $version, '$new_version < $version' );
ok ( $version != $new_version, '$version != $new_version' );
diag "test implicit [in]equality" unless $ENV{PERL_CORE};
$version = $CLASS->$method("v1.2.3");
$new_version = $CLASS->$method("1.2.3.0");
ok ( $version == $new_version, '$version == $new_version' );
$new_version = $CLASS->$method("1.2.3_0");
ok ( $version == $new_version, '$version == $new_version' );
$new_version = $CLASS->$method("1.2.3.1");
ok ( $version < $new_version, '$version < $new_version' );
$new_version = $CLASS->$method("1.2.3_1");
ok ( $version < $new_version, '$version < $new_version' );
$new_version = $CLASS->$method("1.1.999");
ok ( $version > $new_version, '$version > $new_version' );
diag "test with version class names" unless $ENV{PERL_CORE};
$version = $CLASS->$method("v1.2.3");
eval { () = $version < 'version' };
like $@, qr/^Invalid version format/, "error with $version < 'version'";
# that which is not expressly permitted is forbidden
diag "forbidden operations" unless $ENV{PERL_CORE};
ok ( !eval { ++$version }, "noop ++" );
ok ( !eval { --$version }, "noop --" );
ok ( !eval { $version/1 }, "noop /" );
ok ( !eval { $version*3 }, "noop *" );
ok ( !eval { abs($version) }, "noop abs" );
SKIP: {
skip "version require'd instead of use'd, cannot test $qv_declare", 3
unless defined $qv_declare;
# test the $qv_declare() sub
diag "testing $qv_declare" unless $ENV{PERL_CORE};
$version = $CLASS->$qv_declare("1.2");
is ( "$version", "v1.2", $qv_declare.'("1.2") == "1.2.0"' );
$version = $CLASS->$qv_declare(1.2);
is ( "$version", "v1.2", $qv_declare.'(1.2) == "1.2.0"' );
isa_ok( $CLASS->$qv_declare('5.008'), $CLASS );
}
# test creation from existing version object
diag "create new from existing version" unless $ENV{PERL_CORE};
ok (eval {$new_version = $CLASS->$method($version)},
"new from existing object");
ok ($new_version == $version, "class->$method($version) identical");
$new_version = $version->$method(0);
isa_ok ($new_version, $CLASS );
is ($new_version, "0", "version->$method() doesn't clone");
$new_version = $version->$method("1.2.3");
is ($new_version, "1.2.3" , '$version->$method("1.2.3") works too');
# test the CVS revision mode
diag "testing CVS Revision" unless $ENV{PERL_CORE};
$version = new $CLASS qw$Revision: 1.2$;
ok ( $version == "1.2.0", 'qw$Revision: 1.2$ == 1.2.0' );
$version = new $CLASS qw$Revision: 1.2.3.4$;
ok ( $version == "1.2.3.4", 'qw$Revision: 1.2.3.4$ == 1.2.3.4' );
# test the CPAN style reduced significant digit form
diag "testing CPAN-style versions" unless $ENV{PERL_CORE};
$version = $CLASS->$method("1.23_01");
is ( "$version" , "1.23_01", "CPAN-style alpha version" );
ok ( $version > 1.23, "1.23_01 > 1.23");
ok ( $version < 1.24, "1.23_01 < 1.24");
# test reformed UNIVERSAL::VERSION
diag "Replacement UNIVERSAL::VERSION tests" unless $ENV{PERL_CORE};
my $error_regex = $] < 5.006
? 'version \d required'
: 'does not define \$t.{7}::VERSION';
{
my ($fh, $filename) = tempfile('tXXXXXXX', SUFFIX => '.pm', UNLINK => 1);
(my $package = basename($filename)) =~ s/\.pm$//;
print $fh "package $package;\n\$$package\::VERSION=0.58;\n1;\n";
close $fh;
$version = 0.58;
eval "use lib '.'; use $package $version";
unlike($@, qr/$package version $version/,
'Replacement eval works with exact version');
# test as class method
$new_version = $package->VERSION;
cmp_ok($new_version,'==',$version, "Called as class method");
eval "print Completely::Unknown::Module->VERSION";
if ( $] < 5.008 ) {
unlike($@, qr/$error_regex/,
"Don't freak if the module doesn't even exist");
}
else {
unlike($@, qr/defines neither package nor VERSION/,
"Don't freak if the module doesn't even exist");
}
# this should fail even with old UNIVERSAL::VERSION
$version += 0.01;
eval "use lib '.'; use $package $version";
like($@, qr/$package version $version/,
'Replacement eval works with incremented version');
$version =~ s/0+$//; #convert to string and remove trailing 0's
chop($version); # shorten by 1 digit, should still succeed
eval "use lib '.'; use $package $version";
unlike($@, qr/$package version $version/,
'Replacement eval works with single digit');
# this would fail with old UNIVERSAL::VERSION
$version += 0.1;
eval "use lib '.'; use $package $version";
like($@, qr/$package version $version/,
'Replacement eval works with incremented digit');
unlink $filename;
}
{ # dummy up some variously broken modules for testing
my ($fh, $filename) = tempfile('tXXXXXXX', SUFFIX => '.pm', UNLINK => 1);
(my $package = basename($filename)) =~ s/\.pm$//;
print $fh "1;\n";
close $fh;
eval "use lib '.'; use $package 3;";
if ( $] < 5.008 ) {
like($@, qr/$error_regex/,
'Replacement handles modules without package or VERSION');
}
else {
like($@, qr/defines neither package nor VERSION/,
'Replacement handles modules without package or VERSION');
}
eval "use lib '.'; use $package; \$version = $package->VERSION";
unlike ($@, qr/$error_regex/,
'Replacement handles modules without package or VERSION');
ok (!defined($version), "Called as class method");
unlink $filename;
}
{ # dummy up some variously broken modules for testing
my ($fh, $filename) = tempfile('tXXXXXXX', SUFFIX => '.pm', UNLINK => 1);
(my $package = basename($filename)) =~ s/\.pm$//;
print $fh "package $package;\n#look ma no VERSION\n1;\n";
close $fh;
eval "use lib '.'; use $package 3;";
like ($@, qr/$error_regex/,
'Replacement handles modules without VERSION');
eval "use lib '.'; use $package; print $package->VERSION";
unlike ($@, qr/$error_regex/,
'Replacement handles modules without VERSION');
unlink $filename;
}
{ # dummy up some variously broken modules for testing
my ($fh, $filename) = tempfile('tXXXXXXX', SUFFIX => '.pm', UNLINK => 1);
(my $package = basename($filename)) =~ s/\.pm$//;
print $fh "package $package;\n\@VERSION = ();\n1;\n";
close $fh;
eval "use lib '.'; use $package 3;";
like ($@, qr/$error_regex/,
'Replacement handles modules without VERSION');
eval "use lib '.'; use $package; print $package->VERSION";
unlike ($@, qr/$error_regex/,
'Replacement handles modules without VERSION');
unlink $filename;
}
SKIP: { # https://rt.perl.org/rt3/Ticket/Display.html?id=95544
skip "version require'd instead of use'd, cannot test UNIVERSAL::VERSION", 2
unless defined $qv_declare;
my ($fh, $filename) = tempfile('tXXXXXXX', SUFFIX => '.pm', UNLINK => 1);
(my $package = basename($filename)) =~ s/\.pm$//;
print $fh "package $package;\n\$VERSION = '3alpha';\n1;\n";
close $fh;
eval "use lib '.'; use $package; print $package->VERSION";
like ($@, qr/Invalid version format \(non-numeric data\)/,
'Warn about bad \$VERSION');
eval "use lib '.'; use $package 1;";
like ($@, qr/Invalid version format \(non-numeric data\)/,
'Warn about bad $VERSION');
}
SKIP: {
skip 'Cannot test bare v-strings with Perl < 5.6.0', 4
if $] < 5.006_000;
diag "Tests with v-strings" unless $ENV{PERL_CORE};
$version = $CLASS->$method(1.2.3);
ok("$version" eq "v1.2.3", '"$version" eq 1.2.3');
$version = $CLASS->$method(1.0.0);
$new_version = $CLASS->$method(1);
ok($version == $new_version, '$version == $new_version');
skip "version require'd instead of use'd, cannot test declare", 1
unless defined $qv_declare;
$version = &$qv_declare(1.2.3);
ok("$version" eq "v1.2.3", 'v-string initialized $qv_declare()');
}
SKIP: {
skip 'Cannot test bare alpha v-strings with Perl < 5.8.1', 2
if $] lt 5.008_001;
diag "Tests with bare alpha v-strings" unless $ENV{PERL_CORE};
$version = $CLASS->$method(v1.2.3_4);
is($version, "v1.2.3_4", '"$version" eq "v1.2.3_4"');
$version = $CLASS->$method(eval "v1.2.3_4");
is($version, "v1.2.3_4", '"$version" eq "v1.2.3_4" (from eval)');
}
diag "Tests with real-world (malformed) data" unless $ENV{PERL_CORE};
# trailing zero testing (reported by Andreas Koenig).
$version = $CLASS->$method("1");
ok($version->numify eq "1.000", "trailing zeros preserved");
$version = $CLASS->$method("1.0");
ok($version->numify eq "1.000", "trailing zeros preserved");
$version = $CLASS->$method("1.0.0");
ok($version->numify eq "1.000000", "trailing zeros preserved");
$version = $CLASS->$method("1.0.0.0");
ok($version->numify eq "1.000000000", "trailing zeros preserved");
# leading zero testing (reported by Andreas Koenig).
$version = $CLASS->$method(".7");
ok($version->numify eq "0.700", "leading zero inferred");
# leading space testing (reported by Andreas Koenig).
$version = $CLASS->$method(" 1.7");
ok($version->numify eq "1.700", "leading space ignored");
# RT 19517 - deal with undef and 'undef' initialization
ok("$version" ne 'undef', "Undef version comparison #1");
ok("$version" ne undef, "Undef version comparison #2");
$version = $CLASS->$method('undef');
unlike($warning, qr/^Version string 'undef' contains invalid data/,
"Version string 'undef'");
$version = $CLASS->$method(undef);
like($warning, qr/^Use of uninitialized value/,
"Version string 'undef'");
ok($version == 'undef', "Undef version comparison #3");
ok($version == undef, "Undef version comparison #4");
eval "\$version = \$CLASS->$method()"; # no parameter at all
unlike($@, qr/^Bizarre copy of CODE/, "No initializer at all");
ok($version == 'undef', "Undef version comparison #5");
ok($version == undef, "Undef version comparison #6");
$version = $CLASS->$method(0.000001);
unlike($warning, qr/^Version string '1e-06' contains invalid data/,
"Very small version objects");
}
SKIP: {
my $warning;
local $SIG{__WARN__} = sub { $warning = $_[0] };
# dummy up a legal module for testing RT#19017
my ($fh, $filename) = tempfile('tXXXXXXX', SUFFIX => '.pm', UNLINK => 1);
(my $package = basename($filename)) =~ s/\.pm$//;
print $fh <<"EOF";
package $package;
use $CLASS; \$VERSION = ${CLASS}->new('0.0.4');
1;
EOF
close $fh;
eval "use lib '.'; use $package 0.000008;";
like ($@, qr/^$package version 0.000008 required/,
"Make sure very small versions don't freak");
eval "use lib '.'; use $package 1;";
like ($@, qr/^$package version 1 required/,
"Comparing vs. version with no decimal");
eval "use lib '.'; use $package 1.;";
like ($@, qr/^$package version 1 required/,
"Comparing vs. version with decimal only");
if ( $] < 5.006_000 ) {
skip 'Cannot "use" extended versions with Perl < 5.6.0', 3;
}
eval "use lib '.'; use $package v0.0.8;";
my $regex = "^$package version v0.0.8 required";
like ($@, qr/$regex/, "Make sure very small versions don't freak");
$regex =~ s/8/4/; # set for second test
eval "use lib '.'; use $package v0.0.4;";
unlike($@, qr/$regex/, 'Succeed - required == VERSION');
cmp_ok ( $package->VERSION, 'eq', '0.0.4', 'No undef warnings' );
unlink $filename;
}
SKIP: {
skip 'Cannot test "use base qw(version)" when require is used', 3
unless defined $qv_declare;
my ($fh, $filename) = tempfile('tXXXXXXX', SUFFIX => '.pm', UNLINK => 1);
(my $package = basename($filename)) =~ s/\.pm$//;
print $fh <<"EOF";
package $package;
use base qw(version);
1;
EOF
close $fh;
# need to eliminate any other $qv_declare()'s
undef *{"main\::$qv_declare"};
ok(!defined(&{"main\::$qv_declare"}), "make sure we cleared $qv_declare() properly");
eval "use lib '.'; use $package qw/declare qv/;";
ok(defined(&{"main\::$qv_declare"}), "make sure we exported $qv_declare() properly");
isa_ok( &$qv_declare(1.2), $package);
unlink $filename;
}
SKIP: {
if ( $] < 5.006_000 ) {
skip 'Cannot "use" extended versions with Perl < 5.6.0', 3;
}
my ($fh, $filename) = tempfile('tXXXXXXX', SUFFIX => '.pm', UNLINK => 1);
(my $package = basename($filename)) =~ s/\.pm$//;
print $fh <<"EOF";
package $package;
\$VERSION = 1.0;
1;
EOF
close $fh;
eval "use lib '.'; use $package 1.001;";
like ($@, qr/^$package version 1.001 required/,
"User typed numeric so we error with numeric");
eval "use lib '.'; use $package v1.1.0;";
like ($@, qr/^$package version v1.1.0 required/,
"User typed extended so we error with extended");
unlink $filename;
}
eval 'my $v = $CLASS->$method("1._1");';
unlike($@, qr/^Invalid version format \(alpha with zero width\)/,
"Invalid version format 1._1");
{
my $warning;
local $SIG{__WARN__} = sub { $warning = $_[0] };
eval 'my $v = $CLASS->$method(~0);';
unlike($@, qr/Integer overflow in version/, "Too large version");
like($warning, qr/Integer overflow in version/, "Too large version");
}
{
# http://rt.cpan.org/Public/Bug/Display.html?id=30004
my $v1 = $CLASS->$method("v0.1_1");
(my $alpha1 = Dumper($v1)) =~ s/.+'alpha' => ([^,]+),.+/$1/ms;
my $v2 = $CLASS->$method($v1);
(my $alpha2 = Dumper($v2)) =~ s/.+'alpha' => ([^,]+),.+/$1/ms;
is $alpha2, $alpha1, "Don't fall for Data::Dumper's tricks";
}
{
# http://rt.perl.org/rt3/Ticket/Display.html?id=56606
my $badv = bless { version => [1,2,3] }, "version";
is $badv, '1.002003', "Deal with badly serialized versions from YAML";
my $badv2 = bless { qv => 1, version => [1,2,3] }, "version";
is $badv2, 'v1.2.3', "Deal with badly serialized versions from YAML ";
}
{
# https://rt.cpan.org/Public/Bug/Display.html?id=70950
# test indirect usage of version objects
my $sum = 0;
eval '$sum += $CLASS->$method("v2.0.0")';
like $@, qr/operation not supported with version object/,
'No math operations with version objects';
# test direct usage of version objects
my $v = $CLASS->$method("v2.0.0");
eval '$v += 1';
like $@, qr/operation not supported with version object/,
'No math operations with version objects';
}
{
# https://rt.cpan.org/Ticket/Display.html?id=72365
# https://rt.perl.org/rt3/Ticket/Display.html?id=102586
eval 'my $v = $CLASS->$method("version")';
like $@, qr/Invalid version format/,
'The string "version" is not a version';
eval 'my $v = $CLASS->$method("ver510n")';
like $@, qr/Invalid version format/,
'All strings starting with "v" are not versions';
}
SKIP: {
if ( $] < 5.006_000 ) {
skip 'No v-string support at all < 5.6.0', 2;
}
# https://rt.cpan.org/Ticket/Display.html?id=49348
my $v = $CLASS->$method("420");
is "$v", "420", 'Correctly guesses this is not a v-string';
$v = $CLASS->$method(4.2.0);
is "$v", 'v4.2.0', 'Correctly guess that this is a v-string';
}
SKIP: {
if ( $] < 5.006_000 ) {
skip 'No v-string support at all < 5.6.0', 4;
}
# https://rt.cpan.org/Ticket/Display.html?id=50347
# Check that the qv() implementation does not change
ok $CLASS->$method(1.2.3) < $CLASS->$method(1.2.3.1), 'Compare 3 and 4 digit v-strings' ;
ok $CLASS->$method(v1.2.3) < $CLASS->$method(v1.2.3.1), 'Compare 3 and 4 digit v-strings, leaving v';
ok $CLASS->$method("1.2.3") < $CLASS->$method("1.2.3.1"), 'Compare 3 and 4 digit v-strings, quoted';
ok $CLASS->$method("v1.2.3") < $CLASS->$method("v1.2.3.1"), 'Compare 3 and 4 digit v-strings, quoted leading v';
}
{
eval '$CLASS->$method("version")';
pass("no crash with ${CLASS}->${method}('version')");
{
package _102586;
sub TIESCALAR { bless [] }
sub FETCH { "version" }
sub STORE { }
my $v;
tie $v, __PACKAGE__;
$v = $CLASS->$method(1);
eval '$CLASS->$method($v)';
}
pass('no crash with version->new($tied) where $tied returns "version"');
}
{ # [perl #112478]
$_112478::VERSION = 9e99;
ok eval { _112478->VERSION(9e99); 1 }, '->VERSION(9e99) succeeds'
or diag $@;
$_112478::VERSION = 1;
eval { _112478->VERSION(9e99) };
unlike $@, qr/panic/, '->VERSION(9e99) does not panic';
}
}
1;