Coverage for pykickstart/version.py : 45%

Hot-keys on this page
r m x p toggle line displays
j k next/prev highlighted chunk
0 (zero) top of page
1 (one) first highlighted chunk
# # Chris Lumens <clumens@redhat.com> # # Copyright 2006-2015 Red Hat, Inc. # # This copyrighted material is made available to anyone wishing to use, modify, # copy, or redistribute it subject to the terms and conditions of the GNU # General Public License v.2. This program is distributed in the hope that it # will be useful, but WITHOUT ANY WARRANTY expressed or implied, including the # implied warranties 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, write to the Free Software Foundation, Inc., 51 # Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. Any Red Hat # trademarks that are incorporated in the source code or documentation are not # subject to the GNU General Public License and may only be used or replicated # with the express permission of Red Hat, Inc. # Methods for working with kickstart versions.
This module defines several symbolic constants that specify kickstart syntax versions. Each version corresponds roughly to one release of Red Hat Linux, Red Hat Enterprise Linux, or Fedora Core as these are where most syntax changes take place.
This module also exports several functions:
makeVersion - Given a version number, return an instance of the matching handler class.
returnClassForVersion - Given a version number, return the matching handler class. This does not return an instance of that class, however.
stringToVersion - Convert a string representation of a version number into the symbolic constant.
versionToString - Perform the reverse mapping.
versionToLongString - Perform the reverse mapping but use long names.
versionFromFile - Read a kickstart file and determine the version of syntax it uses. This requires the kickstart file to have a version= comment in it. """
# Symbolic names for internal version numbers.
# This always points at the latest version and is the default.
# A one-to-one mapping from string representations to version numbers. "DEVEL": DEVEL, "FC3": FC3, "FC4": FC4, "FC5": FC5, "FC6": FC6, "F7": F7, "F8": F8, "F9": F9, "F10": F10, "F11": F11, "F12": F12, "F13": F13, "F14": F14, "F15": F15, "F16": F16, "F17": F17, "F18": F18, "F19": F19, "F20": F20, "F21": F21, "F22": F22, "F23": F23, "F24": F24, "F25": F25, "F26": F26, "F27": F27, "F28": F28, "RHEL3": RHEL3, "RHEL4": RHEL4, "RHEL5": RHEL5, "RHEL6": RHEL6, "RHEL7": RHEL7, "RHEL8": RHEL8 }
"""Convert string into one of the provided version constants. Raises KickstartVersionError if string does not match anything. """ # First try these short forms. try: return versionMap[s.upper()] except KeyError: pass
# Now try the Fedora versions. m = re.match(r"^fedora.* (\d+)$", s, re.I) # pylint: disable=no-member
if m and m.group(1): if "FC" + m.group(1) in versionMap: return versionMap["FC" + m.group(1)] elif "F" + m.group(1) in versionMap: return versionMap["F" + m.group(1)] else: raise KickstartVersionError(_("Unsupported version specified: %s") % s)
# Now try the RHEL versions. m = re.match(r"^red hat enterprise linux.* (\d+)([\.\d]*)$", s, re.I) # pylint: disable=no-member
if m and m.group(1): if "RHEL" + m.group(1) in versionMap: return versionMap["RHEL" + m.group(1)] else: raise KickstartVersionError(_("Unsupported version specified: %s") % s)
# If nothing else worked, we're out of options. raise KickstartVersionError(_("Unsupported version specified: %s") % s)
"""Convert version into a string representation of the version number. This is the reverse operation of stringToVersion. Raises KickstartVersionError if version does not match anything. """ if not skipDevel and version == versionMap["DEVEL"]: return "DEVEL"
for (key, val) in list(versionMap.items()): if key == "DEVEL": continue elif val == version: return key
raise KickstartVersionError(_("Unsupported version specified: %s") % version)
""" Convert version into a long string representation. """ result = versionToString(version, True) result = result.replace('FC', 'F').replace('F', 'Fedora') result = result.replace('RHEL', 'RedHatEnterpriseLinux') return result
"""Given a file or URL, look for a line starting with #version= and return the version number. If no version is found, return DEVEL. """ v = DEVEL
contents = load_to_str(f)
for line in contents.splitlines(True): if line.strip() == "": continue
if line[:9] == "#version=": v = stringToVersion(line[9:].rstrip()) break
return v
"""Return the class of the syntax handler for version. version can be either a string or the matching constant. Raises KickstartVersionError if version does not match anything. """ try: version = int(version) module = "%s" % versionToString(version, skipDevel=True) except ValueError: module = "%s" % version version = stringToVersion(version)
module = module.lower()
try: _path = os.path.join(os.path.dirname(__file__), "handlers/") sys.path.extend([_path]) loaded = importlib.import_module(module)
for (k, v) in list(loaded.__dict__.items()): if k.lower().endswith("%shandler" % module): return v except: raise KickstartVersionError(_("Unsupported version specified: %s") % version)
"""Return a new instance of the syntax handler for version. version can be either a string or the matching constant. This function is useful for standalone programs which just need to handle a specific version of kickstart syntax (as provided by a command line argument, for example) and need to instantiate the correct object. """ cl = returnClassForVersion(version) return cl()
return versionMap[cls.__name__.split('_')[0]] |