polyxios 0.1.0.dev1__tar.gz → 0.3.0__tar.gz

polyxios-0.3.0/.github/dependabot.yml

@@ -0,0 +1,15 @@
+# Set update schedule for GitHub Actions
+
+version: 2
+updates:
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "MNT"
+    groups:
+      actions:
+        patterns:
+          - "*"

polyxios-0.3.0/.github/release.yml

@@ -0,0 +1,14 @@
+changelog:
+  categories:
+    - title: Breaking changes
+      labels: [breaking]
+    - title: New features
+      labels: [enhancement, feature, new]
+    - title: Bug fixes
+      labels: [bug, fix, regression]
+    - title: Documentation
+      labels: [documentation, docs]
+    - title: Maintenance
+      labels: [maintenance, dependencies, ci, refactor]
+    - title: Other changes
+      labels: ['*']

polyxios-0.3.0/.github/workflows/build_docs.yml

@@ -0,0 +1,207 @@
+name: Build Docs
+
+on:
+  push:
+    branches: [master]
+    # Releases publish /X.Y/ and /stable/ from the tag itself. The `release`
+    # event below never fires for us: release.yml creates the GitHub release
+    # with GITHUB_TOKEN, and GitHub refuses to start new workflow runs from
+    # events raised by that token. The tag push is the trigger that works.
+    tags: ['v[0-9]*']
+  pull_request:
+    branches: [master]
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Tag to publish as a release version (blank = build dev)'
+        required: false
+        default: ''
+
+permissions:
+  contents: read
+
+# One deploy at a time: two jobs pushing to gh-pages would race on the same
+# branch. A running deploy is never cancelled - a half-pushed site is worse
+# than a slow one - but redundant PR builds are.
+concurrency:
+  group: docs-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+
+    outputs:
+      target: ${{ steps.target.outputs.dir }}
+      is_release: ${{ steps.target.outputs.is_release }}
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          # A manual run naming a tag builds that tag, not the branch it was
+          # dispatched from; every other event already points at the right ref.
+          ref: ${{ inputs.tag || github.ref }}
+          # Full history: docs/_ext/contributors.py builds the credits page
+          # from `git shortlog`, and a shallow clone would truncate it.
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+
+      - name: Decide which version directory this build is
+        id: target
+        env:
+          # A tag reaches us three ways: the release event, a tag push, or a
+          # manual run with the tag typed in. Anything else is a dev build.
+          RELEASE_TAG: >-
+            ${{ github.event.release.tag_name
+                || inputs.tag
+                || (github.ref_type == 'tag' && github.ref_name)
+                || '' }}
+        run: |
+          set -euo pipefail
+          if [ -n "${RELEASE_TAG}" ]; then
+            series="$(printf '%s' "${RELEASE_TAG#v}" | cut -d. -f1,2)"
+            if ! printf '%s' "$series" | grep -Eq '^[0-9]+\.[0-9]+$'; then
+              echo "::error::tag '${RELEASE_TAG}' does not parse to an X.Y series"
+              exit 1
+            fi
+            echo "dir=$series" >> "$GITHUB_OUTPUT"
+            echo "switcher=$series" >> "$GITHUB_OUTPUT"
+            echo "is_release=true" >> "$GITHUB_OUTPUT"
+            # Only this build becomes /stable/, so only it may be indexed.
+            # Backfilling an old tag therefore overwrites /stable/ with that
+            # older copy - re-run the newest tag afterwards to put it back.
+            echo "is_stable=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "dir=dev" >> "$GITHUB_OUTPUT"
+            echo "switcher=dev" >> "$GITHUB_OUTPUT"
+            echo "is_release=false" >> "$GITHUB_OUTPUT"
+            echo "is_stable=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install "meson-python>=0.15" "Cython>=3.0" "numpy>=1.24" meson ninja
+
+      - name: Install polyxios with doc extras
+        run: pip install --no-build-isolation -e ".[doc]"
+
+      - name: Build documentation
+        env:
+          # Pins which switcher entry this build highlights, rather than
+          # letting conf.py infer it from the installed version.
+          SWITCHER_VERSION: ${{ steps.target.outputs.switcher }}
+          # Everything that is not the stable copy is built noindex, so the
+          # duplicate pages at /dev/ and /X.Y/ do not compete with /stable/.
+          DOCS_IS_STABLE: ${{ steps.target.outputs.is_stable }}
+        # The Makefile already builds with -W --keep-going, so this matches a
+        # local `make html` exactly.
+        run: make -C docs html
+
+      - name: Upload docs artifact
+        uses: actions/upload-artifact@v7
+        with:
+          name: docs-html
+          path: docs/_build/html/
+          retention-days: 7
+
+  deploy:
+    # Pull requests build but never publish: they can run from forks without
+    # write access, and a PR preview would overwrite the live dev docs.
+    if: github.event_name != 'pull_request'
+    needs: build
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    # `spin release` pushes master and the tag in one go, so two runs reach
+    # this job at once. The workflow-level group keys on the ref and would let
+    # them both through; this one is global, so they queue instead of racing
+    # to push gh-pages.
+    concurrency:
+      group: docs-deploy
+      cancel-in-progress: false
+
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          path: src
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+
+      - uses: actions/download-artifact@v8
+        with:
+          name: docs-html
+          path: html
+
+      - name: Check out gh-pages, creating it on first run
+        env:
+          REPO: ${{ github.repository }}
+        run: |
+          set -euo pipefail
+          if git ls-remote --exit-code --heads "https://github.com/${REPO}.git" gh-pages >/dev/null 2>&1; then
+            git clone --branch gh-pages --single-branch --depth 1 \
+              "https://github.com/${REPO}.git" site
+          else
+            echo "gh-pages does not exist yet, creating it"
+            git clone --depth 1 "https://github.com/${REPO}.git" site
+            cd site
+            git checkout --orphan gh-pages
+            git rm -rq --cached . || true
+            find . -mindepth 1 -maxdepth 1 -not -name .git -exec rm -rf {} +
+          fi
+
+      - name: Place this build under its version directory
+        env:
+          TARGET: ${{ needs.build.outputs.target }}
+          IS_RELEASE: ${{ needs.build.outputs.is_release }}
+        run: |
+          set -euo pipefail
+          rm -rf "site/${TARGET}"
+          mkdir -p "site/${TARGET}"
+          cp -a html/. "site/${TARGET}/"
+
+          # A release is also served from /stable/, which is the URL worth
+          # linking to because it survives the next release.
+          if [ "${IS_RELEASE}" = "true" ]; then
+            rm -rf site/stable
+            mkdir -p site/stable
+            cp -a html/. site/stable/
+          fi
+
+      - name: Regenerate switcher.json and the root redirect
+        env:
+          # The custom domain, not the github.io address, which only 301s here.
+          # Canonical links, the sitemap and switcher.json must name the final
+          # URL. Keep in step with SITE_URL in docs/conf.py.
+          SITE_URL: https://polyxios.org
+        run: python src/tools/gen_switcher.py site --base-url "$SITE_URL"
+
+      - name: Commit and push
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPO: ${{ github.repository }}
+          SHA: ${{ github.sha }}
+          TARGET: ${{ needs.build.outputs.target }}
+        run: |
+          set -euo pipefail
+          cd site
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add -A
+          if git diff --cached --quiet; then
+            echo "site unchanged, nothing to push"
+            exit 0
+          fi
+          git commit -m "DOC: publish ${TARGET} from ${SHA:0:7}"
+          git push "https://x-access-token:${GH_TOKEN}@github.com/${REPO}.git" gh-pages

polyxios-0.3.0/.github/workflows/check_format.yml

@@ -0,0 +1,46 @@
+name: Code Format
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+permissions:
+  contents: read
+
+jobs:
+  pre-commit:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+
+      - uses: pre-commit/action@v3.0.1
+
+  commit-messages:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    if: github.event_name == 'pull_request'
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+
+      - name: Check commit messages
+        run: |
+          for sha in $(git log origin/${{ github.base_ref }}..HEAD --format=%H); do
+            git log -1 --format=%B "$sha" > /tmp/commit_msg
+            echo "Checking: $(git log -1 --format=%s $sha)"
+            python tools/commit-msg.py /tmp/commit_msg || exit 1
+          done

polyxios-0.3.0/.github/workflows/precommit_update.yml

@@ -0,0 +1,26 @@
+name: Pre-commit auto-update
+
+on:
+  schedule:
+    - cron: "0 2 * * Mon"  # weekly
+  workflow_dispatch:
+
+jobs:
+  auto-update:
+    if: github.repository_owner == 'fury-gl'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-python@v7
+
+      - uses: browniebroke/pre-commit-autoupdate-action@v1.0.1
+
+      - uses: peter-evans/create-pull-request@v8.1.1
+        if: always()
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          branch: update/pre-commit-hooks
+          title: "MNT: update pre-commit hooks"
+          commit-message: "MNT: update pre-commit hooks"
+          body: Update versions of pre-commit hooks to latest.

polyxios-0.3.0/.github/workflows/release.yml

@@ -0,0 +1,141 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v[0-9]*'
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Tag name (use *-test suffix to skip PyPI)'
+        required: true
+        default: 'v0.0.0-test'
+
+env:
+  RELEASE_TAG: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.tag || github.ref_name }}
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  build_wheels:
+    name: Wheels / ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v4.2.0
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: dist-wheels-${{ matrix.os }}
+          path: wheelhouse/*.whl
+
+  build_sdist:
+    name: Source distribution
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: '3.12'
+
+      - name: Build sdist
+        run: |
+          pip install build
+          python -m build --sdist
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: dist-sdist
+          path: dist/*.tar.gz
+
+  github_release:
+    name: GitHub Release
+    needs: [build_wheels, build_sdist]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/download-artifact@v8
+        with:
+          pattern: dist-*
+          merge-multiple: true
+          path: dist/
+
+      - name: Extract changelog section
+        id: changelog
+        run: |
+          python - <<'EOF'
+          import re, os, sys
+          tag = os.environ["TAG"].lstrip("v")
+          try:
+              with open("CHANGES.rst") as f:
+                  content = f.read()
+              pattern = rf"(?ms)^{re.escape(tag)}[^\n]*\n[-]+\n(.*?)(?=\n\S[^\n]*\n[-]+|\Z)"
+              m = re.search(pattern, content)
+              notes = m.group(1).strip() if m else ""
+          except Exception:
+              notes = ""
+          with open(os.environ["GITHUB_OUTPUT"], "a") as fh:
+              print(f"notes<<EOF_NOTES\n{notes}\nEOF_NOTES", file=fh)
+          EOF
+        env:
+          TAG: ${{ env.RELEASE_TAG }}
+
+      - name: Create release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          NOTES="${{ steps.changelog.outputs.notes }}"
+          if [ -n "$NOTES" ]; then
+            echo "$NOTES" > release_notes.md
+            echo "" >> release_notes.md
+            echo "---" >> release_notes.md
+            gh release create "${{ env.RELEASE_TAG }}" \
+              dist/* \
+              --title "polyxios ${{ env.RELEASE_TAG }}" \
+              --notes-file release_notes.md \
+              --generate-notes
+          else
+            gh release create "${{ env.RELEASE_TAG }}" \
+              dist/* \
+              --title "polyxios ${{ env.RELEASE_TAG }}" \
+              --generate-notes
+          fi
+
+  publish_pypi:
+    name: PyPI
+    needs: [github_release]
+    if: ${{ !contains(github.event_name == 'workflow_dispatch' && inputs.tag || github.ref_name, 'test') }}
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/polyxios/
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          pattern: dist-*
+          merge-multiple: true
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

polyxios-0.3.0/.github/workflows/test.yml

@@ -0,0 +1,58 @@
+name: Tests
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+  schedule:
+    - cron: "0 2 * * Mon"  # weekly
+
+concurrency:
+  group: test-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  test:
+    if: github.event_name != 'schedule' || github.repository_owner == 'fury-gl'
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 30
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+        os: [ubuntu-latest, macos-latest, windows-latest]
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install OpenMP (macOS)
+        if: runner.os == 'macOS'
+        run: |
+          brew install libomp
+          echo "CC=clang" >> "$GITHUB_ENV"
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install "meson-python>=0.15" "Cython>=3.0" "numpy>=1.24" meson ninja
+
+      - name: Install polyxios
+        run: pip install --no-build-isolation -e ".[dev]"
+
+      - name: Run tests
+        run: pytest tests/ -v --durations=10

{polyxios-0.1.0.dev1 → polyxios-0.3.0}/.gitignore

@@ -71,6 +71,8 @@ instance/
 
 # Sphinx documentation
 docs/_build/
+# generated at build time by docs/_ext/contributors.py
+docs/_includes/contributors.rst
 
 # PyBuilder
 .pybuilder/
@@ -197,9 +199,9 @@ cython_debug/
 .abstra/
 
 # Visual Studio Code
-#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
 #   that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
-#   and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#   and can be added to the global gitignore or merged into this file. However, if you prefer,
 #   you could uncomment the following to ignore the entire vscode folder
 # .vscode/
 # Temporary file for partial code execution
@@ -208,6 +210,17 @@ tempCodeRunnerFile.py
 # Ruff stuff:
 .ruff_cache/
 
+# Claude Code
+CLAUDE.md
+.claude/
+
+# Auto-generated version file
+polyxios/version.py
+
+# Cython generated C files
+*.c
+*.cpp
+
 # PyPI configuration file
 .pypirc
 
@@ -217,4 +230,9 @@ marimo/_lsp/
 __marimo__/
 
 # Streamlit
-.streamlit/secrets.toml
+.streamlit/secrets.toml
+prompts/
+tmp/
+generated/
+.vscode/
+AGENTS.md

polyxios-0.3.0/.mailmap

@@ -0,0 +1,11 @@
+# Canonical name and address per contributor.
+#
+# git shortlog, git log and the generated credits page all honour this file, so
+# one person committing under several addresses is counted once. Add a line
+# here rather than editing the credits page when a duplicate shows up.
+#
+# Format:  Canonical Name <canonical@email>  Other Name <other@email>
+
+Serge Koudoro <skab12@gmail.com> <23106443+skoudoro@users.noreply.github.com>
+Serge Koudoro <skab12@gmail.com> skoudoro <skab12@gmail.com>
+Praneeth Shetty <praneethshetty10@gmail.com> <64432063+ganimtron-10@users.noreply.github.com>

polyxios-0.3.0/.pre-commit-config.yaml

@@ -0,0 +1,37 @@
+ci:
+  autoupdate_schedule: monthly
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: mixed-line-ending
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+      - id: check-case-conflict
+      - id: check-merge-conflict
+      - id: detect-private-key
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.16.3
+    hooks:
+      - id: ruff
+        args: [--fix, --show-fixes]
+      - id: ruff-format
+
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.3
+    hooks:
+      - id: codespell
+        additional_dependencies: [tomli]
+
+  - repo: local
+    hooks:
+      - id: polyxios-commit-msg
+        name: polyxios commit message
+        entry: python tools/commit-msg.py
+        language: python
+        stages: [commit-msg]