Index: third_party/dpkg-dev/scripts/Dpkg/Version.pm |
diff --git a/third_party/dpkg-dev/scripts/Dpkg/Version.pm b/third_party/dpkg-dev/scripts/Dpkg/Version.pm |
deleted file mode 100644 |
index 5461f597fe1d9e6fac00a5ca54ff9b47ceefd55e..0000000000000000000000000000000000000000 |
--- a/third_party/dpkg-dev/scripts/Dpkg/Version.pm |
+++ /dev/null |
@@ -1,445 +0,0 @@ |
-# Copyright © Colin Watson <cjwatson@debian.org> |
-# Copyright © Ian Jackson <iwj@debian.org> |
-# Copyright © 2007 Don Armstrong <don@donarmstrong.com>. |
-# Copyright © 2009 Raphaël Hertzog <hertzog@debian.org> |
-# |
-# This program is free software; you can redistribute it and/or modify |
-# it under the terms of the GNU General Public License as published by |
-# the Free Software Foundation; either version 2 of the License, or |
-# (at your option) any later version. |
-# |
-# This program is distributed in the hope that it will be useful, |
-# but WITHOUT ANY WARRANTY; without even the implied warranty of |
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
-# GNU General Public License for more details. |
-# |
-# You should have received a copy of the GNU General Public License |
-# along with this program. If not, see <https://www.gnu.org/licenses/>. |
- |
-package Dpkg::Version; |
- |
-use strict; |
-use warnings; |
- |
-our $VERSION = '1.01'; |
- |
-use Dpkg::ErrorHandling; |
-use Dpkg::Gettext; |
- |
-use Carp; |
-use Exporter qw(import); |
-our @EXPORT = qw(version_compare version_compare_relation |
- version_normalize_relation version_compare_string |
- version_compare_part version_split_digits version_check |
- REL_LT REL_LE REL_EQ REL_GE REL_GT); |
- |
-use constant { |
- REL_LT => '<<', |
- REL_LE => '<=', |
- REL_EQ => '=', |
- REL_GE => '>=', |
- REL_GT => '>>', |
-}; |
- |
-use overload |
- '<=>' => \&comparison, |
- 'cmp' => \&comparison, |
- '""' => sub { return $_[0]->as_string(); }, |
- 'bool' => sub { return $_[0]->as_string() if $_[0]->is_valid(); }, |
- 'fallback' => 1; |
- |
-=encoding utf8 |
- |
-=head1 NAME |
- |
-Dpkg::Version - handling and comparing dpkg-style version numbers |
- |
-=head1 DESCRIPTION |
- |
-The Dpkg::Version module provides pure-Perl routines to compare |
-dpkg-style version numbers (as used in Debian packages) and also |
-an object oriented interface overriding perl operators |
-to do the right thing when you compare Dpkg::Version object between |
-them. |
- |
-=head1 OBJECT INTERFACE |
- |
-=over 4 |
- |
-=item my $v = Dpkg::Version->new($version, %opts) |
- |
-Create a new Dpkg::Version object corresponding to the version indicated in |
-the string (scalar) $version. By default it will accepts any string |
-and consider it as a valid version. If you pass the option "check => 1", |
-it will return undef if the version is invalid (see version_check for |
-details). |
- |
-You can always call $v->is_valid() later on to verify that the version is |
-valid. |
- |
-=cut |
- |
-sub new { |
- my ($this, $ver, %opts) = @_; |
- my $class = ref($this) || $this; |
- $ver = "$ver" if ref($ver); # Try to stringify objects |
- |
- if ($opts{check}) { |
- return unless version_check($ver); |
- } |
- |
- my $self = {}; |
- if ($ver =~ /^([^:]*):(.+)$/) { |
- $self->{epoch} = $1; |
- $ver = $2; |
- } else { |
- $self->{epoch} = 0; |
- $self->{no_epoch} = 1; |
- } |
- if ($ver =~ /(.*)-(.*)$/) { |
- $self->{version} = $1; |
- $self->{revision} = $2; |
- } else { |
- $self->{version} = $ver; |
- $self->{revision} = 0; |
- $self->{no_revision} = 1; |
- } |
- |
- return bless $self, $class; |
-} |
- |
-=item boolean evaluation |
- |
-When the Dpkg::Version object is used in a boolean evaluation (for example |
-in "if ($v)" or "$v || 'default'") it returns its string representation |
-if the version stored is valid ($v->is_valid()) and undef otherwise. |
- |
-=item $v->is_valid() |
- |
-Returns true if the version is valid, false otherwise. |
- |
-=cut |
- |
-sub is_valid { |
- my ($self) = @_; |
- return scalar version_check($self); |
-} |
- |
-=item $v->epoch(), $v->version(), $v->revision() |
- |
-Returns the corresponding part of the full version string. |
- |
-=cut |
- |
-sub epoch { |
- my $self = shift; |
- return $self->{epoch}; |
-} |
- |
-sub version { |
- my $self = shift; |
- return $self->{version}; |
-} |
- |
-sub revision { |
- my $self = shift; |
- return $self->{revision}; |
-} |
- |
-=item $v->is_native() |
- |
-Returns true if the version is native, false if it has a revision. |
- |
-=cut |
- |
-sub is_native { |
- my $self = shift; |
- return $self->{no_revision}; |
-} |
- |
-=item $v1 <=> $v2, $v1 < $v2, $v1 <= $v2, $v1 > $v2, $v1 >= $v2 |
- |
-Numerical comparison of various versions numbers. One of the two operands |
-needs to be a Dpkg::Version, the other one can be anything provided that |
-its string representation is a version number. |
- |
-=cut |
- |
-sub comparison { |
- my ($a, $b, $inverted) = @_; |
- if (not ref($b) or not $b->isa('Dpkg::Version')) { |
- $b = Dpkg::Version->new($b); |
- } |
- ($a, $b) = ($b, $a) if $inverted; |
- my $r = version_compare_part($a->epoch(), $b->epoch()); |
- return $r if $r; |
- $r = version_compare_part($a->version(), $b->version()); |
- return $r if $r; |
- return version_compare_part($a->revision(), $b->revision()); |
-} |
- |
-=item "$v", $v->as_string(), $v->as_string(%options) |
- |
-Accepts an optional option hash reference, affecting the string conversion. |
- |
-Options: |
- |
-=over 8 |
- |
-=item omit_epoch (defaults to 0) |
- |
-Omit the epoch, if present, in the output string. |
- |
-=item omit_revision (defaults to 0) |
- |
-Omit the revision, if present, in the output string. |
- |
-=back |
- |
-Returns the string representation of the version number. |
- |
-=cut |
- |
-sub as_string { |
- my ($self, %opts) = @_; |
- my $no_epoch = $opts{omit_epoch} || $self->{no_epoch}; |
- my $no_revision = $opts{omit_revision} || $self->{no_revision}; |
- |
- my $str = ''; |
- $str .= $self->{epoch} . ':' unless $no_epoch; |
- $str .= $self->{version}; |
- $str .= '-' . $self->{revision} unless $no_revision; |
- return $str; |
-} |
- |
-=back |
- |
-=head1 FUNCTIONS |
- |
-All the functions are exported by default. |
- |
-=over 4 |
- |
-=item version_compare($a, $b) |
- |
-Returns -1 if $a is earlier than $b, 0 if they are equal and 1 if $a |
-is later than $b. |
- |
-If $a or $b are not valid version numbers, it dies with an error. |
- |
-=cut |
- |
-sub version_compare($$) { |
- my ($a, $b) = @_; |
- my $va = Dpkg::Version->new($a, check => 1); |
- defined($va) || error(_g('%s is not a valid version'), "$a"); |
- my $vb = Dpkg::Version->new($b, check => 1); |
- defined($vb) || error(_g('%s is not a valid version'), "$b"); |
- return $va <=> $vb; |
-} |
- |
-=item version_compare_relation($a, $rel, $b) |
- |
-Returns the result (0 or 1) of the given comparison operation. This |
-function is implemented on top of version_compare(). |
- |
-Allowed values for $rel are the exported constants REL_GT, REL_GE, |
-REL_EQ, REL_LE, REL_LT. Use version_normalize_relation() if you |
-have an input string containing the operator. |
- |
-=cut |
- |
-sub version_compare_relation($$$) { |
- my ($a, $op, $b) = @_; |
- my $res = version_compare($a, $b); |
- |
- if ($op eq REL_GT) { |
- return $res > 0; |
- } elsif ($op eq REL_GE) { |
- return $res >= 0; |
- } elsif ($op eq REL_EQ) { |
- return $res == 0; |
- } elsif ($op eq REL_LE) { |
- return $res <= 0; |
- } elsif ($op eq REL_LT) { |
- return $res < 0; |
- } else { |
- croak "unsupported relation for version_compare_relation(): '$op'"; |
- } |
-} |
- |
-=item my $rel = version_normalize_relation($rel_string) |
- |
-Returns the normalized constant of the relation $rel (a value |
-among REL_GT, REL_GE, REL_EQ, REL_LE and REL_LT). Supported |
-relations names in input are: "gt", "ge", "eq", "le", "lt", ">>", ">=", |
-"=", "<=", "<<". ">" and "<" are also supported but should not be used as |
-they are obsolete aliases of ">=" and "<=". |
- |
-=cut |
- |
-sub version_normalize_relation($) { |
- my $op = shift; |
- |
- warning('relation %s is deprecated: use %s or %s', |
- $op, "$op$op", "$op=") if ($op eq '>' or $op eq '<'); |
- |
- if ($op eq '>>' or $op eq 'gt') { |
- return REL_GT; |
- } elsif ($op eq '>=' or $op eq 'ge' or $op eq '>') { |
- return REL_GE; |
- } elsif ($op eq '=' or $op eq 'eq') { |
- return REL_EQ; |
- } elsif ($op eq '<=' or $op eq 'le' or $op eq '<') { |
- return REL_LE; |
- } elsif ($op eq '<<' or $op eq 'lt') { |
- return REL_LT; |
- } else { |
- croak "bad relation '$op'"; |
- } |
-} |
- |
-=item version_compare_string($a, $b) |
- |
-String comparison function used for comparing non-numerical parts of version |
-numbers. Returns -1 if $a is earlier than $b, 0 if they are equal and 1 if $a |
-is later than $b. |
- |
-The "~" character always sort lower than anything else. Digits sort lower |
-than non-digits. Among remaining characters alphabetic characters (A-Za-z) |
-sort lower than the other ones. Within each range, the ASCII decimal value |
-of the character is used to sort between characters. |
- |
-=cut |
- |
-sub _version_order { |
- my ($x) = @_; |
- |
- if ($x eq '~') { |
- return -1; |
- } elsif ($x =~ /^\d$/) { |
- return $x * 1 + 1; |
- } elsif ($x =~ /^[A-Za-z]$/) { |
- return ord($x); |
- } else { |
- return ord($x) + 256; |
- } |
-} |
- |
-sub version_compare_string($$) { |
- my @a = map { _version_order($_) } split(//, shift); |
- my @b = map { _version_order($_) } split(//, shift); |
- while (1) { |
- my ($a, $b) = (shift @a, shift @b); |
- return 0 if not defined($a) and not defined($b); |
- $a ||= 0; # Default order for "no character" |
- $b ||= 0; |
- return 1 if $a > $b; |
- return -1 if $a < $b; |
- } |
-} |
- |
-=item version_compare_part($a, $b) |
- |
-Compare two corresponding sub-parts of a version number (either upstream |
-version or debian revision). |
- |
-Each parameter is split by version_split_digits() and resulting items |
-are compared together. As soon as a difference happens, it returns -1 if |
-$a is earlier than $b, 0 if they are equal and 1 if $a is later than $b. |
- |
-=cut |
- |
-sub version_compare_part($$) { |
- my @a = version_split_digits(shift); |
- my @b = version_split_digits(shift); |
- while (1) { |
- my ($a, $b) = (shift @a, shift @b); |
- return 0 if not defined($a) and not defined($b); |
- $a ||= 0; # Default value for lack of version |
- $b ||= 0; |
- if ($a =~ /^\d+$/ and $b =~ /^\d+$/) { |
- # Numerical comparison |
- my $cmp = $a <=> $b; |
- return $cmp if $cmp; |
- } else { |
- # String comparison |
- my $cmp = version_compare_string($a, $b); |
- return $cmp if $cmp; |
- } |
- } |
-} |
- |
-=item my @items = version_split_digits($version) |
- |
-Splits a string in items that are each entirely composed either |
-of digits or of non-digits. For instance for "1.024~beta1+svn234" it would |
-return ("1", ".", "024", "~beta", "1", "+svn", "234"). |
- |
-=cut |
- |
-sub version_split_digits($) { |
- return split(/(?<=\d)(?=\D)|(?<=\D)(?=\d)/, $_[0]); |
-} |
- |
-=item my ($ok, $msg) = version_check($version) |
- |
-=item my $ok = version_check($version) |
- |
-Checks the validity of $version as a version number. Returns 1 in $ok |
-if the version is valid, 0 otherwise. In the latter case, $msg |
-contains a description of the problem with the $version scalar. |
- |
-=cut |
- |
-sub version_check($) { |
- my $version = shift; |
- my $str; |
- if (defined $version) { |
- $str = "$version"; |
- $version = Dpkg::Version->new($str) unless ref($version); |
- } |
- if (not defined($str) or not length($str)) { |
- my $msg = _g('version number cannot be empty'); |
- return (0, $msg) if wantarray; |
- return 0; |
- } |
- if ($version->version() =~ m/^[^\d]/) { |
- my $msg = _g('version number does not start with digit'); |
- return (0, $msg) if wantarray; |
- return 0; |
- } |
- if ($str =~ m/([^-+:.0-9a-zA-Z~])/o) { |
- my $msg = sprintf(_g("version number contains illegal character `%s'"), $1); |
- return (0, $msg) if wantarray; |
- return 0; |
- } |
- if ($version->epoch() !~ /^\d*$/) { |
- my $msg = sprintf(_g('epoch part of the version number ' . |
- "is not a number: '%s'"), $version->epoch()); |
- return (0, $msg) if wantarray; |
- return 0; |
- } |
- return (1, '') if wantarray; |
- return 1; |
-} |
- |
-=back |
- |
-=head1 CHANGES |
- |
-=head2 Version 1.01 |
- |
-New argument: Accept an options argument in $v->as_string(). |
- |
-New method: $v->is_native(). |
- |
-=head1 AUTHOR |
- |
-Don Armstrong <don@donarmstrong.com>, Colin Watson |
-<cjwatson@debian.org> and Raphaël Hertzog <hertzog@debian.org>, based on |
-the implementation in F<dpkg/lib/version.c> by Ian Jackson and others. |
- |
-=cut |
- |
-1; |