chore: deduplicate .pre-commit-config.yaml repos block

Author: Magic-Man-us

.github/dependabot.yml

@@ -1,6 +1,6 @@
 version: 2
 updates:
-  - package-ecosystem: "pip"
+  - package-ecosystem: "uv"
     directory: "/"
     schedule:
       interval: "weekly"

.github/workflows/ci.yaml

@@ -100,10 +100,12 @@ jobs:
           path: htmlcov
 
       - name: Build Sphinx docs via uv
+        if: "${{ matrix.python-version == '3.11' }}"
         run: |
           uv run python -m sphinx -b html docs docs/_build/html || true
 
       - name: Upload docs artifact
+        if: "${{ matrix.python-version == '3.11' }}"
         uses: actions/upload-artifact@v4
         with:
           name: docs-html

.github/workflows/ci.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: [3.10, 3.11, 3.12, 3.13, 3.14]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
       - name: Checkout repository
@@ -46,13 +46,13 @@ jobs:
       - name: Install build tools and uv
         run: |
           python -m pip install --upgrade pip setuptools wheel
-          pip install uv
+          python -m pip install uv
 
-      - name: Build wheelhouse for project and dev deps
+      - name: Build wheelhouse for project and dev deps (via uv)
         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]"
+          # Use uv-managed venv to build reproducibly
+          uv pip wheel -w .wheelhouse --no-build-isolation ".[dev]"
 
       - name: Create venv (uv)
         run: |
@@ -62,7 +62,7 @@ jobs:
       - 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]"
+          uv pip install --no-index --find-links .wheelhouse ".[dev]"
 
       - name: Run ruff (via uv)
         run: uv run ruff check .

.github/workflows/main.yml

@@ -0,0 +1,34 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+      - id: check-merge-conflict
+      - id: check-toml
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.1.6
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/psf/black
+    rev: 23.11.0
+    hooks:
+      - id: black
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.7.0
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - pydantic>=2.5.0
+          - aiohttp>=3.9.0
+          - click>=8.1.0
+          - beautifulsoup4>=4.12.0
+        args: [--ignore-missing-imports]
+        exclude: ^tests/

.pre-commit-config.yaml

@@ -0,0 +1,44 @@
+SHELL := /bin/bash
+.PHONY: help install sync test lint type format docs precommit clean
+
+help:
+	@echo "Available targets:"
+	@echo "  make install    # install uv (if missing) and sync dependencies"
+	@echo "  make sync       # uv sync --all-extras"
+	@echo "  make test       # run tests with coverage"
+	@echo "  make lint       # run ruff"
+	@echo "  make type       # run mypy"
+	@echo "  make format     # format with ruff"
+	@echo "  make docs       # build Sphinx docs"
+	@echo "  make precommit  # install pre-commit hooks"
+	@echo "  make clean      # remove build artifacts"
+
+install:
+	@command -v uv >/dev/null 2>&1 || \
+	  { echo "uv not found. Please install uv in your Python environment. Example:"; \
+	    echo "  python -m pip install --upgrade pip && python -m pip install uv"; exit 1; }
+	uv sync --all-extras
+
+sync:
+	uv sync --all-extras
+
+test:
+	uv run pytest --cov
+
+lint:
+	uv run ruff check .
+
+type:
+	uv run mypy src
+
+format:
+	uv run ruff format .
+
+docs:
+	uv run sphinx-build -b html docs docs/_build
+
+precommit:
+	uv run pre-commit install
+
+clean:
+	rm -rf .venv build dist htmlcov coverage.xml coverage.json docs/_build

Makefile

@@ -7,7 +7,7 @@ name = "python-project-deployment"
 version = "0.1.0"
 description = "A scaffolding tool for creating new Python packages with best practices"
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.13"
 license = {text = "MIT"}
 authors = [
     {name = "Magic Man", email = "deleterious420+PythonProjectDeployment@gmail.com"},
@@ -31,12 +31,18 @@ dependencies = [
 
 [project.optional-dependencies]
 dev = [
-    "pytest>=7.4.0",
+    "pytest>=8.0.0",
     "pytest-cov>=4.1.0",
-    "black>=23.7.0",
+    "black>=23.11.0",
     "isort>=5.12.0",
-    "mypy>=1.5.0",
-    "ruff>=0.0.287",
+    "mypy>=1.7.0",
+    "ruff>=0.14.0",
+    "pre-commit>=3.8.0",
+    "bandit>=1.7.0",
+    "safety>=2.0.0",
+    "sphinx>=7.0.0",
+    "sphinx-rtd-theme>=2.0.0",
+    "sphinx-autodoc-typehints>=2.2.0",
 ]
 
 [project.scripts]
@@ -55,22 +61,23 @@ addopts = "--cov=python_project_deployment --cov-report=term-missing --cov-repor
 
 [tool.black]
 line-length = 100
-target-version = ['py313']
+target-version = ['py312']
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+src = ["python_project_deployment", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "B", "C4"]
+per-file-ignores = {"tests/*" = ["S101", "S108"]}
 
 [tool.isort]
 profile = "black"
 line_length = 100
 
 [tool.mypy]
-python_version = "3.10"
+python_version = "3.13"
 warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = true
-
-[tool.ruff]
-line-length = 100
-target-version = "py313"
-
-[tool.ruff.lint]
-select = ["E", "F", "I", "N", "W", "B", "C4"]
-per-file-ignores = {"tests/*" = ["S101", "S108"]}

pyproject.toml

@@ -50,10 +50,10 @@ def main(
     verbose: bool,
 ) -> None:
     """Scaffold a new Python package with best practices.
-    
+
     PACKAGE_NAME: Valid Python package identifier (e.g., my_awesome_pkg)
     TARGET_DIR: Absolute path to parent directory for the project
-    
+
     Example:
         scaffold-python my_package /home/user/projects
     """
@@ -107,15 +107,16 @@ def main(
 
         # Success message
         click.echo("\n" + "=" * 50)
-        click.secho("✨ Scaffold complete!", fg="green", bold=True)
-        click.echo(f"\n📍 Project created at: {result_path}")
+        click.secho(" Scaffold complete!", fg="green", bold=True)
+        click.echo(f"\n Project created at: {result_path}")
 
-        click.echo("\n📖 Next steps:")
+        click.echo("\n Next steps:")
         click.echo(f"  1. cd {result_path}")
         click.echo("  2. source .venv/bin/activate  # (or use uv run)")
-        click.echo(f"  3. uv run python -c \"import {package_name}; print({package_name}.hello())\"")
+        example_cmd = f'uv run python -c "import {package_name}; print({package_name}.hello())"'
+        click.echo(f"  3. {example_cmd}")
 
-        click.echo("\n🔍 Available commands:")
+        click.echo("\n Available commands:")
         click.echo("  • Run tests: pytest")
         click.echo("  • View coverage: open htmlcov/index.html")
         click.echo("  • Build docs: sphinx-build -b html docs docs/_build/html")
@@ -140,6 +141,7 @@ def main(
         click.secho(f"\n❌ Unexpected Error: {e}", fg="red", bold=True)
         if verbose:
             import traceback
+
             click.echo("\n" + traceback.format_exc())
         sys.exit(1)
 

python_project_deployment/cli.py

@@ -8,7 +8,7 @@
 
 class ProjectConfig(BaseModel):
     """Configuration model for a Python project to be scaffolded.
-    
+
     Attributes:
         package_name: Valid Python package identifier
         target_dir: Absolute path to parent directory where project will be created
@@ -62,9 +62,7 @@ def validate_package_name(cls, v: str) -> str:
     def validate_target_dir(cls, v: Path) -> Path:
         """Validate that target_dir is an absolute path."""
         if not v.is_absolute():
-            raise ValueError(
-                f"target_dir must be an absolute path, got: {v}"
-            )
+            raise ValueError(f"target_dir must be an absolute path, got: {v}")
         return v
 
     @model_validator(mode="after")