Testing¶

Running Tests¶

# Run all tests
uv run pytest

# Verbose output
uv run pytest -v

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

# Run tests matching pattern
uv run pytest -k "test_settings"

# Run in parallel (uses pytest-xdist)
uv run pytest -n auto

# With coverage
uv run pytest --cov=src/code_context_agent

Test Structure¶

tests/
├── test_hooks.py                  # HookProvider tests (incl. FailFastHook)
├── test_prompts.py                # Prompt rendering tests
├── test_prompts_mode.py           # Mode-aware prompt tests (v7)
├── test_config_mode.py            # AnalysisMode + full settings tests (v7)
├── test_cli.py                    # CLI helper function tests
├── test_cli_full.py               # --full mode CLI tests (v7)
├── agent/
│   └── test_runner.py             # Analysis runner tests
├── consumer/
│   ├── test_phases.py             # Phase detection tests (v7)
│   ├── test_discovery.py          # Discovery event tests (v7)
│   ├── test_state_v7.py           # Phase/discovery state tests (v7)
│   └── test_rich_consumer.py      # Rich consumer TUI tests (v7)
├── models/
│   └── test_output.py             # Output model tests (incl. PhaseTimingItem)
└── tools/
    ├── test_discovery.py          # Discovery tool tests
    ├── test_git.py                # Git tool tests
    ├── test_shell_security.py     # Shell security enforcement tests
    └── graph/
        ├── test_adapters.py       # Graph adapter tests
        ├── test_analysis.py       # Graph analysis tests
        ├── test_model.py          # Graph model tests
        └── test_tools.py          # Graph tool tests

The test suite covers models, tools, graph analysis, prompt rendering, phase detection, TUI rendering, CLI flags, and security enforcement. Run uv run pytest to see the current count (285 as of v7.0.0).

Configuration¶

Pytest is configured in pyproject.toml:

[tool.pytest.ini_options]
testpaths = ["tests"]
asyncio_mode = "auto"
asyncio_default_fixture_loop_scope = "function"

asyncio_mode = "auto" -- Automatically detects and runs async test functions
asyncio_default_fixture_loop_scope = "function" -- Each test gets its own event loop

Writing Tests¶

Async Tests¶

Async tests run automatically thanks to asyncio_mode = "auto":

async def test_async_operation():
    result = await some_async_function()
    assert result is not None

Per-file Ignores¶

Test files have relaxed linting rules (configured in pyproject.toml):

D -- Docstrings not required in tests
S101 -- assert statements allowed
ARG -- Unused arguments allowed (common in fixtures)

Shell Security Tests¶

The test_shell_security.py file validates the shell tool's security enforcement:

# Verifies allowed commands pass validation
def test_allows_safe_commands(self, cmd):
    assert _validate_command(cmd) is None

# Verifies shell operators are blocked
def test_blocks_shell_operators(self, cmd):
    result = _validate_command(cmd)
    assert result is not None
    assert "Blocked" in result

# Verifies git write operations are blocked
def test_blocks_git_write_ops(self, cmd):
    result = _validate_command(cmd)
    assert result is not None
    assert "read-only" in result

Tests cover allowed programs, blocked programs, shell operator blocking, git read-only enforcement, sensitive path prevention, and full integration through the shell tool function.