From 6310e88054b084509f384ce9f66a9f6a64c731c0 Mon Sep 17 00:00:00 2001 From: Nagamani Chittem Date: Wed, 11 Mar 2026 20:13:27 -0400 Subject: [PATCH 1/2] Add clarification about PyPI package name source 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. --- tutorials/publish-pypi.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/tutorials/publish-pypi.md b/tutorials/publish-pypi.md index e69aa3de..232e42ae 100644 --- a/tutorials/publish-pypi.md +++ b/tutorials/publish-pypi.md @@ -214,6 +214,10 @@ Example: `pyosPackage_yourNameHere`. :class: tip :class: secondary +Before renaming your package, it helps to understand where the package name used by PyPI 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. + #### Required 1. Search your publishing location(s) to make sure your new name isn't taken ([TestPyPI](https://test.pypi.org/), [PyPI](https://pypi.org/), [conda-forge](https://conda-forge.org/packages/)) From 2099cc9ba3e05993e685c21c2df94f2b70742edb Mon Sep 17 00:00:00 2001 From: Nagamani Chittem Date: Fri, 13 Mar 2026 10:18:00 -0400 Subject: [PATCH 2/2] Update tutorials/publish-pypi.md Co-authored-by: Carol Willing --- tutorials/publish-pypi.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/tutorials/publish-pypi.md b/tutorials/publish-pypi.md index 232e42ae..87883646 100644 --- a/tutorials/publish-pypi.md +++ b/tutorials/publish-pypi.md @@ -214,10 +214,9 @@ Example: `pyosPackage_yourNameHere`. :class: tip :class: secondary -Before renaming your package, it helps to understand where the package name used by PyPI 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. +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. #### Required 1. Search your publishing location(s) to make sure your new name isn't taken ([TestPyPI](https://test.pypi.org/), [PyPI](https://pypi.org/), [conda-forge](https://conda-forge.org/packages/))