🎉 feat(dev-tools): add rich-coverage development script

• 📝 Create rich-coverage runner script with uv script dependencies
• 🔄 Update Tests GitHub Actions workflow to include new coverage script
• ⬆️ Update pre-commit hook versions in .pre-commit-config.yaml
• 🚫 Exclude development scripts from package build
• 💡 Add documentation for running coverage reports during development

Author: Falamarcao

.github/workflows/1.2_unit_tests.yml

@@ -28,7 +28,7 @@ jobs:
             uv.lock
 
       - name: Install dependencies
-        run: uv sync --locked --all-groups --extra test --extra coverage
+        run: uv sync --locked --all-groups --extra test
 
       - name: Run code format
         run: uv run ruff format . --check

.github/workflows/1.3_docker_tests.yml

@@ -30,7 +30,7 @@ jobs:
             uv.lock
 
       - name: Install dependencies
-        run: uv sync --locked --all-groups --extra test --extra coverage
+        run: uv sync --locked --all-groups --extra test
 
       - name: Run Docker integration & E2E tests with coverage
         run: uv run coverage run --parallel-mode -m pytest -m "integration or e2e" -k "docker"

.github/workflows/1.4_kubernetes_tests.yml

@@ -58,7 +58,7 @@ jobs:
           echo "KUBERNETES__KUBECONFIG=$kube_config" >> $GITHUB_ENV
 
       - name: Install dependencies
-        run: uv sync --locked --all-groups --extra test --extra coverage
+        run: uv sync --locked --all-groups --extra test
 
       - name: Deploy Selenium Grid to KinD
         run: uv run mcp-selenium-grid helm deploy

.github/workflows/1_tests.yml

@@ -96,16 +96,10 @@ jobs:
         with:
           enable-cache: true
           cache-dependency-glob: |
-            pyproject.toml
-            uv.lock
-      
-      - name: Install dependencies
-        run: uv sync --locked --extra coverage
+            scripts/rich-coverage.py.lock
 
       - name: Combine and report coverage
-        run: |
-          uv run coverage report --format=markdown >> $GITHUB_STEP_SUMMARY
-          uv run ./scripts/check_coverage.py --format=html >> $GITHUB_STEP_SUMMARY
+        run: uv run ./scripts/rich-coverage.py --format=html >> $GITHUB_STEP_SUMMARY # no need to install dependencies
   check:
     name: Did all tests pass?
     if: always()

.pre-commit-config.yaml

@@ -1,10 +1,10 @@
 repos:
   - repo: https://github.com/astral-sh/uv-pre-commit
-    rev: 0.7.21
+    rev: 0.8.5
     hooks:
       - id: uv-lock
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.12.3
+    rev: v0.12.7
     hooks:
       - id: ruff
         args: [--fix]

CONTRIBUTING.md

@@ -88,7 +88,7 @@ git clone git@github.com:Falamarcao/mcp-selenium-grid.git
 cd mcp-selenium-grid
 
 # Create a virtual environment and install dev/test dependencies
-uv sync --all-groups --extra test --extra coverage
+uv sync --all-groups --extra test
 ```
 
 ### 3. Kubernetes Setup (Optional)
@@ -178,8 +178,8 @@ uv run pytest -m integration
 uv run pytest -m e2e
 
 # Run with coverage
-uv run coverage run -m pytest -m unit
-uv run coverage report
+uv run scripts/rich-coverage.py
+uv run scripts/rich-coverage.py --format=html
 ```
 
 #### 🧪 CI & Workflow Testing
@@ -211,7 +211,7 @@ uv run ruff clean             # Clear ruff cache
 
 ## 📦 Dependency Management
 
-- Install all dependencies: `uv sync --all-groups --extra test --extra coverage`
+- Install all dependencies: `uv sync --all-groups --extra test`
 - Add a dependency: `uv add <package>`
 - Add a dev dependency: `uv add <package> --dev`
 - Add a test dependency: `uv add <package> --optional test`

pyproject.toml

@@ -3,7 +3,7 @@
 # AI Agents and contributors: Please assume uv is the default tool for all dependency and environment management in this project.
 # You do NOT need to ask the user if uv is being used—always use uv commands for installs, updates, and checks.
 #
-# - Install all dependencies: `uv sync --all-groups --extra test --extra coverage`
+# - Install all dependencies: `uv sync --all-groups --extra test`
 # - Add a dependency: `uv add <package>`
 # - Add a dev dependency: `uv add <package> --dev`
 # - Add a test dependency: `uv add <package> --optional test`
@@ -57,10 +57,7 @@ test = [
     "pytest-mock>=3.14.1",
     "pytest-asyncio>=1.0.0", # Parallel test execution
     "pytest-sugar>=1.0.0",
-]
-
-coverage = [
-    "coverage[toml]>=7.9.2",
+    "coverage>=7.10.2",
 ]
 
 [build-system]
@@ -73,7 +70,7 @@ packages = ["src/app"]
 [tool.ruff]
 line-length = 100
 target-version = "py312"
-src = ["src/app", "src/tests"]
+src = ["src/app", "src/tests", "scripts"]
 
 [tool.ruff.lint]
 extend-select = [
@@ -96,7 +93,7 @@ disallow_untyped_defs = true
 check_untyped_defs = true
 
 [[tool.mypy.overrides]]
-module = ["fastapi_mcp", "sh"]
+module = ["fastapi_mcp"]
 ignore_missing_imports = true
 
 [tool.pytest.ini_options]

scripts/check_coverage.py

@@ -0,0 +1,32 @@
+#!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.12"
+# dependencies = [
+#     "coverage",
+#     "rich",
+#     "typer",
+# ]
+# ///
+# https://docs.astral.sh/uv/guides/scripts/#using-a-shebang-to-create-an-executable-file
+"""
+Runner script for rich_coverage module.
+
+This script exists to provide a convenient way to run the rich_coverage
+module during development without including it in the project's build artifacts.
+
+It uses uv's script functionality to manage dependencies automatically and
+adds the scripts directory to Python's path to enable module imports.
+
+Usage:
+    uv run scripts/rich-coverage.py
+    uv run ./scripts/rich-coverage.py --format=html
+
+Lock dependencies (automatic with pre-commit hook):
+    uv lock --script scripts/rich-coverage.py
+
+"""
+
+from rich_coverage import rich_coverage_cli
+
+if __name__ == "__main__":
+    rich_coverage_cli()