Testing guidelines

This doc explains how we test the frontend parsers and the online API.

Local unit tests

• Use pytest + pytest-asyncio.

• Mock HTTP (no network) by monkeypatching _fetch_text and _autodetect_index_url.

Example layout:

tests/
  test_utils.py
  test_resolver.py
  test_parser.py
  test_parser_i18n.py
  test_api.py
  test_api_live.py
  conftest.py

conftest.py (live toggle + session)

conftest.py

"""Pytest configuration and shared fixtures.

This module contains pytest configuration settings and shared fixtures
used across the test suite.
"""

import pytest


@pytest.fixture(scope="session")
def anyio_backend() -> str:
    """Configure asyncio as the async backend for tests.

    Returns:
        str: The async backend name to use for testing.
    """
    return "asyncio"

Example Test File

See the existing test files in the tests/ directory for examples of proper test structure and patterns.