Expand sentinel URL fallback normalization and wrapper diagnostics coverage

Co-authored-by: Shri Sukhani <shrisukhani@users.noreply.github.com>

Author: cursoragent

hyperbrowser/transport/error_utils.py

@@ -8,6 +8,7 @@
 _MAX_ERROR_MESSAGE_LENGTH = 2000
 _MAX_REQUEST_URL_DISPLAY_LENGTH = 1000
 _MAX_REQUEST_METHOD_LENGTH = 50
+_INVALID_URL_SENTINELS = {"none", "null", "undefined", "nan"}
 
 
 def _normalize_request_method(method: Any) -> str:
@@ -35,7 +36,7 @@ def _normalize_request_url(url: Any) -> str:
     if not normalized_url:
         return "unknown URL"
     lowered_url = normalized_url.lower()
-    if lowered_url in {"none", "null"} or normalized_url.isdigit():
+    if lowered_url in _INVALID_URL_SENTINELS or normalized_url.isdigit():
         return "unknown URL"
     if any(character.isspace() for character in normalized_url):
         return "unknown URL"

tests/test_transport_error_utils.py

@@ -1,4 +1,5 @@
 import httpx
+import pytest
 
 from hyperbrowser.transport.error_utils import (
     extract_error_message,
@@ -255,6 +256,19 @@ def test_format_request_failure_message_normalizes_numeric_fallback_url_values()
     assert message == "Request GET unknown URL failed"
 
 
+@pytest.mark.parametrize("sentinel_url", ["none", "null", "undefined", "nan"])
+def test_format_request_failure_message_normalizes_sentinel_fallback_url_values(
+    sentinel_url: str,
+):
+    message = format_request_failure_message(
+        httpx.RequestError("network down"),
+        fallback_method="GET",
+        fallback_url=sentinel_url,
+    )
+
+    assert message == "Request GET unknown URL failed"
+
+
 def test_format_request_failure_message_supports_url_like_fallback_values():
     message = format_request_failure_message(
         httpx.RequestError("network down"),
@@ -283,6 +297,18 @@ def test_format_generic_request_failure_message_normalizes_numeric_url_values():
     assert message == "Request GET unknown URL failed"
 
 
+@pytest.mark.parametrize("sentinel_url", ["none", "null", "undefined", "nan"])
+def test_format_generic_request_failure_message_normalizes_sentinel_url_values(
+    sentinel_url: str,
+):
+    message = format_generic_request_failure_message(
+        method="GET",
+        url=sentinel_url,
+    )
+
+    assert message == "Request GET unknown URL failed"
+
+
 def test_format_generic_request_failure_message_supports_url_like_values():
     message = format_generic_request_failure_message(
         method="GET",

tests/test_transport_response_handling.py

@@ -394,6 +394,22 @@ def failing_get(*args, **kwargs):
         transport.close()
 
 
+def test_sync_transport_wraps_unexpected_errors_with_sentinel_url_fallback():
+    transport = SyncTransport(api_key="test-key")
+    original_get = transport.client.get
+
+    def failing_get(*args, **kwargs):
+        raise RuntimeError("boom")
+
+    transport.client.get = failing_get  # type: ignore[assignment]
+    try:
+        with pytest.raises(HyperbrowserError, match="Request GET unknown URL failed"):
+            transport.get("null")
+    finally:
+        transport.client.get = original_get  # type: ignore[assignment]
+        transport.close()
+
+
 def test_async_transport_put_wraps_unexpected_errors_with_url_context():
     async def run() -> None:
         transport = AsyncTransport(api_key="test-key")
@@ -458,6 +474,27 @@ async def failing_put(*args, **kwargs):
     asyncio.run(run())
 
 
+def test_async_transport_wraps_unexpected_errors_with_sentinel_url_fallback():
+    async def run() -> None:
+        transport = AsyncTransport(api_key="test-key")
+        original_put = transport.client.put
+
+        async def failing_put(*args, **kwargs):
+            raise RuntimeError("boom")
+
+        transport.client.put = failing_put  # type: ignore[assignment]
+        try:
+            with pytest.raises(
+                HyperbrowserError, match="Request PUT unknown URL failed"
+            ):
+                await transport.put("none")
+        finally:
+            transport.client.put = original_put  # type: ignore[assignment]
+            await transport.close()
+
+    asyncio.run(run())
+
+
 def test_sync_transport_request_error_without_request_uses_fallback_url():
     transport = SyncTransport(api_key="test-key")
     original_get = transport.client.get
@@ -526,6 +563,22 @@ def failing_get(*args, **kwargs):
         transport.close()
 
 
+def test_sync_transport_request_error_without_request_uses_unknown_url_for_sentinel_input():
+    transport = SyncTransport(api_key="test-key")
+    original_get = transport.client.get
+
+    def failing_get(*args, **kwargs):
+        raise httpx.RequestError("network down")
+
+    transport.client.get = failing_get  # type: ignore[assignment]
+    try:
+        with pytest.raises(HyperbrowserError, match="Request GET unknown URL failed"):
+            transport.get("undefined")
+    finally:
+        transport.client.get = original_get  # type: ignore[assignment]
+        transport.close()
+
+
 def test_async_transport_request_error_without_request_uses_fallback_url():
     async def run() -> None:
         transport = AsyncTransport(api_key="test-key")
@@ -610,3 +663,24 @@ async def failing_delete(*args, **kwargs):
             await transport.close()
 
     asyncio.run(run())
+
+
+def test_async_transport_request_error_without_request_uses_unknown_url_for_sentinel_input():
+    async def run() -> None:
+        transport = AsyncTransport(api_key="test-key")
+        original_delete = transport.client.delete
+
+        async def failing_delete(*args, **kwargs):
+            raise httpx.RequestError("network down")
+
+        transport.client.delete = failing_delete  # type: ignore[assignment]
+        try:
+            with pytest.raises(
+                HyperbrowserError, match="Request DELETE unknown URL failed"
+            ):
+                await transport.delete("nan")
+        finally:
+            transport.client.delete = original_delete  # type: ignore[assignment]
+            await transport.close()
+
+    asyncio.run(run())