debug-toolbar: Command for Claude Code

Testing Workflow

You are writing tests for: $ARGUMENTS

Pre-Testing Checklist

1. Load PRD from specs/active/{slug}/prd.md
2. Identify files to test from implementation
3. Read existing test patterns from tests/
4. Check coverage requirements (90%+)

Critical Rules

1. 90%+ COVERAGE - For all modified modules
2. PATTERN COMPLIANCE - Follow existing test structure
3. ASYNC CLEANUP - Always clean up context vars
4. FIXTURE USAGE - Use conftest.py fixtures
5. ISOLATION - Tests must work in parallel

---

Phase 1: Test Planning

Identify test scope:

# List modified files
git diff --name-only HEAD~1

# Check current coverage
make test-cov

For each module, identify:

• Public methods to test
• Edge cases
• Error conditions
• Integration points

Output: "✓ Phase 1 complete - Test scope identified"

---

Phase 2: Unit Tests

Follow the test pattern:

"""Tests for the {module} module."""

from __future__ import annotations

import pytest

from debug_toolbar.core.context import set_request_context


class TestClassName:
    """Tests for ClassName."""

    def test_method_basic(self) -> None:
        """Should describe expected behavior."""
        # Arrange
        # Act
        # Assert

    @pytest.mark.asyncio
    async def test_async_method(self, context) -> None:
        """Should describe async behavior."""
        set_request_context(None)  # Setup

        # Arrange
        # Act
        # Assert

        set_request_context(None)  # Cleanup

Key test patterns for debug-toolbar:

1. Panel tests:

   • Test generate_stats() returns expected structure
   • Test process_request() and process_response() lifecycle
   • Test get_panel_id() returns correct ID

2. Config tests:

   • Test default values
   • Test custom values
   • Test get_all_panels() with extras/excludes

3. Toolbar tests:

   • Test panel loading
   • Test request/response lifecycle
   • Test data collection