urllib3 2.7.0: exceptions.LocationParseError

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify urllib3.exceptions.LocationParseError in pkg:pypi/urllib3@2.7.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:pypi/urllib3@2.7.0
Demonstrate these symbols/APIs:
  - urllib3.exceptions.LocationParseError

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:baf209d63aed5630d124dc05cb995dbf3c4af7812548178febb28cddb0b59a36","contract":["assert LocationParseError inherits from LocationValueError, ValueError, and HTTPError","assert LocationParseError stores the unparseable location string in its location attribute","assert LocationParseError string representation includes the failed location string","assert urllib3.util.parse_url raises LocationParseError when given a URL with an invalid port","assert urllib3.util.parse_url raises LocationParseError when given a URL with an unclosed bracket host"],"goal":"verify urllib3.exceptions.LocationParseError in pkg:pypi/urllib3@2.7.0","kind":"HOW","packages":["pkg:pypi/urllib3@2.7.0"],"schemaVersion":1,"symbols":["urllib3.exceptions.LocationParseError"]},"contractCommand":["python","test/contract.py"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"pypi","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"pip","schemaVersion":1},"license":"MIT-0","packages":["pkg:pypi/urllib3@2.7.0"],"schemaVersion":1,"subject":"pkg:pypi/urllib3@2.7.0","symbols":["urllib3.exceptions.LocationParseError"],"verifierAdapter":"python@1"}

[project]
name = "verify-urllib3-locationparseerror"
version = "0.1.0"
dependencies = [
    "urllib3==2.7.0",
]

urllib3==2.7.0

"""Demonstration of urllib3.exceptions.LocationParseError handling and URL parsing."""

from typing import Optional
import urllib3.util
from urllib3.exceptions import LocationParseError, HTTPError, LocationValueError


def parse_target_url(url: str) -> urllib3.util.Url:
    """Parse a URL string into a Url object.

    Raises LocationParseError if the URL has an invalid format or port.
    """
    return urllib3.util.parse_url(url)


def extract_unparseable_location(url: str) -> Optional[str]:
    """Attempt to parse a URL and return the failed location string if invalid."""
    try:
        urllib3.util.parse_url(url)
        return None
    except LocationParseError as exc:
        return exc.location


def is_location_parse_error(exc: Exception) -> bool:
    """Check if an exception is a LocationParseError (and therefore HTTPError and LocationValueError)."""
    return isinstance(exc, LocationParseError) and isinstance(exc, HTTPError) and isinstance(exc, LocationValueError)

{
  "schemaVersion": 1,
  "goal": "verify urllib3.exceptions.LocationParseError in pkg:pypi/urllib3@2.7.0",
  "kind": "HOW",
  "packages": [
    "pkg:pypi/urllib3@2.7.0"
  ],
  "symbols": [
    "urllib3.exceptions.LocationParseError"
  ]
}

"""Contract verification test for urllib3.exceptions.LocationParseError in pkg:pypi/urllib3@2.7.0."""

import os
import sys

# Ensure project root is on sys.path for local module imports
sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))

import urllib3.util
from urllib3.exceptions import LocationParseError, LocationValueError, HTTPError
from sample import parse_target_url, extract_unparseable_location, is_location_parse_error


def test_exception_inheritance() -> None:
    """Assertion 1: assert LocationParseError inherits from LocationValueError, ValueError, and HTTPError."""
    assert issubclass(LocationParseError, LocationValueError), "LocationParseError must subclass LocationValueError"
    assert issubclass(LocationParseError, ValueError), "LocationParseError must subclass ValueError"
    assert issubclass(LocationParseError, HTTPError), "LocationParseError must subclass HTTPError"


def test_location_attribute() -> None:
    """Assertion 2: assert LocationParseError stores the unparseable location string in its location attribute."""
    bad_location = "http://example.com:notaport"
    err = LocationParseError(bad_location)
    assert err.location == bad_location, "err.location must match provided location string"
    assert is_location_parse_error(err), "err must be recognized by hierarchy check"


def test_string_representation() -> None:
    """Assertion 3: assert LocationParseError string representation includes the failed location string."""
    bad_location = "http://example.com:notaport"
    err = LocationParseError(bad_location)
    expected_message = f"Failed to parse: {bad_location}"
    assert str(err) == expected_message, f"Expected '{expected_message}', got '{str(err)}'"


def test_parse_url_invalid_port() -> None:
    """Assertion 4: assert urllib3.util.parse_url raises LocationParseError when given a URL with an invalid port."""
    bad_url = "http://example.com:notaport/path"
    raised = False
    try:
        parse_target_url(bad_url)
    except LocationParseError as exc:
        raised = True
        assert exc.location == bad_url, f"Expected location '{bad_url}', got '{exc.location}'"
        assert isinstance(exc, HTTPError), "LocationParseError must be an HTTPError"
        assert isinstance(exc, ValueError), "LocationParseError must be a ValueError"

    assert raised, "parse_target_url should have raised LocationParseError"
    extracted = extract_unparseable_location(bad_url)
    assert extracted == bad_url, f"Expected extracted location '{bad_url}', got '{extracted}'"


def test_parse_url_unclosed_bracket() -> None:
    """Assertion 5: assert urllib3.util.parse_url raises LocationParseError when given a URL with an unclosed bracket host."""
    bad_url = "http://[invalid_bracket_ipv6/path"
    raised = False
    try:
        parse_target_url(bad_url)
    except LocationParseError as exc:
        raised = True
        assert exc.location == bad_url, f"Expected location '{bad_url}', got '{exc.location}'"

    assert raised, "parse_target_url should have raised LocationParseError"
    extracted = extract_unparseable_location(bad_url)
    assert extracted == bad_url, f"Expected extracted location '{bad_url}', got '{extracted}'"


def main() -> None:
    test_exception_inheritance()
    test_location_attribute()
    test_string_representation()
    test_parse_url_invalid_port()
    test_parse_url_unclosed_bracket()
    print("All contract assertions passed.")


if __name__ == "__main__":
    main()