Skip to content

manual_test.md

Latest commit

 

History

History
115 lines (86 loc) · 2.58 KB

manual_test.md

File metadata and controls

115 lines (86 loc) · 2.58 KB

Manual Testing Guide

Prerequisites

  1. Ensure you're in a git repository with some changes
  2. Install uv following instructions at: https://docs.astral.sh/uv/getting-started/installation/
  3. Install dependencies: 
    uv sync --all-extras

Test 1: Validate the Solution

Run the automated validation script:

uv run python validate_solution.py

This will check:

  • Git environment
  • Python imports
  • Server creation
  • Tool registration
  • Tool execution
  • Template creation

Test 2: Run Unit Tests

uv run pytest test_server.py -v

Test 3: Test with Claude Code

  1. Configure MCP Server

    Add the server to Claude Code:

    # Add the MCP server
claude mcp add pr-agent -- uv --directory /absolute/path/to/module1/solution run server.py

# Verify it's configured
claude mcp list

  2. Restart Claude Code to pick up the new server

  3. Make Some Git Changes

    In any git repository:

    echo "test change" >> README.md
git add README.md

  4. Test with Claude

    Ask Claude:

    • "Can you analyze my git changes?"
    • "What PR templates are available?"
    • "Based on my changes, which PR template should I use?"

Test 4: Direct Server Testing

You can also test the server directly:

import asyncio
from server import analyze_file_changes, get_pr_templates, suggest_template

async def test():
    # Test analyze_file_changes
    changes = await analyze_file_changes("main", True)
    print("Changes:", changes[:200] + "...")
    
    # Test get_pr_templates
    templates = await get_pr_templates()
    print("Templates available:", len(json.loads(templates)))
    
    # Test suggest_template
    suggestion = await suggest_template(
        "Fixed authentication bug", 
        "bug"
    )
    print("Suggestion:", json.loads(suggestion)["recommended_template"]["type"])

asyncio.run(test())

Expected Behavior

  1. analyze_file_changes should return JSON with:

    • base_branch
    • files_changed
    • statistics
    • commits
    • diff (if include_diff=True)

  2. get_pr_templates should return JSON array of templates with:

    • filename
    • type
    • content

  3. suggest_template should return JSON with:

    • recommended_template
    • reasoning
    • template_content
    • usage_hint

Troubleshooting

  • "Git not found": Ensure you're in a git repository
  • Import errors: Check virtual environment is activated
  • MCP connection failed: Verify the path in the claude mcp add command is absolute
  • No tools showing: Restart Claude Code after adding the server