Skip to content

Add clarification about PyPI package name source#615

Open
M-Nagamani wants to merge 2 commits intopyOpenSci:mainfrom
M-Nagamani:main
Open

Add clarification about PyPI package name source#615
M-Nagamani wants to merge 2 commits intopyOpenSci:mainfrom
M-Nagamani:main

Conversation

@M-Nagamani
Copy link

Adds a short explanation clarifying that the package name used by PyPI is defined in pyproject.toml. This helps explain why a package may need to be renamed if the name is already taken.

Fixes #244

Adds a short explanation clarifying that the package name used by PyPI is defined in `pyproject.toml`. This helps explain why a package may need to be renamed if the name is already taken.
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
@M-Nagamani
Copy link
Author

Thanks for the suggestion! I've updated the text accordingly.


Before renaming your package, it helps to understand where the PyPI package name comes from. The name that PyPI registers is defined in the `pyproject.toml` file under the `[project]` section. This name does not have to match your GitHub repository name, but many projects keep them the same for clarity.

If the name in `pyproject.toml` is already taken on PyPI, you will need to choose a different name before publishing.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
If the name in `pyproject.toml` is already taken on PyPI, you will need to choose a different name before publishing.
If the name in `pyproject.toml` is already taken on PyPI, you will need to choose a different name before publishing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Python Package Guide: Fix breakout box / admonition that shows a user how to rename their package if the name is taken on pypi

3 participants