Source code for NanoVNASaver.utils.version

#  NanoVNASaver
#  A python program to view and export Touchstone data from a NanoVNA
#  Copyright (C) 2019, 2020  Rune B. Broberg
#  Copyright (C) 2020,2021 NanoVNA-Saver Authors
#
#  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 3 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/>.
import logging
import re
import typing

logger = logging.getLogger(__name__)


_RXP = re.compile(
    r"""^
    \D*
    (?P<major>\d+)\.
    (?P<minor>\d+)\.?
    (?P<revision>\d+)?
    (?P<note>.*)
    $""",
    re.VERBOSE,
)


[docs] class Version(typing.NamedTuple): """Represents four components version: MAJOR.MAIN.REV-NOTE Plrease note: - `-NOTE` part is optional - please use #parse() or #build() hepler methods to prepare right version """ major: int minor: int revision: int note: str
[docs] @staticmethod def parse(vstring: str = "0.0.0") -> "Version": if (match := _RXP.search(vstring)) is None: logger.error("Unable to parse version: %s", vstring) return Version(0, 0, 0, "") return Version( int(match.group("major")), int(match.group("minor")), int(match.group("revision") or "0"), match.group("note"), )
[docs] @staticmethod def build( major: int, minor: int, revision: int = 0, note: str = "" ) -> "Version": return Version(major, minor, revision, note)
def __str__(self) -> str: return f"{self.major}.{self.minor}.{self.revision}{self.note}" def __repr__(self) -> str: return f"{self.major}.{self.minor}.{self.revision}{self.note}"