trainingsample 0.3.0__tar.gz → 0.3.2__tar.gz

{trainingsample-0.3.0 → trainingsample-0.3.2}/.github/workflows/ci.yml

@@ -108,7 +108,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.11", "3.12", "3.13"]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
 
     steps:
     - uses: actions/checkout@v4
@@ -387,7 +387,7 @@ jobs:
     runs-on: ubuntu-24.04-arm
     strategy:
       matrix:
-        python: ["3.11", "3.12", "3.13"]
+        python: ["3.11", "3.12", "3.13", "3.14"]
 
     steps:
     - uses: actions/checkout@v4
@@ -434,7 +434,6 @@ jobs:
         container: off
         manylinux: manylinux_2_39
       env:
-        PYO3_USE_ABI3_FORWARD_COMPATIBILITY: '1'
         LIBCLANG_PATH: ${{ env.LIBCLANG_PATH }}
         LLVM_CONFIG_PATH: ${{ env.LLVM_CONFIG_PATH }}
         OPENCV_INCLUDE_PATHS: ${{ github.workspace }}/third_party/opencv-static/include/opencv4

{trainingsample-0.3.0 → trainingsample-0.3.2}/.github/workflows/publish.yml

@@ -25,6 +25,10 @@ jobs:
             target: x86_64
             manylinux: manylinux_2_35
             python: '3.13'
+          - os: ubuntu-22.04
+            target: x86_64
+            manylinux: manylinux_2_35
+            python: '3.14'
           # Ubuntu 24.04 (libc 2.39)
           - os: ubuntu-24.04
             target: x86_64
@@ -38,6 +42,10 @@ jobs:
             target: x86_64
             manylinux: manylinux_2_39
             python: '3.13'
+          - os: ubuntu-24.04
+            target: x86_64
+            manylinux: manylinux_2_39
+            python: '3.14'
     steps:
     - uses: actions/checkout@v4
     - uses: actions/setup-python@v5
@@ -104,8 +112,6 @@ jobs:
         container: off
         manylinux: ${{ matrix.manylinux }}
       env:
-        # Use stable ABI for forward compatibility
-        PYO3_USE_ABI3_FORWARD_COMPATIBILITY: '1'
         # LLVM for opencv-rust bindings (from earlier install step)
         LIBCLANG_PATH: ${{ env.LIBCLANG_PATH }}
         LLVM_CONFIG_PATH: ${{ env.LLVM_CONFIG_PATH }}
@@ -135,7 +141,7 @@ jobs:
     runs-on: ubuntu-24.04-arm
     strategy:
       matrix:
-        python: ['3.11', '3.12', '3.13']
+        python: ['3.11', '3.12', '3.13', '3.14']
     steps:
     - uses: actions/checkout@v4
     - uses: actions/setup-python@v5
@@ -186,8 +192,6 @@ jobs:
         container: off
         manylinux: manylinux_2_39
       env:
-        # Use stable ABI for forward compatibility
-        PYO3_USE_ABI3_FORWARD_COMPATIBILITY: '1'
         # LLVM for opencv-rust bindings (from earlier install step)
         LIBCLANG_PATH: ${{ env.LIBCLANG_PATH }}
         LLVM_CONFIG_PATH: ${{ env.LLVM_CONFIG_PATH }}
@@ -217,7 +221,7 @@ jobs:
     strategy:
       matrix:
         target: [aarch64]
-        python: ['3.11', '3.12', '3.13']
+        python: ['3.11', '3.12', '3.13', '3.14']
     steps:
     - uses: actions/checkout@v4
     - uses: actions/setup-python@v5
@@ -251,8 +255,6 @@ jobs:
         args: --release --out dist -i python --no-default-features --features python-bindings,simd,opencv,metal
         sccache: 'false'
       env:
-        # Use stable ABI for forward compatibility
-        PYO3_USE_ABI3_FORWARD_COMPATIBILITY: '1'
         # OpenCV static linking configuration
         OPENCV_INCLUDE_PATHS: ${{ github.workspace }}/third_party/opencv-static/include/opencv4
         OPENCV_LINK_PATHS: ${{ github.workspace }}/third_party/opencv-static/lib
@@ -306,6 +308,11 @@ jobs:
             manylinux: manylinux_2_35
             python: '3.13'
             artifact_name: wheels-ubuntu-22.04-x86_64-py3.13
+          - os: ubuntu-22.04
+            target: x86_64
+            manylinux: manylinux_2_35
+            python: '3.14'
+            artifact_name: wheels-ubuntu-22.04-x86_64-py3.14
           # Ubuntu 24.04 (libc 2.39)
           - os: ubuntu-24.04
             target: x86_64
@@ -322,6 +329,11 @@ jobs:
             manylinux: manylinux_2_39
             python: '3.13'
             artifact_name: wheels-ubuntu-24.04-x86_64-py3.13
+          - os: ubuntu-24.04
+            target: x86_64
+            manylinux: manylinux_2_39
+            python: '3.14'
+            artifact_name: wheels-ubuntu-24.04-x86_64-py3.14
           # Linux aarch64 (DGX Spark / GB10)
           - os: ubuntu-24.04-arm
             target: aarch64
@@ -338,6 +350,11 @@ jobs:
             manylinux: manylinux_2_39
             python: '3.13'
             artifact_name: wheels-linux-aarch64-py3.13
+          - os: ubuntu-24.04-arm
+            target: aarch64
+            manylinux: manylinux_2_39
+            python: '3.14'
+            artifact_name: wheels-linux-aarch64-py3.14
           # macOS aarch64
           - os: macos-latest
             target: aarch64
@@ -354,6 +371,11 @@ jobs:
             manylinux: ''
             python: '3.13'
             artifact_name: wheels-macos-latest-aarch64-py3.13
+          - os: macos-latest
+            target: aarch64
+            manylinux: ''
+            python: '3.14'
+            artifact_name: wheels-macos-latest-aarch64-py3.14
     steps:
     - uses: actions/download-artifact@v4
       with:

trainingsample-0.3.2/BENCHMARKS.md

@@ -0,0 +1,102 @@
+# Benchmarks
+
+## Commands
+
+Build the current checkout before measuring:
+
+```bash
+python -m venv .venv
+.venv/bin/python -m pip install -e '.[dev]'
+.venv/bin/maturin develop --release
+```
+
+Run the performance suite:
+
+```bash
+.venv/bin/python -m pytest tests/test_performance_benchmarks.py -q -s
+```
+
+Run pytest-benchmark cases only:
+
+```bash
+.venv/bin/python -m pytest \
+  tests/test_performance_benchmarks.py::TestDetailedBenchmarks \
+  --benchmark-only
+```
+
+Save machine-readable results:
+
+```bash
+.venv/bin/python -m pytest \
+  tests/test_performance_benchmarks.py::TestDetailedBenchmarks \
+  --benchmark-only \
+  --benchmark-json benchmark.json
+```
+
+## Measured operations
+
+| Case | TrainingSample call | Reference |
+|---|---|---|
+| Crop | `batch_crop_images` | NumPy slicing |
+| Resize | `batch_resize_images` | direct `cv2.resize(..., INTER_LINEAR)` loop |
+| Luminance | `batch_calculate_luminance` | `cv2.cvtColor(..., COLOR_RGB2GRAY)` plus `numpy.mean` |
+| Pipeline | resize, then luminance | equivalent OpenCV loop |
+| Video resize | `batch_resize_videos` | no external baseline |
+| Center crop | `batch_center_crop_images` | no external baseline |
+
+## Comparison constraints
+
+| Topic | Constraint |
+|---|---|
+| Crop ownership | TrainingSample returns owned arrays; plain NumPy slicing returns views |
+| Resize color order | Resize is applied directly to the same RGB byte arrays; no RGB/BGR conversion is included |
+| Resize interpolation | Both resize paths use linear interpolation |
+| Luminance input | Both paths interpret the input as RGB |
+| Batch shape | Mixed-shape inputs are processed one image at a time by the OpenCV reference loop |
+| Build mode | Measure release builds only |
+
+NumPy view-returning crop timings do not measure the cost of producing owned,
+contiguous output. Use `.copy()` when owned-output cost is the subject of the
+comparison.
+
+## Result metadata
+
+Record these fields with timing results:
+
+```text
+git commit
+operating system and architecture
+CPU model
+Python version
+NumPy version
+TrainingSample version
+Rust OpenCV version and link mode
+Python cv2 version
+OpenCV thread count
+input shapes and dtypes
+batch size
+target sizes
+warm-up count
+sample count
+median and dispersion
+```
+
+## Test behavior
+
+The performance file contains both benchmarks and assertions.
+
+| Assertion type | Examples |
+|---|---|
+| Correctness | output count, shape, dtype, pixel equality, luminance tolerance |
+| Resource behavior | repeated calls, concurrent calls, memory cleanup |
+| Broad timing guard | completion limits and scaling bounds intended for CI |
+| Statistical timing | pytest-benchmark cases in `TestDetailedBenchmarks` |
+
+Single-run `time.perf_counter` output is diagnostic. It is not a stable result
+across hosts or OpenCV builds.
+
+## Published numbers
+
+This repository does not currently store benchmark artifacts keyed by commit,
+host, and OpenCV configuration. Fixed timing tables are therefore not included
+in this document.