# conftest.py

*noun*

say it: **“KON-test dot PIE”** **/ˈkɑnˌtɛst dɑt ˈpaɪ/**

A file that pytest reads first, holding setup that every test in its folder shares.

## What is **conftest.py**?

**conftest.py** is a file pytest reads before it runs the tests in its folder and the folders inside it. It holds
the set-up every one of those tests shares, such as fixtures or choosing matplotlib's Agg backend, so no test file
repeats it.

```python
# tests/conftest.py
import matplotlib
matplotlib.use("Agg")   # every chart test in this folder draws with no window
```

## In a sentence

- “The Agg setting lives in **conftest.py**, so no test file repeats it.”
- “pytest read **conftest.py** before any test in the folder ran.”

Level: Journeyman · [More Python terms at this level](https://www.ask-codey.com/glossary?category=python&level=3)

Updated: November 19, 2026

Source: https://www.ask-codey.com/glossary/conftest-py
