anyplotlib 0.1.0b1__tar.gz

anyplotlib-0.1.0b1/.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.12"
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --group dev
+
+      - name: Install Playwright browsers
+        run: uv run playwright install --with-deps chromium
+
+      - name: Run tests with coverage
+        run: uv run pytest
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          files: coverage.xml
+          fail_ci_if_error: false
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

anyplotlib-0.1.0b1/.github/workflows/docs.yml

@@ -0,0 +1,169 @@
+name: Docs
+
+on:
+  push:
+    # Publish to dev/ on every push to main …
+    branches: [main]
+    # … and to a versioned directory on every release tag.
+    tags: ["v*.*.*"]
+  pull_request:
+    branches: [main]
+  # Allow manual re-builds from the Actions tab.
+  workflow_dispatch:
+
+# Only one docs deployment should run at a time to avoid race conditions on
+# the gh-pages branch.
+concurrency:
+  group: docs-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write   # needed to push to gh-pages
+
+jobs:
+  # ── Build ──────────────────────────────────────────────────────────────────
+  # Runs on every push and every pull request.  Treats warnings as errors so
+  # broken cross-references and bad docstrings are caught before merge.
+  build:
+    name: Build docs
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      # ── uv + Python ──────────────────────────────────────────────────────
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.13"
+          enable-cache: true
+
+      # ── Dependencies ─────────────────────────────────────────────────────
+      # Install the package itself plus the [docs] optional-dependency group
+      # (sphinx, pydata-sphinx-theme, sphinx-gallery, pillow, playwright).
+      - name: Install dependencies (with docs extras)
+        run: uv sync --extra docs
+
+      # Playwright ships the Python bindings but NOT the browser binaries.
+      # --with-deps also installs the OS-level shared libraries Chromium needs
+      # (libglib2, libnss3, etc.) on bare Ubuntu runners.
+      - name: Install Playwright browser
+        run: uv run playwright install chromium --with-deps
+
+      # ── Build Pyodide wheel ───────────────────────────────────────────────
+      # Produces docs/_static/wheels/anyplotlib-0.0.0-py3-none-any.whl so the
+      # in-browser Pyodide bridge can install the exact source tree that built
+      # these docs — no PyPI release required.
+      - name: Build Pyodide wheel
+        run: |
+          mkdir -p docs/_static/wheels
+          uv build --wheel --out-dir docs/_static/wheels/
+          # Rename to the stable sentinel name micropip expects for URL installs.
+          cd docs/_static/wheels
+          for f in anyplotlib-*.whl; do
+            [ "$f" != "anyplotlib-0.0.0-py3-none-any.whl" ] && mv "$f" anyplotlib-0.0.0-py3-none-any.whl
+          done
+
+      # ── Sphinx build ─────────────────────────────────────────────────────
+      # -W turns warnings into errors; --keep-going collects all of them.
+      - name: Build HTML documentation
+        run: |
+          uv run sphinx-build -b html docs build/html -W --keep-going
+
+      # ── Upload built HTML as an artifact so it can be inspected on PRs ──
+      - name: Upload HTML artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: docs-html
+          path: build/html
+          retention-days: 7
+
+  # ── Deploy ─────────────────────────────────────────────────────────────────
+  # Only runs after a successful build on pushes to main or release tags.
+  # Pull requests skip this job entirely.
+  deploy:
+    name: Deploy docs
+    needs: build
+    runs-on: ubuntu-latest
+    # Skip deployment for pull requests.
+    if: github.event_name != 'pull_request'
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      # ── uv + Python ──────────────────────────────────────────────────────
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.13"
+          enable-cache: true
+
+      # ── Dependencies ─────────────────────────────────────────────────────
+      - name: Install dependencies (with docs extras)
+        run: uv sync --extra docs
+
+      - name: Install Playwright browser
+        run: uv run playwright install chromium --with-deps
+
+      # ── Determine deployment target ──────────────────────────────────────
+      # Release tag  (refs/tags/v1.2.3) → destination = "v1.2.3"
+      # Everything else (push to main, manual dispatch) → destination = "dev"
+      - name: Determine deployment directory
+        id: target
+        shell: bash
+        run: |
+          if [[ "${GITHUB_REF}" == refs/tags/v* ]]; then
+            echo "dest_dir=${GITHUB_REF_NAME}" >> "$GITHUB_OUTPUT"
+          else
+            echo "dest_dir=dev" >> "$GITHUB_OUTPUT"
+          fi
+
+      # ── Build Pyodide wheel ───────────────────────────────────────────────
+      - name: Build Pyodide wheel
+        run: |
+          mkdir -p docs/_static/wheels
+          uv build --wheel --out-dir docs/_static/wheels/
+          cd docs/_static/wheels
+          for f in anyplotlib-*.whl; do
+            [ "$f" != "anyplotlib-0.0.0-py3-none-any.whl" ] && mv "$f" anyplotlib-0.0.0-py3-none-any.whl
+          done
+
+      # ── Sphinx build ─────────────────────────────────────────────────────
+      - name: Build HTML documentation
+        env:
+          DOCS_VERSION: ${{ steps.target.outputs.dest_dir }}
+        run: |
+          uv run sphinx-build -b html docs build/html -W --keep-going
+
+      # ── Deploy to gh-pages ───────────────────────────────────────────────
+      # keep_files: true preserves all existing directories on the branch so
+      # versioned releases accumulate rather than overwriting each other.
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./build/html
+          destination_dir: ${{ steps.target.outputs.dest_dir }}
+          keep_files: true
+          commit_message: |
+            docs: deploy ${{ steps.target.outputs.dest_dir }} @ ${{ github.sha }}
+
+      # ── Deploy root files (redirect + switcher) ──────────────────────────
+      # Places index.html and switcher.json at the root of gh-pages so the
+      # bare URL redirects to dev/ and the version switcher is always reachable.
+      - name: Deploy root redirect and switcher
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs/_root
+          destination_dir: .
+          keep_files: true
+          commit_message: |
+            docs: update root redirect and switcher.json @ ${{ github.sha }}
+

anyplotlib-0.1.0b1/.github/workflows/prepare_release.yml

@@ -0,0 +1,218 @@
+name: Prepare Release
+
+# Run manually from the Actions tab.
+# Creates a branch + PR that bumps the version, builds the changelog,
+# and updates the docs switcher — ready to review before tagging.
+on:
+  workflow_dispatch:
+    inputs:
+      bump:
+        description: "Version component to bump"
+        required: true
+        type: choice
+        options:
+          - minor
+          - bugfix
+          - major
+          - pre-release   # increments the bN counter on the current base version
+      beta:
+        description: "Mark as beta pre-release (adds bN suffix; always true for pre-release)"
+        required: false
+        type: boolean
+        default: false
+
+permissions:
+  contents: write        # push branch
+  pull-requests: write   # open PR
+
+jobs:
+  prepare:
+    name: Prepare release PR
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.13"
+          enable-cache: true
+
+      - name: Install dev dependencies
+        run: uv sync
+
+      # ── Compute the new version ──────────────────────────────────────────
+      - name: Compute new version
+        id: version
+        env:
+          BUMP: ${{ inputs.bump }}
+          IS_BETA: ${{ inputs.beta }}
+        run: |
+          CURRENT=$(grep '^version = ' pyproject.toml | sed 's/version = "\(.*\)"/\1/')
+          export CURRENT_VERSION="$CURRENT"
+
+          NEW_VERSION=$(python3 - <<'PYEOF'
+          import re, os
+
+          current = os.environ["CURRENT_VERSION"]
+          bump    = os.environ["BUMP"]
+          is_beta = os.environ["IS_BETA"].lower() == "true"
+
+          m = re.match(r"^(\d+)\.(\d+)\.(\d+)(?:b(\d+))?", current)
+          major  = int(m.group(1))
+          minor  = int(m.group(2))
+          patch  = int(m.group(3))
+          beta_n = int(m.group(4)) if m.group(4) else None
+
+          if bump == "major":
+              major, minor, patch = major + 1, 0, 0
+          elif bump == "minor":
+              minor, patch = minor + 1, 0
+          elif bump == "bugfix":
+              patch += 1
+          elif bump == "pre-release":
+              # Keep the same base; just walk the beta counter forward.
+              is_beta = True
+              beta_n  = (beta_n or 0) + 1
+
+          if is_beta:
+              if bump != "pre-release":
+                  beta_n = 1          # fresh beta series for the new base
+              print(f"{major}.{minor}.{patch}b{beta_n}", end="")
+          else:
+              print(f"{major}.{minor}.{patch}", end="")
+          PYEOF
+          )
+
+          echo "new_version=$NEW_VERSION"                  >> "$GITHUB_OUTPUT"
+          echo "tag=v$NEW_VERSION"                         >> "$GITHUB_OUTPUT"
+          echo "branch=release/v$NEW_VERSION"              >> "$GITHUB_OUTPUT"
+          echo "is_beta=${{ inputs.beta }}"                >> "$GITHUB_OUTPUT"
+          echo "Bumping (${{ inputs.bump }}): $CURRENT → $NEW_VERSION"
+
+      # ── Bump version strings ─────────────────────────────────────────────
+      - name: Bump version in pyproject.toml
+        run: |
+          sed -i 's/^version = ".*"/version = "${{ steps.version.outputs.new_version }}"/' pyproject.toml
+
+      - name: Bump version in docs/conf.py
+        run: |
+          sed -i 's/^release = ".*"/release = "${{ steps.version.outputs.new_version }}"/' docs/conf.py
+
+      # ── Build changelog ──────────────────────────────────────────────────
+      - name: Build changelog with towncrier
+        run: |
+          FRAGMENT_COUNT=$(find upcoming_changes -maxdepth 1 -name "*.rst" \
+                            ! -name "README.rst" | wc -l)
+          if [ "$FRAGMENT_COUNT" -eq 0 ]; then
+            echo "⚠ No news fragments found — skipping towncrier (CHANGELOG.rst unchanged)."
+          else
+            uvx towncrier build --yes --version "${{ steps.version.outputs.new_version }}"
+          fi
+
+      # ── Update docs switcher.json ────────────────────────────────────────
+      - name: Update docs/switcher.json
+        env:
+          VERSION_TAG: ${{ steps.version.outputs.tag }}
+          IS_BETA: ${{ inputs.beta }}
+        shell: python
+        run: |
+          import json, re, pathlib, os
+
+          version = os.environ["VERSION_TAG"]
+          is_beta = os.environ["IS_BETA"].lower() == "true"
+
+          path = pathlib.Path("docs/_root/switcher.json")
+          text = path.read_text()
+          # The file may contain a trailing comma; strip it before parsing.
+          text_clean = re.sub(r",(\s*[\]\}])", r"\1", text)
+          entries = json.loads(text_clean)
+
+          # Remove any existing entry for this version (makes the step idempotent).
+          entries = [e for e in entries if e.get("version") != version]
+
+          label = f"{version} (beta)" if is_beta else f"{version} (stable)"
+          url   = f"https://cssfrancis.github.io/anyplotlib/{version}/"
+          # Insert right after the "dev" entry so newest stable floats to top.
+          entries.insert(1, {"name": label, "version": version, "url": url})
+
+          path.write_text(json.dumps(entries, indent=2) + "\n")
+
+      # ── Update root redirect for stable releases ─────────────────────────
+      - name: Update root redirect (stable releases only)
+        if: ${{ inputs.beta == false && inputs.bump != 'pre-release' }}
+        env:
+          VERSION_TAG: ${{ steps.version.outputs.tag }}
+        shell: python
+        run: |
+          import re, pathlib, os
+
+          version = os.environ["VERSION_TAG"]
+          path = pathlib.Path("docs/_root/index.html")
+          text = path.read_text()
+
+          text = re.sub(r'(content="0; url=)[^"]+(")',       rf"\g<1>{version}/\2",   text)
+          text = re.sub(r'(rel="canonical" href=")[^"]+(")', rf"\g<1>{version}/\2",   text)
+          text = re.sub(r'(<a href=")[^"]+(">[^<]*</a>)',    rf"\g<1>{version}/\2",   text)
+          text = re.sub(r'(Redirecting to <a href="[^"]+">)[^<]*(</a>)',
+                        rf"\g<1>{version} documentation\2", text)
+
+          path.write_text(text)
+
+      # ── Commit and push ──────────────────────────────────────────────────
+      - name: Configure git
+        run: |
+          git config user.name  "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Commit release changes
+        run: |
+          git checkout -b "${{ steps.version.outputs.branch }}"
+
+          # Stage version bumps, updated changelog, and consumed fragments.
+          git add pyproject.toml docs/conf.py CHANGELOG.rst
+          git add docs/_root/switcher.json docs/_root/index.html
+          git add -A upcoming_changes/    # stages deleted fragment files
+
+          git commit -m "chore: prepare release ${{ steps.version.outputs.tag }}"
+          git push origin "${{ steps.version.outputs.branch }}"
+
+      # ── Open pull request ────────────────────────────────────────────────
+      - name: Open pull request
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TAG: ${{ steps.version.outputs.tag }}
+          BRANCH: ${{ steps.version.outputs.branch }}
+        run: |
+          gh pr create \
+            --title "Release ${TAG}" \
+            --base  main \
+            --head  "${BRANCH}" \
+            --body  "## Release ${TAG}
+
+          > Auto-generated by the **Prepare Release** workflow.
+
+          ### What changed
+          - Version bumped to \`${TAG}\` in \`pyproject.toml\` and \`docs/conf.py\`
+          - \`CHANGELOG.rst\` updated from towncrier fragments
+          - \`docs/_root/switcher.json\` updated with the new version entry
+          $([ '${{ inputs.beta }}' = 'false' ] && echo '- Root redirect updated to point to this release' || echo '')
+
+          ### Review checklist
+          - [ ] \`CHANGELOG.rst\` reads well — edit the fragment text directly if needed
+          - [ ] Version strings are correct in \`pyproject.toml\` and \`docs/conf.py\`
+          - [ ] \`switcher.json\` has the right label and URL
+          - [ ] CI passes
+
+          ### After merging
+          Create and push the tag to trigger the Release and Docs workflows:
+          \`\`\`bash
+          git fetch origin
+          git tag ${TAG} origin/main
+          git push origin ${TAG}
+          \`\`\`"
+

anyplotlib-0.1.0b1/.github/workflows/release.yml

@@ -0,0 +1,115 @@
+name: Release
+
+# Fires when a version tag is pushed (manually, after the Prepare Release PR
+# is merged and reviewed).
+#
+# Jobs:
+#   build    - build wheel + sdist with uv
+#   publish  - upload to PyPI via OIDC trusted publishing (no API token needed)
+#   release  - create a GitHub Release with the dist files and changelog notes
+
+on:
+  push:
+    tags: ["v*.*.*"]
+
+permissions:
+  contents: write    # create GitHub Releases and upload assets
+  id-token: write    # OIDC token for PyPI trusted publishing
+
+jobs:
+  # --------------------------------------------------------------------------
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.13"
+          enable-cache: true
+
+      - name: Build wheel and sdist
+        run: uv build
+
+      - name: Upload dist artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+          retention-days: 7
+
+  # --------------------------------------------------------------------------
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+
+    environment:
+      name: pypi
+      url: https://pypi.org/p/anyplotlib
+
+    steps:
+      - name: Download dist artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      # Trusted publishing - no API token required.
+      # One-time setup on pypi.org: add a pending publisher for
+      #   Owner: CSSFrancis  Repo: anyplotlib  Workflow: release.yml
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  # --------------------------------------------------------------------------
+  release:
+    name: Create GitHub Release
+    needs: build
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Download dist artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Prepare release notes
+        env:
+          TAG: ${{ github.ref_name }}
+        shell: python
+        run: |
+          import re, pathlib, os
+          tag = os.environ["TAG"]
+          # Prefer the curated RELEASE_NOTES.md; fall back to the matching
+          # CHANGELOG.rst section, then to a generic stub.
+          curated = pathlib.Path("RELEASE_NOTES.md")
+          if curated.exists():
+              notes = curated.read_text()
+          else:
+              text = pathlib.Path("CHANGELOG.rst").read_text()
+              parts = re.split(r"(?m)(?=^\S[^\n]*\n=+\n)", text)
+              section = next((p.strip() for p in parts if p.strip().startswith(tag)), None)
+              notes = section or ("Release " + tag + "\n\nSee CHANGELOG.rst.")
+          pathlib.Path("release_notes.md").write_text(notes)
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TAG: ${{ github.ref_name }}
+        run: |
+          PRERELEASE_FLAG=""
+          if [[ "$TAG" == *b* ]]; then PRERELEASE_FLAG="--prerelease"; fi
+          gh release create "$TAG" \
+            --title "$TAG" \
+            --notes-file release_notes.md \
+            $PRERELEASE_FLAG \
+            dist/*

anyplotlib-0.1.0b1/.github/workflows/tests.yml

@@ -0,0 +1,80 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+concurrency:
+  group: tests-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Python ${{ matrix.python-version }} / ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        exclude:
+          - os: macos-latest
+            python-version: "3.10"
+          - os: macos-latest
+            python-version: "3.11"
+          - os: windows-latest
+            python-version: "3.10"
+          - os: windows-latest
+            python-version: "3.11"
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Install Playwright browsers (Linux)
+        if: runner.os == 'Linux'
+        run: uv run playwright install chromium --with-deps
+
+      - name: Install Playwright browsers (macOS / Windows)
+        if: runner.os != 'Linux'
+        run: uv run playwright install chromium
+
+      - name: Run tests
+        run: uv run pytest anyplotlib/tests/ -v --tb=short
+
+  minimum-deps:
+    name: Minimum deps (Python 3.10 / ubuntu)
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.10"
+          enable-cache: true
+
+      - name: Install dependencies at minimum versions
+        run: uv sync --resolution lowest-direct
+
+      - name: Show installed versions
+        run: uv run pip list --format=columns
+
+      - name: Install Playwright browsers
+        run: uv run playwright install chromium --with-deps
+
+      - name: Run tests
+        run: uv run pytest anyplotlib/tests/ -v --tb=short

anyplotlib-0.1.0b1/.gitignore

@@ -0,0 +1,53 @@
+# Python bytecode / caches
+__pycache__/
+*.py[cod]
+*$py.class
+*.pyo
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Test / coverage artefacts
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+# Jupyter notebooks checkpoints
+.ipynb_checkpoints/
+
+# Sphinx build output
+docs/_build/
+docs/api/generated/
+docs/auto_examples/
+docs/sg_execution_times.rst
+build/html/
+build/doctrees/
+
+# Generated Pyodide wheel (built by workflow / make html — never commit)
+docs/_static/wheels/
+docs/_static/anywidget_config.js
+
+# Editor / IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# macOS
+.DS_Store
+
+# Git worktrees
+.worktrees/
+
+# Generated by Sphinx-Gallery (anywidget iframe HTML) — never commit
+docs/_static/viewer_widgets/