monocoat 1.2.0__tar.gz

monocoat-1.2.0/.github/workflows/ci.yml

@@ -0,0 +1,86 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: ruff check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      # ruff is pinned (here and in the `dev` extra) so a new release promoting
+      # rules into E/F/I/UP/B cannot turn main red; bump it on purpose.
+      - run: python -m pip install --upgrade pip "ruff==0.16.10"
+      # Lint only: no repo-wide `ruff format` gate (owner ruling).
+      - run: ruff check src tests
+
+  test:
+    name: pytest (py${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: python -m pip install --upgrade pip
+      - run: python -m pip install -e ".[dev]"
+      # sassc lets the real-compiler SCSS tests run instead of skipping.
+      - run: sudo apt-get update && sudo apt-get install -y sassc
+      - name: pytest (sandboxed HOME/XDG so nothing touches the runner's desktop)
+        run: |
+          sandbox="$(mktemp -d)"
+          export HOME="$sandbox" XDG_CONFIG_HOME="$sandbox/.config" \
+                 XDG_CACHE_HOME="$sandbox/.cache" XDG_DATA_HOME="$sandbox/.local/share"
+          python -m pytest -q
+
+  wheel-smoke:
+    name: build + clean-venv wheel smoke
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: python -m pip install --upgrade pip build twine
+      - run: python -m build
+      - run: python -m twine check --strict dist/*
+      - name: Install the wheel with no extras into a clean venv
+        run: |
+          python -m venv /tmp/smoke
+          /tmp/smoke/bin/pip install dist/*.whl
+      - name: Core runs without any third-party deps
+        run: |
+          sandbox="$(mktemp -d)"
+          export HOME="$sandbox" XDG_CONFIG_HOME="$sandbox/.config" \
+                 XDG_CACHE_HOME="$sandbox/.cache" XDG_DATA_HOME="$sandbox/.local/share"
+          /tmp/smoke/bin/monocoat --version
+          /tmp/smoke/bin/monocoat doctor --json || true
+          # The zero-dep promise: rich/textual must NOT have been pulled in.
+          if /tmp/smoke/bin/python -c "import rich" 2>/dev/null; then
+            echo "::error::rich is importable in a no-extras install"; exit 1
+          fi
+          if /tmp/smoke/bin/python -c "import textual" 2>/dev/null; then
+            echo "::error::textual is importable in a no-extras install"; exit 1
+          fi
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          retention-days: 7

monocoat-1.2.0/.github/workflows/release.yml

@@ -0,0 +1,109 @@
+name: Release
+
+# Cut by pushing a vX.Y.Z tag whose number matches monocoat.__version__.
+# Publishing uses PyPI Trusted Publishing (OIDC): no API token is stored.
+# One-time setup on pypi.org: add a trusted publisher for
+#   owner=blakebratcher repo=monocoat workflow=release.yml environment=pypi
+
+on:
+  push:
+    tags: ["v*.*.*"]
+
+permissions:
+  contents: read
+
+jobs:
+  guard:
+    name: tag == __version__, CHANGELOG has the section
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.check.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - id: check
+        env:
+          TAG: ${{ github.ref_name }}
+        run: |
+          version="$(python - <<'PY'
+          import re, pathlib
+          src = pathlib.Path("src/monocoat/__init__.py").read_text()
+          print(re.search(r'^__version__\s*=\s*"([^"]+)"', src, re.M).group(1))
+          PY
+          )"
+          if [ "$TAG" != "v$version" ]; then
+            echo "::error::tag $TAG does not match monocoat.__version__ $version"
+            exit 1
+          fi
+          if ! grep -qE "^## \[$version\]" CHANGELOG.md; then
+            echo "::error::CHANGELOG.md has no '## [$version]' section"
+            exit 1
+          fi
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+
+  build:
+    needs: guard
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: python -m pip install --upgrade pip build twine
+      - run: python -m build
+      - run: python -m twine check --strict dist/*
+      - name: Wheel smoke (no extras, clean venv)
+        run: |
+          python -m venv /tmp/smoke
+          /tmp/smoke/bin/pip install dist/*.whl
+          test "$(/tmp/smoke/bin/monocoat --version)" = "monocoat ${{ needs.guard.outputs.version }}"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/monocoat/
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    needs: [guard, publish-pypi]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Extract this version's CHANGELOG section
+        env:
+          VERSION: ${{ needs.guard.outputs.version }}
+        run: |
+          python - <<'PY' > notes.md
+          import os, re, pathlib
+          version = re.escape(os.environ["VERSION"])
+          text = pathlib.Path("CHANGELOG.md").read_text()
+          m = re.search(rf"^## \[{version}\][^\n]*\n(.*?)(?=^## \[|\Z)", text, re.M | re.S)
+          print(m.group(1).strip())
+          PY
+          test -s notes.md
+      - name: Create the GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ github.ref_name }}
+        run: gh release create "$TAG" dist/* --title "monocoat $TAG" --notes-file notes.md --verify-tag

monocoat-1.2.0/.gitignore

@@ -0,0 +1,47 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.venv/
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+
+# Type checking / linting
+.mypy_cache/
+.ruff_cache/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Claude Code local overrides
+.claude.local.md
+.claude/settings.local.json
+
+# Logs
+*.log
+
+# OS
+Thumbs.db
+Desktop.ini
+.DS_Store
+
+# makepkg output when building the AUR recipes in place
+packaging/aur/*/src/
+packaging/aur/*/pkg/
+packaging/aur/*/*.tar.*
+packaging/aur/*/monocoat/
+
+# Agent scratch: git worktrees and SDD plan workspaces
+.worktrees/
+.superpowers/

monocoat-1.2.0/AGENTS.md

@@ -0,0 +1 @@
+CLAUDE.md