feat: Add pre-commit hooks for code quality enforcement

- Add .pre-commit-config.yaml with ruff linter/formatter and mypy
- Add setup-pre-commit.sh script for easy installation
- Update pyproject.toml dev dependencies with pre-commit tools
- Fix pytest-anyio -> pytest-asyncio dependency name
- Add missing newline at end of pyproject.toml

This ensures all code is automatically formatted and linted on every commit,
maintaining consistent code quality across the project.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: codebydivine

.pre-commit-config.yaml

@@ -0,0 +1,31 @@
+# See https://pre-commit.com for more information
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.4
+    hooks:
+      # Run the linter
+      - id: ruff
+        args: [--fix]
+      # Run the formatter
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+      - id: check-json
+      - id: check-toml
+      - id: check-merge-conflict
+      - id: debug-statements
+        language_version: python3.13
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.14.1
+    hooks:
+      - id: mypy
+        additional_dependencies: [types-requests]
+        args: [--ignore-missing-imports]
+        files: ^src/

pyproject.toml

@@ -35,8 +35,11 @@ dependencies = [
 dev = [
     "pytest>=8.0",
     "pytest-cov>=4.0",
-    "pytest-anyio>=0.21",
+    "pytest-asyncio>=0.21",
     "python-dotenv>=1.0.0",
+    "pre-commit>=3.5.0",
+    "ruff>=0.8.0",
+    "mypy>=1.14.0",
 ]
 
 [project.urls]
@@ -90,4 +93,4 @@ python_version = "3.13"
 warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = false
-ignore_missing_imports = true
+ignore_missing_imports = true

scripts/setup-hooks.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+# Setup script for pre-commit hooks
+
+echo "🔧 Setting up pre-commit hooks for code formatting..."
+
+# Install pre-commit if in virtual environment
+if [[ "$VIRTUAL_ENV" != "" ]]; then
+    echo "✓ Virtual environment detected"
+else
+    echo "⚠️  No virtual environment detected. It's recommended to use one."
+    echo "   Run: python3 -m venv .venv && source .venv/bin/activate"
+    read -p "Continue anyway? (y/N) " -n 1 -r
+    echo
+    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+        exit 1
+    fi
+fi
+
+# Install dev dependencies
+echo "📦 Installing development dependencies..."
+pip install -e ".[dev]"
+
+# Install pre-commit hooks
+echo "🪝 Installing pre-commit hooks..."
+pre-commit install
+
+# Run against all files for the first time (optional)
+echo "🧹 Running formatters on all files..."
+pre-commit run --all-files || true
+
+echo "✅ Setup complete!"
+echo ""
+echo "Now ruff will automatically:"
+echo "  - Format your code on every commit"
+echo "  - Fix common linting issues"
+echo "  - Ensure consistent code style"
+echo ""
+echo "To manually run formatters: pre-commit run --all-files"

setup-pre-commit.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# Setup script for pre-commit hooks
+
+echo "Setting up pre-commit hooks for divine-thegraph-token-api..."
+
+# Install dev dependencies (including pre-commit)
+echo "Installing dev dependencies..."
+pip install -e ".[dev]"
+
+# Install pre-commit hooks
+echo "Installing pre-commit hooks..."
+pre-commit install
+
+# Run pre-commit on all files to show what it will do
+echo "Running pre-commit on all files (this will show and fix any formatting issues)..."
+pre-commit run --all-files
+
+echo ""
+echo "✅ Pre-commit hooks are now installed!"
+echo ""
+echo "From now on, every time you commit:"
+echo "  - Ruff will automatically fix code style issues"
+echo "  - Ruff formatter will format your code"
+echo "  - MyPy will check types"
+echo "  - Various file checks will run"
+echo ""
+echo "To manually run pre-commit: pre-commit run --all-files"
+echo "To bypass pre-commit (not recommended): git commit --no-verify"