Skip to content

Explain in which cases packages are automatically detected #10680

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
radoering merged 3 commits into from
Jan 16, 2026
+14 −2
Merged

Explain in which cases packages are automatically detected #10680

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
07f7994
docs: clarify automatic package detection
nothing-991 Jan 8, 2026
3b19b4c
docs: clarify when packages are automatically detected
nothing-991 Jan 13, 2026
8071422
use note instead of header; reword and add link
radoering Jan 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 14 additions & 2 deletions docs/pyproject.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -574,8 +574,20 @@ based on the `python` requirement, use `project.classifiers` instead of this set

A list of packages and modules to include in the final distribution.

If your project structure differs from the standard one supported by `poetry`,
you can specify the packages you want to include in the final distribution.
If packages are not automatically detected, you can specify the packages you want
to include in the final distribution.

{{% note %}}
Poetry automatically detects a single **module** or **package** whose name matches the
[normalized](https://packaging.python.org/en/latest/specifications/name-normalization/#name-normalization)
project name with `-` replaced with `_`.

The detected module or package must be located either:

- at the same level as the `pyproject.toml` file (flat layout), or
- inside a `src/` directory (src layout).

{{% /note %}}

```toml
[tool.poetry]
Expand Down