1 package Module::Build::Version;
7 eval "use version $VERSION";
8 if ($@) { # can't locate version files, use our own
10 # Avoid redefined warnings if an old version.pm was available
11 delete $version::{$_} foreach keys %version::;
13 # first we get the stub version module
16 s/(\$VERSION)\s=\s\d+/\$VERSION = 0/;
21 # and now get the current version::vpp code
24 s/(\$VERSION)\s=\s\d+/\$VERSION = 0/;
29 # but we eval them in reverse order since version depends on
30 # version::vpp to already exist
31 eval $vpp; die $@ if $@;
32 $INC{'version/vpp.pm'} = 'inside Module::Build::Version';
33 eval $version; die $@ if $@;
34 $INC{'version.pm'} = 'inside Module::Build::Version';
37 # now we can safely subclass version, installed or not
43 # stub version module to make everything else happy
49 use vars qw(@ISA $VERSION $CLASS *qv);
55 push @ISA, "version::vpp";
56 *version::qv = \&version::vpp::qv;
58 # Preloaded methods go here.
61 my $callpkg = caller();
65 sub {return bless version::qv(shift), $class }
66 unless defined(&{"$callpkg\::qv"});
71 # replace everything from here to the end with the current version/vpp.pm
77 use vars qw ($VERSION @ISA @REGEXS);
81 ^v? # optional leading 'v'
82 (\d*) # major revision not required
83 \. # requires at least one decimal
93 'nomethod' => \&vnoop,
98 my ($class, $value) = @_;
99 my $self = bless ({}, ref ($class) || $class);
101 if ( ref($value) && eval("$value->isa('version')") ) {
102 # Can copy the elements directly
103 $self->{version} = [ @{$value->{version} } ];
104 $self->{qv} = 1 if $value->{qv};
105 $self->{alpha} = 1 if $value->{alpha};
106 $self->{original} = ''.$value->{original};
111 my $currlocale = POSIX::setlocale(&POSIX::LC_ALL);
112 my $radix_comma = ( POSIX::localeconv()->{decimal_point} eq ',' );
114 if ( not defined $value or $value =~ /^undef$/ ) {
115 # RT #19517 - special case for undef comparison
116 # or someone forgot to pass a value
117 push @{$self->{version}}, 0;
118 $self->{original} = "0";
122 if ( $#_ == 2 ) { # must be CVS-style
126 $value = _un_vstring($value);
128 # exponential notation
129 if ( $value =~ /\d+.?\d*e-?\d+/ ) {
130 $value = sprintf("%.9f",$value);
134 # if the original locale used commas for decimal points, we
135 # just replace commas with decimal places, rather than changing
137 if ( $radix_comma ) {
141 # This is not very efficient, but it is morally equivalent
142 # to the XS code (as that is the reference implementation).
143 # See vutil/vutil.c for details
148 my ($start, $last, $pos, $s);
151 while ( substr($value,$s,1) =~ /\s/ ) { # leading whitespace is OK
155 if (substr($value,$s,1) eq 'v') {
157 $qv = 1; # force quoted version processing
160 $start = $last = $pos = $s;
162 # pre-scan the input string to check for decimals/underbars
163 while ( substr($value,$pos,1) =~ /[._\d]/ ) {
164 if ( substr($value,$pos,1) eq '.' ) {
167 Carp::croak("Invalid version format ".
168 "(underscores before decimal)");
173 elsif ( substr($value,$pos,1) eq '_' ) {
176 Carp::croak("Invalid version format ".
177 "(multiple underscores)");
180 $width = $pos - $last - 1; # natural width of sub-version
185 if ( $alpha && !$saw_period ) {
187 Carp::croak("Invalid version format (alpha without decimal)");
190 if ( $alpha && $saw_period && $width == 0 ) {
192 Carp::croak("Invalid version format (misplaced _ in number)");
195 if ( $saw_period > 1 ) {
196 $qv = 1; # force quoted version processing
209 if ( !$qv && $width < 3 ) {
210 $self->{width} = $width;
213 while ( substr($value,$pos,1) =~ /\d/ ) {
217 if ( substr($value,$pos,1) !~ /[a-z]/ ) { ### FIX THIS ###
224 # this is atoi() that delimits on underscores
229 # the following if() will only be true after the decimal
230 # point of a version originally created with a bare
231 # floating point number, i.e. not quoted in any way
232 if ( !$qv && $s > $start && $saw_period == 1 ) {
234 while ( $s < $end ) {
236 $rev += substr($value,$s,1) * $mult;
238 if ( abs($orev) > abs($rev) ) {
240 Carp::croak("Integer overflow in version");
243 if ( substr($value,$s,1) eq '_' ) {
249 while (--$end >= $s) {
251 $rev += substr($value,$end,1) * $mult;
253 if ( abs($orev) > abs($rev) ) {
255 Carp::croak("Integer overflow in version");
262 push @{$self->{version}}, $rev;
263 if ( substr($value,$pos,1) eq '.'
264 && substr($value,$pos+1,1) =~ /\d/ ) {
267 elsif ( substr($value,$pos,1) eq '_'
268 && substr($value,$pos+1,1) =~ /\d/ ) {
271 elsif ( substr($value,$pos,1) =~ /\d/ ) {
279 while ( substr($value,$pos,1) =~ /\d/ ) {
285 while (substr($value,$pos,1) =~ /[\d_]/ && $digits < 3) {
286 if ( substr($value,$pos,1) ne '_' ) {
294 if ( $qv ) { # quoted versions always get at least three terms
295 my $len = scalar @{$self->{version}};
298 push @{$self->{version}}, 0;
302 if ( substr($value,$pos) ) { # any remaining text
303 warn "Version string '$value' contains invalid data; ".
304 "ignoring: '".substr($value,$pos)."'";
307 # cache the original value for use when stringification
308 $self->{original} = substr($value,0,$pos);
316 unless (_verify($self)) {
318 Carp::croak("Invalid version object");
320 my $width = $self->{width} || 3;
321 my $alpha = $self->{alpha} || "";
322 my $len = $#{$self->{version}};
323 my $digit = $self->{version}[0];
324 my $string = sprintf("%d.", $digit );
326 for ( my $i = 1 ; $i < $len ; $i++ ) {
327 $digit = $self->{version}[$i];
329 my $denom = 10**(3-$width);
330 my $quot = int($digit/$denom);
331 my $rem = $digit - ($quot * $denom);
332 $string .= sprintf("%0".$width."d_%d", $quot, $rem);
335 $string .= sprintf("%03d", $digit);
340 $digit = $self->{version}[$len];
341 if ( $alpha && $width == 3 ) {
344 $string .= sprintf("%0".$width."d", $digit);
348 $string .= sprintf("000");
357 unless (_verify($self)) {
359 Carp::croak("Invalid version object");
361 my $alpha = $self->{alpha} || "";
362 my $len = $#{$self->{version}};
363 my $digit = $self->{version}[0];
364 my $string = sprintf("v%d", $digit );
366 for ( my $i = 1 ; $i < $len ; $i++ ) {
367 $digit = $self->{version}[$i];
368 $string .= sprintf(".%d", $digit);
372 $digit = $self->{version}[$len];
374 $string .= sprintf("_%0d", $digit);
377 $string .= sprintf(".%0d", $digit);
382 for ( $len = 2 - $len; $len != 0; $len-- ) {
383 $string .= sprintf(".%0d", 0);
393 unless (_verify($self)) {
395 Carp::croak("Invalid version object");
397 return $self->{original};
403 my ($left,$right,$swap) = @_;
404 my $class = ref($left);
405 unless ( UNIVERSAL::isa($right, $class) ) {
406 $right = $class->new($right);
410 ($left, $right) = ($right, $left);
412 unless (_verify($left)) {
414 Carp::croak("Invalid version object");
416 unless (_verify($right)) {
418 Carp::croak("Invalid version object");
420 my $l = $#{$left->{version}};
421 my $r = $#{$right->{version}};
422 my $m = $l < $r ? $l : $r;
423 my $lalpha = $left->is_alpha;
424 my $ralpha = $right->is_alpha;
427 while ( $i <= $m && $retval == 0 ) {
428 $retval = $left->{version}[$i] <=> $right->{version}[$i];
432 # tiebreaker for alpha with identical terms
435 && $left->{version}[$m] == $right->{version}[$m]
436 && ( $lalpha || $ralpha ) ) {
438 if ( $lalpha && !$ralpha ) {
441 elsif ( $ralpha && !$lalpha) {
446 # possible match except for trailing 0's
447 if ( $retval == 0 && $l != $r ) {
449 while ( $i <= $r && $retval == 0 ) {
450 if ( $right->{version}[$i] != 0 ) {
451 $retval = -1; # not a match after all
457 while ( $i <= $l && $retval == 0 ) {
458 if ( $left->{version}[$i] != 0 ) {
459 $retval = +1; # not a match after all
471 return vcmp($self,$self->new("0"),1);
476 Carp::croak("operation not supported with version object");
481 return (exists $self->{alpha});
487 $value = _un_vstring($value);
488 $value = 'v'.$value unless $value =~ /(^v|\d+\.\d+\.\d)/;
489 my $version = version->new($value); # always use base class
495 return (exists $self->{qv});
502 && eval { exists $self->{version} }
503 && ref($self->{version}) eq 'ARRAY'
515 if ( $] >= 5.006_000 && length($value) >= 3 && $value !~ /[._]/ ) {
516 my $tvalue = sprintf("v%vd",$value);
517 if ( $tvalue =~ /^v\d+\.\d+\.\d+$/ ) {
525 # Thanks to Yitzchak Scott-Thoennes for this mode of operation
528 *UNIVERSAL::VERSION = sub {
529 my ($obj, $req) = @_;
530 my $class = ref($obj) || $obj;
533 eval "require $class" unless %{"$class\::"}; # already existing
534 return undef if $@ =~ /Can't locate/ and not defined $req;
536 if ( not %{"$class\::"} and $] >= 5.008) { # file but no package
538 Carp::croak( "$class defines neither package nor VERSION"
539 ."--version check failed");
542 my $version = eval "\$$class\::VERSION";
543 if ( defined $version ) {
544 local $^W if $] <= 5.008;
545 $version = version::vpp->new($version);
548 if ( defined $req ) {
549 unless ( defined $version ) {
552 ? "$class version $req required--this is only version "
553 : "$class does not define \$$class\::VERSION"
554 ."--version check failed";
556 if ( $ENV{VERSION_DEBUG} ) {
564 $req = version::vpp->new($req);
566 if ( $req > $version ) {
570 sprintf ("%s version %s required--".
571 "this is only version %s", $class,
572 $req->normal, $version->normal)
577 sprintf ("%s version %s required--".
578 "this is only version %s", $class,
579 $req->stringify, $version->stringify)
585 return defined $version ? $version->stringify : undef;
589 1; #this line is important and will help the module return a true value