Add respx support for mocking httpx requests (#2973)

* Add respx support for mocking httpx requests

Implement MockVWSForHttpx context manager using respx to intercept httpx
requests to Vuforia APIs. Reuses existing handler logic by converting
httpx.Request to requests.PreparedRequest. Includes 13 tests covering
real_http parameter, response delays, custom URLs, and database
management. Adds httpx and respx as core dependencies.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* Fix mypy type issues in respx implementation

* Fix mypy error codes for type ignore comments

* Fix ruff linting issue with dict comprehension

Add noqa comment to suppress C416 ruff error while keeping dict
comprehension to satisfy pyrefly type checking requirements.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* Use RequestData instead of PreparedRequest in respx adapter

Convert httpx.Request directly to RequestData, removing the
PreparedRequest intermediate. This eliminates the requests library
dependency from the respx module and removes all type suppression
comments (type: ignore, noqa).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Fix lint and type issues in respx mock docs

* Add documentation for MockVWSForHttpx

Document the new httpx/respx mock backend in README, index, getting-started,
mock-api-reference, and a new httpx-example.rst file.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>

Author: adamtheturtle

README.rst

@@ -38,6 +38,30 @@ By default, an exception will be raised if any requests to unmocked addresses ar
 
 .. _requests: https://pypi.org/project/requests/
 
+Mocking calls made to Vuforia with Python ``httpx``
+----------------------------------------------------
+
+Using the mock redirects requests to Vuforia made with `httpx`_ to an in-memory implementation.
+
+.. code-block:: python
+
+    """Make a request to the Vuforia Web Services API mock."""
+
+    import httpx
+
+    from mock_vws import MockVWSForHttpx
+    from mock_vws.database import CloudDatabase
+
+    with MockVWSForHttpx() as mock:
+        database = CloudDatabase()
+        mock.add_cloud_database(cloud_database=database)
+        # This will use the Vuforia mock.
+        httpx.get(url="https://vws.vuforia.com/summary", timeout=30)
+
+By default, an exception will be raised if any requests to unmocked addresses are made.
+
+.. _httpx: https://pypi.org/project/httpx/
+
 Using Docker to mock calls to Vuforia from any language
 -------------------------------------------------------
 

docs/source/getting-started.rst

@@ -1,4 +1,12 @@
 Getting started
 ---------------
 
+Mocking calls made to Vuforia with Python ``requests``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 .. include:: basic-example.rst
+
+Mocking calls made to Vuforia with Python ``httpx``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: httpx-example.rst

docs/source/httpx-example.rst

@@ -0,0 +1,22 @@
+Using the mock redirects requests to Vuforia made with `httpx`_ to an in-memory implementation.
+
+.. code-block:: python
+
+   """Make a request to the Vuforia Web Services API mock."""
+
+   import httpx
+
+   from mock_vws import MockVWSForHttpx
+   from mock_vws.database import CloudDatabase
+
+   with MockVWSForHttpx() as mock:
+       database = CloudDatabase()
+       mock.add_cloud_database(cloud_database=database)
+       # This will use the Vuforia mock.
+       httpx.get(url="https://vws.vuforia.com/summary", timeout=30)
+
+By default, an exception will be raised if any requests to unmocked addresses are made.
+
+See :ref:`mock-api-reference` for details of what can be changed and how.
+
+.. _httpx: https://pypi.org/project/httpx/

docs/source/index.rst

@@ -12,6 +12,11 @@ This requires Python |minimum-python-version|\+.
 
 .. include:: basic-example.rst
 
+Mocking calls made to Vuforia with Python ``httpx``
+----------------------------------------------------
+
+.. include:: httpx-example.rst
+
 Using Docker to mock calls to Vuforia from any language
 -------------------------------------------------------
 

docs/source/mock-api-reference.rst

@@ -7,6 +7,10 @@ API Reference
    :members:
    :undoc-members:
 
+.. autoclass:: mock_vws.MockVWSForHttpx
+   :members:
+   :undoc-members:
+
 .. autoclass:: mock_vws.MissingSchemeError
    :members:
    :undoc-members:

pyproject.toml

@@ -36,12 +36,14 @@ dynamic = [
 dependencies = [
     "beartype>=0.22.9",
     "flask>=3.0.3",
+    "httpx>=0.27.0",
     "numpy>=1.26.4",
     "pillow>=11.0.0",
     "piq>=0.8.0",
     "pydantic-settings>=2.6.1",
     "requests>=2.32.3",
     "responses>=0.25.3",
+    "respx>=0.21.0",
     "torch>=2.5.1",
     "torchmetrics>=1.5.1",
     "torchvision>=0.20.1",

spelling_private_dict.txt

@@ -45,6 +45,7 @@ hmac
 html
 http
 https
+httpx
 iff
 io
 issuecomment
@@ -98,6 +99,7 @@ reqjsonarr
 resheader
 resjson
 resjsonarr
+respx
 rfc
 rgb
 str

src/mock_vws/__init__.py

@@ -4,8 +4,10 @@
     MissingSchemeError,
     MockVWS,
 )
+from mock_vws._respx_mock_server.decorators import MockVWSForHttpx
 
 __all__ = [
     "MissingSchemeError",
     "MockVWS",
+    "MockVWSForHttpx",
 ]

src/mock_vws/_respx_mock_server/__init__.py

@@ -0,0 +1 @@
+"""A fake implementation of Vuforia Web Services for use with respx."""