vws-python 2026.2.22__tar.gz → 2026.2.24__tar.gz

{vws_python-2026.2.22 → vws_python-2026.2.24}/CHANGELOG.rst

@@ -4,6 +4,14 @@ Changelog
 Next
 ----
 
+2026.02.24
+----------
+
+
+2026.02.23
+----------
+
+
 2026.02.22
 ----------
 

{vws_python-2026.2.22/src/vws_python.egg-info → vws_python-2026.2.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vws-python
-Version: 2026.2.22
+Version: 2026.2.24
 Summary: Interact with the Vuforia Web Services (VWS) API.
 Author-email: Adam Dangoor <adamdangoor@gmail.com>
 License-Expression: MIT
@@ -18,6 +18,7 @@ Requires-Python: >=3.13
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: beartype>=0.22.9
+Requires-Dist: httpx>=0.28.0
 Requires-Dist: requests>=2.32.3
 Requires-Dist: urllib3>=2.2.3
 Requires-Dist: vws-auth-tools>=2024.7.12
@@ -36,16 +37,16 @@ Requires-Dist: prek==0.3.3; extra == "dev"
 Requires-Dist: pydocstringformatter==0.7.5; extra == "dev"
 Requires-Dist: pydocstyle==6.3; extra == "dev"
 Requires-Dist: pygments==2.19.2; extra == "dev"
-Requires-Dist: pylint[spelling]==4.0.4; extra == "dev"
+Requires-Dist: pylint[spelling]==4.0.5; extra == "dev"
 Requires-Dist: pylint-per-file-ignores==3.2.0; extra == "dev"
-Requires-Dist: pyproject-fmt==2.16.1; extra == "dev"
-Requires-Dist: pyrefly==0.53.0; extra == "dev"
+Requires-Dist: pyproject-fmt==2.16.2; extra == "dev"
+Requires-Dist: pyrefly==0.54.0; extra == "dev"
 Requires-Dist: pyright==1.1.408; extra == "dev"
 Requires-Dist: pyroma==5.0.1; extra == "dev"
 Requires-Dist: pytest==9.0.2; extra == "dev"
 Requires-Dist: pytest-cov==7.0.0; extra == "dev"
 Requires-Dist: pyyaml==6.0.3; extra == "dev"
-Requires-Dist: ruff==0.15.1; extra == "dev"
+Requires-Dist: ruff==0.15.2; extra == "dev"
 Requires-Dist: shellcheck-py==0.11.0.1; extra == "dev"
 Requires-Dist: shfmt-py==3.12.0.2; extra == "dev"
 Requires-Dist: sphinx==9.1.0; extra == "dev"
@@ -57,10 +58,10 @@ Requires-Dist: sphinxcontrib-spelling==8.0.2; extra == "dev"
 Requires-Dist: sybil==9.3.0; extra == "dev"
 Requires-Dist: torch>=2.5.1; extra == "dev"
 Requires-Dist: torchvision>=0.20.1; extra == "dev"
-Requires-Dist: ty==0.0.17; extra == "dev"
+Requires-Dist: ty==0.0.18; extra == "dev"
 Requires-Dist: types-requests==2.32.4.20260107; extra == "dev"
 Requires-Dist: vulture==2.14; extra == "dev"
-Requires-Dist: vws-python-mock==2026.2.22.2; extra == "dev"
+Requires-Dist: vws-python-mock==2026.2.22.3; extra == "dev"
 Requires-Dist: vws-test-fixtures==2023.3.5; extra == "dev"
 Requires-Dist: yamlfix==1.19.1; extra == "dev"
 Requires-Dist: zizmor==1.22.0; extra == "dev"

{vws_python-2026.2.22 → vws_python-2026.2.24}/conftest.py

@@ -28,6 +28,7 @@ def pytest_collection_modifyitems(items: list[pytest.Item]) -> None:
 
 @pytest.fixture(name="make_image_file")
 def fixture_make_image_file(
+    *,
     high_quality_image: io.BytesIO,
 ) -> Generator[None]:
     """Make an image file available in the test directory.
@@ -43,6 +44,7 @@ def fixture_make_image_file(
 
 @pytest.fixture(name="mock_vws")
 def fixture_mock_vws(
+    *,
     monkeypatch: pytest.MonkeyPatch,
 ) -> Generator[None]:
     """Yield a mock VWS.

{vws_python-2026.2.22 → vws_python-2026.2.24}/docs/source/api-reference.rst

@@ -20,3 +20,7 @@ API Reference
 .. automodule:: vws.response
    :undoc-members:
    :members:
+
+.. automodule:: vws.transports
+   :undoc-members:
+   :members:

{vws_python-2026.2.22 → vws_python-2026.2.24}/pyproject.toml

@@ -33,6 +33,7 @@ dynamic = [
 ]
 dependencies = [
     "beartype>=0.22.9",
+    "httpx>=0.28.0",
     "requests>=2.32.3",
     "urllib3>=2.2.3",
     "vws-auth-tools>=2024.7.12",
@@ -52,16 +53,16 @@ optional-dependencies.dev = [
     "pydocstringformatter==0.7.5",
     "pydocstyle==6.3",
     "pygments==2.19.2",
-    "pylint[spelling]==4.0.4",
+    "pylint[spelling]==4.0.5",
     "pylint-per-file-ignores==3.2.0",
-    "pyproject-fmt==2.16.1",
-    "pyrefly==0.53.0",
+    "pyproject-fmt==2.16.2",
+    "pyrefly==0.54.0",
     "pyright==1.1.408",
     "pyroma==5.0.1",
     "pytest==9.0.2",
     "pytest-cov==7.0.0",
     "pyyaml==6.0.3",
-    "ruff==0.15.1",
+    "ruff==0.15.2",
     # We add shellcheck-py not only for shell scripts and shell code blocks,
     # but also because having it installed means that ``actionlint-py`` will
     # use it to lint shell commands in GitHub workflow files.
@@ -79,10 +80,10 @@ optional-dependencies.dev = [
     # See: https://vws-python.github.io/vws-python-mock/installation.html#faster-installation
     "torch>=2.5.1",
     "torchvision>=0.20.1",
-    "ty==0.0.17",
+    "ty==0.0.18",
     "types-requests==2.32.4.20260107",
     "vulture==2.14",
-    "vws-python-mock==2026.2.22.2",
+    "vws-python-mock==2026.2.22.3",
     "vws-test-fixtures==2023.3.5",
     "yamlfix==1.19.1",
     "zizmor==1.22.0",
@@ -357,6 +358,8 @@ ignore_path = [
 # Ideally we would limit the paths to the source code where we want to ignore names,
 # but Vulture does not enable this.
 ignore_names = [
+    # Public API classes imported by users from vws.transports
+    "HTTPXTransport",
     # pytest configuration
     "pytest_collect_file",
     "pytest_collection_modifyitems",

{vws_python-2026.2.22 → vws_python-2026.2.24}/spelling_private_dict.txt

@@ -54,6 +54,7 @@ hmac
 html
 http
 https
+httpx
 iff
 io
 issuecomment

{vws_python-2026.2.22 → vws_python-2026.2.24}/src/vws/_vws_request.py

@@ -2,11 +2,11 @@
 API.
 """
 
-import requests
 from beartype import BeartypeConf, beartype
 from vws_auth_tools import authorization_header, rfc_1123_date
 
 from vws.response import Response
+from vws.transports import Transport
 
 
 @beartype(conf=BeartypeConf(is_pep484_tower=True))
@@ -21,27 +21,30 @@ def target_api_request(
     base_vws_url: str,
     request_timeout_seconds: float | tuple[float, float],
     extra_headers: dict[str, str],
+    transport: Transport,
 ) -> Response:
     """Make a request to the Vuforia Target API.
 
-    This uses `requests` to make a request against https://vws.vuforia.com.
-
     Args:
         content_type: The content type of the request.
         server_access_key: A VWS server access key.
         server_secret_key: A VWS server secret key.
-        method: The HTTP method which will be used in the request.
-        data: The request body which will be used in the request.
-        request_path: The path to the endpoint which will be used in the
+        method: The HTTP method which will be used in the
+            request.
+        data: The request body which will be used in the
             request.
+        request_path: The path to the endpoint which will be
+            used in the request.
         base_vws_url: The base URL for the VWS API.
-        request_timeout_seconds: The timeout for the request, as used by
-            ``requests.request``. This can be a float to set both the
-            connect and read timeouts, or a (connect, read) tuple.
-        extra_headers: Additional headers to include in the request.
+        request_timeout_seconds: The timeout for the request.
+            This can be a float to set both the connect and
+            read timeouts, or a (connect, read) tuple.
+        extra_headers: Additional headers to include in the
+            request.
+        transport: The HTTP transport to use for the request.
 
     Returns:
-        The response to the request made by `requests`.
+        The response to the request.
     """
     date_string = rfc_1123_date()
 
@@ -64,20 +67,10 @@ def target_api_request(
 
     url = base_vws_url.rstrip("/") + request_path
 
-    requests_response = requests.request(
+    return transport(
         method=method,
         url=url,
         headers=headers,
         data=data,
         timeout=request_timeout_seconds,
     )
-
-    return Response(
-        text=requests_response.text,
-        url=requests_response.url,
-        status_code=requests_response.status_code,
-        headers=dict(requests_response.headers),
-        request_body=requests_response.request.body,
-        tell_position=requests_response.raw.tell(),
-        content=bytes(requests_response.content),
-    )

{vws_python-2026.2.22 → vws_python-2026.2.24}/src/vws/query.py

@@ -6,7 +6,6 @@ import json
 from http import HTTPMethod, HTTPStatus
 from typing import Any, BinaryIO
 
-import requests
 from beartype import BeartypeConf, beartype
 from urllib3.filepost import encode_multipart_formdata
 from vws_auth_tools import authorization_header, rfc_1123_date
@@ -24,7 +23,7 @@ from vws.exceptions.custom_exceptions import (
 )
 from vws.include_target_data import CloudRecoIncludeTargetData
 from vws.reports import QueryResult, TargetData
-from vws.response import Response
+from vws.transports import RequestsTransport, Transport
 
 _ImageType = io.BytesIO | BinaryIO
 
@@ -50,21 +49,26 @@ class CloudRecoService:
         client_secret_key: str,
         base_vwq_url: str = "https://cloudreco.vuforia.com",
         request_timeout_seconds: float | tuple[float, float] = 30.0,
+        transport: Transport | None = None,
     ) -> None:
         """
         Args:
             client_access_key: A VWS client access key.
             client_secret_key: A VWS client secret key.
             base_vwq_url: The base URL for the VWQ API.
-            request_timeout_seconds: The timeout for each HTTP request, as
-                used by ``requests.request``. This can be a float to set
-                both the connect and read timeouts, or a (connect, read)
-                tuple.
+            request_timeout_seconds: The timeout for each
+                HTTP request. This can be a float to set both
+                the connect and read timeouts, or a
+                (connect, read) tuple.
+            transport: The HTTP transport to use for
+                requests. Defaults to
+                ``RequestsTransport()``.
         """
         self._client_access_key = client_access_key
         self._client_secret_key = client_secret_key
         self._base_vwq_url = base_vwq_url
         self._request_timeout_seconds = request_timeout_seconds
+        self._transport = transport or RequestsTransport()
 
     def query(
         self,
@@ -143,22 +147,13 @@ class CloudRecoService:
             "Content-Type": content_type_header,
         }
 
-        requests_response = requests.request(
+        response = self._transport(
             method=method,
             url=self._base_vwq_url.rstrip("/") + request_path,
             headers=headers,
             data=content,
             timeout=self._request_timeout_seconds,
         )
-        response = Response(
-            text=requests_response.text,
-            url=requests_response.url,
-            status_code=requests_response.status_code,
-            headers=dict(requests_response.headers),
-            request_body=requests_response.request.body,
-            tell_position=requests_response.raw.tell(),
-            content=bytes(requests_response.content),
-        )
 
         if response.status_code == HTTPStatus.REQUEST_ENTITY_TOO_LARGE:
             raise RequestEntityTooLargeError(response=response)

vws_python-2026.2.24/src/vws/transports.py

@@ -0,0 +1,158 @@
+"""HTTP transport implementations for VWS clients."""
+
+from typing import Protocol, runtime_checkable
+
+import httpx
+import requests
+from beartype import BeartypeConf, beartype
+
+from vws.response import Response
+
+
+@runtime_checkable
+class Transport(Protocol):
+    """Protocol for HTTP transports used by VWS clients.
+
+    A transport is a callable that makes an HTTP request and
+    returns a ``Response``.
+    """
+
+    def __call__(
+        self,
+        *,
+        method: str,
+        url: str,
+        headers: dict[str, str],
+        data: bytes,
+        timeout: float | tuple[float, float],
+    ) -> Response:
+        """Make an HTTP request.
+
+        Args:
+            method: The HTTP method (e.g. "GET", "POST").
+            url: The full URL to request.
+            headers: Headers to send with the request.
+            data: The request body as bytes.
+            timeout: The timeout for the request. A float
+                sets both the connect and read timeouts. A
+                (connect, read) tuple sets them individually.
+
+        Returns:
+            A Response populated from the HTTP response.
+        """
+        ...  # pylint: disable=unnecessary-ellipsis
+
+
+@beartype(conf=BeartypeConf(is_pep484_tower=True))
+class RequestsTransport:
+    """HTTP transport using the ``requests`` library.
+
+    This is the default transport.
+    """
+
+    def __call__(
+        self,
+        *,
+        method: str,
+        url: str,
+        headers: dict[str, str],
+        data: bytes,
+        timeout: float | tuple[float, float],
+    ) -> Response:
+        """Make an HTTP request using ``requests``.
+
+        Args:
+            method: The HTTP method.
+            url: The full URL.
+            headers: Request headers.
+            data: The request body.
+            timeout: The request timeout.
+
+        Returns:
+            A Response populated from the requests response.
+        """
+        requests_response = requests.request(
+            method=method,
+            url=url,
+            headers=headers,
+            data=data,
+            timeout=timeout,
+        )
+
+        return Response(
+            text=requests_response.text,
+            url=requests_response.url,
+            status_code=requests_response.status_code,
+            headers=dict(requests_response.headers),
+            request_body=requests_response.request.body,
+            tell_position=requests_response.raw.tell(),
+            content=bytes(requests_response.content),
+        )
+
+
+@beartype(conf=BeartypeConf(is_pep484_tower=True))
+class HTTPXTransport:
+    """HTTP transport using the ``httpx`` library.
+
+    Use this transport for environments where ``httpx`` is
+    preferred over ``requests``.
+    """
+
+    def __call__(
+        self,
+        *,
+        method: str,
+        url: str,
+        headers: dict[str, str],
+        data: bytes,
+        timeout: float | tuple[float, float],
+    ) -> Response:
+        """Make an HTTP request using ``httpx``.
+
+        Args:
+            method: The HTTP method.
+            url: The full URL.
+            headers: Request headers.
+            data: The request body.
+            timeout: The request timeout.
+
+        Returns:
+            A Response populated from the httpx response.
+        """
+        if isinstance(timeout, tuple):
+            connect_timeout, read_timeout = timeout
+            httpx_timeout = httpx.Timeout(
+                connect=connect_timeout,
+                read=read_timeout,
+                write=None,
+                pool=None,
+            )
+        else:
+            httpx_timeout = httpx.Timeout(
+                connect=timeout,
+                read=timeout,
+                write=None,
+                pool=None,
+            )
+
+        httpx_response = httpx.request(
+            method=method,
+            url=url,
+            headers=headers,
+            content=data,
+            timeout=httpx_timeout,
+            follow_redirects=True,
+        )
+
+        content = bytes(httpx_response.content)
+        request_content = httpx_response.request.content
+
+        return Response(
+            text=httpx_response.text,
+            url=str(object=httpx_response.url),
+            status_code=httpx_response.status_code,
+            headers=dict(httpx_response.headers),
+            request_body=bytes(request_content) or None,
+            tell_position=len(content),
+            content=content,
+        )

{vws_python-2026.2.22 → vws_python-2026.2.24}/src/vws/vumark_service.py

@@ -20,6 +20,7 @@ from vws.exceptions.vws_exceptions import (
     TooManyRequestsError,
     UnknownTargetError,
 )
+from vws.transports import RequestsTransport, Transport
 from vws.vumark_accept import VuMarkAccept
 
 
@@ -29,25 +30,31 @@ class VuMarkService:
 
     def __init__(
         self,
+        *,
         server_access_key: str,
         server_secret_key: str,
         base_vws_url: str = "https://vws.vuforia.com",
         request_timeout_seconds: float | tuple[float, float] = 30.0,
+        transport: Transport | None = None,
     ) -> None:
         """
         Args:
             server_access_key: A VWS server access key.
             server_secret_key: A VWS server secret key.
             base_vws_url: The base URL for the VWS API.
-            request_timeout_seconds: The timeout for each HTTP request, as
-                used by ``requests.request``. This can be a float to set
-                both the connect and read timeouts, or a (connect, read)
-                tuple.
+            request_timeout_seconds: The timeout for each
+                HTTP request. This can be a float to set both
+                the connect and read timeouts, or a
+                (connect, read) tuple.
+            transport: The HTTP transport to use for
+                requests. Defaults to
+                ``RequestsTransport()``.
         """
         self._server_access_key = server_access_key
         self._server_secret_key = server_secret_key
         self._base_vws_url = base_vws_url
         self._request_timeout_seconds = request_timeout_seconds
+        self._transport = transport or RequestsTransport()
 
     def generate_vumark_instance(
         self,
@@ -109,6 +116,7 @@ class VuMarkService:
             base_vws_url=self._base_vws_url,
             request_timeout_seconds=self._request_timeout_seconds,
             extra_headers={"Accept": accept},
+            transport=self._transport,
         )
 
         if (

{vws_python-2026.2.22 → vws_python-2026.2.24}/src/vws/vws.py

@@ -43,6 +43,7 @@ from vws.reports import (
     TargetSummaryReport,
 )
 from vws.response import Response
+from vws.transports import RequestsTransport, Transport
 
 _ImageType = io.BytesIO | BinaryIO
 
@@ -68,21 +69,26 @@ class VWS:
         server_secret_key: str,
         base_vws_url: str = "https://vws.vuforia.com",
         request_timeout_seconds: float | tuple[float, float] = 30.0,
+        transport: Transport | None = None,
     ) -> None:
         """
         Args:
             server_access_key: A VWS server access key.
             server_secret_key: A VWS server secret key.
             base_vws_url: The base URL for the VWS API.
-            request_timeout_seconds: The timeout for each HTTP request, as
-                used by ``requests.request``. This can be a float to set
-                both the connect and read timeouts, or a (connect, read)
-                tuple.
+            request_timeout_seconds: The timeout for each
+                HTTP request. This can be a float to set both
+                the connect and read timeouts, or a
+                (connect, read) tuple.
+            transport: The HTTP transport to use for
+                requests. Defaults to
+                ``RequestsTransport()``.
         """
         self._server_access_key = server_access_key
         self._server_secret_key = server_secret_key
         self._base_vws_url = base_vws_url
         self._request_timeout_seconds = request_timeout_seconds
+        self._transport = transport or RequestsTransport()
 
     def make_request(
         self,
@@ -96,29 +102,31 @@ class VWS:
     ) -> Response:
         """Make a request to the Vuforia Target API.
 
-        This uses `requests` to make a request against Vuforia.
-
         Args:
-            method: The HTTP method which will be used in the request.
-            data: The request body which will be used in the request.
-            request_path: The path to the endpoint which will be used in the
+            method: The HTTP method which will be used in
+                the request.
+            data: The request body which will be used in the
                 request.
-            expected_result_code: See "VWS API Result Codes" on
+            request_path: The path to the endpoint which
+                will be used in the request.
+            expected_result_code: See
+                "VWS API Result Codes" on
                 https://developer.vuforia.com/library/web-api/cloud-targets-web-services-api.
             content_type: The content type of the request.
-            extra_headers: Additional headers to include in the request.
+            extra_headers: Additional headers to include in
+                the request.
 
         Returns:
-            The response to the request made by `requests`.
+            The response to the request.
 
         Raises:
-            ~vws.exceptions.custom_exceptions.ServerError: There is an error
-                with Vuforia's servers.
-            ~vws.exceptions.vws_exceptions.TooManyRequestsError: Vuforia is
-                rate limiting access.
-            json.JSONDecodeError: The server did not respond with valid JSON.
-                This may happen if the server address is not a valid Vuforia
-                server.
+            ~vws.exceptions.custom_exceptions.ServerError:
+                There is an error with Vuforia's servers.
+            ~vws.exceptions.vws_exceptions.TooManyRequestsError:
+                Vuforia is rate limiting access.
+            json.JSONDecodeError: The server did not respond
+                with valid JSON. This may happen if the
+                server address is not a valid Vuforia server.
         """
         response = target_api_request(
             content_type=content_type,
@@ -130,6 +138,7 @@ class VWS:
             base_vws_url=self._base_vws_url,
             request_timeout_seconds=self._request_timeout_seconds,
             extra_headers=extra_headers or {},
+            transport=self._transport,
         )
 
         if (
@@ -343,6 +352,10 @@ class VWS:
         while True:
             report = self.get_target_summary_report(target_id=target_id)
             if report.status != TargetStatuses.PROCESSING:
+                # Guard against the target still being seen as
+                # processing by other endpoints due to eventual
+                # consistency.
+                time.sleep(seconds_between_requests)
                 return
 
             elapsed_time = time.monotonic() - start_time

{vws_python-2026.2.22 → vws_python-2026.2.24/src/vws_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vws-python
-Version: 2026.2.22
+Version: 2026.2.24
 Summary: Interact with the Vuforia Web Services (VWS) API.
 Author-email: Adam Dangoor <adamdangoor@gmail.com>
 License-Expression: MIT
@@ -18,6 +18,7 @@ Requires-Python: >=3.13
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: beartype>=0.22.9
+Requires-Dist: httpx>=0.28.0
 Requires-Dist: requests>=2.32.3
 Requires-Dist: urllib3>=2.2.3
 Requires-Dist: vws-auth-tools>=2024.7.12
@@ -36,16 +37,16 @@ Requires-Dist: prek==0.3.3; extra == "dev"
 Requires-Dist: pydocstringformatter==0.7.5; extra == "dev"
 Requires-Dist: pydocstyle==6.3; extra == "dev"
 Requires-Dist: pygments==2.19.2; extra == "dev"
-Requires-Dist: pylint[spelling]==4.0.4; extra == "dev"
+Requires-Dist: pylint[spelling]==4.0.5; extra == "dev"
 Requires-Dist: pylint-per-file-ignores==3.2.0; extra == "dev"
-Requires-Dist: pyproject-fmt==2.16.1; extra == "dev"
-Requires-Dist: pyrefly==0.53.0; extra == "dev"
+Requires-Dist: pyproject-fmt==2.16.2; extra == "dev"
+Requires-Dist: pyrefly==0.54.0; extra == "dev"
 Requires-Dist: pyright==1.1.408; extra == "dev"
 Requires-Dist: pyroma==5.0.1; extra == "dev"
 Requires-Dist: pytest==9.0.2; extra == "dev"
 Requires-Dist: pytest-cov==7.0.0; extra == "dev"
 Requires-Dist: pyyaml==6.0.3; extra == "dev"
-Requires-Dist: ruff==0.15.1; extra == "dev"
+Requires-Dist: ruff==0.15.2; extra == "dev"
 Requires-Dist: shellcheck-py==0.11.0.1; extra == "dev"
 Requires-Dist: shfmt-py==3.12.0.2; extra == "dev"
 Requires-Dist: sphinx==9.1.0; extra == "dev"
@@ -57,10 +58,10 @@ Requires-Dist: sphinxcontrib-spelling==8.0.2; extra == "dev"
 Requires-Dist: sybil==9.3.0; extra == "dev"
 Requires-Dist: torch>=2.5.1; extra == "dev"
 Requires-Dist: torchvision>=0.20.1; extra == "dev"
-Requires-Dist: ty==0.0.17; extra == "dev"
+Requires-Dist: ty==0.0.18; extra == "dev"
 Requires-Dist: types-requests==2.32.4.20260107; extra == "dev"
 Requires-Dist: vulture==2.14; extra == "dev"
-Requires-Dist: vws-python-mock==2026.2.22.2; extra == "dev"
+Requires-Dist: vws-python-mock==2026.2.22.3; extra == "dev"
 Requires-Dist: vws-test-fixtures==2023.3.5; extra == "dev"
 Requires-Dist: yamlfix==1.19.1; extra == "dev"
 Requires-Dist: zizmor==1.22.0; extra == "dev"

{vws_python-2026.2.22 → vws_python-2026.2.24}/src/vws_python.egg-info/SOURCES.txt

@@ -34,6 +34,7 @@ src/vws/py.typed
 src/vws/query.py
 src/vws/reports.py
 src/vws/response.py
+src/vws/transports.py
 src/vws/vumark_accept.py
 src/vws/vumark_service.py
 src/vws/vws.py
@@ -52,5 +53,6 @@ tests/__init__.py
 tests/conftest.py
 tests/test_cloud_reco_exceptions.py
 tests/test_query.py
+tests/test_transports.py
 tests/test_vws.py
 tests/test_vws_exceptions.py

{vws_python-2026.2.22 → vws_python-2026.2.24}/src/vws_python.egg-info/requires.txt

@@ -1,4 +1,5 @@
 beartype>=0.22.9
+httpx>=0.28.0
 requests>=2.32.3
 urllib3>=2.2.3
 vws-auth-tools>=2024.7.12
@@ -18,16 +19,16 @@ prek==0.3.3
 pydocstringformatter==0.7.5
 pydocstyle==6.3
 pygments==2.19.2
-pylint[spelling]==4.0.4
+pylint[spelling]==4.0.5
 pylint-per-file-ignores==3.2.0
-pyproject-fmt==2.16.1
-pyrefly==0.53.0
+pyproject-fmt==2.16.2
+pyrefly==0.54.0
 pyright==1.1.408
 pyroma==5.0.1
 pytest==9.0.2
 pytest-cov==7.0.0
 pyyaml==6.0.3
-ruff==0.15.1
+ruff==0.15.2
 shellcheck-py==0.11.0.1
 shfmt-py==3.12.0.2
 sphinx==9.1.0
@@ -39,10 +40,10 @@ sphinxcontrib-spelling==8.0.2
 sybil==9.3.0
 torch>=2.5.1
 torchvision>=0.20.1
-ty==0.0.17
+ty==0.0.18
 types-requests==2.32.4.20260107
 vulture==2.14
-vws-python-mock==2026.2.22.2
+vws-python-mock==2026.2.22.3
 vws-test-fixtures==2023.3.5
 yamlfix==1.19.1
 zizmor==1.22.0

{vws_python-2026.2.22 → vws_python-2026.2.24}/tests/conftest.py

@@ -35,6 +35,7 @@ def fixture_mock_vumark_database() -> Generator[VuMarkDatabase]:
 
 @pytest.fixture
 def vumark_service_client(
+    *,
     _mock_vumark_database: VuMarkDatabase,
 ) -> VuMarkService:
     """A ``VuMarkService`` client which connects to a mock VuMark database."""
@@ -45,14 +46,14 @@ def vumark_service_client(
 
 
 @pytest.fixture
-def vumark_target_id(_mock_vumark_database: VuMarkDatabase) -> str:
+def vumark_target_id(*, _mock_vumark_database: VuMarkDatabase) -> str:
     """The ID of the VuMark template target."""
     (target,) = _mock_vumark_database.vumark_targets
     return target.target_id
 
 
 @pytest.fixture
-def vws_client(_mock_database: CloudDatabase) -> VWS:
+def vws_client(*, _mock_database: CloudDatabase) -> VWS:
     """A VWS client which connects to a mock database."""
     return VWS(
         server_access_key=_mock_database.server_access_key,
@@ -61,7 +62,7 @@ def vws_client(_mock_database: CloudDatabase) -> VWS:
 
 
 @pytest.fixture
-def cloud_reco_client(_mock_database: CloudDatabase) -> CloudRecoService:
+def cloud_reco_client(*, _mock_database: CloudDatabase) -> CloudRecoService:
     """A ``CloudRecoService`` client which connects to a mock database."""
     return CloudRecoService(
         client_access_key=_mock_database.client_access_key,
@@ -71,6 +72,7 @@ def cloud_reco_client(_mock_database: CloudDatabase) -> CloudRecoService:
 
 @pytest.fixture(name="image_file", params=["r+b", "rb"])
 def fixture_image_file(
+    *,
     high_quality_image: io.BytesIO,
     tmp_path: Path,
     request: pytest.FixtureRequest,
@@ -86,6 +88,7 @@ def fixture_image_file(
 
 @pytest.fixture(params=["high_quality_image", "image_file"])
 def image(
+    *,
     request: pytest.FixtureRequest,
     high_quality_image: io.BytesIO,
     image_file: BinaryIO,

vws_python-2026.2.24/tests/test_transports.py

@@ -0,0 +1,61 @@
+"""Tests for HTTP transport implementations."""
+
+from http import HTTPStatus
+
+import httpx
+import respx
+
+from vws.response import Response
+from vws.transports import HTTPXTransport
+
+
+class TestHTTPXTransport:
+    """Tests for ``HTTPXTransport``."""
+
+    @staticmethod
+    @respx.mock
+    def test_float_timeout() -> None:
+        """``HTTPXTransport`` works with a float timeout."""
+        route = respx.post(url="https://example.com/test").mock(
+            return_value=httpx.Response(
+                status_code=HTTPStatus.OK,
+                text="OK",
+            ),
+        )
+        transport = HTTPXTransport()
+        response = transport(
+            method="POST",
+            url="https://example.com/test",
+            headers={"Content-Type": "text/plain"},
+            data=b"hello",
+            timeout=30.0,
+        )
+        assert route.called
+        assert isinstance(response, Response)
+        assert response.status_code == HTTPStatus.OK
+        assert response.text == "OK"
+        assert response.tell_position == len(b"OK")
+
+    @staticmethod
+    @respx.mock
+    def test_tuple_timeout() -> None:
+        """``HTTPXTransport`` works with a (connect, read) timeout
+        tuple.
+        """
+        route = respx.post(url="https://example.com/test").mock(
+            return_value=httpx.Response(
+                status_code=HTTPStatus.OK,
+                text="OK",
+            ),
+        )
+        transport = HTTPXTransport()
+        response = transport(
+            method="POST",
+            url="https://example.com/test",
+            headers={"Content-Type": "text/plain"},
+            data=b"hello",
+            timeout=(5.0, 30.0),
+        )
+        assert route.called
+        assert isinstance(response, Response)
+        assert response.status_code == HTTPStatus.OK