# Run basic usage example
uv run python examples/basic_usage.py

# Run async loading example
uv run python examples/async_loading.py

# Run any example
uv run python examples/<example_name>.py

<Warning>
  Always use meaningful variable names. Avoid single-letter variables except for common cases like `i`, `j` in loops or `e` for exceptions.
</Warning>

## Testing Guidelines

### Test Requirements

<Steps>
  <Step title="Write tests for all new features">
    Every new feature must include comprehensive tests
  </Step>
  
  <Step title="Maintain 80%+ code coverage">
    Coverage must not decrease with new changes (enforced by CI)
  </Step>
  
  <Step title="Use pytest fixtures">
    Leverage fixtures for common setup and teardown
  </Step>
  
  <Step title="Mock external dependencies">
    Use mocks for HTTP requests and file I/O in unit tests
  </Step>
  
  <Step title="Add integration tests">
    Include integration tests for features that interact with real data
  </Step>
</Steps>

### Test Structure

```python Example Test
import pytest
from unittest.mock import Mock, patch
import tif1

class TestSession:
    """Tests for Session class."""
    
    @pytest.fixture
    def mock_session(self):
        """Create a mock session for testing."""
        return tif1.get_session(2025, "Test GP", "Race")
    
    def test_get_driver_valid(self, mock_session):
        """Test getting a valid driver."""
        with patch('tif1.core.Session.drivers_df') as mock_drivers:
            mock_drivers.return_value = pd.DataFrame({
                'Driver': ['VER', 'HAM'],
                'Team': ['Red Bull', 'Mercedes']
            })
            
            driver = mock_session.get_driver('VER')
            assert driver.code == 'VER'
    
    def test_get_driver_invalid(self, mock_session):
        """Test getting an invalid driver raises error."""
        with pytest.raises(tif1.DriverNotFoundError):
            mock_session.get_driver('XXX')
    
    @pytest.mark.benchmark
    def test_laps_loading_performance(self, benchmark):
        """Benchmark laps loading performance."""
        session = tif1.get_session(2025, "Test GP", "Race")
        result = benchmark(lambda: session.laps)
        assert len(result) > 0

# Run benchmarks
uv run pytest -o addopts='' tests/test_benchmarks.py -v -m benchmark --benchmark-only --no-cov -n 0

# Compare with baseline
uv run pytest tests/test_benchmarks.py --benchmark-compare