tryx 1.1.1__tar.gz → 1.4.2__tar.gz

tryx-1.4.2/.github/workflows/CI.yml

@@ -0,0 +1,291 @@
+name: CI
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_run:
+    workflows: ["Release"]
+    types: [completed]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: false
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  quality:
+    name: Quality Checks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: astral-sh/setup-uv@v5
+      - uses: dtolnay/rust-toolchain@stable
+      - name: Install dev dependencies
+        run: uv sync --group dev --no-install-project
+      - name: Ruff lint
+        run: uv run --no-project ruff check .
+      - name: Ruff format check
+        run: uv run --no-project ruff format --check .
+
+  tests:
+    name: Python Tests
+    needs: quality
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: astral-sh/setup-uv@v5
+      - uses: dtolnay/rust-toolchain@stable
+      - name: Rust cache (tryx root)
+        uses: Swatinem/rust-cache@v2
+
+      - name: Rust cache (whatsapp-rust workspace)
+        uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: "libs/whatsapp-rust -> target"
+      - name: Install dev dependencies
+        run: uv sync --group dev --no-install-project
+      - name: Build native extension
+        run: uv run maturin develop
+      - name: Run pytest
+        run: uv run pytest -q
+
+  linux:
+    name: Linux manylinux wheels
+    needs: [quality, tests]
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - runner: ubuntu-22.04
+            target: x86_64
+          - runner: ubuntu-22.04
+            target: aarch64
+          - runner: ubuntu-22.04
+            target: i686
+          - runner: ubuntu-22.04
+            target: s390x
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Setup QEMU
+        if: matrix.platform.target != 'x86_64'
+        uses: docker/setup-qemu-action@v3
+        with:
+          platforms: ${{ matrix.platform.target }}
+      - name: Workaround ring ARM asm macro in cross builds
+        if: matrix.platform.target == 'aarch64'
+        run: echo "CFLAGS_aarch64_unknown_linux_gnu=-D__ARM_ARCH=8" >> "$GITHUB_ENV"
+      - uses: dtolnay/rust-toolchain@stable
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') && matrix.platform.target != 'aarch64' }}
+          manylinux: auto
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-linux-${{ matrix.platform.target }}
+          path: dist
+
+  android:
+    name: Android wheels
+    needs: [quality, tests]
+    runs-on: ubuntu-22.04
+    strategy:
+      fail-fast: false
+      matrix:
+        target:
+          - aarch64
+          - x86_64
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.target }}-linux-android
+      - name: Setup Android NDK
+        uses: nttld/setup-ndk@v1
+        with:
+          ndk-version: r27d
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}-linux-android
+          args: --release --out dist
+          container: off
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-android-${{ matrix.target }}
+          path: dist
+
+  windows:
+    name: Windows wheels
+    needs: [quality, tests]
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - runner: windows-latest
+            target: x64
+            python_arch: x64
+          - runner: windows-latest
+            target: x86
+            python_arch: x86
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          architecture: ${{ matrix.platform.python_arch }}
+      - uses: dtolnay/rust-toolchain@stable
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-windows-${{ matrix.platform.target }}
+          path: dist
+
+  macos:
+    name: macOS wheels
+    needs: [quality, tests]
+    # Both targets use macos-latest (Apple Silicon) — x86_64 is cross-compiled.
+    # macos-13 runners have very long queues (12h+); macos-latest is faster.
+    runs-on: macos-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        target: [aarch64, x86_64]
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.target }}-apple-darwin
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-macos-${{ matrix.target }}
+          path: dist
+
+  sdist:
+    name: Source distribution
+    needs: [quality, tests]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - uses: dtolnay/rust-toolchain@stable
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - name: Upload sdist
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-sdist
+          path: dist
+
+  release:
+    name: Publish to PyPI
+    if: >
+      ${{
+        github.event_name == 'workflow_run' &&
+        github.event.workflow_run.conclusion == 'success'
+      }}
+    needs: [linux, android, windows, macos, sdist]
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - name: Log release context
+        run: |
+          echo "event=${GITHUB_EVENT_NAME}"
+          echo "ref=${GITHUB_REF}"
+          echo "sha=${GITHUB_SHA}"
+
+      - name: Download wheel artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist
+
+      - name: Ensure PyPI token exists
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          if [ -z "${UV_PUBLISH_TOKEN}" ]; then
+            echo "::error::Missing PYPI_API_TOKEN secret."
+            exit 1
+          fi
+
+      - name: Validate release artifacts
+        run: |
+          set -euo pipefail
+          shopt -s nullglob
+          files=(dist/*)
+          if [ ${#files[@]} -eq 0 ]; then
+            echo "::error::No artifacts found in dist/."
+            exit 1
+          fi
+          printf '%s\n' "${files[@]}"
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Publish artifacts
+        run: uv publish dist/*
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}

tryx-1.4.2/.github/workflows/docs.yml

@@ -0,0 +1,146 @@
+name: Documentation
+
+on:
+  push:
+    branches: [master, main, dev]
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - "python/tryx/**"
+
+  pull_request:
+    branches: [master, main, dev]
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - "python/tryx/**"
+
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Version to deploy (e.g. 0.7, 0.8)"
+        required: false
+        type: string
+
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+
+concurrency:
+  group: docs-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  # ── Job 1: Validate (runs on PR + push) ────────────────────────────────────
+  validate:
+    name: Validate Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: astral-sh/setup-uv@v5
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - name: Install dependencies
+        run: uv sync --group dev --group docs --no-install-project
+
+      - name: Validate .pyi stubs with pyright
+        run: |
+          uv run --no-project pyright python/tryx/client.pyi \
+                 python/tryx/events.pyi \
+                 python/tryx/types.pyi \
+                 python/tryx/wacore.pyi \
+                 python/tryx/helpers.pyi \
+                 python/tryx/backend.pyi \
+                 python/tryx/exceptions.pyi \
+                 python/tryx/__init__.pyi \
+                 python/tryx/tryx.pyi \
+                 python/tryx/media.pyi
+
+      - name: Validate .pyi stubs with mypy
+        run: |
+          uv run --no-project mypy python/tryx/client.pyi \
+               python/tryx/events.pyi \
+               python/tryx/types.pyi \
+               python/tryx/wacore.pyi \
+               python/tryx/helpers.pyi \
+               python/tryx/backend.pyi \
+               python/tryx/exceptions.pyi \
+               python/tryx/__init__.pyi \
+               python/tryx/tryx.pyi \
+               python/tryx/media.pyi \
+               --ignore-missing-imports
+
+      - name: Build docs (validation only)
+        run: uv run --no-project zensical build -f mkdocs.yml -s
+
+  # ── Job 2: Deploy (runs on push or manual trigger) ─────────────────────────
+  deploy:
+    name: Deploy Documentation
+    needs: validate
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' || github.event_name == 'workflow_dispatch'
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          submodules: recursive
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Install dependencies
+        run: uv sync --group dev --group docs --no-install-project
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      # Auto-deploy from tag → versioned docs (e.g. v0.8.0 → "0.8")
+      - name: Deploy versioned docs (from tag)
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          VERSION=$(echo "${{ github.ref_name }}" | sed 's/^v//' | sed 's/\.[0-9]*$//')
+          echo "Deploying docs for version: $VERSION"
+          uv run --no-project mike deploy --push --update-aliases "$VERSION" latest
+          uv run --no-project mike set-default --push latest
+
+      # Auto-deploy from master → "dev" version
+      - name: Deploy dev docs (from master)
+        if: "!startsWith(github.ref, 'refs/tags/') && github.event_name == 'push'"
+        run: |
+          echo "Deploying docs as dev"
+          uv run --no-project mike deploy --push --update-aliases dev latest
+          uv run --no-project mike set-default --push latest
+
+      # Manual deploy with custom version
+      - name: Deploy custom version (manual)
+        if: github.event_name == 'workflow_dispatch' && inputs.version != ''
+        run: |
+          echo "Deploying docs for version: ${{ inputs.version }}"
+          uv run --no-project mike deploy --push --update-aliases "${{ inputs.version }}" latest
+          uv run --no-project mike set-default --push latest
+
+      # Manual deploy without version → deploy as dev
+      - name: Deploy dev docs (manual)
+        if: github.event_name == 'workflow_dispatch' && inputs.version == ''
+        run: |
+          echo "Deploying docs as dev"
+          uv run --no-project mike deploy --push --update-aliases dev latest
+          uv run --no-project mike set-default --push latest
+
+      - name: List deployed versions
+        if: success()
+        run: uv run --no-project mike list

tryx-1.4.2/.github/workflows/pr-check.yml

@@ -0,0 +1,138 @@
+name: PR Check
+
+on:
+  pull_request:
+    branches: [master, main, dev]
+
+permissions:
+  contents: read
+
+jobs:
+  quality:
+    name: Quality Checks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: astral-sh/setup-uv@v5
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - name: Install dev dependencies
+        run: uv sync --group dev --no-install-project
+
+      - name: Ruff lint
+        run: uv run --no-project ruff check .
+
+      - name: Ruff format check
+        run: uv run --no-project ruff format --check .
+
+  tests:
+    name: Python Tests
+    needs: quality
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: astral-sh/setup-uv@v5
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - name: Rust cache (tryx root)
+        uses: Swatinem/rust-cache@v2
+
+      - name: Rust cache (whatsapp-rust workspace)
+        uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: "libs/whatsapp-rust -> target"
+
+      - name: Install dev dependencies
+        run: uv sync --group dev --no-install-project
+
+      - name: Build native extension
+        run: uv run maturin develop
+
+      - name: Run pytest
+        run: uv run pytest -q
+
+  stubs:
+    name: Type Stubs Check
+    needs: quality
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: astral-sh/setup-uv@v5
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - name: Install dependencies
+        run: uv sync --group dev --group docs --no-install-project
+
+      - name: Validate .pyi stubs with pyright
+        run: |
+          uv run --no-project pyright python/tryx/client.pyi \
+                 python/tryx/events.pyi \
+                 python/tryx/types.pyi \
+                 python/tryx/wacore.pyi \
+                 python/tryx/helpers.pyi \
+                 python/tryx/backend.pyi \
+                 python/tryx/exceptions.pyi \
+                 python/tryx/__init__.pyi \
+                 python/tryx/tryx.pyi \
+                 python/tryx/media.pyi
+
+      - name: Validate .pyi stubs with mypy
+        run: |
+          uv run --no-project mypy python/tryx/client.pyi \
+               python/tryx/events.pyi \
+               python/tryx/types.pyi \
+               python/tryx/wacore.pyi \
+               python/tryx/helpers.pyi \
+               python/tryx/backend.pyi \
+               python/tryx/exceptions.pyi \
+               python/tryx/__init__.pyi \
+               python/tryx/tryx.pyi \
+               python/tryx/media.pyi \
+               --ignore-missing-imports
+
+  docs:
+    name: Documentation Build
+    needs: quality
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: astral-sh/setup-uv@v5
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - name: Install dependencies
+        run: uv sync --group dev --group docs --no-install-project
+
+      - name: Build docs (validation only)
+        run: uv run --no-project zensical build -f mkdocs.yml -s

tryx-1.4.2/.github/workflows/release.yml

@@ -0,0 +1,51 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - master
+      - main
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Semantic Release
+    runs-on: ubuntu-latest
+    # Only run if the commit is NOT from semantic-release itself
+    if: "!contains(github.event.head_commit.message, 'Automatically generated by python-semantic-release')"
+    concurrency: release
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          submodules: recursive
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: astral-sh/setup-uv@v5
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - name: Install dependencies
+        run: uv sync --group dev --no-install-project
+
+      - name: Python Semantic Release
+        id: release
+        run: uv run --no-project python -m semantic_release version
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Print release info
+        if: steps.release.outcome == 'success'
+        run: |
+          echo "✅ Release completed"
+          echo "Tag: ${{ steps.release.outputs.tag }}"
+          echo "Version: ${{ steps.release.outputs.version }}"
+          echo "Major: ${{ steps.release.outputs.major }}"
+          echo "Minor: ${{ steps.release.outputs.minor }}"
+          echo "Patch: ${{ steps.release.outputs.patch }}"

tryx-1.4.2/.pre-commit-config.yaml

@@ -0,0 +1,47 @@
+minimum_pre_commit_version: "3.7.0"
+default_install_hook_types: [pre-commit, commit-msg]
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-json
+
+  - repo: local
+    hooks:
+      - id: ruff-check
+        name: ruff check
+        entry: uv run --no-project ruff check --fix
+        language: system
+        types_or: [python, pyi]
+
+      - id: ruff-format
+        name: ruff format
+        entry: uv run --no-project ruff format
+        language: system
+        types_or: [python, pyi]
+
+      - id: pyright
+        name: pyright type check
+        entry: uv run --no-project pyright
+        language: system
+        types: [python]
+        pass_filenames: false
+        files: "^python/tryx/.*\\.(py|pyi)$"
+
+      - id: stub-parity
+        name: check stub parity
+        entry: uv run --no-project python scripts/check_stub_parity.py
+        language: system
+        pass_filenames: false
+        files: "^python/tryx/.*\\.(py|pyi)$"
+
+      - id: conventional-commit-message
+        name: conventional commit message
+        entry: uv run --no-project python scripts/check_commit_message.py
+        language: system
+        stages: [commit-msg]