~launchpad-pqm/launchpad/devel

« back to all changes in this revision

Viewing changes to lib/lp/archivepublisher/debversion.py

  • Committer: Launchpad Patch Queue Manager
  • Date: 2010-08-03 23:01:44 UTC
  • mfrom: (11282.1.1 rb-521110)
  • Revision ID: launchpad@pqm.canonical.com-20100803230144-4wrusv2ezj1lgqgj
[testfix][rs=jelmer][ui=None] Revert 11282,
        as it requires a version of python-debian not yet available on
        buildbot.

Show diffs side-by-side

added added

removed removed

Lines of Context:
10
10
 
11
11
__metaclass__ = type
12
12
 
13
 
# This code came from sourcerer but has been heavily modified since.
14
 
 
15
 
from debian import changelog
 
13
# This code came from sourcerer.
16
14
 
17
15
import re
18
16
 
 
17
 
19
18
# Regular expressions make validating things easy
20
19
valid_epoch = re.compile(r'^[0-9]+$')
21
20
valid_upstream = re.compile(r'^[0-9][A-Za-z0-9+:.~-]*$')
22
21
valid_revision = re.compile(r'^[A-Za-z0-9+.~]+$')
23
22
 
24
 
VersionError = changelog.VersionError
25
 
 
26
 
 
27
 
class BadInputError(VersionError):
28
 
    pass
29
 
 
30
 
 
31
 
class BadEpochError(BadInputError):
32
 
    pass
33
 
 
34
 
 
35
 
class BadUpstreamError(BadInputError):
36
 
    pass
37
 
 
38
 
 
39
 
class BadRevisionError(BadInputError):
40
 
    pass
41
 
 
42
 
 
43
 
class Version(changelog.Version):
 
23
# Character comparison table for upstream and revision components
 
24
cmp_table = "~ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz+-.:"
 
25
 
 
26
 
 
27
class VersionError(Exception): pass
 
28
class BadInputError(VersionError): pass
 
29
class BadEpochError(BadInputError): pass
 
30
class BadUpstreamError(BadInputError): pass
 
31
class BadRevisionError(BadInputError): pass
 
32
 
 
33
class Version(object):
44
34
    """Debian version number.
45
35
 
46
36
    This class is designed to be reasonably transparent and allow you
54
44
    Properties:
55
45
      epoch       Epoch
56
46
      upstream    Upstream version
57
 
      debian_version    Debian/local revision
 
47
      revision    Debian/local revision
58
48
    """
59
49
 
60
50
    def __init__(self, ver):
 
51
        """Parse a string or number into the three components."""
 
52
        self.epoch = 0
 
53
        self.upstream = None
 
54
        self.revision = None
61
55
 
62
56
        ver = str(ver)
63
57
        if not len(ver):
64
 
            raise BadInputError("Input cannot be empty")
65
 
 
66
 
        try:
67
 
            changelog.Version.__init__(self, ver)
68
 
        except ValueError, e:
69
 
            raise VersionError(e)
70
 
 
71
 
        if self.epoch is not None:
 
58
            raise BadInputError, "Input cannot be empty"
 
59
 
 
60
        # Epoch is component before first colon
 
61
        idx = ver.find(":")
 
62
        if idx != -1:
 
63
            self.epoch = ver[:idx]
72
64
            if not len(self.epoch):
73
 
                raise BadEpochError("Epoch cannot be empty")
74
 
            if not valid_epoch.match(self.epoch):
75
 
                raise BadEpochError("Bad epoch format")
76
 
 
77
 
        if self.debian_version is not None:
78
 
            if self.debian_version == "":
79
 
                raise BadRevisionError("Revision cannot be empty")
80
 
            if not valid_revision.search(self.debian_version):
81
 
                raise BadRevisionError("Bad revision format")
82
 
 
83
 
        if not len(self.upstream_version):
84
 
            raise BadUpstreamError("Upstream version cannot be empty")
85
 
        if not valid_upstream.search(self.upstream_version):
 
65
                raise BadEpochError, "Epoch cannot be empty"
 
66
            if not valid_epoch.search(self.epoch):
 
67
                raise BadEpochError, "Bad epoch format"
 
68
            ver = ver[idx+1:]
 
69
 
 
70
        # Revision is component after last hyphen
 
71
        idx = ver.rfind("-")
 
72
        if idx != -1:
 
73
            self.revision = ver[idx+1:]
 
74
            if not len(self.revision):
 
75
                raise BadRevisionError, "Revision cannot be empty"
 
76
            if not valid_revision.search(self.revision):
 
77
                raise BadRevisionError, "Bad revision format"
 
78
            ver = ver[:idx]
 
79
 
 
80
        # Remaining component is upstream
 
81
        self.upstream = ver
 
82
        if not len(self.upstream):
 
83
            raise BadUpstreamError, "Upstream version cannot be empty"
 
84
        if not valid_upstream.search(self.upstream):
86
85
            raise BadUpstreamError(
87
 
                "Bad upstream version format %s" % self.upstream_version)
 
86
                "Bad upstream version format", self.upstream)
 
87
 
 
88
        self.epoch = int(self.epoch)
 
89
 
 
90
    def getWithoutEpoch(self):
 
91
        """Return the version without the epoch."""
 
92
        str = self.upstream
 
93
        if self.revision is not None:
 
94
            str += "-%s" % (self.revision,)
 
95
        return str
 
96
 
 
97
    without_epoch = property(getWithoutEpoch)
 
98
 
 
99
    def __str__(self):
 
100
        """Return the class as a string for printing."""
 
101
        str = ""
 
102
        if self.epoch > 0:
 
103
            str += "%d:" % (self.epoch,)
 
104
        str += self.upstream
 
105
        if self.revision is not None:
 
106
            str += "-%s" % (self.revision,)
 
107
        return str
 
108
 
 
109
    def __repr__(self):
 
110
        """Return a debugging representation of the object."""
 
111
        return "<%s epoch: %d, upstream: %r, revision: %r>" \
 
112
               % (self.__class__.__name__, self.epoch,
 
113
                  self.upstream, self.revision)
 
114
 
 
115
    def __cmp__(self, other):
 
116
        """Compare two Version classes."""
 
117
        other = Version(other)
 
118
 
 
119
        result = cmp(self.epoch, other.epoch)
 
120
        if result != 0: return result
 
121
 
 
122
        result = deb_cmp(self.upstream, other.upstream)
 
123
        if result != 0: return result
 
124
 
 
125
        result = deb_cmp(self.revision or "", other.revision or "")
 
126
        if result != 0: return result
 
127
 
 
128
        return 0
 
129
 
 
130
 
 
131
def strcut(str, idx, accept):
 
132
    """Cut characters from str that are entirely in accept."""
 
133
    ret = ""
 
134
    while idx < len(str) and str[idx] in accept:
 
135
        ret += str[idx]
 
136
        idx += 1
 
137
 
 
138
    return (ret, idx)
 
139
 
 
140
def deb_order(str, idx):
 
141
    """Return the comparison order of two characters."""
 
142
    if idx >= len(str):
 
143
        return 0
 
144
    elif str[idx] == "~":
 
145
        return -1
 
146
    else:
 
147
        return cmp_table.index(str[idx])
 
148
 
 
149
def deb_cmp_str(x, y):
 
150
    """Compare two strings in a deb version."""
 
151
    idx = 0
 
152
    while (idx < len(x)) or (idx < len(y)):
 
153
        result = deb_order(x, idx) - deb_order(y, idx)
 
154
        if result < 0:
 
155
            return -1
 
156
        elif result > 0:
 
157
            return 1
 
158
 
 
159
        idx += 1
 
160
 
 
161
    return 0
 
162
 
 
163
def deb_cmp(x, y):
 
164
    """Implement the string comparison outlined by Debian policy."""
 
165
    x_idx = y_idx = 0
 
166
    while x_idx < len(x) or y_idx < len(y):
 
167
        # Compare strings
 
168
        (x_str, x_idx) = strcut(x, x_idx, cmp_table)
 
169
        (y_str, y_idx) = strcut(y, y_idx, cmp_table)
 
170
        result = deb_cmp_str(x_str, y_str)
 
171
        if result != 0: return result
 
172
 
 
173
        # Compare numbers
 
174
        (x_str, x_idx) = strcut(x, x_idx, "0123456789")
 
175
        (y_str, y_idx) = strcut(y, y_idx, "0123456789")
 
176
        result = cmp(int(x_str or "0"), int(y_str or "0"))
 
177
        if result != 0: return result
 
178
 
 
179
    return 0