OTAnalytics 0.7.3__tar.gz → 0.7.5__tar.gz

{otanalytics-0.7.3 → otanalytics-0.7.5}/.github/workflows/benchmark.yml

@@ -40,8 +40,8 @@ jobs:
       - name: Install the project
         shell: bash
         run: uv sync --locked --dev
-      - name: Run regression tests
-        run: uv run pytest ./tests/benchmark_otanalytics.py --benchmark-json output.json
+      - name: Run benchmark tests
+        run: uv run pytest ./tests/benchmark --benchmark-json output.json
       - name: Store benchmark result
         uses: benchmark-action/github-action-benchmark@v1
         with:

{otanalytics-0.7.3 → otanalytics-0.7.5}/.github/workflows/regression-test.yml

@@ -39,4 +39,4 @@ jobs:
         shell: bash
         run: uv sync --locked --dev
       - name: Run regression tests
-        run: uv run pytest ./tests/regression_otanalytics.py
+        run: uv run pytest ./tests/regression

otanalytics-0.7.5/.github/workflows/system-test.yml

@@ -0,0 +1,34 @@
+---
+name: System Test With Pytest
+
+on:
+  # Run tests each time a PR is opened or changed.
+  # Allow other Workflows (e.g., build workflows) to call this workflow.
+  pull_request:
+  workflow_call:
+
+permissions: read-all
+
+jobs:
+  test:
+    name: Execute system tests across various operating systems and Python versions.
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        py: ["3.12"]
+      fail-fast: true
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+      - name: Set up Python ${{ matrix.py }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.py }}
+      - name: Run Python System Tests
+        uses: platomo/test-python-app-action@v4
+        timeout-minutes: 60
+        with:
+          py-version: ${{ matrix.py }}
+          package-path: OTAnalytics
+          test-path: tests/system

{otanalytics-0.7.3 → otanalytics-0.7.5}/.github/workflows/test.yml

@@ -25,10 +25,10 @@ jobs:
         uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.py }}
-      - name: Run Python Tests
+      - name: Run Python Unit Tests
         uses: platomo/test-python-app-action@v4
         timeout-minutes: 60
         with:
           py-version: ${{ matrix.py }}
           package-path: OTAnalytics
-          test-path: tests/OTAnalytics
+          test-path: tests/unit

{otanalytics-0.7.3 → otanalytics-0.7.5}/.gitignore

@@ -3,6 +3,12 @@ data/
 !tests/data
 tests/data/OTCamera19_FR20_2023-05-24*
 tests/scripts/
+.envrc
+# Where S3_USER_SOURCE stages downloaded tracks and videos while running
+.cache-otanalytics/
+
+# Anthropic Claude
+.claude/rules/shared
 
 # Byte-compiled / optimized / DLL files
 __pycache__/

{otanalytics-0.7.3 → otanalytics-0.7.5}/.pre-commit-config.yaml

@@ -14,15 +14,10 @@ repos:
       - id: requirements-txt-fixer
       - id: check-executables-have-shebangs
       - id: detect-private-key
-  - repo: local
+  - repo: https://github.com/OpenTrafficCam/dependency-update-pre-commit
+    rev: v0.2.0
     hooks:
-      - id: update-type-stubs
-        name: Check for Type Stubs and Update Config
-        entry: ./update_precommit.py
-        language: system
-        files: ^requirements.*\.txt$
-        stages:
-          - pre-commit
+      - id: update-mypy-dependencies
   - repo: https://github.com/PyCQA/flake8
     rev: 7.3.0
     hooks:
@@ -45,36 +40,42 @@ repos:
         entry: mypy OTAnalytics tests --config-file=pyproject.toml
         additional_dependencies:
           - av==13.0.0
-          - black==24.8.0
+          - black==25.1.0
           - customtkinter==5.2.2
-          - fastapi==0.116.2
-          - hatch-requirements-txt==0.4.1
+          - fastapi==0.128.0
           - ijson==3.3.0
           - interrogate==1.7.0
-          - isort==5.13.2
+          - isort==6.0.1
           - matplotlib==3.10.0
+          - minio==7.2.20
           - more-itertools==10.7.0
           - mypy==1.16.1
           - nicegui==2.24.1
           - numpy==2.1.1
           - opencv-python-headless==4.10.0.84
-          - pandas-stubs==2.2.3.241126
+          - pandas-stubs==2.3.2.250926
           - pandas==2.3.3
+          - playwright==1.55.0
           - polars==1.32.3
           - pre-commit==4.1.0
           - pyarrow==21.0.0
           - pytest-asyncio==0.24.0
           - pytest-benchmark==5.1.0
-          - pytest-cov==6.0.0
-          - pytest-lazy-fixtures==1.1.2
+          - pytest-cov==7.0.0
+          - pytest-lazy-fixtures==1.4.0
+          - pytest-playwright==0.7.1
+          - pytest-timeout==2.4.0
           - pytest==8.3.4
-          - starlette==0.48.0
-          - twine==6.1.0
+          - starlette==0.49.1
+          - testcontainers==4.13.1
+          - twine==6.2.0
           - types-PyYAML
+          - types-aioboto3
+          - types-aiobotocore-s3==2.26.0
           - types-flake8
           - types-openpyxl
           - types-pillow
-          - types-pywin32
+          - types-pywin32; sys_platform == "win32"
           - types-requests
           - types-seaborn
           - types-selenium

otanalytics-0.7.5/.run/pytest-acceptance-tests.run.xml

@@ -0,0 +1,19 @@
+<component name="ProjectRunConfigurationManager">
+    <configuration default="false" name="pytest-acceptance-tests" type="tests" factoryName="py.test">
+        <module name="OTAnalytics"/>
+        <option name="INTERPRETER_OPTIONS" value=""/>
+        <option name="PARENT_ENVS" value="true"/>
+        <option name="SDK_HOME" value=""/>
+        <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$"/>
+        <option name="IS_MODULE_SDK" value="true"/>
+        <option name="ADD_CONTENT_ROOTS" value="true"/>
+        <option name="ADD_SOURCE_ROOTS" value="true"/>
+        <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py"/>
+        <option name="_new_keywords" value="&quot;&quot;"/>
+        <option name="_new_parameters" value="&quot;&quot;"/>
+        <option name="_new_additionalArguments" value="&quot;&quot;"/>
+        <option name="_new_target" value="&quot;$PROJECT_DIR$/tests/acceptance&quot;"/>
+        <option name="_new_targetType" value="&quot;PATH&quot;"/>
+        <method v="2"/>
+    </configuration>
+</component>

otanalytics-0.7.5/.run/pytest-benchmark-tests.run.xml

@@ -0,0 +1,19 @@
+<component name="ProjectRunConfigurationManager">
+    <configuration default="false" name="pytest-benchmark-tests" type="tests" factoryName="py.test">
+        <module name="OTAnalytics"/>
+        <option name="INTERPRETER_OPTIONS" value=""/>
+        <option name="PARENT_ENVS" value="true"/>
+        <option name="SDK_HOME" value=""/>
+        <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$"/>
+        <option name="IS_MODULE_SDK" value="true"/>
+        <option name="ADD_CONTENT_ROOTS" value="true"/>
+        <option name="ADD_SOURCE_ROOTS" value="true"/>
+        <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py"/>
+        <option name="_new_keywords" value="&quot;&quot;"/>
+        <option name="_new_parameters" value="&quot;&quot;"/>
+        <option name="_new_additionalArguments" value="&quot;&quot;"/>
+        <option name="_new_target" value="&quot;$PROJECT_DIR$/tests/benchmark&quot;"/>
+        <option name="_new_targetType" value="&quot;PATH&quot;"/>
+        <method v="2"/>
+    </configuration>
+</component>

otanalytics-0.7.5/.run/pytest-regression-tests.run.xml

@@ -0,0 +1,19 @@
+<component name="ProjectRunConfigurationManager">
+    <configuration default="false" name="pytest-regression-tests" type="tests" factoryName="py.test">
+        <module name="OTAnalytics"/>
+        <option name="INTERPRETER_OPTIONS" value=""/>
+        <option name="PARENT_ENVS" value="true"/>
+        <option name="SDK_HOME" value=""/>
+        <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$"/>
+        <option name="IS_MODULE_SDK" value="true"/>
+        <option name="ADD_CONTENT_ROOTS" value="true"/>
+        <option name="ADD_SOURCE_ROOTS" value="true"/>
+        <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py"/>
+        <option name="_new_keywords" value="&quot;&quot;"/>
+        <option name="_new_parameters" value="&quot;&quot;"/>
+        <option name="_new_additionalArguments" value="&quot;&quot;"/>
+        <option name="_new_target" value="&quot;$PROJECT_DIR$/tests/regression&quot;"/>
+        <option name="_new_targetType" value="&quot;PATH&quot;"/>
+        <method v="2"/>
+    </configuration>
+</component>

otanalytics-0.7.5/.run/pytest-unit-tests.run.xml

@@ -0,0 +1,19 @@
+<component name="ProjectRunConfigurationManager">
+    <configuration default="false" name="pytest-unit-tests" type="tests" factoryName="py.test">
+        <module name="OTAnalytics"/>
+        <option name="INTERPRETER_OPTIONS" value=""/>
+        <option name="PARENT_ENVS" value="true"/>
+        <option name="SDK_HOME" value=""/>
+        <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$"/>
+        <option name="IS_MODULE_SDK" value="true"/>
+        <option name="ADD_CONTENT_ROOTS" value="true"/>
+        <option name="ADD_SOURCE_ROOTS" value="true"/>
+        <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py"/>
+        <option name="_new_keywords" value="&quot;&quot;"/>
+        <option name="_new_parameters" value="&quot;&quot;"/>
+        <option name="_new_additionalArguments" value="&quot;&quot;"/>
+        <option name="_new_target" value="&quot;$PROJECT_DIR$/tests/unit&quot;"/>
+        <option name="_new_targetType" value="&quot;PATH&quot;"/>
+        <method v="2"/>
+    </configuration>
+</component>

otanalytics-0.7.5/CONTEXT.md

@@ -0,0 +1,56 @@
+# OTAnalytics
+
+Traffic analysis on road user trajectories: OTAnalytics loads Tracks recorded by
+OTVision, lets a user define Sections and Flows over them, and counts the road
+users crossing those Sections.
+
+## Language
+
+### Obtaining input files
+
+**Transfer Mode**:
+Where an OTAnalytics instance obtains its Track and Video files — the local
+filesystem, or an S3 bucket. Fixed for the lifetime of the process by the
+startup configuration; it is not something a user switches while working.
+_Avoid_: storage backend, data source (both suggest a per-load choice).
+
+**Startup Configuration**:
+The environment variables naming the Transfer Mode and, in S3 mode, the bucket
+and credentials. Fixed for the lifetime of the process. Deliberately not a file.
+Says what a deployment may authenticate to, never which project it holds: the
+Key Prefix comes from the **otconfig** instead, because that is per-project and
+varies per lease. Credentials must never travel in an otconfig, since users save
+and share those files.
+_Avoid_: config file (there isn't one, and it invites confusion with otconfig).
+
+**Key Prefix**:
+The S3 prefix a project's Tracks and Videos live under, covering one camera or
+site. A property of the project, declared by its otconfig, and required there in
+S3 mode — so opening a different project moves where an instance reads from,
+within the one configured bucket. Until a project is loaded there is no Key
+Prefix and nothing can be listed.
+_Avoid_: path, folder (S3 has neither); startup configuration (it is per-project,
+unlike the bucket and credentials).
+
+**User Source**:
+The local directory that downloaded objects are written into, mirroring their S3
+keys, so that a Track file and its Video land side by side. Named after
+OTCloud's `S3_USER_SOURCE` for cross-repo consistency, though the name conveys
+little on its own. Its contents do not survive a restart.
+_Avoid_: cache (implies reuse across runs, which there is none of).
+
+**Load Window**:
+The start and end time a user selects to decide which Tracks and Videos to load.
+Bounded by a configured maximum duration, because continuous processing produces
+far more data than can be held at once. An over-long selection is _clamped_ —
+its end snaps to the maximum and the user is told — never rejected.
+_Avoid_: time range, date range (`DateRange` already means the filter applied to
+already-loaded Tracks, which is a different thing).
+
+**Track File Provider** / **Video File Provider**:
+What a request for input files is asked of. Each implementation owns its own way
+of asking the user, so nothing downstream knows where files came from: the local
+one opens a file chooser, the S3 one asks for a Load Window and downloads. This
+is the seam that makes the Transfer Mode interchangeable.
+_Avoid_: file loader, importer (both suggest they also parse, which they do not —
+they only obtain paths).

{otanalytics-0.7.3 → otanalytics-0.7.5}/OTAnalytics/adapter_ui/abstract_frame_filter.py

@@ -1,9 +1,10 @@
 from abc import ABC, abstractmethod
 
+from OTAnalytics.adapter_ui.abstract_frame import AbstractFrame
 from OTAnalytics.adapter_ui.dto import DateRangeDto
 
 
-class AbstractFrameFilter(ABC):
+class AbstractFrameFilter(AbstractFrame, ABC):
     @abstractmethod
     def _introduce_to_viewmodel(self) -> None:
         pass

{otanalytics-0.7.3 → otanalytics-0.7.5}/OTAnalytics/adapter_ui/abstract_frame_project.py

@@ -1,9 +1,9 @@
-from abc import abstractmethod
+from abc import ABC, abstractmethod
 from datetime import datetime
 from typing import Optional
 
 
-class AbstractFrameProject:
+class AbstractFrameProject(ABC):
     @abstractmethod
     def introduce_to_viewmodel(self) -> None:
         pass
@@ -17,7 +17,7 @@ class AbstractFrameProject:
         raise NotImplementedError
 
 
-class AbstractFrameSvzMetadata:
+class AbstractFrameSvzMetadata(ABC):
     @abstractmethod
     def introduce_to_viewmodel(self) -> None:
         pass