# pyproject.toml

*noun*

say it: **“PY-praj-ekt dot TOM-ul”** **/ˈpaɪˌprɑdʒɛkt dɑt ˈtɑməl/**

A settings file at the top of a Python project that describes it in one place: its name, version, the packages it needs and how tools such as pytest and Ruff should behave.

## What is a `pyproject.toml` file?

A `pyproject.toml` file describes a Python project in one place: its name, version, the packages it needs and how tools should treat it.

```toml
[project]
name = "coffee-shop"
version = "1.0.0"
dependencies = ["requests>=2.32"]

[tool.pytest.ini_options]
testpaths = ["tests"]
```

## In a sentence

- “The project's name and version live in **pyproject.toml**.”
- “Ruff reads its rules from **pyproject.toml**, so everyone on the team gets the same checks.”

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

Updated: November 19, 2026

Source: https://www.ask-codey.com/glossary/pyproject-toml
