Source code for cobbler.grub

import logging
from typing import Optional

import netaddr


[docs]def parse_grub_remote_file(file_location: str) -> Optional[str]: """ Parses a URI which grub would try to load from the network. :param file_location: The location which grub would try to load from the network. :return: In case the URL could be parsed it is returned in the converted format. Otherwise None is returned. :raises TypeError: In case file_location is not of type ``str``. :raises ValueError: In case the file location does not contain a valid IPv4 or IPv6 address """ if not isinstance(file_location, str): raise TypeError("\"file_location\" should be of type \"str\"") if file_location.startswith("ftp://"): logging.warning("FTP protocol not supported by GRUB. Only HTTP and TFTP [%s]", file_location) return None elif file_location.startswith("http://"): (server, delim, path) = file_location[7:].partition('/') prot = "http" elif file_location.startswith("tftp://"): (server, delim, path) = file_location[7:].partition('/') prot = "tftp" else: logging.warning("Unknown or unsupported protocol set for GRUB [%s]", file_location) return None if not (server.startswith("@@") and server.endswith("server@@")): if not (netaddr.valid_ipv4(server) or netaddr.valid_ipv6(server)): raise ValueError("Invalid remote file format %s\n%s is not a valid IP address" % (file_location, server)) res = '(%s,%s)/%s' % (prot, server, path) # logging.info("Found remote grub file. Converted [%s] to [%s]", file_location, res) return res