Skip to content

fix: try harder to avoid a common user mistake#856

Merged
webknjaz merged 3 commits intopypa:mainfrom
henryiii:fix/838
Mar 9, 2021
Merged

fix: try harder to avoid a common user mistake#856
webknjaz merged 3 commits intopypa:mainfrom
henryiii:fix/838

Conversation

@henryiii
Copy link
Copy Markdown
Contributor

@henryiii henryiii commented Mar 9, 2021

Closes #838. This should make a common user mistake harder.

I do think this should produce a better error message, though, when setup.py does not contain a call to setuptools.setup(). Possibly via a change to setuptools or pip?

Comment on lines -204 to +203
.. code-block:: python
.. warning::
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

This provides a red box, while the IMPORTANT admonition didn't do anything very special.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Hopefully, changing the theme to furo or the one @pradyunsg is working on will improve this

installs. This file used to be required, but can be omitted in modern
setuptools. If you include the file, you must have a call to
:func:`setup()` in it:
setuptools.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Don't you still need to call setup() if you include it?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

This just moved to a red box with a warning. See the line below.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I guess I should wait a bit after waking up to give feedback on PRs 🤦

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I am truly blind.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@henryiii
Copy link
Copy Markdown
Contributor Author

henryiii commented Mar 9, 2021

96BBE04C-2931-4758-96E3-247B541AD4CF

@webknjaz webknjaz added the type: enhancement A self-contained enhancement or new feature label Mar 9, 2021
Comment thread source/tutorials/packaging-projects.rst Outdated
Co-authored-by: Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
Comment thread source/tutorials/packaging-projects.rst Outdated
Co-authored-by: Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
@webknjaz webknjaz merged commit 18c634a into pypa:main Mar 9, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type: enhancement A self-contained enhancement or new feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Step in packaging guide to create `setup.py' might cause confusion

3 participants