pyvoy 1.3.0__tar.gz

pyvoy-1.3.0/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

pyvoy-1.3.0/.github/workflows/bench.yaml

@@ -0,0 +1,42 @@
+name: Benchmark
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "src/**"
+      - "Cargo.lock"
+      - "bench/**"
+      - ".github/workflows/bench.yaml"
+  # Just verify the harness on PRs, no need for actual numbers
+  pull_request:
+    paths:
+      - "bench/**"
+      - ".github/workflows/bench.yaml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  bench:
+    runs-on: ubuntu-24.04
+    strategy:
+      fail-fast: false
+      matrix:
+        # Overkill to benchmark with every Python version, we just use the latest.
+        python:
+          - "3.14"
+          - "3.14t"
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+
+      - run: rustup update
+
+      - run: cargo install --features http3 oha
+
+      - run: uv sync --python ${{ matrix.python }} --managed-python
+
+      - run: uv run poe bench ${{ github.event_name == 'pull_request' && '--short' || '' }}

pyvoy-1.3.0/.github/workflows/ci.yaml

@@ -0,0 +1,106 @@
+name: CI
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  attestations: write
+  id-token: write
+
+concurrency:
+  # Cancel in-progress jobs for PRs only
+  group: ${{ github.workflow }}-${{ github.ref == 'refs/heads/main' && github.sha || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - macos-15
+          - ubuntu-24.04
+          - windows-2025
+        python:
+          - "3.11"
+          - "3.14"
+        # Test oldest and newest on all OS's, but others only on one
+        # to save CI load.
+        include:
+          - os: ubuntu-24.04
+            python: "3.11"
+          - os: ubuntu-24.04
+            python: "3.12"
+          - os: ubuntu-24.04
+            python: "3.13"
+          - os: ubuntu-24.04
+            python: "3.14t"
+          # Enable coverage on just one job
+          - os: ubuntu-24.04
+            python: "3.14"
+            coverage: "cov"
+          - os: ubuntu-24.04
+            python: "3.15"
+          - os: ubuntu-24.04
+            python: "3.15t"
+
+    env:
+      # Avoid multiple compile e.g. in lint and test by setting as a job env var
+      RUSTFLAGS: ${{ matrix.coverage == 'cov' && '-C instrument-coverage' || '' }}
+      # Test the abi3 build on the oldest versions, and version-specific builds on the rest.
+      MATURIN_PEP517_ARGS: ${{ (matrix.python == '3.11' || matrix.python == '3.12') && '--features pyo3/abi3-py311' || '' }}
+
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        with:
+          python-version: ${{ matrix.python }}
+
+      - name: Setup rust
+        run: |
+          rustup update
+          ${{ matrix.coverage == 'cov' && 'rustup component add llvm-tools' || '' }}
+
+      - run: uv lock --check
+
+      # Go ahead and run lint on all Python versions since we may have version-specific
+      # guards in rust in the future.
+      - name: run lints
+        if: startsWith(matrix.os, 'ubuntu-')
+        run: uv run poe lint
+
+      - name: run tests
+        # Coverage instrumentation slows websockets compression down too much while the integration test has
+        # relatively tight timeouts.
+        run: uv run poe test ${{ github.event_name == 'push' && matrix.coverage != 'cov' && '--full' || '' }}
+
+      # Needed for connect integration tests runner
+      - uses: actions/setup-go@b7ad1dad31e06c5925ef5d2fc7ad053ef454303e # v7.0.0
+        if: github.event_name == 'push' && matrix.python != '3.14t' && !startsWith(matrix.os, 'windows-')
+        with:
+          go-version: stable
+
+      - name: run connect integration tests on push
+        # TODO: Enable on free-threaded Python after publishing a wheel for it.
+        # The integration test first installs pyvoy from PyPi before we reinstall from local
+        # and it's tricky to avoid that.
+        if: github.event_name == 'push' && matrix.python != '3.15t' && !startsWith(matrix.os, 'windows-')
+        run: uv run poe integration-test-connect
+
+      - name: verify wheel build
+        run: uv run poe wheel
+
+      - name: prepare coverage
+        if: ${{ matrix.coverage == 'cov' }}
+        run: |
+          $(rustc --print=target-libdir)/../bin/llvm-profdata merge -sparse default_*.profraw -o tests.profdata
+          $(rustc --print=target-libdir)/../bin/llvm-cov export -format=lcov --ignore-filename-regex='/.cargo/registry' --ignore-filename-regex='.cargo/git/checkouts' --ignore-filename-regex='.rustup/toolchains' -instr-profile tests.profdata pyvoy/_pyvoy.*.so > tests.lcov
+
+      - uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
+        if: ${{ matrix.coverage == 'cov' }}

pyvoy-1.3.0/.github/workflows/codeql.yml

@@ -0,0 +1,41 @@
+name: "CodeQL"
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+  schedule:
+    - cron: "44 7 * * 2"
+
+jobs:
+  analyze:
+    name: Analyze (${{ matrix.language }})
+    runs-on: ubuntu-latest
+    permissions:
+      security-events: write
+      packages: read
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - language: actions
+            build-mode: none
+          - language: python
+            build-mode: none
+          - language: rust
+            build-mode: none
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@2892aa5e19bbd11bc0cff5427e3b750a04d9e3c2 # v4.38.2
+        with:
+          languages: ${{ matrix.language }}
+          build-mode: ${{ matrix.build-mode }}
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@2892aa5e19bbd11bc0cff5427e3b750a04d9e3c2 # v4.38.2
+        with:
+          category: "/language:${{matrix.language}}"

pyvoy-1.3.0/.github/workflows/docs.yaml

@@ -0,0 +1,49 @@
+name: Documentation
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "docs/**"
+      - zensical.toml
+      - ".github/workflows/docs.yaml"
+  pull_request:
+    paths:
+      - "docs/**"
+      - zensical.toml
+      - ".github/workflows/docs.yaml"
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    environment:
+      name: ${{ github.event_name != 'pull_request' && 'github-pages' || null }}
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-24.04
+
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.14"
+
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+
+      - run: uv run --group docs --no-dev zensical build --clean
+
+      - uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0
+        if: github.event_name != 'pull_request'
+        with:
+          path: site
+
+      - uses: actions/deploy-pages@368f82528645a54fb793d4d04e342629a3f51346 # v5.0.1
+        if: github.event_name != 'pull_request'
+        id: deployment

pyvoy-1.3.0/.github/workflows/release.yaml

@@ -0,0 +1,120 @@
+name: Release
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+  pull_request:
+    paths:
+      - .github/workflows/release.yaml
+
+permissions:
+  id-token: write
+  attestations: write
+  contents: write
+
+env:
+  # When bumping, also bump MATURIN_PEP517_ARGS in ci.yaml
+  # maturin flags to build targets we publish non-abi3 wheels for
+  UNSTABLE_API_FLAGS: -i 3.13 -i 3.14 -i 3.14t -i 3.15 -i 3.15t
+  # maturin flags to build targets we publish abi3 wheels for
+  ABI3_FLAGS: -i 3.11 --features pyo3/abi3-py311
+  ABI3T_FLAGS: -i 3.15t --features pyo3/abi3t-py315
+
+jobs:
+  ext:
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      matrix:
+        include:
+          - runner: ubuntu-24.04
+            target: x86_64
+            manylinux: manylinux_2_28
+          - runner: ubuntu-24.04
+            target: x86_64
+            manylinux: musllinux_1_2
+          - runner: ubuntu-24.04-arm
+            target: aarch64
+            manylinux: manylinux_2_28
+          - runner: ubuntu-24.04-arm
+            target: aarch64
+            manylinux: musllinux_1_2
+          - runner: windows-2025
+            target: x86_64
+          - runner: windows-11-arm
+            target: aarch64
+          - runner: macos-15
+            target: aarch64
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      # We only publish abi3 wheels for Windows
+      - name: Build wheels
+        if: runner.os != 'Windows'
+        uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist ${{ env.UNSTABLE_API_FLAGS }}
+          sccache: true
+          manylinux: ${{ matrix.manylinux }}
+          before-script-linux: ${{ matrix.manylinux == 'manylinux_2_28' && 'dnf install -y clang' || 'apt-get install -y libclang-dev' }}
+
+      - name: Build abi3 wheel
+        uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist ${{ env.ABI3_FLAGS }}
+          sccache: true
+          manylinux: ${{ matrix.manylinux }}
+          before-script-linux: ${{ matrix.manylinux == 'manylinux_2_28' && 'dnf install -y clang' || 'apt-get install -y libclang-dev' }}
+
+      - name: Build abi3t wheel
+        uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist ${{ env.ABI3T_FLAGS }}
+          sccache: true
+          manylinux: ${{ matrix.manylinux }}
+          before-script-linux: ${{ matrix.manylinux == 'manylinux_2_28' && 'dnf install -y clang' || 'apt-get install -y libclang-dev' }}
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: wheels-${{ matrix.runner }}-${{ matrix.target }}${{ matrix.manylinux && format('-{0}', matrix.manylinux) || '' }}
+          path: dist
+
+  ext-sdist:
+    runs-on: ubuntu-26.04
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - name: Build sdist
+        uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          command: sdist
+          args: --out dist
+
+      - name: Upload sdist
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: wheels-sdist
+          path: dist
+
+  release:
+    runs-on: ubuntu-26.04
+    environment: ${{ github.event_name == 'push' && 'prod' || github.event_name == 'workflow_dispatch' && 'dev' || null }}
+    needs:
+      - ext
+      - ext-sdist
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          path: dist/
+          merge-multiple: true
+
+      - name: publish all packages
+        if: github.event_name != 'pull_request'
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        with:
+          repository-url: ${{ github.event_name == 'workflow_dispatch' && 'https://test.pypi.org/legacy/' || null }}
+          skip-existing: true

pyvoy-1.3.0/.github/workflows/renovate.yaml

@@ -0,0 +1,18 @@
+name: Renovate Dependencies
+
+on:
+  schedule:
+    # https://crontab.guru/#5_12_*_*_1
+    - cron: "5 12 * * 1"
+  workflow_dispatch:
+
+# Uses app token so default token needs no permissions
+permissions: {}
+
+jobs:
+  renovate:
+    uses: curioswitch/go-build/.github/workflows/export-renovate.yaml@7d855da299ce7a10188c909a58328fc21ed89c40 # v0.9.0
+    with:
+      github_app_id: "1047503"
+    secrets:
+      github_app_key: ${{ secrets.CURIOSWITCH_APP_KEY }}

pyvoy-1.3.0/.gitignore

@@ -0,0 +1,23 @@
+debug
+target
+
+__pycache__
+.venv
+
+.envrc
+.idea
+.vscode
+
+pyvoy/_pyvoy.*
+
+*.profraw
+*.profdata
+*.lcov
+
+profile.json.gz
+
+out
+site
+.DS_Store
+
+wstest/reports

pyvoy-1.3.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,31 @@
+This project follows the CurioSwitch code of conduct.
+
+> [!WARNING]
+> Any following content is overridden by the laws of CurioSwitch's residing country, Japan.
+> For example, things like death threats will be dealt with strictly.
+
+There is just one guideline: be fair. It is not possible to define fairness precisely
+but consider these examples when thinking about it.
+
+Fair:
+
+- Respond promptly to submitted issues / PRs.
+  - Contributors spend time on submissions and it is not fair to not do the same in return.
+- Aim for robust / tested code and systems.
+  - It is not fair to users to give them a tool that only half-works and causes them frustration.
+- Acknowledge others' points, even if disagreeing, instead of ignoring.
+  - People engage in good faith, and it is not fair to leave it wasted.
+
+Unfair:
+
+- Keep issues about bugs or significant pain points open for a long time or suggest the contributor can raise a PR.
+  - Users are not maintainers and it is not fair to expect them to become one to fix a bug
+    (it is always welcome when they have the time and will to contribute though).
+- Prioritize issues and discussions with friends, acquaintances, or those in the same timezone over others.
+  - This is OSS and it is not fair to create boundaries or factions within it.
+
+We are not perfect and may act in a way that isn't fair. This is fine and generally will not
+need punitive measures - we will aim to improve over time. But do accept feedback about it in
+good faith and respond to it fairly. If you need to provide feedback related to the above in
+a private matter, feel free to email oss@curioswitch.org and we will aim to help in a fair
+manner.