|Build Status| |codecov| |PyPI| |Documentation Status|
.. contents:: :local:
Mock for the Vuforia Web Services (VWS) API and the Vuforia Web Query API.
requests
Using the mock redirects requests to Vuforia made with requests
_ to an in-memory implementation.
This requires Python 3.12+.
.. code-block:: shell
pip install vws-python-mock
.. code-block:: python
"""Make a request to the Vuforia Web Services API mock."""
import requests
from mock_vws import MockVWS
from mock_vws.database import VuforiaDatabase
with MockVWS() as mock:
database = VuforiaDatabase()
mock.add_database(database=database)
# This will use the Vuforia mock.
requests.get("https://vws.vuforia.com/summary", timeout=30)
By default, an exception will be raised if any requests to unmocked addresses are made.
.. _requests: https://pypi.org/project/requests/
It is possible run a Mock VWS instance using Docker containers.
This allows you to run tests against a mock VWS instance regardless of the language or tooling you are using.
See the the instructions <https://vws-python-mock.readthedocs.io/en/latest/docker.html>
__ for how to do this.
See the full documentation <https://vws-python-mock.readthedocs.io/en/latest>
__.
This includes details on how to use the mock, options, and details of the differences between the mock and the real Vuforia Web Services.
.. |Build Status| image:: https://github.com/VWS-Python/vws-python-mock/actions/workflows/ci.yml/badge.svg?branch=main :target: https://github.com/VWS-Python/vws-python-mock/actions .. |codecov| image:: https://codecov.io/gh/VWS-Python/vws-python-mock/branch/main/graph/badge.svg :target: https://codecov.io/gh/VWS-Python/vws-python-mock .. |PyPI| image:: https://badge.fury.io/py/VWS-Python-Mock.svg :target: https://badge.fury.io/py/VWS-Python-Mock .. |Documentation Status| image:: https://readthedocs.org/projects/vws-python-mock/badge/?version=latest :target: https://vws-python-mock.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status