vws-python 2026.2.25.1__tar.gz → 2026.8.26__tar.gz

{vws_python-2026.2.25.1 → vws_python-2026.8.26}/.github/dependabot.yml

@@ -12,3 +12,8 @@ updates:
     schedule:
       interval: daily
     open-pull-requests-limit: 10
+
+  - package-ecosystem: pre-commit
+    directory: /
+    schedule:
+      interval: daily

vws_python-2026.8.26/.github/workflows/autofix.yml

@@ -0,0 +1,37 @@
+---
+name: autofix.ci
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  autofix:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+          persist-credentials: false
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v10.0.1
+
+      - name: Run fixers
+        uses: j178/prek-action@v3.0.0
+        with:
+          prek-version: 0.4.11
+          extra-args: >-
+            --all-files --hook-stage pre-commit --no-fail-fast --verbose
+        env:
+          UV_NO_CACHE: '1'
+          UV_PYTHON: 3.14
+
+      - uses: autofix-ci/action@v1.3.4
+        if: always()

{vws_python-2026.2.25.1 → vws_python-2026.8.26}/.github/workflows/ci.yml

@@ -17,18 +17,18 @@ jobs:
   build:
     strategy:
       matrix:
-        python-version: ['3.13', '3.14']
+        python-version: ['3.14']
         platform: [ubuntu-latest, windows-latest]
 
     runs-on: ${{ matrix.platform }}
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           persist-credentials: false
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@v10.0.1
         with:
           enable-cache: true
           cache-dependency-glob: '**/pyproject.toml'

{vws_python-2026.2.25.1 → vws_python-2026.8.26}/.github/workflows/dependabot-merge.yml

@@ -1,4 +1,5 @@
 ---
+
 name: Dependabot auto-merge
 on: pull_request
 
@@ -9,13 +10,8 @@ permissions:
 jobs:
   dependabot:
     runs-on: ubuntu-latest
-    if: github.actor == 'dependabot[bot]'
+    if: github.event.pull_request.user.login == 'dependabot[bot]'
     steps:
-      - name: Dependabot metadata
-        id: metadata
-        uses: dependabot/fetch-metadata@v2
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
       - name: Enable auto-merge for Dependabot PRs
         run: gh pr merge --auto --merge "$PR_URL"
         env:

{vws_python-2026.2.25.1 → vws_python-2026.8.26}/.github/workflows/lint.yml

@@ -17,35 +17,34 @@ jobs:
   build:
     strategy:
       matrix:
-        python-version: ['3.13']
+        python-version: ['3.14']
         platform: [ubuntu-latest, windows-latest]
         hook-stage: [pre-commit, pre-push, manual]
 
     runs-on: ${{ matrix.platform }}
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           persist-credentials: false
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@v10.0.1
         with:
           enable-cache: true
           cache-dependency-glob: '**/pyproject.toml'
 
       - name: Lint
-        # Use bash to ensure the step fails if any command fails.
-        # PowerShell does not fail on intermediate command failures by default.
-        shell: bash
-        run: uv run --extra=dev prek run --all-files --hook-stage ${{ matrix.hook-stage }}
-          --verbose
+        uses: j178/prek-action@v3.0.0
+        with:
+          prek-version: 0.4.11
+          cache: false
+          extra-args: >-
+            --all-files --hook-stage ${{ matrix.hook-stage }} --verbose
         env:
+          UV_NO_CACHE: '1'
           UV_PYTHON: ${{ matrix.python-version }}
 
-      - uses: pre-commit-ci/lite-action@v1.1.0
-        if: always()
-
   completion-lint:
     needs: build
     runs-on: ubuntu-latest

{vws_python-2026.2.25.1 → vws_python-2026.8.26}/.github/workflows/publish-site.yml

@@ -22,7 +22,7 @@ jobs:
         with:
           documentation_path: docs/source
           pyproject_extras: dev
-          python_version: '3.13'
+          python_version: '3.14'
           sphinx_build_options: -W
           cache: true
           publish: ${{ github.ref_name == 'main' }}

{vws_python-2026.2.25.1 → vws_python-2026.8.26}/.github/workflows/release.yml

@@ -20,7 +20,7 @@ jobs:
       contents: write
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:  # zizmor: ignore[artipacked] git-auto-commit-action requires credentials
           # See
           # https://github.com/stefanzweifel/git-auto-commit-action?tab=readme-ov-file#push-to-protected-branches
@@ -33,7 +33,7 @@ jobs:
           fetch-depth: 0
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@v10.0.1
         with:
           enable-cache: true
           cache-dependency-glob: '**/pyproject.toml'
@@ -47,33 +47,27 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Get the changelog underline
-        id: changelog_underline
-        run: |
-          underline="$(echo "${{ steps.calver.outputs.release }}" | tr -c '\n' '-')"
-          echo "underline=${underline}" >> "$GITHUB_OUTPUT"
+      # 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
+        env:
+          RELEASE: ${{ steps.calver.outputs.release }}
+        run: uv run --extra=release towncrier build --draft --version "$RELEASE" >
+          release-notes.md
 
-      - name: Update changelog
-        id: update_changelog
-        uses: jacobtomlinson/gha-find-replace@v3
-        with:
-          find: "Next\n----"
-          replace: "Next\n----\n\n${{ steps.calver.outputs.release }}\n${{ steps.changelog_underline.outputs.underline\
-            \ }}\n"
-          include: CHANGELOG.rst
-          regex: false
+      # 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 --extra=release towncrier build --yes --version "$RELEASE"
 
-      - name: Check Update changelog was modified
-        run: |
-          if [ "${{ steps.update_changelog.outputs.modifiedFiles }}" = "0" ]; then
-            echo "Error: No files were modified when updating changelog"
-            exit 1
-          fi
       - uses: stefanzweifel/git-auto-commit-action@v7
         id: commit
         with:
           commit_message: Bump CHANGELOG
-          file_pattern: CHANGELOG.rst
+          file_pattern: CHANGELOG.rst newsfragments
           # Error if there are no changes.
           skip_dirty_check: true
 
@@ -92,12 +86,14 @@ jobs:
           tag: ${{ steps.tag_version.outputs.new_tag }}
           makeLatest: true
           name: Release ${{ steps.tag_version.outputs.new_tag }}
-          body: ${{ steps.tag_version.outputs.changelog }}
+          bodyFile: release-notes.md
 
       - name: Build a binary wheel and a source tarball
+        env:
+          NEW_TAG: ${{ steps.tag_version.outputs.new_tag }}
         run: |
           git fetch --tags
-          git checkout ${{ steps.tag_version.outputs.new_tag }}
+          git checkout "$NEW_TAG"
           uv build --sdist --wheel --out-dir dist/
           uv run --extra=release check-wheel-contents dist/*.whl
 

{vws_python-2026.2.25.1 → vws_python-2026.8.26}/.gitignore

@@ -112,3 +112,6 @@ secrets.tar
 src/*/_setuptools_scm_version.txt
 
 uv.lock
+
+# Vale styles downloaded by ``vale sync``
+styles/

vws_python-2026.8.26/.vale.ini

@@ -0,0 +1,15 @@
+StylesPath = styles
+MinAlertLevel = error
+
+Packages = https://github.com/tbhb/vale-ai-tells/releases/download/v1.29.0/ai-tells.zip
+
+[*.{rst,md}]
+BasedOnStyles = ai-tells
+
+# These rules misclassify established technical, example, or release-note prose
+# in this repository. All other ai-tells rules remain enforced.
+ai-tells.ColonUsage = NO
+ai-tells.FigurativeLands = NO
+ai-tells.FormalTransitions = NO
+ai-tells.OverusedVocabularyVerbs = NO
+ai-tells.VerbTricolon = NO

{vws_python-2026.2.25.1 → vws_python-2026.8.26}/CHANGELOG.rst

@@ -1,8 +1,34 @@
 Changelog
 =========
 
-Next
-----
+.. towncrier release notes start
+
+2026.08.26
+----------
+
+- Test synchronous and asynchronous Model Target error responses through the
+  public mock API, and include rate-limit and server-error branches in coverage.
+
+2026.08.14
+----------
+
+- Drop Python 3.13 support, update VWS Python Mock, and test quota and project-state error responses against the mock.
+
+- Add ``QuotaExceededError``, ``LicenseCheckFailedError``, and ``AuthorizationFailedError`` for documented VuMark Generation API result codes.
+
+- Fix ``target_id`` on target exceptions when ``base_vws_url`` includes a path prefix.
+
+- Retain explicitly provided falsy custom transports instead of replacing them with defaults.
+
+- Raise a response-carrying ``CloudRecoError`` when Cloud Query returns a documented empty or non-JSON 4xx response instead of leaking ``JSONDecodeError``.
+
+- Add support for the Model Target Web API.
+  ``ModelTargetService`` and ``AsyncModelTargetService`` create standard and advanced Model Target datasets, wait for them to be generated, download them and delete them.
+
+- Map the ``ProjectHasNoApiAccess`` result code, as spelled in Vuforia's result codes table, to ``ProjectHasNoAPIAccessError``. The previously mapped ``ProjectHasNoAPIAccess`` casing, which Vuforia does not document, is no longer mapped.
+
+- Add support for the Database Reco Counts report.
+  ``VWS`` and ``AsyncVWS`` take an optional ``database_id``, and have new ``request_database_reco_counts_report``, ``download_reco_counts_report`` and ``wait_for_reco_counts_report`` methods.
 
 2026.02.25.1
 ------------

{vws_python-2026.2.25.1/src/vws_python.egg-info → vws_python-2026.8.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vws-python
-Version: 2026.2.25.1
+Version: 2026.8.26
 Summary: Interact with the Vuforia Web Services (VWS) API.
 Author-email: Adam Dangoor <adamdangoor@gmail.com>
 License-Expression: MIT
@@ -12,9 +12,8 @@ Classifier: Environment :: Web Environment
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: POSIX
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Requires-Python: >=3.13
+Requires-Python: >=3.14
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: beartype>=0.22.9
@@ -23,51 +22,56 @@ Requires-Dist: requests>=2.32.3
 Requires-Dist: urllib3>=2.2.3
 Requires-Dist: vws-auth-tools>=2024.7.12
 Provides-Extra: dev
-Requires-Dist: actionlint-py==1.7.11.24; extra == "dev"
+Requires-Dist: actionlint-py==1.7.12.24; extra == "dev"
 Requires-Dist: check-manifest==0.51; extra == "dev"
-Requires-Dist: deptry==0.24.0; extra == "dev"
+Requires-Dist: deptry==0.25.1; extra == "dev"
 Requires-Dist: doc8==2.0.0; extra == "dev"
-Requires-Dist: doccmd==2026.2.15; extra == "dev"
+Requires-Dist: doccmd==2026.8.16; extra == "dev"
 Requires-Dist: freezegun==1.5.5; extra == "dev"
 Requires-Dist: furo==2025.12.19; extra == "dev"
 Requires-Dist: interrogate==1.7.0; extra == "dev"
-Requires-Dist: mypy[faster-cache]==1.19.1; extra == "dev"
-Requires-Dist: mypy-strict-kwargs==2026.1.12; extra == "dev"
-Requires-Dist: prek==0.3.3; extra == "dev"
-Requires-Dist: pydocstringformatter==0.7.5; extra == "dev"
+Requires-Dist: mypy[faster-cache]==2.3.1; extra == "dev"
+Requires-Dist: mypy-strict-kwargs==2026.8.25.1; extra == "dev"
+Requires-Dist: no-defaults==2.1.0; extra == "dev"
+Requires-Dist: prek==0.4.14; extra == "dev"
+Requires-Dist: pydocstringformatter==1.0.0; extra == "dev"
 Requires-Dist: pydocstyle==6.3; extra == "dev"
-Requires-Dist: pygments==2.19.2; 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.2; extra == "dev"
-Requires-Dist: pyrefly==0.54.0; extra == "dev"
-Requires-Dist: pyright==1.1.408; extra == "dev"
+Requires-Dist: pygments==2.21.0; extra == "dev"
+Requires-Dist: pylint[spelling]==4.0.7; extra == "dev"
+Requires-Dist: pylint-per-file-ignores==3.2.1; extra == "dev"
+Requires-Dist: pyproject-fmt==2.28.0; extra == "dev"
+Requires-Dist: pyrefly==1.2.0; extra == "dev"
+Requires-Dist: pyright==1.1.411; extra == "dev"
 Requires-Dist: pyroma==5.0.1; extra == "dev"
-Requires-Dist: pytest==9.0.2; extra == "dev"
-Requires-Dist: pytest-asyncio==1.3.0; extra == "dev"
-Requires-Dist: pytest-cov==7.0.0; extra == "dev"
+Requires-Dist: pytest==9.1.1; extra == "dev"
+Requires-Dist: pytest-asyncio==1.4.0; extra == "dev"
+Requires-Dist: pytest-beartype-tests==2026.8.16; extra == "dev"
+Requires-Dist: pytest-cov==7.1.0; extra == "dev"
 Requires-Dist: pyyaml==6.0.3; extra == "dev"
-Requires-Dist: ruff==0.15.2; extra == "dev"
+Requires-Dist: ruff==0.16.4; extra == "dev"
 Requires-Dist: shellcheck-py==0.11.0.1; extra == "dev"
-Requires-Dist: shfmt-py==3.12.0.2; extra == "dev"
+Requires-Dist: shfmt-py==4.0.0; extra == "dev"
 Requires-Dist: sphinx==9.1.0; extra == "dev"
 Requires-Dist: sphinx-copybutton==0.5.2; extra == "dev"
 Requires-Dist: sphinx-lint==1.0.2; extra == "dev"
 Requires-Dist: sphinx-pyproject==0.3.0; extra == "dev"
-Requires-Dist: sphinx-substitution-extensions==2026.1.12; extra == "dev"
+Requires-Dist: sphinx-substitution-extensions==2026.8.13.1; extra == "dev"
 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.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.3; extra == "dev"
-Requires-Dist: vws-test-fixtures==2023.3.5; extra == "dev"
+Requires-Dist: sphinxcontrib-towncrier==0.5.0a0; extra == "dev"
+Requires-Dist: strict-kwargs==2026.8.16; extra == "dev"
+Requires-Dist: sybil==10.1.0; extra == "dev"
+Requires-Dist: towncrier==25.8.0; extra == "dev"
+Requires-Dist: ty==0.0.74; extra == "dev"
+Requires-Dist: types-requests==2.33.0.20260712; extra == "dev"
+Requires-Dist: vale==3.18.0.0; extra == "dev"
+Requires-Dist: vulture==2.16; extra == "dev"
+Requires-Dist: vws-python-mock==2026.8.26.1; extra == "dev"
+Requires-Dist: vws-test-fixtures==2026.8.23; extra == "dev"
 Requires-Dist: yamlfix==1.19.1; extra == "dev"
-Requires-Dist: zizmor==1.22.0; extra == "dev"
+Requires-Dist: zizmor==1.29.0; extra == "dev"
 Provides-Extra: release
 Requires-Dist: check-wheel-contents==0.6.3; extra == "release"
+Requires-Dist: towncrier==25.8.0; extra == "release"
 Dynamic: license-file
 
 |Build Status| |PyPI|
@@ -145,4 +149,4 @@ See the `full documentation <https://vws-python.github.io/vws-python/>`__.
    :target: https://github.com/VWS-Python/vws-python/actions
 .. |PyPI| image:: https://badge.fury.io/py/VWS-Python.svg
    :target: https://badge.fury.io/py/VWS-Python
-.. |minimum-python-version| replace:: 3.13
+.. |minimum-python-version| replace:: 3.14

{vws_python-2026.2.25.1 → vws_python-2026.8.26}/README.rst

@@ -73,4 +73,4 @@ See the `full documentation <https://vws-python.github.io/vws-python/>`__.
    :target: https://github.com/VWS-Python/vws-python/actions
 .. |PyPI| image:: https://badge.fury.io/py/VWS-Python.svg
    :target: https://badge.fury.io/py/VWS-Python
-.. |minimum-python-version| replace:: 3.13
+.. |minimum-python-version| replace:: 3.14

{vws_python-2026.2.25.1 → vws_python-2026.8.26}/conftest.py

@@ -1,13 +1,12 @@
 """Setup for Sybil."""
 
-import io
+import io  # noqa: TC003
 import uuid
-from collections.abc import Generator
+from collections.abc import Generator  # noqa: TC003
 from doctest import ELLIPSIS
 from pathlib import Path
 
 import pytest
-from beartype import beartype
 from mock_vws import MockVWS
 from mock_vws.database import CloudDatabase
 from sybil import Sybil
@@ -18,14 +17,6 @@ from sybil.parsers.rest import (
 )
 
 
-@beartype
-def pytest_collection_modifyitems(items: list[pytest.Item]) -> None:
-    """Apply the beartype decorator to all collected test functions."""
-    for item in items:
-        if isinstance(item, pytest.Function):
-            item.obj = beartype(obj=item.obj)
-
-
 @pytest.fixture(name="make_image_file")
 def fixture_make_image_file(
     *,
@@ -55,18 +46,31 @@ def fixture_mock_vws(
     server_secret_key = uuid.uuid4().hex
     client_access_key = uuid.uuid4().hex
     client_secret_key = uuid.uuid4().hex
+    database_id = uuid.uuid4().hex
 
     database = CloudDatabase(
         server_access_key=server_access_key,
         server_secret_key=server_secret_key,
         client_access_key=client_access_key,
         client_secret_key=client_secret_key,
+        database_id=database_id,
     )
 
     monkeypatch.setenv(name="VWS_SERVER_ACCESS_KEY", value=server_access_key)
     monkeypatch.setenv(name="VWS_SERVER_SECRET_KEY", value=server_secret_key)
     monkeypatch.setenv(name="VWS_CLIENT_ACCESS_KEY", value=client_access_key)
     monkeypatch.setenv(name="VWS_CLIENT_SECRET_KEY", value=client_secret_key)
+    monkeypatch.setenv(name="VWS_DATABASE_ID", value=database_id)
+    # The mock accepts one hard-coded pair of Model Target Web API OAuth2
+    # credentials, which it does not expose.
+    monkeypatch.setenv(
+        name="VWS_MODEL_TARGET_CLIENT_ID",
+        value="client-id",
+    )
+    monkeypatch.setenv(
+        name="VWS_MODEL_TARGET_CLIENT_SECRET",
+        value="client-secret",
+    )
     # We use a low processing time so that tests run quickly.
     with MockVWS(processing_time_seconds=0.2) as mock:
         mock.add_cloud_database(cloud_database=database)

{vws_python-2026.2.25.1 → vws_python-2026.8.26}/docs/source/api-reference.rst

@@ -17,6 +17,18 @@ API Reference
    :undoc-members:
    :members:
 
+.. automodule:: vws.model_target_service
+   :undoc-members:
+   :members:
+
+.. automodule:: vws.async_model_target_service
+   :undoc-members:
+   :members:
+
+.. automodule:: vws.model_target_datasets
+   :undoc-members:
+   :members:
+
 .. automodule:: vws.reports
    :undoc-members:
    :members:

{vws_python-2026.2.25.1 → vws_python-2026.8.26}/docs/source/conf.py

@@ -23,8 +23,17 @@ extensions = [
     "sphinx.ext.napoleon",
     "sphinx_substitution_extensions",
     "sphinxcontrib.spelling",
+    "sphinxcontrib.towncrier.ext",
 ]
 
+# Render the unreleased ``newsfragments/`` entries into
+# ``docs/source/unreleased.rst`` so the Sphinx spelling, doc-build and
+# link-checking gates cover the prose before it is assembled into
+# CHANGELOG.rst at release time.
+towncrier_draft_autoversion_mode = "draft"
+towncrier_draft_include_empty = True
+towncrier_draft_working_directory = f"{_pyproject_file.parent}"
+
 templates_path = ["_templates"]
 source_suffix = ".rst"
 master_doc = "index"

{vws_python-2026.2.25.1 → vws_python-2026.8.26}/docs/source/exceptions.rst

@@ -28,6 +28,15 @@ CloudRecoService exceptions
    :inherited-members: Exception
    :exclude-members: errno, filename, filename2, strerror
 
+ModelTargetService exceptions
+-----------------------------
+
+.. automodule:: vws.exceptions.model_target_exceptions
+   :members:
+   :show-inheritance:
+   :inherited-members: Exception
+   :exclude-members: errno, filename, filename2, strerror
+
 Custom exceptions
 -----------------