#pytest-8-doctests

.gitignore

/.*cache/
/__pycache__/

conftest.py

from __future__ import annotations

import warnings

import pytest


doctest_marker = pytest.mark.usefixtures("suppress_env")


@pytest.fixture
def suppress_env() -> None:
    warnings.filterwarnings("ignore", category=FutureWarning)


def pytest_itemcollected(item: pytest.Item) -> None:
    if isinstance(item, pytest.DoctestItem):
        item.add_marker(doctest_marker)

hatch.toml

[envs.default]
skip-install = true

[[envs.default.matrix]]
pt = ["7", "8"]

[envs.default.overrides]
matrix.pt.dependencies = [
  { value = "pytest==7.4.3", if = ["7"] },
  { value = "pytest==8.0.0.rc1", if = ["8"] },
]

[envs.default.scripts]
test = "pytest -vv --doctest-modules -Werror"

test_warnings.py

from __future__ import annotations

import warnings


def has_doctest() -> None:
    """Doctest!
    
    >>> import warnings
    >>> warnings.warn("Hi!", FutureWarning)
    """


def test_warn(suppress_env) -> None:
    warnings.warn("Hi!", FutureWarning)