vws-python-mock 2026.9.12__tar.gz → 2026.10.9__tar.gz

{vws_python_mock-2026.9.12 → vws_python_mock-2026.10.9}/.dockerignore

@@ -17,7 +17,7 @@ prek.toml
 .vale.ini
 .yamlfmt
 admin
-CHANGELOG.rst
+CHANGELOG.md
 ci
 CODE_OF_CONDUCT.rst
 CONTRIBUTING.rst

{vws_python_mock-2026.9.12 → vws_python_mock-2026.10.9}/.github/workflows/autofix.yml

@@ -20,10 +20,10 @@ jobs:
           persist-credentials: false
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.0.1
+        uses: astral-sh/setup-uv@v10.2.0
 
       - name: Run fixers
-        uses: j178/prek-action@v3.0.0
+        uses: j178/prek-action@v3.0.1
         with:
           prek-version: 0.4.11
           extra-args: >-

{vws_python_mock-2026.9.12 → vws_python_mock-2026.10.9}/.github/workflows/docker-build.yml

@@ -35,11 +35,11 @@ jobs:
         uses: docker/setup-buildx-action@v4
 
       - name: Check Docker bake definition
-        uses: docker/bake-action@v7.3.0
+        uses: docker/bake-action@v7.4.0
         with:
           call: check
 
       - name: Build Docker images
-        uses: docker/bake-action@v7.3.0
+        uses: docker/bake-action@v7.4.0
         with:
           push: false

{vws_python_mock-2026.9.12 → vws_python_mock-2026.10.9}/.github/workflows/lint.yml

@@ -30,10 +30,10 @@ jobs:
           persist-credentials: false
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.0.1
+        uses: astral-sh/setup-uv@v10.2.0
 
       - name: Lint
-        uses: j178/prek-action@v3.0.0
+        uses: j178/prek-action@v3.0.1
         with:
           prek-version: 0.4.11
           extra-args: >-
@@ -49,7 +49,7 @@ jobs:
   completion-lint:
     needs: build
     runs-on: ubuntu-latest
-    if: always()  # Run even if one matrix job fails
+    if: ${{ !cancelled() }}  # Run even if one matrix job fails
     steps:
       - name: Check matrix job status
         run: |-

{vws_python_mock-2026.9.12 → vws_python_mock-2026.10.9}/.github/workflows/release.yml

@@ -35,7 +35,7 @@ jobs:
           token: ${{ secrets.RELEASE_PAT }}
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.0.1
+        uses: astral-sh/setup-uv@v10.2.0
         with:
           enable-cache: true
           cache-dependency-glob: '**/pyproject.toml'
@@ -49,33 +49,24 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
-      # towncrier writes the rendered notes to stdout (informational
-      # chatter goes to stderr), so this is the curated release body for
-      # this version, not github-tag-action's commit-derived changelog.
-      - name: Generate the GitHub release notes
+      - name: Assemble native Markdown release notes
         env:
           RELEASE: ${{ steps.calver.outputs.release }}
-        run: uv run --group=release towncrier build --draft --version "$RELEASE" >
-          release-notes.md
-
-      # Assemble the same fragments into CHANGELOG.rst under a new
-      # ``$RELEASE`` section and delete the consumed fragment files.
-      - name: Update the changelog
-        env:
-          RELEASE: ${{ steps.calver.outputs.release }}
-        run: uv run --group=release towncrier build --yes --version "$RELEASE"
+        run: |
+          uv run --group=release towncrier build --yes --version "$RELEASE"
+          cp "docs/source/changelog/$RELEASE.md" release-notes.md
 
       - uses: stefanzweifel/git-auto-commit-action@v7
         id: commit
         with:
           commit_message: Bump CHANGELOG
-          file_pattern: CHANGELOG.rst newsfragments
+          file_pattern: CHANGELOG.md docs/source/changelog newsfragments
           # Error if there are no changes.
           skip_dirty_check: true
 
       - name: Bump version and push tag
         id: tag_version
-        uses: mathieudutour/github-tag-action@v6.2
+        uses: mathieudutour/github-tag-action@v7
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           custom_tag: ${{ steps.calver.outputs.release }}
@@ -114,7 +105,7 @@ jobs:
           persist-credentials: false
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.0.1
+        uses: astral-sh/setup-uv@v10.2.0
         with:
           enable-cache: true
           cache-dependency-glob: '**/pyproject.toml'
@@ -160,7 +151,7 @@ jobs:
         uses: docker/setup-qemu-action@v4
 
       - name: Build and push Docker images
-        uses: docker/bake-action@v7.3.0
+        uses: docker/bake-action@v7.4.0
         with:
           push: true
         env:

{vws_python_mock-2026.9.12 → vws_python_mock-2026.10.9}/.github/workflows/test.yml

@@ -74,7 +74,7 @@ jobs:
           - tests/mock_vws/test_database_summary.py::TestDatabaseSummary::test_inactive_images
           - tests/mock_vws/test_database_summary.py::TestDatabaseSummary::test_inactive_failed
           - tests/mock_vws/test_database_summary.py::TestDatabaseSummary::test_deleted
-          - tests/mock_vws/test_database_summary.py::TestProcessingImages
+          - tests/mock_vws/test_database_summary.py::test_processing_images
           - tests/mock_vws/test_database_summary.py::TestQuotas
           - tests/mock_vws/test_database_summary.py::TestRecos
           - tests/mock_vws/test_database_summary.py::TestRequestUsage
@@ -128,15 +128,15 @@ jobs:
           - tests/mock_vws/test_model_target_generation_warning.py
           - tests/mock_vws/test_model_target_failure_response.py
           - tests/mock_vws/test_model_target_training_allowance.py
-          - tests/mock_vws/test_model_target_web_api.py
+          - tests/mock_vws/model_target_web_api
           - tests/mock_vws/test_model_target_retries.py
           - tests/mock_vws/test_vumark_generation_api.py
           - tests/mock_vws/test_vumark_generation_failure.py
           - tests/mock_vws/test_target_validators.py
-          - tests/mock_vws/test_requests_mock_usage.py
-          - tests/mock_vws/test_respx_mock_usage.py
-          - tests/mock_vws/test_httpx2_mock_usage.py
-          - tests/mock_vws/test_flask_app_usage.py
+          - tests/mock_vws/requests_mock
+          - tests/mock_vws/respx_mock
+          - tests/mock_vws/httpx2_mock
+          - tests/mock_vws/flask_app
           - tests/mock_vws/test_healthcheck.py
           - tests/mock_vws/test_docker.py
           - README.rst
@@ -148,7 +148,7 @@ jobs:
           persist-credentials: false
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.0.1
+        uses: astral-sh/setup-uv@v10.2.0
         with:
           enable-cache: true
           cache-dependency-glob: '**/pyproject.toml'
@@ -226,7 +226,7 @@ jobs:
           persist-credentials: false
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.0.1
+        uses: astral-sh/setup-uv@v10.2.0
         with:
           enable-cache: true
           cache-dependency-glob: '**/pyproject.toml'
@@ -271,7 +271,7 @@ jobs:
           persist-credentials: false
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.0.1
+        uses: astral-sh/setup-uv@v10.2.0
         with:
           enable-cache: true
           cache-dependency-glob: '**/pyproject.toml'
@@ -324,7 +324,7 @@ jobs:
   coverage:
     name: Combine & check coverage
     needs: [ci-tests, skip-tests, windows-tests]
-    if: always()
+    if: ${{ !cancelled() }}
     runs-on: ubuntu-latest
 
     steps:
@@ -333,7 +333,7 @@ jobs:
           persist-credentials: false
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.0.1
+        uses: astral-sh/setup-uv@v10.2.0
         with:
           enable-cache: true
           cache-dependency-glob: '**/pyproject.toml'
@@ -368,7 +368,7 @@ jobs:
   completion-ci:
     needs: [ci-tests, skip-tests, windows-tests, coverage]
     runs-on: ubuntu-latest
-    if: always()
+    if: ${{ !cancelled() }}
     steps:
       - name: Check all jobs status
         run: |-

{vws_python_mock-2026.9.12 → vws_python_mock-2026.10.9}/.vale.ini

@@ -14,7 +14,6 @@ ai-tells.ContrastiveFormulas = NO
 ai-tells.ContrastiveNegation = NO
 ai-tells.EmptyPadding = NO
 ai-tells.EmptyPaddingStacked = NO
-ai-tells.FigurativeLands = NO
 ai-tells.FillerPhrases = NO
 ai-tells.FormalRegister = NO
 ai-tells.FormalTransitions = NO

vws_python_mock-2026.10.9/CHANGELOG.md

@@ -0,0 +1,3 @@
+# Changelog
+
+Release notes are stored as [one Markdown file per version](docs/source/changelog/).

vws_python_mock-2026.10.9/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include docs *.md

{vws_python_mock-2026.9.12/src/vws_python_mock.egg-info → vws_python_mock-2026.10.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vws-python-mock
-Version: 2026.9.12
+Version: 2026.10.9
 Summary: A mock for the Vuforia Web Services (VWS) API.
 Author-email: Adam Dangoor <adamdangoor@gmail.com>
 License-Expression: MIT
@@ -114,10 +114,10 @@ By default, an exception will be raised if any requests to unmocked addresses ar
 .. _httpx: https://pypi.org/project/httpx/
 .. _HTTPX2: https://httpx2.pydantic.dev/
 
-Using Docker to mock calls to Vuforia from any language
--------------------------------------------------------
+Using containers to mock calls to Vuforia from any language
+-----------------------------------------------------------
 
-It is possible run a Mock VWS instance using Docker containers.
+You can run a Mock VWS instance using Docker or Apple's ``container`` CLI.
 
 This allows you to run tests against a mock VWS instance regardless of the language or tooling you are using.
 

{vws_python_mock-2026.9.12 → vws_python_mock-2026.10.9}/README.rst

@@ -76,10 +76,10 @@ By default, an exception will be raised if any requests to unmocked addresses ar
 .. _httpx: https://pypi.org/project/httpx/
 .. _HTTPX2: https://httpx2.pydantic.dev/
 
-Using Docker to mock calls to Vuforia from any language
--------------------------------------------------------
+Using containers to mock calls to Vuforia from any language
+-----------------------------------------------------------
 
-It is possible run a Mock VWS instance using Docker containers.
+You can run a Mock VWS instance using Docker or Apple's ``container`` CLI.
 
 This allows you to run tests against a mock VWS instance regardless of the language or tooling you are using.
 

{vws_python_mock-2026.9.12 → vws_python_mock-2026.10.9}/admin/create_secrets_files.py

@@ -290,11 +290,8 @@ def main() -> None:
         for i in range(num_databases)
     ]
     files_to_create = [file for file in required_files if not file.exists()]
-    driver: WebDriver | None = None
-
     while bool(files_to_create):
-        if driver is None:
-            driver = vws_web_tools.create_chrome_driver()
+        driver = vws_web_tools.create_chrome_driver()
         file = files_to_create[-1]
         _ = sys.stdout.write(f"Creating database {file.name}\n")
         (
@@ -327,11 +324,9 @@ def main() -> None:
         except TimeoutException:
             _ = sys.stderr.write("Timed out during database setup\n")
             driver.quit()
-            driver = None
             continue
 
         driver.quit()
-        driver = None
 
         file_contents = _generate_secrets_file_content(
             cloud_database_details=cloud_database_details,

vws_python_mock-2026.10.9/docs/source/changelog/2018.09.10.0.md

@@ -0,0 +1,3 @@
+# 2018.09.10.0
+
+- Initial release

vws_python_mock-2026.10.9/docs/source/changelog/2018.12.01.0.md

@@ -0,0 +1,3 @@
+# 2018.12.01.0
+
+- Distribute type information.

vws_python_mock-2026.10.9/docs/source/changelog/2024.02.16.md

@@ -0,0 +1,3 @@
+# 2024.02.16
+
+- Add a structural similarity image matcher.

vws_python_mock-2026.10.9/docs/source/changelog/2024.07.02.1.md

@@ -0,0 +1,3 @@
+# 2024.07.02.1
+
+- Fix installation on Windows now that `numpy` 2.0.0 has been released.

vws_python_mock-2026.10.9/docs/source/changelog/2024.07.15.md

@@ -0,0 +1,3 @@
+# 2024.07.15
+
+- Support passing data as strings.

vws_python_mock-2026.10.9/docs/source/changelog/2024.08.30.md

@@ -0,0 +1 @@
+# 2024.08.30

vws_python_mock-2026.10.9/docs/source/changelog/2025.02.18.md

@@ -0,0 +1 @@
+# 2025.02.18

vws_python_mock-2026.10.9/docs/source/changelog/2025.02.21.md

@@ -0,0 +1 @@
+# 2025.02.21

vws_python_mock-2026.10.9/docs/source/changelog/2025.03.10.1.md

@@ -0,0 +1 @@
+# 2025.03.10.1

vws_python_mock-2026.10.9/docs/source/changelog/2025.03.10.md

@@ -0,0 +1 @@
+# 2025.03.10

vws_python_mock-2026.10.9/docs/source/changelog/2026.02.15.3.md

@@ -0,0 +1,4 @@
+# 2026.02.15.3
+
+- Add `response_delay_seconds` parameter to `MockVWS` for simulating slow server responses and testing timeout handling.
+- Add `response_delay_seconds` setting to the Flask mock (`VWSSettings` and `VWQSettings`) for simulating slow server responses.

vws_python_mock-2026.10.9/docs/source/changelog/2026.02.15.4.md

@@ -0,0 +1,3 @@
+# 2026.02.15.4
+
+- Add `sleep_fn` parameter to `MockVWS` for injecting a custom delay strategy, enabling deterministic and fast tests without monkey-patching.

vws_python_mock-2026.10.9/docs/source/changelog/2026.02.15.5.md

@@ -0,0 +1 @@
+# 2026.02.15.5

vws_python_mock-2026.10.9/docs/source/changelog/2026.02.18.1.md

@@ -0,0 +1 @@
+# 2026.02.18.1

vws_python_mock-2026.10.9/docs/source/changelog/2026.02.18.2.md

@@ -0,0 +1 @@
+# 2026.02.18.2

vws_python_mock-2026.10.9/docs/source/changelog/2026.02.18.md

@@ -0,0 +1 @@
+# 2026.02.18

vws_python_mock-2026.10.9/docs/source/changelog/2026.02.21.md

@@ -0,0 +1,5 @@
+# 2026.02.21
+
+- Add `VuMarkTarget` class for VuMark template targets, alongside the renamed `ImageTarget` class (previously `Target`).
+  `ImageTarget` is for image-based targets and `VuMarkTarget` is for VuMark template targets.
+  Both can be stored in a `VuforiaDatabase`.

vws_python_mock-2026.10.9/docs/source/changelog/2026.02.22.1.md

@@ -0,0 +1 @@
+# 2026.02.22.1

vws_python_mock-2026.10.9/docs/source/changelog/2026.02.22.2.md

@@ -0,0 +1 @@
+# 2026.02.22.2

vws_python_mock-2026.10.9/docs/source/changelog/2026.02.22.3.md

@@ -0,0 +1,4 @@
+# 2026.02.22.3
+
+- `MockVWS` now intercepts both `requests` (via `responses`) and `httpx` (via `respx`) simultaneously.
+  `MockVWSForHttpx` has been removed: `MockVWS` handles both HTTP libraries.

vws_python_mock-2026.10.9/docs/source/changelog/2026.02.22.md

@@ -0,0 +1 @@
+# 2026.02.22

vws_python_mock-2026.10.9/docs/source/changelog/2026.04.26.md

@@ -0,0 +1 @@
+# 2026.04.26

vws_python_mock-2026.10.9/docs/source/changelog/2026.08.04.2.md

@@ -0,0 +1,16 @@
+# 2026.08.04.2
+
+- Replace the PyTorch image-quality stack with OpenCV and a lightweight BRISQUE implementation.
+  This reduces dependency download and installation sizes and removes the need to configure PyTorch's CPU-only package index.
+- Allow VuMark generation requests to be configured to return `QuotaExceeded`, `LicenseCheckFailed`, or `AuthorizationFailed` responses.
+- Cloud databases with `request_quota=0` now return a `RequestQuotaReached` response from VWS endpoints.
+- Add a mock implementation of the Model Target Web API, including OAuth2 token creation, standard and advanced dataset creation, status polling, dataset download, and deletion.
+- Improve Model Target Web API mock authentication failure responses, including malformed and unsecured JSON Web Token headers.
+- Match real Vuforia Model Target dataset creation validation error shape, including per-request UUID, details list, and status codes (415 for unsupported media type, 400 with `BAD_REQUEST` validation details).
+- Match real Vuforia Model Target unknown-dataset response shape (`NOT_FOUND` code, `Could not find a model-view database with uuid <uuid>` message, `userId:` target).
+  Keep each Model Target dataset status response internally consistent when processing completes while the response is being generated.
+- Make synthetic Model Target dataset zip downloads byte-for-byte reproducible.
+- Match real Vuforia Model Target Web API error responses for invalid request bodies, invalid dataset creation payloads, unknown datasets, and downloads of still-processing datasets.
+- Add configurable `TargetQuotaReached`, `ProjectSuspended`, and `ProjectHasNoAPIAccess` responses from VWS endpoints.
+- Add configurable `TooManyRequests` responses from VWS endpoints using the `CloudDatabase.requests_per_second_limit` setting.
+- Add `CloudQueryFailureResponse` and the `MockVWS.cloud_query_failure_response` parameter for returning configurable Cloud Query failure status codes, headers, and raw bodies through the `requests` and `httpx` backends.

vws_python_mock-2026.10.9/docs/source/changelog/2026.08.14.md

@@ -0,0 +1,39 @@
+# 2026.08.14
+
+- Give `CloudDatabase` a `database_id`, and reject a reco counts report request whose path names a database which the request's server keys do not belong to, as real Vuforia does.
+- Return a response, rather than raising an uncaught `PIL.Image.DecompressionBombError`, when an image with a small file size but a huge number of pixels is given to `POST /targets` or `POST /v1/query`.
+  As real Vuforia does, `POST /targets` now returns the `ImageTooLarge` result code for an image with more than 37748736 pixels, and the Query API applies no pixel count limit.
+- Return targets in a deterministic order from the Query API, `GET /targets` and `GET /duplicates/{target_id}`.
+  Targets are ordered by upload date and then by target ID, so repeated runs agree with each other.
+  This order is not Vuforia's match score order.
+- Document the Docker containers' configuration with the environment variable names and values which the applications actually read, starting with `TARGET_MANAGER_BASE_URL`.
+- Build the Docker images from a committed `uv.lock` with a `.dockerignore`, so that image contents are reproducible from a commit, source edits no longer invalidate the dependency layer, and repository files such as tests and documentation are no longer copied into the images.
+- Store Model Target datasets in the target manager service rather than in the VWS application.
+  In the Docker deployment, datasets now survive a restart of the VWS container, matching how cloud databases and their targets are stored.
+  The VWS application also no longer imports the target manager module's state: it constructs its own request rate limiter and reco counts report store.
+- Report the Docker containers as unhealthy without a traceback in the health check probe output while nothing is yet listening on the port.
+- Support `cadDataBlob` and `cadDataFormat` in Model Target dataset creation requests, and require exactly one of `cadDataUrl` and `cadDataBlob` for each model.
+- Reject Model Target Web API and OAuth2 token requests with a `Content-Length` header which is not an integer, matching the load balancer in front of real Vuforia.
+- Reject Model Target dataset creation requests with wrongly typed `name`, `targetSdk` or `models` entry values.
+- Treat standard and advanced Model Target datasets as separate resources: status, download and delete requests made through the other dataset type's routes now return the unknown-dataset error rather than acting on the dataset.
+- Reject Model Target dataset creation requests with values outside the documented enumerations for the `automaticColoring`, `motionHint`, `optimizeTrackingFor`, `realisticAppearance`, `simplify` and `trackingMode` model fields.
+- Report the `failed` training status when downloading a Model Target dataset whose generation failed, rather than the `not-started` status which a still-processing dataset reports.
+- Add configurable failed Model Target dataset status responses.
+- Add configurable Model Target dataset generation warning responses.
+- Reject Model Target dataset creation requests with `guideViewPosition` objects which are missing `rotation` or `translation`, or which have `rotation` or `translation` values that are not JSON arrays.
+- Reject Model Target dataset creation requests with `guideViewPosition` `rotation` or `translation` arrays which contain values that are not JSON numbers.
+- Reject Model Target bearer tokens whose JWT payload is not a JSON object.
+- Reject Model Target bearer tokens with empty or malformed JWT signatures.
+- Reject Model Target dataset creation requests with models which are missing `name`, or which have wrongly typed `cadDataUrl`, `name` or `views` values.
+- Reject Model Target dataset creation requests with a body which is valid JSON but not a JSON object, rather than raising an error in the mock.
+- Accept State-Based Model Target configuration and validate per-view state selections against its declared states.
+- Reject Model Target dataset creation requests with `views` entries which are not JSON objects, which are missing `guideViewPosition` or `name`, or which have wrongly typed `guideViewPosition` or `name` values.
+- Model VWS request rate limits per endpoint with the new `CloudDatabase.request_rate_limits` setting, including the limits which Vuforia documents as `mock_vws.request_rate_limits.DOCUMENTED_REQUEST_RATE_LIMITS`.
+  No request rate limit is applied by default.
+- Change the `ProjectHasNoAPIAccess` result code to `ProjectHasNoApiAccess`, matching Vuforia's result codes table.
+- Add the reco counts report endpoint, and a download URL for the generated CSV report.
+- Preserve the recognition count fields, the reco rating and the reco threshold when dumping a `CloudDatabase` or an `ImageTarget` to a dictionary and loading it back.
+- Rate an image of a single color as `0` rather than raising an uncaught `ZeroDivisionError`.
+- Return a 404 response from the Flask and Docker mock for a request to a path which it does not serve, and for a request to a served path with a method which that path does not serve, as real Vuforia does, rather than raising an error.
+- Reject VuMark instance generation requests whose `instance_id` is not a string with a `BadRequest` result, as real Vuforia does, and move the `instance_id` checks into validators shared by both mock backends.
+- Reject Model Target dataset creation requests with a body which cannot be decoded as UTF-8, rather than raising an error in the mock, and decode OAuth2 token request bodies leniently.

vws_python_mock-2026.10.9/docs/source/changelog/2026.08.26.1.md

@@ -0,0 +1,3 @@
+# 2026.08.26.1
+
+- Add configurable Model Target HTTP failure responses for selected dataset request phases.

vws_python_mock-2026.10.9/docs/source/changelog/2026.08.26.md

@@ -0,0 +1,9 @@
+# 2026.08.26
+
+- Guard the state which the Docker containers share between requests with a lock.
+  The containers serve requests on threads, so concurrent requests, such as those made by a test suite which runs in parallel, could previously race with each other: listing databases while a target was added could return a 500 response, and a target which was being updated or deleted could briefly be missing from a database.
+- Give each call of a function decorated with a `MockVWS` instance its own databases and targets.
+  Previously, every use of an instance shared one set of databases and targets, so decorating two test functions with one instance made them affect each other.
+  A database can still be inspected during a call, and its targets are what they were before the call again once it returns.
+  Using an instance as a context manager is unchanged: a `with` block still shares its state with every other use of the same instance.
+- - Add configurable Model Target `TRAINING_ALLOWANCE_EXCEEDED` responses to the in-process and Flask/Docker mocks.

vws_python_mock-2026.10.9/docs/source/changelog/2026.09.06.md

@@ -0,0 +1,31 @@
+# 2026.09.06
+
+- Add `MockVWS.set_target_recognition_counts` and a matching target manager endpoint for the Flask and Docker mock, for setting the recognition counts which the target summary report and the reco counts report show for a target.
+  A reco counts report now has a row for each target with recognitions in the requested month, and the recognition counts and recognition threshold of a cloud database are kept when the database is created in the Flask and Docker mock.
+
+- Order Query API and `GET /duplicates/{target_id}` results by match score, with the best match first, as the real Query API does.
+  Matches with equal scores keep the existing upload date and then target ID order.
+
+  Image matchers now return a score, or `None` for no match, rather than a `bool`.
+  `StructuralSimilarityMatcher` returns the images' SSIM score, and `ExactMatcher` gives every match the same score.
+  A custom `query_match_checker` or `duplicate_match_checker` which returns a `bool` now raises a `TypeError`; return a score, such as `1.0`, for a match and `None` for no match instead.
+  The mock's ranking is its matcher's opinion, not Vuforia's proprietary one, so the mock's order still need not agree with the real Query API's order.
+
+- Respond, rather than failing to respond, to a request body which is not UTF-8 and to a query request whose `multipart/form-data` body ends before its closing boundary.
+
+- Return a `400` response which names the offending field and the accepted values, rather than a `500` response, when the target manager container is given an invalid cloud database or VuMark database to create.
+  Return a `404` response, rather than a `500` response, when the target manager container is asked to add a target to a database which does not exist.
+
+- Say which claims about the real Vuforia Web Services the mock has not had checked against them.
+  `unverified-behavior` lists each such claim and what would verify it, and `differences-to-vws` marks the unverified assumptions among its deliberate differences.
+
+- Return a `BadImage` response, rather than failing to respond, when an image given to the Target API is truncated before the end of its image data.
+
+- `MockVWS` now intercepts `httpx2` requests, synchronous and asynchronous, alongside `requests` and `httpx`.
+  The `httpx2` path uses native `httpx2` requests and responses, and does not need `httpx2.alias_httpx()`.
+
+- Fix nested `MockVWS` instances on the `httpx` backend: an inner mock is now the only one which answers while it is running, matching the `requests` and `httpx2` backends.
+  Previously the outer mock kept answering and requests to the inner mock's URL were refused.
+
+- Return a response, rather than raising an uncaught `JSONDecodeError`, when an empty body is given to a VWS endpoint which takes a JSON body.
+  As real Vuforia does, `POST /targets` and `PUT /targets/<target_id>` now return a 500 `Fail` response, the reco counts report endpoint returns a 400 `Fail` response, and the VuMark instance generation endpoint returns a 400 `BadRequest` response.

vws_python_mock-2026.10.9/docs/source/changelog/2026.09.08.1.md

@@ -0,0 +1,6 @@
+# 2026.09.08.1
+
+- The URL of a reco counts report now has the shape of the presigned cloud storage URL which real Vuforia returns.
+  The report file is named `{date}-{hour}.csv` for the current month and `{month}.csv` for the previous month, so two requests for the same month in the same hour name the same file and serve the report which the first request generated.
+  The URL carries the query parameters of a presigned URL, and the mock honors `X-Amz-Date` and `X-Amz-Expires` as real Vuforia's storage does, so a URL which is out of date or which has no query parameters gives the `403` XML error document which Amazon S3 gives.
+  A report which is not yet generated gives the `404` `NoSuchKey` XML error document which Amazon S3 gives, as real Vuforia has now been observed to do, rather than an empty body.

vws_python_mock-2026.10.9/docs/source/changelog/2026.09.08.md

@@ -0,0 +1,6 @@
+# 2026.09.08
+
+- The response delay and client timeout simulation is now provided by the `mock-response-delay` package.
+- The mock now returns NGINX's `400 Request Header Or Cookie Too Large` response for any request header line longer than 8190 bytes, as real Vuforia does.
+- Match real Vuforia's request rate limiting, which was checked against it on 2026-09-08.
+  `DOCUMENTED_REQUEST_RATE_LIMITS` now allows two `GET /targets` requests per minute rather than one, a rate-limited request gets Envoy's empty-bodied `429` response rather than a JSON `TooManyRequests` body, and the limits are applied before the request's signature is checked.

vws_python_mock-2026.10.9/docs/source/changelog/2026.09.12.md

@@ -0,0 +1,6 @@
+# 2026.09.12
+
+- Validate decoded Model Target request values before processing them.
+- Type target-manager request defaults as database dictionaries instead of arbitrary mappings.
+- Type parsed Target Manager request bodies using recursive JSON values.
+- Accept integer `response_delay_seconds` values when mocking `requests` calls.

vws_python_mock-2026.10.9/docs/source/changelog/2026.10.09.md

@@ -0,0 +1,13 @@
+# 2026.10.09 (2026-10-09)
+
+## Changes
+
+- Make VuMark targets with zero processing time immediately ready for instance generation, even when their last modified timestamp is equal to or ahead of the server clock.
+  Targets with positive processing time become ready at their exact completion timestamp. ([#3705](https://github.com/VWS-Python/vws-python-mock/issues/3705))
+- Clean up Docker deployment test images and containers even when fixture setup fails partway through. ([#3711](https://github.com/VWS-Python/vws-python-mock/issues/3711))
+- Bound Flask health-check HTTP requests to five seconds so an unresponsive server is reported as unhealthy. ([#3712](https://github.com/VWS-Python/vws-python-mock/issues/3712))
+- Set `VWS_BASE_URL` in the Docker setup instructions so report download URLs point to the published mock service. ([#3713](https://github.com/VWS-Python/vws-python-mock/issues/3713))
+- Wait for Docker test services through their published HTTP ports as well as their native Docker health checks. ([#3714](https://github.com/VWS-Python/vws-python-mock/issues/3714))
+- - Document running and building the mock directly with Apple's container CLI using the same images as Docker.
+    Support the existing deployment tests through Socktainer's optional Docker API, allow an explicit API version, and bind all test service ports to loopback.
+- Publish native Markdown release notes and use the same notes in documentation where available.

vws_python_mock-2026.10.9/docs/source/changelog.md

@@ -0,0 +1,11 @@
+# Changelog
+
+Releases are assembled from `newsfragments/` using Towncrier.
+
+```{toctree}
+:maxdepth: 1
+:glob:
+:reversed:
+
+changelog/*
+```

{vws_python_mock-2026.9.12 → vws_python_mock-2026.10.9}/docs/source/ci-setup.rst

@@ -24,7 +24,8 @@ Create environment variable files for secrets:
    $ cp vuforia_secrets.env.example ci_secrets/vuforia_secrets_1.env
    $ ...
 
-Populate every variable listed in :file:`vuforia_secrets.env.example`. Each file needs distinct active Cloud database credentials so concurrent jobs do not modify the same database.
+Populate every variable listed in :file:`vuforia_secrets.env.example`.
+Each file needs distinct active Cloud database credentials so concurrent jobs do not modify the same database.
 The files can share the inactive Cloud, active and inactive VuMark, and Model Target credentials.
 Add at least as many consecutively numbered files, starting at zero, as there are builds in the GitHub test matrix.
 

{vws_python_mock-2026.9.12 → vws_python_mock-2026.10.9}/docs/source/conf.py

@@ -17,6 +17,7 @@ project = _pyproject_config.name
 author = _pyproject_config.author
 
 extensions = [
+    "myst_parser",
     "sphinx_copybutton",
     "sphinx.ext.autodoc",
     "sphinx.ext.intersphinx",
@@ -30,19 +31,15 @@ extensions = [
 ]
 
 # Render the unreleased ``newsfragments/`` entries into
-# ``docs/source/unreleased.rst`` so the Sphinx spelling, doc-build and
+# ``docs/source/unreleased.md`` so the Sphinx spelling, doc-build and
 # link-checking gates cover the prose before it is assembled into
-# CHANGELOG.rst at release time.
+# the versioned Markdown notes at release time.
 towncrier_draft_autoversion_mode = "draft"
 towncrier_draft_include_empty = True
 towncrier_draft_working_directory = f"{_pyproject_file.parent}"
 
-# Required by sphinx-toolbox 4.2.0rc1 for compatibility with Sphinx 9.
-# See https://github.com/sphinx-toolbox/sphinx-toolbox/issues/201#issuecomment-4313483053.
-autodoc_use_legacy_class_based = True
-
 templates_path = ["_templates"]
-source_suffix = ".rst"
+source_suffix = {".rst": "restructuredtext", ".md": "markdown"}
 master_doc = "index"
 
 project_copyright = f"%Y, {author}"