vws-python-mock 2026.2.15.4__tar.gz → 2026.2.18__tar.gz

{vws_python_mock-2026.2.15.4 → vws_python_mock-2026.2.18}/.github/workflows/docker-build.yml

@@ -23,13 +23,6 @@ jobs:
     name: Build Docker images
     runs-on: ubuntu-latest
 
-    strategy:
-      matrix:
-        image:
-          - name: target-manager
-          - name: vws
-          - name: vwq
-
     steps:
       - uses: actions/checkout@v6
         with:
@@ -41,24 +34,12 @@ jobs:
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
 
-      - name: Build Docker image
-        uses: docker/build-push-action@v6.19.2
+      - name: Check Docker bake definition
+        uses: docker/bake-action@v6.10.0
         with:
-          platforms: linux/amd64,linux/arm64
-          file: src/mock_vws/_flask_server/Dockerfile
-          push: false
-          target: ${{ matrix.image.name }}
-          tags: |-
-            adamtheturtle/vuforia-${{ matrix.image.name }}-mock:latest
+          call: check
 
-  completion-docker:
-    needs: build
-    runs-on: ubuntu-latest
-    if: always()  # Run even if one matrix job fails
-    steps:
-      - name: Check matrix job status
-        run: |-
-          if ! ${{ needs.build.result == 'success' }}; then
-            echo "One or more matrix jobs failed"
-            exit 1
-          fi
+      - name: Build Docker images
+        uses: docker/bake-action@v6.10.0
+        with:
+          push: false

{vws_python_mock-2026.2.15.4 → vws_python_mock-2026.2.18}/.github/workflows/release.yml

@@ -135,20 +135,10 @@ jobs:
           verbose: true
 
   docker:
-    name: Publish Docker image (${{ matrix.image.target }})
+    name: Publish Docker images
     needs: release
     runs-on: ubuntu-latest
 
-    strategy:
-      matrix:
-        image:
-          - target: target-manager
-            repo: adamtheturtle/vuforia-target-manager-mock
-          - target: vws
-            repo: adamtheturtle/vuforia-vws-mock
-          - target: vwq
-            repo: adamtheturtle/vuforia-vwq-mock
-
     permissions: {}
 
     steps:
@@ -169,13 +159,9 @@ jobs:
       - name: Set up QEMU
         uses: docker/setup-qemu-action@v3
 
-      - name: Build and push Docker image
-        uses: docker/build-push-action@v6.19.2
+      - name: Build and push Docker images
+        uses: docker/bake-action@v6.10.0
         with:
-          file: src/mock_vws/_flask_server/Dockerfile
-          platforms: linux/amd64,linux/arm64
           push: true
-          target: ${{ matrix.image.target }}
-          tags: |-
-            ${{ matrix.image.repo }}:latest
-            ${{ matrix.image.repo }}:${{ needs.release.outputs.version }}
+        env:
+          VERSION: ${{ needs.release.outputs.version }}

{vws_python_mock-2026.2.15.4 → vws_python_mock-2026.2.18}/.github/workflows/test.yml

@@ -113,6 +113,7 @@ jobs:
           - tests/mock_vws/test_update_target.py::TestInactiveProject
           - tests/mock_vws/test_requests_mock_usage.py
           - tests/mock_vws/test_flask_app_usage.py
+          - tests/mock_vws/test_vumark_generation_api.py
           - tests/mock_vws/test_docker.py
           - README.rst
           - docs/source/basic-example.rst

{vws_python_mock-2026.2.15.4 → vws_python_mock-2026.2.18}/.pre-commit-config.yaml

@@ -415,3 +415,11 @@ repos:
         language: python
         types_or: [markdown, rst]
         additional_dependencies: [uv==0.9.5]
+
+      - id: hclfmt
+        name: hclfmt
+        entry: hclfmt -w
+        language: golang
+        types: [hcl]
+        additional_dependencies: [github.com/hashicorp/hcl/v2/cmd/hclfmt@v2.24.0]
+        stages: [pre-commit]

{vws_python_mock-2026.2.15.4 → vws_python_mock-2026.2.18}/CHANGELOG.rst

@@ -4,6 +4,14 @@ Changelog
 Next
 ----
 
+2026.02.18
+----------
+
+
+2026.02.15.5
+------------
+
+
 2026.02.15.4
 ------------
 

{vws_python_mock-2026.2.15.4/src/vws_python_mock.egg-info → vws_python_mock-2026.2.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vws-python-mock
-Version: 2026.2.15.4
+Version: 2026.2.18
 Summary: A mock for the Vuforia Web Services (VWS) API.
 Author-email: Adam Dangoor <adamdangoor@gmail.com>
 License-Expression: MIT
@@ -27,18 +27,19 @@ Requires-Dist: requests>=2.32.3
 Requires-Dist: responses>=0.25.3
 Requires-Dist: torch>=2.5.1
 Requires-Dist: torchmetrics>=1.5.1
+Requires-Dist: torchvision>=0.20.1
 Requires-Dist: tzdata; sys_platform == "win32"
 Requires-Dist: vws-auth-tools>=2024.7.12
 Requires-Dist: werkzeug>=3.1.2
 Provides-Extra: dev
-Requires-Dist: actionlint-py==1.7.10.24; extra == "dev"
+Requires-Dist: actionlint-py==1.7.11.24; extra == "dev"
 Requires-Dist: check-manifest==0.51; extra == "dev"
 Requires-Dist: check-wheel-contents==0.6.3; extra == "dev"
 Requires-Dist: coverage==7.13.4; extra == "dev"
 Requires-Dist: deptry==0.24.0; extra == "dev"
 Requires-Dist: dirty-equals==0.11; extra == "dev"
 Requires-Dist: doc8==2.0.0; extra == "dev"
-Requires-Dist: doccmd==2026.1.31.3; extra == "dev"
+Requires-Dist: doccmd==2026.2.15; extra == "dev"
 Requires-Dist: docker==7.1.0; extra == "dev"
 Requires-Dist: enum-tools[sphinx]==0.13.0; extra == "dev"
 Requires-Dist: freezegun==1.5.5; extra == "dev"
@@ -46,13 +47,13 @@ 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.2; extra == "dev"
+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: pylint[spelling]==4.0.4; extra == "dev"
 Requires-Dist: pylint-per-file-ignores==3.2.0; extra == "dev"
-Requires-Dist: pyproject-fmt==2.16.0; extra == "dev"
-Requires-Dist: pyrefly==0.52.0; extra == "dev"
+Requires-Dist: pyproject-fmt==2.16.1; extra == "dev"
+Requires-Dist: pyrefly==0.53.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"
@@ -60,7 +61,7 @@ Requires-Dist: pytest-retry==1.7.0; extra == "dev"
 Requires-Dist: pytest-xdist==3.8.0; extra == "dev"
 Requires-Dist: python-dotenv==1.2.1; extra == "dev"
 Requires-Dist: pyyaml==6.0.3; extra == "dev"
-Requires-Dist: requests-mock-flask==2026.1.12; extra == "dev"
+Requires-Dist: requests-mock-flask==2026.2.16; extra == "dev"
 Requires-Dist: ruff==0.15.1; extra == "dev"
 Requires-Dist: shellcheck-py==0.11.0.1; extra == "dev"
 Requires-Dist: shfmt-py==3.12.0.2; extra == "dev"
@@ -75,15 +76,15 @@ Requires-Dist: sphinxcontrib-httpdomain==2.0.0; extra == "dev"
 Requires-Dist: sphinxcontrib-spelling==8.0.2; extra == "dev"
 Requires-Dist: sybil==9.3.0; extra == "dev"
 Requires-Dist: tenacity==9.1.4; extra == "dev"
-Requires-Dist: ty==0.0.16; extra == "dev"
+Requires-Dist: ty==0.0.17; extra == "dev"
 Requires-Dist: types-docker==7.1.0.20260109; extra == "dev"
 Requires-Dist: types-pyyaml==6.0.12.20250915; extra == "dev"
 Requires-Dist: types-requests==2.32.4.20260107; extra == "dev"
 Requires-Dist: urllib3==2.6.3; extra == "dev"
 Requires-Dist: vulture==2.14; extra == "dev"
-Requires-Dist: vws-python==2025.3.10.1; extra == "dev"
+Requires-Dist: vws-python==2026.2.15; extra == "dev"
 Requires-Dist: vws-test-fixtures==2023.3.5; extra == "dev"
-Requires-Dist: vws-web-tools==2024.10.6.1; extra == "dev"
+Requires-Dist: vws-web-tools==2026.2.17.1; extra == "dev"
 Requires-Dist: yamlfix==1.19.1; extra == "dev"
 Requires-Dist: zizmor==1.22.0; extra == "dev"
 Provides-Extra: release

vws_python_mock-2026.2.18/admin/create_secrets_files.py

@@ -0,0 +1,240 @@
+"""Create licenses and target databases for the tests to run against.
+
+See the instructions in the contributing guide in the documentation.
+"""
+
+import datetime
+import os
+import sys
+import textwrap
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+import vws_web_tools
+from dotenv import load_dotenv
+from selenium.common.exceptions import TimeoutException
+
+if TYPE_CHECKING:
+    from selenium.webdriver.remote.webdriver import WebDriver
+    from vws_web_tools import DatabaseDict, VuMarkDatabaseDict
+
+
+VUMARK_TEMPLATE_SVG_FILE_PATH = Path(__file__).with_name(
+    name="vumark_template.svg",
+)
+
+
+def _create_and_get_database_details(
+    driver: "WebDriver",
+    email_address: str,
+    password: str,
+    license_name: str,
+    database_name: str,
+) -> "DatabaseDict":
+    """Create a cloud database and get its details.
+
+    Returns database details.
+    """
+    vws_web_tools.log_in(
+        driver=driver,
+        email_address=email_address,
+        password=password,
+    )
+    vws_web_tools.wait_for_logged_in(driver=driver)
+    vws_web_tools.create_license(driver=driver, license_name=license_name)
+
+    vws_web_tools.create_cloud_database(
+        driver=driver,
+        database_name=database_name,
+        license_name=license_name,
+    )
+
+    return vws_web_tools.get_database_details(
+        driver=driver,
+        database_name=database_name,
+    )
+
+
+def _create_and_get_vumark_details(
+    driver: "WebDriver",
+    vumark_database_name: str,
+) -> "VuMarkDatabaseDict":
+    """Create a VuMark database and get its details.
+
+    Returns VuMark database details.
+    """
+    vws_web_tools.create_vumark_database(
+        driver=driver,
+        database_name=vumark_database_name,
+    )
+
+    return vws_web_tools.get_vumark_database_details(
+        driver=driver,
+        database_name=vumark_database_name,
+    )
+
+
+def _generate_secrets_file_content(
+    database_details: "DatabaseDict",
+    vumark_details: "VuMarkDatabaseDict",
+    inactive_database_details: "DatabaseDict",
+    vumark_target_id: str,
+) -> str:
+    """Generate the content of a secrets file."""
+    return textwrap.dedent(
+        text=f"""\
+        VUFORIA_TARGET_MANAGER_DATABASE_NAME={database_details["database_name"]}
+        VUFORIA_SERVER_ACCESS_KEY={database_details["server_access_key"]}
+        VUFORIA_SERVER_SECRET_KEY={database_details["server_secret_key"]}
+        VUFORIA_CLIENT_ACCESS_KEY={database_details["client_access_key"]}
+        VUFORIA_CLIENT_SECRET_KEY={database_details["client_secret_key"]}
+
+        INACTIVE_VUFORIA_TARGET_MANAGER_DATABASE_NAME={inactive_database_details["database_name"]}
+        INACTIVE_VUFORIA_SERVER_ACCESS_KEY={inactive_database_details["server_access_key"]}
+        INACTIVE_VUFORIA_SERVER_SECRET_KEY={inactive_database_details["server_secret_key"]}
+        INACTIVE_VUFORIA_CLIENT_ACCESS_KEY={inactive_database_details["client_access_key"]}
+        INACTIVE_VUFORIA_CLIENT_SECRET_KEY={inactive_database_details["client_secret_key"]}
+
+        VUMARK_VUFORIA_TARGET_MANAGER_DATABASE_NAME={vumark_details["database_name"]}
+        VUMARK_VUFORIA_TARGET_ID={vumark_target_id}
+        VUMARK_VUFORIA_SERVER_ACCESS_KEY={vumark_details["server_access_key"]}
+        VUMARK_VUFORIA_SERVER_SECRET_KEY={vumark_details["server_secret_key"]}
+        """,
+    )
+
+
+def _create_and_get_vumark_target_id(
+    driver: "WebDriver",
+    vumark_database_name: str,
+    vumark_template_name: str,
+) -> str:
+    """Upload a VuMark template and get its target ID."""
+    vws_web_tools.upload_vumark_template(
+        driver=driver,
+        database_name=vumark_database_name,
+        svg_file_path=VUMARK_TEMPLATE_SVG_FILE_PATH,
+        template_name=vumark_template_name,
+        width=100.0,
+    )
+    return vws_web_tools.get_vumark_target_id(
+        driver=driver,
+        database_name=vumark_database_name,
+        target_name=vumark_template_name,
+    )
+
+
+def _create_vuforia_resource_names() -> tuple[str, str, str, str]:
+    """Create names for Vuforia resources."""
+    time = datetime.datetime.now(tz=datetime.UTC).strftime(
+        format="%Y-%m-%d-%H-%M-%S",
+    )
+    return (
+        f"my-license-{time}",
+        f"my-database-{time}",
+        f"my-vumark-database-{time}",
+        f"my-vumark-template-{time}",
+    )
+
+
+def main() -> None:
+    """Create secrets files."""
+    email_address = os.environ["VWS_EMAIL_ADDRESS"]
+    password = os.environ["VWS_PASSWORD"]
+    new_secrets_dir = Path(os.environ["NEW_SECRETS_DIR"]).expanduser()
+    existing_secrets_file = Path(
+        os.environ["EXISTING_SECRETS_FILE"]
+    ).expanduser()
+    if not existing_secrets_file.exists():
+        msg = f"Existing secrets file does not exist: {existing_secrets_file}"
+        raise FileNotFoundError(msg)
+    load_dotenv(dotenv_path=existing_secrets_file)
+    inactive_database_details: DatabaseDict = {
+        "database_name": os.environ[
+            "INACTIVE_VUFORIA_TARGET_MANAGER_DATABASE_NAME"
+        ],
+        "server_access_key": os.environ["INACTIVE_VUFORIA_SERVER_ACCESS_KEY"],
+        "server_secret_key": os.environ["INACTIVE_VUFORIA_SERVER_SECRET_KEY"],
+        "client_access_key": os.environ["INACTIVE_VUFORIA_CLIENT_ACCESS_KEY"],
+        "client_secret_key": os.environ["INACTIVE_VUFORIA_CLIENT_SECRET_KEY"],
+    }
+    new_secrets_dir.mkdir(exist_ok=True)
+
+    num_databases = 100
+    required_files = [
+        (new_secrets_dir / f"vuforia_secrets_{i}.env")
+        for i in range(num_databases)
+    ]
+    files_to_create = [file for file in required_files if not file.exists()]
+    driver: WebDriver | None = None
+
+    while files_to_create:
+        if driver is None:
+            driver = vws_web_tools.create_chrome_driver()
+        file = files_to_create[-1]
+        sys.stdout.write(f"Creating database {file.name}\n")
+        (
+            license_name,
+            database_name,
+            vumark_database_name,
+            vumark_template_name,
+        ) = _create_vuforia_resource_names()
+
+        try:
+            database_details = _create_and_get_database_details(
+                driver=driver,
+                email_address=email_address,
+                password=password,
+                license_name=license_name,
+                database_name=database_name,
+            )
+        except TimeoutException:
+            sys.stderr.write(
+                "Timed out waiting for database setup/details after retries\n"
+            )
+            driver.quit()
+            driver = None
+            continue
+
+        try:
+            vumark_details = _create_and_get_vumark_details(
+                driver=driver,
+                vumark_database_name=vumark_database_name,
+            )
+        except TimeoutException:
+            sys.stderr.write(
+                "Timed out waiting for VuMark setup/details after retries\n"
+            )
+            driver.quit()
+            driver = None
+            continue
+
+        try:
+            vumark_target_id = _create_and_get_vumark_target_id(
+                driver=driver,
+                vumark_database_name=vumark_database_name,
+                vumark_template_name=vumark_template_name,
+            )
+        except TimeoutException:
+            sys.stderr.write(
+                "Timed out waiting for VuMark template upload after retries\n"
+            )
+            driver.quit()
+            driver = None
+            continue
+
+        driver.quit()
+        driver = None
+
+        file_contents = _generate_secrets_file_content(
+            database_details=database_details,
+            vumark_details=vumark_details,
+            inactive_database_details=inactive_database_details,
+            vumark_target_id=vumark_target_id,
+        )
+        file.write_text(data=file_contents)
+        sys.stdout.write(f"Created database {file.name}\n")
+        files_to_create.pop()
+
+
+if __name__ == "__main__":
+    main()