lttnganalyses/common/version_utils.py

   1 # The MIT License (MIT)
   2 #
   3 # Copyright (C) 2015 - Antoine Busque <abusque@efficios.com>
   4 #
   5 # Permission is hereby granted, free of charge, to any person obtaining a copy
   6 # of this software and associated documentation files (the "Software"), to deal
   7 # in the Software without restriction, including without limitation the rights
   8 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
   9 # copies of the Software, and to permit persons to whom the Software is
  10 # furnished to do so, subject to the following conditions:
  11 #
  12 # The above copyright notice and this permission notice shall be included in
  13 # all copies or substantial portions of the Software.
  14 #
  15 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  18 # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  19 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  20 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  21 # SOFTWARE.
  22
  23 import re
  24 from functools import total_ordering
  25
  26
  27 @total_ordering
  28 class Version:
  29     def __init__(self, major, minor, patch, extra=None):
  30         self.major = major
  31         self.minor = minor
  32         self.patch = patch
  33         self.extra = extra
  34
  35     def __lt__(self, other):
  36         if self.major < other.major:
  37             return True
  38         if self.major > other.major:
  39             return False
  40
  41         if self.minor < other.minor:
  42             return True
  43         if self.minor > other.minor:
  44             return False
  45
  46         return self.patch < other.patch
  47
  48     def __eq__(self, other):
  49         return (
  50             self.major == other.major and
  51             self.minor == other.minor and
  52             self.patch == other.patch
  53         )
  54
  55     def __repr__(self):
  56         version_str = '{}.{}.{}'.format(self.major, self.minor, self.patch)
  57         if self.extra:
  58             version_str += self.extra
  59
  60         return version_str
  61
  62     @classmethod
  63     def new_from_string(cls, string):
  64         version_match = re.match(r'(\d+)\.(\d+)\.(\d+)(.*)', string)
  65
  66         if version_match is None:
  67             major = minor = patch = 0
  68             extra = '+unknown'
  69         else:
  70             major = int(version_match.group(1))
  71             minor = int(version_match.group(2))
  72             patch = int(version_match.group(3))
  73             extra = version_match.group(4)
  74
  75         return cls(major, minor, patch, extra)