quater 0.1.0__tar.gz

quater-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,34 @@
+---
+name: Bug report
+about: Report something that is broken or confusing
+title: ""
+assignees: ""
+---
+
+## What happened?
+
+
+## Expected behavior
+
+
+## Reproduction
+
+Please share a small code example, command, or test case if possible.
+
+```python
+
+```
+
+## Environment
+
+- Quater version:
+- Python version:
+- OS:
+
+## Extra context
+
+
+## Working on this?
+
+Please wait until a maintainer marks the issue `accepted`. After that, comment
+before starting and make sure nobody else is assigned or already working on it.

quater-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: true

quater-0.1.0/.github/ISSUE_TEMPLATE/documentation.md

@@ -0,0 +1,20 @@
+---
+name: Documentation
+about: Report missing, confusing, or outdated docs
+title: ""
+assignees: ""
+---
+
+## Which docs page?
+
+
+## What is confusing or missing?
+
+
+## Suggested change
+
+
+## Working on this?
+
+Please wait until a maintainer marks the issue `accepted`. After that, comment
+before starting and make sure nobody else is assigned or already working on it.

quater-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,27 @@
+---
+name: Feature request
+about: Suggest a new feature or API change
+title: ""
+assignees: ""
+---
+
+## Problem
+
+What are you trying to do, and what is hard today?
+
+## Proposed behavior
+
+
+## Alternatives considered
+
+
+## API sketch
+
+```python
+
+```
+
+## Working on this?
+
+Please wait until a maintainer marks the issue `accepted`. After that, comment
+before starting and make sure nobody else is assigned or already working on it.

quater-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,24 @@
+## Summary
+
+<!-- Write 2-3 short bullets about what changed. -->
+
+## Linked Issue
+
+Fixes #
+
+## Contributor Checklist
+
+- [ ] The linked issue was marked `accepted` before I started.
+- [ ] Nobody else was assigned or already working on the issue before I started.
+- [ ] My branch is named `issue_{issue_number}`.
+- [ ] The PR is focused on one issue with no unrelated changes.
+- [ ] Tests are added or updated when behavior changes.
+- [ ] Docs are updated when user-facing behavior changes.
+- [ ] Changelog is updated when the change is release-visible.
+- [ ] I listed the checks I ran below.
+
+## Checks Run
+
+```text
+
+```

quater-0.1.0/.github/dependabot.yml

@@ -0,0 +1,31 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: monthly
+    open-pull-requests-limit: 1
+    groups:
+      github-actions:
+        patterns:
+          - "*"
+
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: monthly
+    open-pull-requests-limit: 1
+    groups:
+      docs-dependencies:
+        patterns:
+          - "*"
+
+  - package-ecosystem: cargo
+    directory: /
+    schedule:
+      interval: monthly
+    open-pull-requests-limit: 1
+    groups:
+      native-dependencies:
+        patterns:
+          - "*"

quater-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,126 @@
+name: ci
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  checks:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          enable-cache: true
+
+      - name: Install Python dependencies
+        run: uv sync --frozen --group dev --group release
+
+      - name: Format check
+        run: uv run --no-sync ruff format --check .
+
+      - name: Lint
+        run: uv run --no-sync ruff check .
+
+      - name: Type check
+        run: uv run --no-sync mypy src examples tests
+
+      - name: Security lint
+        run: uv run --no-sync bandit -q -c pyproject.toml -r src/quater
+
+      - name: Dependency audit
+        run: uv run --no-sync pip-audit
+
+      - name: Test Rust router
+        run: cargo test --locked
+
+      - name: Build package distributions
+        run: uv build
+
+      - name: Check package metadata
+        run: uv run --no-sync twine check dist/*
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: "20"
+          cache: npm
+
+      - name: Install docs dependencies
+        run: npm ci
+
+      - name: Audit docs dependencies
+        run: npm audit --audit-level=moderate
+
+      - name: Build docs
+        run: npm run docs:build
+
+  tests:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --frozen --group dev
+
+      - name: Run tests with coverage
+        run: uv run --no-sync coverage run -m pytest -q
+
+      - name: Coverage report
+        run: uv run --no-sync coverage report
+
+      - name: Generate coverage XML
+        if: matrix.python-version == '3.13'
+        run: uv run --no-sync coverage xml -o coverage.xml
+
+      - name: Upload coverage to Codecov
+        if: ${{ matrix.python-version == '3.13' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository) }}
+        uses: codecov/codecov-action@v6
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: true
+          use_oidc: true

quater-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,272 @@
+name: release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      repository:
+        description: "Package index to publish to"
+        required: true
+        default: testpypi
+        type: choice
+        options:
+          - testpypi
+          - pypi
+
+permissions:
+  contents: read
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          enable-cache: true
+
+      - name: Install Python dependencies
+        run: uv sync --frozen --group dev --group release
+
+      - name: Format check
+        run: uv run --no-sync ruff format --check .
+
+      - name: Lint
+        run: uv run --no-sync ruff check .
+
+      - name: Type check
+        run: uv run --no-sync mypy src examples tests
+
+      - name: Run tests
+        run: uv run --no-sync pytest -q
+
+      - name: Test Rust router
+        run: cargo test --locked
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: "20"
+          cache: npm
+
+      - name: Install docs dependencies
+        run: npm ci
+
+      - name: Audit docs dependencies
+        run: npm audit --audit-level=moderate
+
+      - name: Build docs
+        run: npm run docs:build
+
+  build-sdist:
+    needs: verify
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          enable-cache: true
+
+      - name: Build source distribution
+        run: uv build --sdist --out-dir dist
+
+      - name: Upload source distribution
+        uses: actions/upload-artifact@v7
+        with:
+          name: sdist
+          path: dist/*
+
+  build-linux-wheels:
+    needs: verify
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        target:
+          - x86_64
+          - aarch64
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          target: ${{ matrix.target }}
+          args: --release --out dist --strip
+          manylinux: "2014"
+          sccache: "true"
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v7
+        with:
+          name: wheels-linux-${{ matrix.target }}
+          path: dist/*
+
+  build-macos-wheels:
+    needs: verify
+    runs-on: macos-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        target:
+          - x86_64
+          - aarch64
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          target: ${{ matrix.target }}
+          args: --release --out dist --strip
+          sccache: "true"
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v7
+        with:
+          name: wheels-macos-${{ matrix.target }}
+          path: dist/*
+
+  build-windows-wheels:
+    needs: verify
+    runs-on: windows-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          target: x64
+          args: --release --out dist --strip
+          sccache: "true"
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v7
+        with:
+          name: wheels-windows-x64
+          path: dist/*
+
+  validate-distributions:
+    needs:
+      - build-sdist
+      - build-linux-wheels
+      - build-macos-wheels
+      - build-windows-wheels
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Download distributions
+        uses: actions/download-artifact@v8
+        with:
+          path: dist
+          merge-multiple: true
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          enable-cache: true
+
+      - name: Install release dependencies
+        run: uv sync --frozen --no-default-groups --group release --no-install-project
+
+      - name: Check package metadata
+        run: uv run --no-sync twine check dist/*
+
+      - name: Upload checked distributions
+        uses: actions/upload-artifact@v7
+        with:
+          name: python-package-distributions
+          path: dist/*
+
+  publish-testpypi:
+    needs: validate-distributions
+    if: github.event_name == 'workflow_dispatch' && inputs.repository == 'testpypi'
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/quater
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v8
+        with:
+          name: python-package-distributions
+          path: dist
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  publish-pypi:
+    needs: validate-distributions
+    if: (github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')) || (github.event_name == 'workflow_dispatch' && inputs.repository == 'pypi')
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/quater
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v8
+        with:
+          name: python-package-distributions
+          path: dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  refresh-docs:
+    # Stable docs track the latest release tag, so rebuild the Vercel site once
+    # the package actually ships. Skipped automatically for TestPyPI dry runs
+    # (publish-pypi does not run, so this job's dependency is unmet).
+    needs: publish-pypi
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger Vercel docs rebuild
+        env:
+          DEPLOY_HOOK: ${{ secrets.VERCEL_DEPLOY_HOOK }}
+        run: |
+          if [ -z "$DEPLOY_HOOK" ]; then
+            echo "VERCEL_DEPLOY_HOOK secret not set; skipping docs rebuild." >&2
+            exit 0
+          fi
+          curl -fsS -X POST "$DEPLOY_HOOK"

quater-0.1.0/.gitignore

@@ -0,0 +1,35 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+
+# Build artifacts
+build/
+dist/
+*.egg-info/
+
+# Tool caches
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.uv-cache/
+.coverage
+node_modules/
+docs/.vitepress/cache/
+docs/.vitepress/dist/
+docs/en/stable/
+.docs-channels/
+
+# Virtual environments
+.venv/
+venv/
+
+# Local environment
+.env
+.env.*
+notes/
+sample_projects
+target/
+src/quater/*.so
+.bench-venv
+.gstack/

quater-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,20 @@
+repos:
+  - repo: local
+    hooks:
+      - id: ruff-format
+        name: ruff format
+        entry: uv run --no-sync ruff format --check .
+        language: system
+        pass_filenames: false
+
+      - id: ruff-check
+        name: ruff check
+        entry: uv run --no-sync ruff check .
+        language: system
+        pass_filenames: false
+
+      - id: mypy
+        name: mypy
+        entry: uv run --no-sync mypy src examples tests
+        language: system
+        pass_filenames: false