Class Version

cassandra/util.py:1698–1782

Representation of a Cassandra version. Mostly follows the implementation of the same logic in the Java driver; see https://github.com/apache/cassandra-java-driver/blob/4.19.2/core/src/main/java/com/datastax/oss/driver/api/core/Version.java. Cassandra versions are assumed to correspond

@total_ordering
class Version(object):
    """
    Representation of a Cassandra version.  Mostly follows the implementation of the same logic in the Java driver;
    see https://github.com/apache/cassandra-java-driver/blob/4.19.2/core/src/main/java/com/datastax/oss/driver/api/core/Version.java.

    Cassandra versions are assumed to correspond to major.minor.patch with an optional additional numeric build field as well as a
    string prerelease field.
    """

    def __init__(self, version):
        self._version = version

        match = VERSION_REGEX.match(version)
        if not match:
            raise ValueError("Version string {0} did not match expected format".format(version))

        self.major = int(match[1])
        self.minor = int(match[2])

        try:
            self.patch = self._cleanup_int(match[3])
        except:
            self.patch = 0

        try:
            self.build = self._cleanup_int(match[4])
        except:
            self.build = 0

        try:
            self.prerelease = self._cleanup_str(match[5])
        except:
            self.prerelease = ""

        # This is used in a few places below so let's just build it now
        self._tuple = (self.major, self.minor, self.patch, self.build, self.prerelease)

    # Trim off the leading '.' characters and convert the discovered value to an integer
    def _cleanup_int(self, instr):
        return int(instr[1:]) if instr else 0

    # Trim off the leading '.' or '~' characters and just return the string directly
    def _cleanup_str(self, instr):
        return instr[1:] if instr else ""

    def __hash__(self):
        return hash(self._tuple)

    def __repr__(self):
        version_string = "Version({0}, {1}, {2}".format(self.major, self.minor, self.patch)
        if self.build:
            version_string += ", {}".format(self.build)
        if self.prerelease:
            version_string += ", {}".format(self.prerelease)
        version_string += ")"

        return version_string