tryx 0.2.0__tar.gz

tryx-0.2.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,74 @@
+name: Bug Report
+description: Report a bug or regression in Tryx
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for filing a bug report. Please provide enough detail for reproducibility.
+
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What is the bug?
+      placeholder: Short and clear bug summary
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: Include exact steps and sample code if possible.
+      placeholder: |
+        1. ...
+        2. ...
+        3. ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs / Traceback
+      description: Paste relevant logs or traceback.
+      render: shell
+
+  - type: input
+    id: version
+    attributes:
+      label: Tryx Version
+      placeholder: e.g. 0.2.1
+    validations:
+      required: true
+
+  - type: input
+    id: python
+    attributes:
+      label: Python Version
+      placeholder: e.g. 3.12.3
+    validations:
+      required: true
+
+  - type: input
+    id: os
+    attributes:
+      label: OS
+      placeholder: e.g. Ubuntu 24.04 / macOS 15 / Windows 11
+    validations:
+      required: true

tryx-0.2.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Documentation
+    url: https://krypton-byte.github.io/tryx/
+    about: Check docs for installation, API usage, and troubleshooting.

tryx-0.2.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,36 @@
+name: Feature Request
+description: Suggest an improvement for Tryx
+labels: [enhancement]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the suggestion. Please describe the use case and expected API/behavior.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem are you trying to solve?
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed Solution
+      description: Describe the desired behavior or API.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Optional alternatives or workarounds.
+
+  - type: textarea
+    id: impact
+    attributes:
+      label: Impact
+      description: Who benefits and what areas are affected?

tryx-0.2.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,29 @@
+## Summary
+
+<!-- What changed and why? -->
+
+## Type of Change
+
+- [ ] feat
+- [ ] fix
+- [ ] docs
+- [ ] refactor
+- [ ] chore
+- [ ] ci/build
+- [ ] breaking change
+
+## Checklist
+
+- [ ] PR title follows Conventional Commits (`type(scope): summary`)
+- [ ] Local checks pass (`ruff`, formatting, stub parity)
+- [ ] Docs updated if behavior/API changed
+- [ ] Relevant tests added/updated
+- [ ] No secrets or generated build artifacts committed
+
+## Linked Issues
+
+<!-- e.g. Closes #123 -->
+
+## Notes for Reviewer
+
+<!-- Optional: focus areas, trade-offs, migration notes -->

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

@@ -0,0 +1,263 @@
+name: CI
+
+on:
+  push:
+    tags:
+      - "v*"
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+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
+      - name: Install dev dependencies
+        run: uv sync --group dev --no-install-project
+      - name: Ruff lint
+        run: uv run --no-project --with ruff==0.11.4 ruff check .
+      - name: Ruff format check
+        run: uv run --no-project --with ruff==0.11.4 ruff format --check .
+      - name: Validate stub parity
+        run: uv run python scripts/check_stub_parity.py
+
+  # linux:
+  #   name: Linux manylinux wheels
+  #   needs: quality
+  #   runs-on: ${{ matrix.platform.runner }}
+  #   strategy:
+  #     fail-fast: false
+  #     matrix:
+  #       platform:
+  #         - runner: ubuntu-22.04
+  #           target: x86_64
+  #         - runner: ubuntu-22.04
+  #           target: x86
+  #         - runner: ubuntu-22.04
+  #           target: aarch64
+  #         - runner: ubuntu-22.04
+  #           target: armv7
+  #   steps:
+  #     - uses: actions/checkout@v4
+  #       with:
+  #         submodules: recursive
+  #     - uses: actions/setup-python@v5
+  #       with:
+  #         python-version: "3.12"
+  #     - name: Workaround ring ARM asm macro in cross builds
+  #       if: matrix.platform.target == 'aarch64' || matrix.platform.target == 'armv7'
+  #       run: |
+  #         if [ "${{ matrix.platform.target }}" = "aarch64" ]; then
+  #           echo "CFLAGS_aarch64_unknown_linux_gnu=-D__ARM_ARCH=8" >> "$GITHUB_ENV"
+  #         else
+  #           echo "CFLAGS_armv7_unknown_linux_gnueabihf=-D__ARM_ARCH=7" >> "$GITHUB_ENV"
+  #         fi
+  #     - 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' && matrix.platform.target != 'armv7' }}
+  #         manylinux: auto
+  #     - name: Upload wheels
+  #       uses: actions/upload-artifact@v4
+  #       with:
+  #         name: wheels-linux-${{ matrix.platform.target }}
+  #         path: dist
+
+  musllinux:
+    name: Linux musllinux wheels
+    needs: quality
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - runner: ubuntu-22.04
+            target: x86_64
+          # - runner: ubuntu-22.04
+          #   target: x86
+          # - runner: ubuntu-22.04
+          #   target: aarch64
+          # - runner: ubuntu-22.04
+          #   target: armv7
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Workaround ring ARM asm macro in cross builds
+        if: matrix.platform.target == 'aarch64' || matrix.platform.target == 'armv7'
+        run: |
+          if [ "${{ matrix.platform.target }}" = "aarch64" ]; then
+            echo "CFLAGS_aarch64_unknown_linux_musl=-D__ARM_ARCH=8" >> "$GITHUB_ENV"
+          else
+            echo "CFLAGS_armv7_unknown_linux_musleabihf=-D__ARM_ARCH=7" >> "$GITHUB_ENV"
+          fi
+      - 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' && matrix.platform.target != 'armv7' }}
+          manylinux: musllinux_1_2
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-musllinux-${{ matrix.platform.target }}
+          path: dist
+
+  # windows:
+  #   name: Windows wheels
+  #   needs: quality
+  #   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
+  #         - runner: windows-11-arm
+  #           target: aarch64
+  #           python_arch: arm64
+  #   steps:
+  #     - uses: actions/checkout@v4
+  #       with:
+  #         submodules: recursive
+  #     - uses: actions/setup-python@v5
+  #       with:
+  #         python-version: "3.12"
+  #         architecture: ${{ matrix.platform.python_arch }}
+  #     - 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
+  #   runs-on: ${{ matrix.platform.runner }}
+  #   strategy:
+  #     fail-fast: false
+  #     matrix:
+  #       platform:
+  #         - runner: macos-15-intel
+  #           target: x86_64
+  #         - runner: macos-latest
+  #           target: aarch64
+  #   steps:
+  #     - uses: actions/checkout@v4
+  #       with:
+  #         submodules: recursive
+  #     - uses: actions/setup-python@v5
+  #       with:
+  #         python-version: "3.12"
+  #     - 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-macos-${{ matrix.platform.target }}
+  #         path: dist
+
+  sdist:
+    name: Source distribution
+    needs: quality
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - 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: ${{ startsWith(github.ref, 'refs/tags/v') }}
+    needs: [musllinux, 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-0.2.0/.github/workflows/commit-messages.yml

@@ -0,0 +1,53 @@
+name: Conventional Commits
+
+on:
+  push:
+    tags-ignore:
+      - "v*"
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+permissions:
+  contents: read
+  pull-requests: read
+
+jobs:
+  commit-subjects:
+    name: Validate commit messages
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          submodules: recursive
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Resolve commit range
+        id: commit_range
+        run: |
+          set -euo pipefail
+
+          if [ "${GITHUB_EVENT_NAME}" = "pull_request" ]; then
+            range="${{ github.event.pull_request.base.sha }}..${{ github.event.pull_request.head.sha }}"
+          else
+            before_sha="${{ github.event.before }}"
+            after_sha="${GITHUB_SHA}"
+
+            if [ "${before_sha}" = "0000000000000000000000000000000000000000" ]; then
+              if git rev-parse "${after_sha}^" >/dev/null 2>&1; then
+                range="${after_sha}^..${after_sha}"
+              else
+                range="${after_sha}..${after_sha}"
+              fi
+            else
+              range="${before_sha}..${after_sha}"
+            fi
+          fi
+
+          echo "range=${range}" >> "$GITHUB_OUTPUT"
+          echo "Using commit range: ${range}"
+
+      - name: Check commit subjects in range
+        run: |
+          python scripts/check_commit_message.py --range "${{ steps.commit_range.outputs.range }}"

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

@@ -0,0 +1,57 @@
+name: Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - ".github/workflows/docs.yml"
+  pull_request:
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - ".github/workflows/docs.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build docs
+    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
+      - name: Build MkDocs site (strict)
+        run: uv run --no-project --with mkdocs==1.6.0 --with mkdocs-material==9.6.0 mkdocs build --strict
+      - name: Upload pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    name: Deploy docs
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

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

@@ -0,0 +1,109 @@
+name: Semantic Release
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  actions: write
+
+concurrency:
+  group: semantic-release
+  cancel-in-progress: false
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Log trigger context
+        run: |
+          echo "event=${GITHUB_EVENT_NAME}"
+          echo "ref=${GITHUB_REF}"
+          echo "actor=${GITHUB_ACTOR}"
+          echo "default_branch=${{ github.event.repository.default_branch }}"
+
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.repository.default_branch }}
+          fetch-depth: 0
+          submodules: recursive
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Configure git identity
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Capture release baseline
+        id: baseline
+        run: |
+          echo "sha=$(git rev-parse HEAD)" >> "$GITHUB_OUTPUT"
+          echo "tag=$(git describe --tags --abbrev=0 2>/dev/null || true)" >> "$GITHUB_OUTPUT"
+
+      - name: Run semantic release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: uv run --no-project --with python-semantic-release==9.21.1 semantic-release version
+
+      - name: Push release commit and tags
+        run: git push --follow-tags origin HEAD:${{ github.event.repository.default_branch }}
+
+      - name: Capture release result
+        id: release_result
+        run: |
+          set -euo pipefail
+          after_sha=$(git rev-parse HEAD)
+          after_tag=$(git describe --tags --abbrev=0 2>/dev/null || true)
+
+          echo "after_sha=${after_sha}" >> "$GITHUB_OUTPUT"
+          echo "after_tag=${after_tag}" >> "$GITHUB_OUTPUT"
+
+          echo "before_sha=${{ steps.baseline.outputs.sha }}"
+          echo "after_sha=${after_sha}"
+          echo "before_tag=${{ steps.baseline.outputs.tag }}"
+          echo "after_tag=${after_tag}"
+
+          if [ "${after_sha}" = "${{ steps.baseline.outputs.sha }}" ] && [ "${after_tag}" = "${{ steps.baseline.outputs.tag }}" ]; then
+            echo "released=false" >> "$GITHUB_OUTPUT"
+            echo "No new release generated in this run."
+          else
+            echo "released=true" >> "$GITHUB_OUTPUT"
+            echo "Release generated. Latest tag: ${after_tag:-none}"
+          fi
+
+      - name: Create GitHub release
+        if: ${{ steps.release_result.outputs.released == 'true' && startsWith(steps.release_result.outputs.after_tag, 'v') }}
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ steps.release_result.outputs.after_tag }}
+          generate_release_notes: true
+
+      - name: Trigger CI release build on new tag
+        if: ${{ steps.release_result.outputs.released == 'true' && startsWith(steps.release_result.outputs.after_tag, 'v') }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -euo pipefail
+          status=$(curl -sS -o /tmp/ci_dispatch_response.json -w "%{http_code}" -X POST \
+            -H "Authorization: Bearer ${GITHUB_TOKEN}" \
+            -H "Accept: application/vnd.github+json" \
+            "https://api.github.com/repos/${GITHUB_REPOSITORY}/actions/workflows/CI.yml/dispatches" \
+            -d "{\"ref\":\"${{ steps.release_result.outputs.after_tag }}\"}")
+
+          if [ "${status}" != "204" ]; then
+            echo "::error::Failed to trigger CI.yml via workflow_dispatch (HTTP ${status})."
+            cat /tmp/ci_dispatch_response.json
+            exit 1
+          fi
+
+          echo "Triggered CI.yml on tag ${{ steps.release_result.outputs.after_tag }}"
+
+      - name: Skip CI trigger when no release
+        if: ${{ steps.release_result.outputs.released != 'true' }}
+        run: echo "Skip CI dispatch because semantic-release produced no new tag."

tryx-0.2.0/.gitignore

@@ -0,0 +1,78 @@
+/target
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+.pytest_cache/
+*.py[cod]
+#db
+*.db
+*.db-shm
+*.db-wal
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+.venv/
+env/
+bin/
+build/
+develop-eggs/
+dist/
+eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+include/
+man/
+venv/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+pip-selfcheck.json
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.cache
+nosetests.xml
+coverage.xml
+
+# Translations
+*.mo
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+# Rope
+.ropeproject
+
+# Django stuff:
+*.log
+*.pot
+
+.DS_Store
+
+# Sphinx documentation
+docs/_build/
+
+# MkDocs generated output
+site/
+
+# PyCharm
+.idea/
+
+# VSCode
+.vscode/
+
+# Pyenv
+.python-version