wpr-http 0.2.0__py3-none-any.whl

wpr_http/__init__.py

@@ -0,0 +1,60 @@
+"""Public network client API backed by Firefox Necko."""
+
+from wpr_runtime_core.registry import RuntimeCompatibilityError, RuntimeManifest
+
+from .client import AsyncWprHttpClient, WprHttpClient
+from .exceptions import (
+    WprConnectError,
+    WprHttpError,
+    WprHTTPStatusError,
+    WprPoolTimeoutError,
+    WprProxyError,
+    WprTimeoutError,
+    WprTransportError,
+)
+from .models import Headers, HttpRequest, HttpResponse, NetworkTiming, Request, Timeout
+
+__version__ = "0.2.0"
+
+
+class AsyncClient(AsyncWprHttpClient):
+    """Standalone client: select and validate an actual Firefox network runtime."""
+
+    def __init__(
+        self, *, firefox_version=None, runtime_home=None, config=None, **kwargs
+    ):
+        # Explicit config supports local development builds. Installed engines
+        # always go through manifest/version/hash validation.
+        if config is None and firefox_version is None:
+            firefox_version = "155"
+        super().__init__(
+            config=config,
+            firefox_version=firefox_version,
+            runtime_home=runtime_home,
+            **kwargs,
+        )
+
+
+Response = HttpResponse
+
+__all__ = [
+    "AsyncClient",
+    "AsyncWprHttpClient",
+    "Headers",
+    "HttpRequest",
+    "HttpResponse",
+    "NetworkTiming",
+    "Request",
+    "Response",
+    "RuntimeCompatibilityError",
+    "RuntimeManifest",
+    "Timeout",
+    "WprConnectError",
+    "WprHTTPStatusError",
+    "WprHttpClient",
+    "WprHttpError",
+    "WprPoolTimeoutError",
+    "WprProxyError",
+    "WprTimeoutError",
+    "WprTransportError",
+]

wpr_http/__main__.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+import argparse
+import json
+
+from wpr_runtime_core.installer import RUNTIME_CATALOG, install_runtime
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(prog="python -m wpr_http")
+    commands = parser.add_subparsers(dest="command", required=True)
+    commands.add_parser(
+        "runtimes", help="list published engine versions in this client's catalog"
+    )
+    install = commands.add_parser("install-runtime")
+    install.add_argument("--version", default="155")
+    install.add_argument("--runtime-home")
+    install.add_argument("--force", action="store_true")
+    args = parser.parse_args()
+    if args.command == "runtimes":
+        print(json.dumps(RUNTIME_CATALOG, indent=2))
+    else:
+        print(install_runtime(args.version, args.runtime_home, force=args.force, product="network"))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

wpr_http/_urls.py

@@ -0,0 +1,31 @@
+"""URL helpers used in diagnostics; credential and query values stay private."""
+
+from urllib.parse import urlsplit, urlunsplit
+
+
+def safe_url(url: str) -> str:
+    try:
+        parsed = urlsplit(url)
+        host = parsed.hostname or ""
+        if ":" in host and not host.startswith("["):
+            host = f"[{host}]"
+        if parsed.port:
+            host = f"{host}:{parsed.port}"
+        return urlunsplit(
+            (parsed.scheme, host, parsed.path, "..." if parsed.query else "", "")
+        )
+    except ValueError:
+        return "<invalid URL>"
+
+
+def safe_proxy(proxy: str) -> str:
+    try:
+        parsed = urlsplit(proxy)
+        host = parsed.hostname or "<unknown>"
+        if ":" in host and not host.startswith("["):
+            host = f"[{host}]"
+        if parsed.port:
+            host = f"{host}:{parsed.port}"
+        return f"{parsed.scheme}://{host}"
+    except ValueError:
+        return "<configured proxy>"