test-patterns

Unified Pyramid Fixture Pattern for Tests

🎯 Use the Unified pyramid_app Fixture

ALWAYS use the unified pyramid_app fixture for new tests. This is the single, standardized way to create Pyramid applications in tests.

1. Basic Test Pattern

def test_basic_functionality(pyramid_app):
    """Use pyramid_app directly with defaults."""
    app = pyramid_app()
    
    response = app.post_json('/mcp', {
        'jsonrpc': '2.0',
        'id': 1,
        'method': 'tools/list'
    })
    assert response.status_code == 200

2. Test with Custom Settings

def test_custom_settings(pyramid_app):
    """Configure custom settings for your test."""
    settings = {
        "mcp.server_name": "custom-test-server",
        "mcp.mount_path": "/api/mcp"
    }
    app = pyramid_app(settings=settings)
    
    # Test with custom configuration
    response = app.post_json('/api/mcp', {...})
    assert response.status_code == 200

3. Test with Specific Views

def test_with_views(pyramid_app):
    """Add specific views for testing."""
    
    def my_test_view(request):
        return {"message": "test"}
    
    views = [
        (my_test_view, "test_route", {"renderer": "json"})
    ]
    app = pyramid_app(views=views)
    
    # Test the added view
    response = app.get('/test_route') 
    assert response.json == {"message": "test"}

4. Test with Limited Scanning

def test_scoped_tools(pyramid_app):
    """Limit tool scanning to specific module."""
    app = pyramid_app(scan_path="tests.unit.specific_module")
    
    # Only tools from specific_module will be available
    response = app.post_json('/mcp', {
        'jsonrpc': '2.0',
        'id': 1, 
        'method': 'tools/list'
    })
    # Verify only expected tools are listed

5. Test with Ignore Patterns

def test_ignore_problematic_modules(pyramid_app):
    """Ignore specific modules during scanning."""
    app = pyramid_app(ignore=["tests.cornice", "tests.integration.slow"])
    
    # Tools from ignored modules won't be available
    response = app.post_json('/mcp', {
        'jsonrpc': '2.0',
        'id': 1,
        'method': 'tools/list'
    })