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}\n"
                    f"HTTP 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: