python-testing

Python and Testing Rules

Testing Requirements

Unit Tests are Mandatory

All new code must include unit tests.

• Minimum 90% code coverage
• Tests must pass before committing
• Use Vitest for TypeScript/JavaScript, pytest for Python

Running Tests

# Run all tests
uv run pytest

# Run with coverage
uv run pytest --cov=src/fruityloops_mcp --cov-report=term-missing

# Run specific test file
uv run pytest tests/test_server.py

# Run specific test
uv run pytest tests/test_server.py::TestFLStudioMCPServer::test_initialization

Writing Tests

Follow pytest conventions:

# File: tests/test_feature.py
import pytest
from fruityloops_mcp.module import Feature

class TestFeature:
    """Test suite for Feature class."""
    
    def test_basic_functionality(self):
        """Test basic functionality."""
        feature = Feature()
        result = feature.do_something()
        assert result is not None
    
    @pytest.mark.asyncio
    async def test_async_functionality(self):
        """Test async functionality."""
        feature = Feature()
        result = await feature.do_async()
        assert result == expected_value

Test Organization

tests/
├── __init__.py
├── test_server.py          # Server tests
├── test_midi.py            # MIDI interface tests
├── test_integration.py     # Integration tests
├── test_edge_cases.py      # Edge case tests
└── conftest.py             # Shared fixtures

Python Code Standards

Package Manager

Always use uv instead of npm, pip, or ts-node.

# ✅ Correct
uv run pytest
uv run python script.py
uv add package-name
uv sync

# ❌ Wrong
pip install package-name
python script.py
npm install

Code Quality Tools

Ruff for linting and formatting:

# Check code
uv run ruff check .

# Fix issues automatically
uv run ruff check --fix .

# Format code
uv run ruff format .

# Check formatting without changes
uv run ruff format --check .

Type Hints