Package ganeti :: Package utils :: Module version

[frames] | no frames]

Module version

source code

Version utilities.

Functions

[hide private]

BuildVersion(major, minor, revision)
Calculates int version number from major, minor and revision numbers.

source code

SplitVersion(version)
Splits version number stored in an int.

source code

tuple or None

ParseVersion(versionstring)
Parses a version string.

source code

string or None

UpgradeRange(target, current=CURRENT_VERSION)
Verify whether a version is within the range of automatic upgrades.

source code

bool

ShouldCfgdowngrade(version, current=CURRENT_VERSION)
Decide whether cfgupgrade --downgrade should be called.

source code

bool

IsCorrectConfigVersion(targetversion, configversion)
Decide whether configuration version is compatible with the target.

source code

IsBefore(version, major, minor, revision)
Decide if a given version is strictly before a given version.

source code

IsEqual(version, major, minor, revision)
Decide if a given version matches the given version.

source code

Variables

[hide private]

_FULL_VERSION_RE = re.compile(r"(\d+)\.(\d+)\.(\d+)")

_SHORT_VERSION_RE = re.compile(r"(\d+)\.(\d+)")

FIRST_UPGRADE_VERSION = 2, 10, 0

CURRENT_VERSION = constants.VERSION_MAJOR, constants.VERSION_M...

Imports: re, constants

Function Details

[hide private]

BuildVersion(major, minor, revision)

source code

Calculates int version number from major, minor and revision numbers.

Returns: int representing version number

SplitVersion(version)

source code

Splits version number stored in an int.

Returns: tuple; (major, minor, revision)

ParseVersion(versionstring)

source code

Parses a version string.

Parameters:

versionstring (string) - the version string to parse

Returns: tuple or None

(major, minor, revision) if parsable, None otherwise.

UpgradeRange(target, current=CURRENT_VERSION)

source code

Verify whether a version is within the range of automatic upgrades.

Parameters:

target (tuple) - The version to upgrade to as (major, minor, revision)
current (tuple) - The version to upgrade from as (major, minor, revision)

Returns: string or None

None, if within the range, and a human-readable error message otherwise

ShouldCfgdowngrade(version, current=CURRENT_VERSION)

source code

Decide whether cfgupgrade --downgrade should be called.

Given the current version and the version to change to, decide if in the transition process cfgupgrade --downgrade should be called

Parameters:

version (tuple) - The version to upgrade to as (major, minor, revision)
current (tuple) - The version to upgrade from as (major, minor, revision)

Returns: bool

True, if cfgupgrade --downgrade should be called.

IsCorrectConfigVersion(targetversion, configversion)

source code

Decide whether configuration version is compatible with the target.

Parameters:

targetversion (tuple) - The version to upgrade to as (major, minor, revision)
configversion (tuple) - The version of the current configuration

Returns: bool

True, if the configversion fits with the target version.

IsBefore(version, major, minor, revision)

source code

Decide if a given version is strictly before a given version.

Parameters:

version ((int, int, int) or None) - (major, minor, revision) or None, with None being before all versions
major (int) - major version
minor (int) - minor version
revision (int) - revision

IsEqual(version, major, minor, revision)

source code

Decide if a given version matches the given version.

If the revision is set to None, only major and minor are compared.

Parameters:

version ((int, int, int) or None) - (major, minor, revision) or None, with None being before all versions
major (int) - major version
minor (int) - minor version
revision (int) - revision

Variables Details

[hide private]

CURRENT_VERSION

Value:

constants.VERSION_MAJOR, constants.VERSION_MINOR, constants.VERSION_RE
VISION