Add page "How to modernize a setup.py project?" #1371
Conversation
sinoroc
force-pushed
the
add-modernize-setup-py-project
branch
from
2f2a185 to
fc17418
Compare
sinoroc
force-pushed
the
add-modernize-setup-py-project
branch
from
fc17418 to
ae74041
Compare
github-merge-queue
bot
removed this pull request from the merge queue due to failed status checks
|
Thanks all for the help! :) |
| =================================== | ||
|
|
||
| A :term:`pyproject.toml` file is strongly recommended. | ||
| The presence of a :file:`pyproject.toml` file itself does not bring much. [#]_ |
There was a problem hiding this comment.
I realized that this prompts an inaccuracy in my understanding of the matter. See pypa/sampleproject#204 (comment).
@sinoroc I think this deserves a clarification. WDYT?
There was a problem hiding this comment.
@webknjaz As I stated in the other discussion thread you linked, I do not understand the issue.
The important thing is the content of pyproject.toml, first of all the build-system table.
I have been told, and I have written it in this document, that simply having an empty pyproject.toml triggers the "build isolation" behavior for pip (and other installers?). But that should be anecdotal nowadays (I heard it caused some issues at some point in the early days of PEP 517), isn't build isolation the default behavior for pip nowadays?
I am not sure how to improve this paragraph. Maybe we could move the whole sentence further down below or maybe even to a side note / foot note.
This is meant as a starting point. There is much more to say, and that can be said in follow-up pull requests.
Preview (but there were some small modifications on other pages as well, mainly links):
GitHub: refs #1334