Function validate_url

codewiki/cli/utils/validation.py:13–52

Validate URL format. Args: url: URL to validate require_https: Require HTTPS scheme (except localhost) allow_localhost: Allow localhost URLs Returns: Validated URL Raises: ConfigurationError: If URL is invalid

(url: str, require_https: bool = False, allow_localhost: bool = True)

def validate_url(url: str, require_https: bool = False, allow_localhost: bool = True) -> str:
    """
    Validate URL format.

    Args:
        url: URL to validate
        require_https: Require HTTPS scheme (except localhost)
        allow_localhost: Allow localhost URLs

    Returns:
        Validated URL

    Raises:
        ConfigurationError: If URL is invalid
    """
    try:
        parsed = urlparse(url)

        # Check scheme
        if not parsed.scheme:
            raise ConfigurationError(f"Invalid URL (missing scheme): {url}")

        # Check HTTPS requirement
        if require_https and parsed.scheme != "https":
            # Allow HTTP for localhost
            if allow_localhost and parsed.hostname in ["localhost", "127.0.0.1", "::1"]:
                pass
            else:
                raise ConfigurationError(
                    f"URL must use HTTPS: {url}\nHTTP is only allowed for localhost"
                )

        # Check hostname
        if not parsed.hostname:
            raise ConfigurationError(f"Invalid URL (missing hostname): {url}")

        return url
    except ValueError as e:
        raise ConfigurationError(f"Invalid URL format: {url}\nError: {e}")


def validate_api_key(api_key: str, min_length: int = 10) -> str:
    """
    Validate API key format.