Skip to content

docs: update Poetry dependency groups for PEP 735 - #824

Merged
InessaPawson merged 2 commits into
pyOpenSci:mainfrom
simonvanlierde:fix-poetry-dependency-groups
Oct 14, 2026
Merged

InessaPawson merged 2 commits into
pyOpenSci:mainfrom
simonvanlierde:fix-poetry-dependency-groups

Conversation

@simonvanlierde

Copy link
Copy Markdown
Contributor

Hi! A small fix towards #492.

"Challenges with Poetry" on the build tools page says there is no Python standard for grouped dependencies, and that Poetry doesn't follow the standard format for development dependencies. Both have been out of date since PEP 735 and Poetry 2.2.0, so the page counts something against Poetry that no longer applies.

  • PEP 735 dependency groups are that standard, and the guide already recommends [dependency-groups] on its dependencies page. Poetry supports them since 2.2.0 (September 2025, "Add support for PEP 735 dependency groups").
  • I merged the two bullets into one: Poetry's own [tool.poetry.group.<name>.dependencies] format predates PEP 735, and Poetry 2.2 and later also read the standard [dependency-groups] table. It links to the guide's own dependency groups section.
  • I dropped "grouped dependencies are not optional", since Poetry has had optional groups for a while.
  • I kept the note on not confusing groups with optional dependencies (poetry add --optional=GROUP_NAME). That flag still takes an extra name in current Poetry.

Tests: nox -s docs-test passes locally, and so do the translated builds. I didn't touch the .po files.

Best,

Simon

The Poetry challenges said there is no standard for grouped or
development dependencies. PEP 735 dependency groups are that standard,
the guide already recommends them, and Poetry supports them since 2.2.
@netlify

netlify Bot commented Oct 13, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for python-package-guide ready!

Name Link
🔨 Latest commit 78de969
🔍 Latest deploy log https://app.netlify.com/projects/python-package-guide/deploys/6acf66378f4c2f595a5bbe44
😎 Deploy Preview https://deploy-preview-824--python-package-guide.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@InessaPawson InessaPawson added the documentation Improvements or additions to documentation label Oct 13, 2026
Comment thread package-structure-code/python-package-build-tools.md Outdated

@InessaPawson InessaPawson left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@simonvanlierde Thanks, Simon! The update is accurate and the cross-reference resolves. Just one inline suggestion to apply.

Co-authored-by: Inessa Pawson <inessapawson@gmail.com>
@simonvanlierde

Copy link
Copy Markdown
Contributor Author

Applied, thanks @InessaPawson!

@InessaPawson
InessaPawson merged commit b14fad0 into pyOpenSci:main Oct 14, 2026
4 of 7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants