Refactor frame processing & add frame maxing

.gitattributes

@@ -0,0 +1,16 @@
+# See also https://help.github.com/en/github/using-git/configuring-git-to-handle-line-endings.
+
+# Set the default behavior, in case people don't have core.autocrlf set.
+* text=auto
+
+# Always normalize these file types.
+*.c text
+*.cc text
+*.cpp text
+*.cxx text
+*.h text
+*.hpp text
+*.hxx text
+*.java text
+*.txt text
+*.md text

.github/actions/download-release-asset/Dockerfile

@@ -0,0 +1,13 @@
+FROM alpine:latest
+
+RUN apk add --no-cache \
+  bash \
+  ca-certificates \
+  curl \
+  wget \
+  jq
+
+COPY download-asset.sh /usr/bin/download-asset
+RUN chmod +x /usr/bin/download-asset
+
+ENTRYPOINT ["/usr/bin/download-asset"]

.github/actions/download-release-asset/action.yml

@@ -0,0 +1,15 @@
+---
+name: download-release-asset
+description: Download release asset from Github release
+inputs:
+  filename:
+    description: Filename of asset to download
+    required: true
+branding:
+  color: yellow
+  icon: download-cloud
+runs:
+  using: docker
+  image: Dockerfile
+  args:
+  - ${{ inputs.filename }}

.github/actions/download-release-asset/download-asset.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+# Modified from https://github.com/wyozi/download-gh-release-asset
+#
+set -e
+set -o pipefail
+
+# Ensure that the GITHUB_TOKEN secret is included
+if [[ -z "${GITHUB_TOKEN}" ]]; then
+  echo "Set the GITHUB_TOKEN env variable."
+  exit 1
+fi
+
+# Ensure that the file path is present
+if [[ -z "${INPUT_FILENAME}" ]]; then
+  echo "It seems you forgot to pass the filename of the asset to download"
+  exit 1
+fi
+
+FILE="${INPUT_FILENAME}"
+
+asset_id=$(jq ".release.assets | map(select(.name == \"$FILE\"))[0].id" $GITHUB_EVENT_PATH)
+if [ "$asset_id" = "null" ]; then
+  echo "ERROR: asset id not found"
+  exit 1
+fi;
+
+AUTH_HEADER="Authorization: token ${GITHUB_TOKEN}"
+ASSET_URL="https://api.github.com/repos/${GITHUB_REPOSITORY}/releases/assets/${asset_id}"
+
+curl \
+  -L \
+  -H "${AUTH_HEADER}" \
+  -H "Accept:application/octet-stream" \
+  -o "${FILE}" \
+  "${ASSET_URL}"

.github/workflows/ci.yml

@@ -0,0 +1,129 @@
+name: CI
+on:
+  workflow_dispatch:
+    inputs:
+      debug_enabled:
+        type: boolean
+        description: 'Run the build with tmate debugging enabled (https://github.com/marketplace/actions/debugging-with-tmate)'
+        required: false
+        default: false
+  push:
+    tags-ignore:
+      - "*.*"
+    paths-ignore:
+      - "docs/**"
+    branches:
+      - "*"
+  pull_request:
+    branches:
+      - "*"
+
+jobs:
+  pre-commit:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-python@v2
+    - uses: pre-commit/action@v2.0.3
+
+  tests:
+    name: ${{ matrix.runs-on }} • py${{ matrix.python }}
+    needs: pre-commit
+    defaults:
+      run:
+        shell: bash
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runs-on: ubuntu-latest
+            python: '3.7'
+            triplet: x64-linux-mixed
+          - runs-on: ubuntu-latest
+            python: '3.8'
+            triplet: x64-linux-mixed
+          - runs-on: ubuntu-latest
+            python: '3.9'
+            triplet: x64-linux-mixed
+          - runs-on: ubuntu-latest
+            python: '3.10'
+            triplet: x64-linux-mixed
+          - runs-on: ubuntu-latest
+            python: '3.11'
+            triplet: x64-linux-mixed
+
+          - runs-on: macos-latest
+            python: '3.7'
+            triplet: x64-osx-mixed
+          - runs-on: macos-latest
+            python: '3.8'
+            triplet: x64-osx-mixed
+          - runs-on: macos-latest
+            python: '3.9'
+            triplet: x64-osx-mixed
+          - runs-on: macos-latest
+            python: '3.10'
+            triplet: x64-osx-mixed
+          - runs-on: macos-latest
+            python: '3.11'
+            triplet: x64-osx-mixed
+
+          - runs-on: windows-latest
+            python: '3.7'
+            triplet: x64-windows
+          - runs-on: windows-latest
+            python: '3.8'
+            triplet: x64-windows
+          - runs-on: windows-latest
+            python: '3.9'
+            triplet: x64-windows
+          - runs-on: windows-latest
+            python: '3.10'
+            triplet: x64-windows
+          - runs-on: windows-latest
+            python: '3.11'
+            triplet: x64-windows
+    env:
+      VCPKG_DEFAULT_TRIPLET: ${{ matrix.triplet }}
+    runs-on: ${{ matrix.runs-on }}
+
+    steps:
+    - uses: actions/checkout@v2
+
+    - uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python }}
+
+    - name: Install test dependencies
+      # TODO(jfarebro): There's a bug with Windows cmake and PEP517 builds via pip install.
+      # As a temporary workaround installing cmake outside of the isolated env seems to work.
+      run: |
+        python -m pip install --user --upgrade -r tests/requirements.txt
+        python -m pip install --user cmake
+
+    - uses: microsoft/setup-msbuild@v1.1
+      if: runner.os == 'Windows'
+    # TODO(jfarebro): 02/16/2023 - There's a bug where pkg-config isn't installed on the macOS
+    # runner. See: https://github.com/actions/runner-images/pull/7125
+    - name: Install pkg-config on macOS
+      if: runner.os == 'macOS'
+      run: brew install pkg-config
+    - uses: lukka/run-vcpkg@v10
+      with:
+        vcpkgGitCommitId: "9aa0d66373ce3a6868d12353d0d4960db0d4bd18"
+        # There's a permissions issue with the cache
+        # https://github.com/microsoft/vcpkg/issues/20121
+        doNotCache: true
+
+    - name: Build
+      run: python -m pip install --user --verbose .
+
+    - name: Test
+      run: python -m pytest
+
+    # Enable tmate debugging of manually-triggered workflows if the input option was provided
+    - name: Setup SSH debug session on failure
+      uses: mxschmitt/action-tmate@v3
+      if: ${{ github.event_name == 'workflow_dispatch' && inputs.debug_enabled && failure() }}
+      with:
+        limit-access-to-actor: true

.github/workflows/release.yml

@@ -0,0 +1,26 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  wheels:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - uses: ./.github/actions/download-release-asset
+      name: Download release wheels
+      with:
+        filename: wheels.zip
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    - name: Unzip wheels asset
+      run: |
+        unzip wheels.zip -d dist
+    - name: Publish to PyPi
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        user: __token__
+        password: ${{ secrets.PYPI_TOKEN }}
+        print_hash: true

.github/workflows/wheels.yml

@@ -0,0 +1,122 @@
+name: Wheels
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build:
+    name: ${{ matrix.runs-on }} • ${{ matrix.arch }}
+    defaults:
+      run:
+        shell: bash
+    strategy:
+      matrix:
+        include:
+          - runs-on: ubuntu-latest
+            arch: x86_64
+          - runs-on: windows-latest
+            arch: AMD64
+          - runs-on: macos-latest
+            arch: x86_64
+          - runs-on: macos-latest
+            arch: arm64
+    runs-on: ${{ matrix.runs-on }}
+    steps:
+    - uses: actions/checkout@v2
+
+    - name: Setup Docker
+      if: runner.os == 'Linux'
+      run: docker login ghcr.io --username "${GITHUB_ACTOR}" --password "${GITHUB_CR_TOKEN}"
+      env:
+        GITHUB_CR_TOKEN: ${{ secrets.CR_TOKEN }}
+
+    - name: Setup msbuild
+      if: runner.os == 'Windows'
+      uses: microsoft/setup-msbuild@v1.1
+
+    # TODO(jfarebro): 02/16/2023 - There's a bug where pkg-config isn't installed on the macOS
+    # runner. See: https://github.com/actions/runner-images/pull/7125
+    - name: Install pkg-config on macOS
+      if: runner.os == 'macOS'
+      run: brew install pkg-config
+
+    - name: Setup vcpkg
+      if: runner.os == 'macOS'  || runner.os == 'Windows'
+      uses: lukka/run-vcpkg@v10
+      with:
+        vcpkgGitCommitId: "9aa0d66373ce3a6868d12353d0d4960db0d4bd18"
+        # There's a permissions issue with the cache
+        # https://github.com/microsoft/vcpkg/issues/20121
+        doNotCache: true
+
+    - name: Build wheels
+      uses: pypa/cibuildwheel@v2.12.0
+      env:
+        CIBW_ARCHS: "${{ matrix.arch }}"
+
+    - name: Upload wheels
+      uses: actions/upload-artifact@v2
+      with:
+        name: wheels
+        path: ./wheelhouse/*.whl
+
+
+  pypi:
+    name: Deploy wheels to PyPi test
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - uses: actions/download-artifact@v1
+        with:
+          name: wheels
+
+      - name: Append PyPi test SHA
+        run: |
+          find wheels -type f -exec sh -c \
+            "mv {} \$(echo {} | awk -F\"-\" '{OFS = FS; \$2 = \$2\"+${GITHUB_SHA::7}\"; print}')" \;
+
+      - name: Publish to PyPi test
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI_TEST_TOKEN }}
+          repository_url: https://test.pypi.org/legacy/
+          packages_dir: wheels/
+          print_hash: true
+
+
+  release:
+    name: Stage wheels to Github releases
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - uses: actions/download-artifact@v1
+        with:
+          name: wheels
+
+      - name: Create wheel archive
+        run: |
+          zip --junk-paths wheels wheels/*
+
+      - name: Create release
+        id: create_release
+        uses: actions/create-release@v1.0.0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: ${{ github.ref }}
+          release_name: Release ${{ github.ref }}
+          draft: true
+          prerelease: ${{ contains(github.ref, '-') }}
+
+      - name: Upload artifacts to release
+        uses: actions/upload-release-asset@v1.0.1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          upload_url: ${{ steps.create_release.outputs.upload_url }}
+          asset_path: ./wheels.zip
+          asset_name: wheels.zip
+          asset_content_type: application/zip

.gitignore

@@ -27,3 +27,8 @@ doc/examples/*Example
 *.lai
 *.la
 *.a
+
+# Python
+*.pyc
+
+*.egg-info/

.pre-commit-config.yaml

@@ -0,0 +1,12 @@
+repos:
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v2.3.0
+    hooks:
+    -   id: check-yaml
+    -   id: end-of-file-fixer
+    -   id: trailing-whitespace
+    -   id: debug-statements
+-   repo: https://github.com/psf/black
+    rev: 22.3.0
+    hooks:
+    -   id: black