chore(ci): build wheelhouse, use uv for venv and runs, cache wheels & pre-commit, add workflow_dispatch and pages deploy

Author: Magic-Man-us

.github/dependabot.yml

@@ -0,0 +1,14 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "github-pre-commit"
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/workflows/ci.yaml

@@ -0,0 +1,131 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  test:
+    name: Tests and checks
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Cache pip
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ matrix.python-version }}-${{ hashFiles('**/pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-${{ matrix.python-version }}-
+
+      - name: Cache pip wheels & pre-commit
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cache/pip/wheels
+            .wheelhouse
+            ~/.cache/pre-commit
+          key: ${{ runner.os }}-pip-wheels-${{ matrix.python-version }}-${{ hashFiles('**/pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-wheels-${{ matrix.python-version }}-
+
+      - name: Install build tools and uv
+        run: |
+          python -m pip install --upgrade pip setuptools wheel
+          pip install uv
+
+      - name: Build wheelhouse for project and dev deps
+        run: |
+          # Build wheels for the project and development extras into .wheelhouse
+          # This will be fast when the cache is warm.
+          python -m pip wheel -w .wheelhouse "[dev]" || python -m pip wheel -w .wheelhouse ".[dev]"
+
+      - name: Create venv (uv)
+        run: |
+          # create a fresh .venv using uv
+          uv venv
+
+      - name: Install project dev dependencies into venv from wheelhouse
+        run: |
+          # Install using only the local wheels for reproducibility / speed
+          uv pip install --no-index --find-links .wheelhouse "[dev]" || uv pip install --no-index --find-links .wheelhouse ".[dev]"
+
+      - name: Run ruff (via uv)
+        run: uv run ruff check .
+
+      - name: Check formatting with Black (via uv)
+        run: uv run python -m black --check .
+
+      - name: Run mypy (via uv)
+        run: uv run python -m mypy .
+
+      - name: Run pre-commit hooks (all files) via uv
+        run: |
+          uv run pre-commit install
+          uv run pre-commit run --all-files
+
+      - name: Run tests (with coverage) via uv
+        run: |
+          uv run pytest -q --cov=python_project_deployment --cov-report=xml:coverage.xml --cov-report=html:htmlcov
+
+      - name: Upload coverage xml
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-xml
+          path: coverage.xml
+
+      - name: Upload coverage HTML
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-html
+          path: htmlcov
+
+      - name: Build Sphinx docs via uv
+        run: |
+          uv run python -m sphinx -b html docs docs/_build/html || true
+
+      - name: Upload docs artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: docs-html
+          path: docs/_build/html
+
+  deploy-docs:
+    name: Publish docs to GitHub Pages
+    runs-on: ubuntu-latest
+    needs: test
+    # Only deploy on pushes to main (avoid publishing from PRs)
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Download docs artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: docs-html
+          path: docs/_build/html
+
+      - name: Upload pages artifact
+        uses: actions/upload-pages-artifact@v1
+        with:
+          path: docs/_build/html
+
+      - name: Deploy to GitHub Pages
+        uses: actions/deploy-pages@v1
+        with: {}

pyproject.toml

@@ -10,7 +10,7 @@ readme = "README.md"
 requires-python = ">=3.10"
 license = {text = "MIT"}
 authors = [
-    {name = "Magic Man", email = "magicman@example.com"},
+    {name = "Magic Man", email = "deleterious420+PythonProjectDeployment@gmail.com"},
 ]
 keywords = ["scaffolding", "template", "python", "package", "project"]
 classifiers = [
@@ -43,8 +43,8 @@ dev = [
 scaffold-python = "python_project_deployment.cli:main"
 
 [project.urls]
-Homepage = "https://github.com/magicman/python-project-deployment"
-Repository = "https://github.com/magicman/python-project-deployment"
+Homepage = "https://github.com/Magic-Man-us/PythonProjectDeployment"
+Repository = "https://github.com/Magic-Man-us/PythonProjectDeployment"
 
 [tool.hatch.build.targets.wheel]
 packages = ["python_project_deployment"]
@@ -54,12 +54,12 @@ testpaths = ["tests"]
 addopts = "--cov=python_project_deployment --cov-report=term-missing --cov-report=html"
 
 [tool.black]
-line-length = 88
-target-version = ['py310']
+line-length = 100
+target-version = ['py313']
 
 [tool.isort]
 profile = "black"
-line_length = 88
+line_length = 100
 
 [tool.mypy]
 python_version = "3.10"
@@ -68,6 +68,9 @@ warn_unused_configs = true
 disallow_untyped_defs = true
 
 [tool.ruff]
-line-length = 88
+line-length = 100
 target-version = "py310"
+
+[tool.ruff.lint]
 select = ["E", "F", "I", "N", "W", "B", "C4"]
+per-file-ignores = {"tests/*" = ["S101", "S108"]}