maas-base/gpustack/utils/validators.py

import ipaddress
from urllib.parse import urlparse


def url(value: str) -> bool:
    """
    Validates whether the given string is a properly formatted URL.

    This function checks if the provided string has a valid URL scheme
    (e.g., 'http', 'https') and a valid hostname (e.g., 'localhost', 'example.com').

    Args:
        value (str): The URL string to be validated.

    Returns:
        bool: True if the string is a valid URL with a non-empty scheme and hostname,
              False otherwise.
    """
    parsed_url = urlparse(value)
    if parsed_url.scheme and parsed_url.hostname:
        return True

    return False


def ip(value: str) -> bool:
    """
    Validates whether the given string is a properly formatted IP address.

    This function checks if the provided string is a valid IPv4 or IPv6 address.

    Args:
        value (str): The IP address string to be validated.

    Returns:
        bool: True if the string is a valid IP address, False otherwise.
    """
    try:
        ipaddress.ip_address(value)
        return True
    except ValueError:
        return False