crace 1.0.0__tar.gz

crace-1.0.0/.github/workflows/docs.yml

@@ -0,0 +1,102 @@
+# ============================================================
+# GitHub Actions Workflow: Deploy documentation
+#
+# This workflow builds the project documentation using
+# Jupyter Book and deploys the generated HTML pages to
+# GitHub Pages.
+#
+# Trigger:
+#   - Runs automatically when files under docs/** are pushed
+#     to the main branch.
+#
+# Workflow steps:
+#   1. Checkout repository source code.
+#   2. Set up Python environment.
+#   3. Install documentation dependencies.
+#   4. Synchronize required static files.
+#   5. Build documentation with Jupyter Book.
+#   6. Upload generated HTML as a GitHub Pages artifact.
+#   7. Deploy the artifact to GitHub Pages.
+#
+# The deployed documentation will be available at:
+#   https://race-autoconfig.github.io/crace/
+#
+# ============================================================
+
+name: Deploy documentation
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Check docs changes
+        id: changes
+        run: |
+          if [ -z "${{ github.event.before }}" ]; then
+            echo "changed=true" >> $GITHUB_OUTPUT
+            exit 0
+          fi
+
+          CHANGED=$(git diff --name-only ${{ github.event.before }} ${{ github.sha }} | grep "^docs/" || true)
+
+          if [ -n "$CHANGED" ]; then
+            echo "changed=true" >> $GITHUB_OUTPUT
+          else
+            echo "changed=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Skip if no changes
+        if: steps.changes.outputs.changed == 'false'
+        run: |
+          echo "No changes in docs/, skipping deployment."
+          exit 0
+
+      - name: Setup Python
+        if: steps.changes.outputs.changed == 'true'
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install dependencies
+        if: steps.changes.outputs.changed == 'true'
+        run: |
+          pip install --upgrade pip
+          pip install -r docs/requirements.txt
+
+      - name: Build docs
+        if: steps.changes.outputs.changed == 'true'
+        run: |
+          jupyter-book build docs
+
+      - name: Upload artifact
+        if: steps.changes.outputs.changed == 'true'
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_build/html
+
+      - name: Deploy to GitHub Pages
+        if: steps.changes.outputs.changed == 'true'
+        id: deployment
+        uses: actions/deploy-pages@v4

crace-1.0.0/.github/workflows/test.yml

@@ -0,0 +1,79 @@
+# ============================================================
+# GitHub Actions Workflow: Build and publish package to TestPyPI
+#
+# This workflow builds the source distribution (sdist) and
+# wheel for the project and publishes them to TestPyPI using
+# Trusted Publishing.
+#
+# Trigger:
+#   - Runs automatically when a GitHub release is published.
+#
+# Steps:
+#   1. Checkout repository
+#   2. Set up Python environment
+#   3. Install build dependencies
+#   4. Build sdist and wheel
+#   5. Upload package to TestPyPI
+# ============================================================
+name: Publish to TestPyPI
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  build-and-publish-test:
+    runs-on: ubuntu-latest
+    environment: publish-testpypi
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine setuptools wheel
+
+      - name: Build package
+        run: python -m build
+
+      - name: Check distribution
+        run: twine check dist/*
+
+      - name: Get version
+        id: version
+        run: echo "VERSION=$(python -c 'from description import version; print(version)')" >> $GITHUB_OUTPUT
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+      - name: Wait for availability
+        run: sleep 10
+
+      - name: Test install from TestPyPI
+        run: |
+          pip install --no-cache-dir \
+            -i https://test.pypi.org/simple/ \
+            --extra-index-url https://pypi.org/simple \
+            crace==${{ steps.version.outputs.VERSION }}
+
+      - name: Verify version
+        run: |
+          VERSION=$(python -c "from description import version; print(version)")
+          INSTALLED=$(python -c "import crace; print(crace.__version__)")
+          if [ "$VERSION" != "$INSTALLED" ]; then
+            echo "Version mismatch: $VERSION vs $INSTALLED"
+            exit 1
+          fi
+
+      - name: Test CLI
+        run: crace --help

crace-1.0.0/.github/workflows/wheels.yml

@@ -0,0 +1,81 @@
+# ============================================================
+# GitHub Actions Workflow: Build and publish package to PyPI
+#
+# This workflow builds the source distribution (sdist) and
+# wheel for the project and publishes them to PyPI using
+# Trusted Publishing.
+#
+# Trigger:
+#   - Runs automatically when a GitHub release is published.
+#
+# Steps:
+#   1. Checkout repository
+#   2. Set up Python environment
+#   3. Install build dependencies
+#   4. Build sdist and wheel
+#   5. Upload package to PyPI
+# ============================================================
+
+name: Wheel builder
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment: publish-pypi
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Check tag format
+        run: |
+          TAG=${GITHUB_REF#refs/tags/}
+          echo "Tag: $TAG"
+
+          if [[ ! "$TAG" =~ ^v[0-9]+\.[0-9]+\.[0-9]+([a-z0-9\.]*)?$ ]]; then
+            echo "❌ Invalid tag format: $TAG"
+            exit 1
+          fi
+
+          if [[ "$TAG" == *".dev"* ]]; then
+            echo "❌ Refusing to publish dev version"
+            exit 1
+          fi
+
+      - name: Build package
+        run: python -m build
+
+      - name: Show built files
+        run: ls -lh dist
+
+      - name: Check distribution
+        run: twine check dist/*
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1