pypa / pypa/packaging.python.org

Minimal version of setuptools supporting license-files

Open
#1,870 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
1.7k
Forks
1.7k
Avg merge
3d 12h
Merged PRs (30d)
4

Description

Issue Description

According to section Configuring setuptools using pyproject.toml files of the setuptools documentation, the minimal version is 77.0.3:

Support for project.license-files and SPDX license expressions in project.license (PEP 639) were introduced in version 77.0.0.

According to license and license-files in this guide, the minimal version is 77.0.3:

build backend versions that introduced PEP 639 support

hatchling setuptools flit-core [2] pdm-backend poetry-core
1.27.0 77.0.3 3.12 2.4.0 not yet

I understand that patch version 3 might simply fix early bugs, but I would prefer consistency. Should we modify the setuptools guide or the packaging guide? Commit https://github.com/pypa/packaging.python.org/commit/faf4c7d882ef2be310d5dc46d54ca666aa18821c doesn't explain why 77.0.3 should be preferred over 77.0.0 (or 77.0.1 since 77.0.0 appears to have been yanked).

Code of Conduct
  • I am aware that participants in this repository must follow the PSF Code of Conduct.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by comparing the setuptools guide's "Configuring setuptools using pyproject.toml files" section with the packaging guide's "license" and "license-files" section, then inspect commit faf4c7d882ef2be310d5dc46d54ca666aa18821c. Verify whether setuptools 77.0.0, 77.0.1, or 77.0.3 is the appropriate minimum and update the relevant documentation consistently, explaining the version choice.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.