Configuration Reference¶

CLI Options¶

Option	Description
`--pep723-check`	Enable PEP 723 inline script dependency checks
`--pep723-paths PATH`	Directory to scan (repeatable)
`--pep723-ignore NAME`	Import name to ignore (repeatable)

All options go under [tool.pytest.ini_options]:

Directories to scan for PEP 723 scripts, relative to the project root. One path per line.

[tool.pytest.ini_options]
pep723_paths =
    src/mypkg
    scripts

When no paths are configured and --pep723-paths is not given, the plugin scans all .py files collected by pytest.

Import names to skip during validation. Use for internal packages, conda-only deps, or intentionally optional imports. One name per line.

[tool.pytest.ini_options]
pep723_ignore_imports =
    mypkg
    ira_mod
    tblite

Additional import-to-package mappings. One import=package pair per line. These extend the built-in mapping table.

[tool.pytest.ini_options]
pep723_extra_mappings =
    myspecial=my-special-pkg
    gi=pygobject

The plugin registers a pep723 marker. Use it for selective runs:

# Run only PEP 723 checks
pytest --pep723-check -m pep723

# Exclude PEP 723 checks
pytest -m "not pep723"