From 62872812bc31ede8a7d752924d94b0187de11276 Mon Sep 17 00:00:00 2001 From: Aria Ghasedi Date: Sun, 6 Sep 2026 11:32:08 +0330 Subject: [PATCH 1/2] docs: update links to relocated PyPI documentation PyPI's user documentation moved from warehouse.pypa.io/api-reference/ to docs.pypi.org, and pipx moved off pypa.github.io. Six links across three docs pages currently 404: warehouse.pypa.io/api-reference/json.html -> docs.pypi.org/api/json/ warehouse.pypa.io/api-reference/legacy.html#upload-api (x3) -> docs.pypi.org/api/upload/ warehouse.pypa.io/api-reference/xml-rpc.html#deprecated-methods -> docs.pypi.org/api/#api-preference pypa.github.io/pipx/ -> pipx.pypa.io/stable/ The XML-RPC page has no direct successor, since that API was dropped rather than moved. The API Preference section of docs.pypi.org/api/ now carries the deprecation notice the old anchor pointed at, so the surrounding sentence about PyPI search still reads correctly. All replacement URLs verified to return 200. --- docs/cli.md | 2 +- docs/contributing.md | 2 +- docs/repositories.md | 8 ++++---- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/cli.md b/docs/cli.md index 5abc0a31ddb..4deef4c6c94 100644 --- a/docs/cli.md +++ b/docs/cli.md @@ -949,7 +949,7 @@ poetry search requests pendulum PyPI no longer allows for the search of packages without a browser. Please use https://pypi.org/search (via a browser) instead. -For more information, please see [warehouse documentation](https://warehouse.pypa.io/api-reference/xml-rpc.html#deprecated-methods) +For more information, please see [warehouse documentation](https://docs.pypi.org/api/#api-preference) and this [discussion](https://discuss.python.org/t/fastly-interfering-with-pypi-search/73597/6). {{% /note %}} diff --git a/docs/contributing.md b/docs/contributing.md index 40900d5acfe..4c1b2da01aa 100644 --- a/docs/contributing.md +++ b/docs/contributing.md @@ -238,7 +238,7 @@ present), and the development branch. #### Multiple versions When trying to reproduce issues, you often want to use multiple versions of Poetry at the same time. -[pipx](https://pypa.github.io/pipx/) makes this easy to do: +[pipx](https://pipx.pypa.io/stable/) makes this easy to do: ```sh pipx install --suffix @1.2.1 'poetry==1.2.1' diff --git a/docs/repositories.md b/docs/repositories.md index 9c3b5c40054..2dfbe7274d8 100644 --- a/docs/repositories.md +++ b/docs/repositories.md @@ -69,7 +69,7 @@ poetry add --source foo private-package Great, now all that is left is to publish your package. Assuming you'd want to share it privately with your team, you can configure the -[Upload API](https://warehouse.pypa.io/api-reference/legacy.html#upload-api) endpoint for your +[Upload API](https://docs.pypi.org/api/upload/) endpoint for your [publishable repository](#publishable-repositories). ```bash @@ -332,7 +332,7 @@ to be provided only by one specific source to avoid dependency confusion attacks #### Python Package Index (PyPI) Poetry interacts with [PyPI](https://pypi.org) via its -[JSON API](https://warehouse.pypa.io/api-reference/json.html). This is used to retrieve a requested +[JSON API](https://docs.pypi.org/api/json/). This is used to retrieve a requested package's versions, metadata, files, etc. {{% note %}} @@ -430,7 +430,7 @@ well. Poetry treats repositories to which you publish packages as user-specific and not project-specific configuration unlike [package sources](#package-sources). Poetry, today, only supports the -[Legacy Upload API](https://warehouse.pypa.io/api-reference/legacy.html#upload-api) when publishing +[Legacy Upload API](https://docs.pypi.org/api/upload/) when publishing your project. These are configured using the [`config`]({{< relref "cli#config" >}}) command, under the @@ -442,7 +442,7 @@ poetry config repositories.testpypi https://test.pypi.org/legacy/ {{% note %}} -[Legacy Upload API](https://warehouse.pypa.io/api-reference/legacy.html#upload-api) URLs are +[Legacy Upload API](https://docs.pypi.org/api/upload/) URLs are typically different to the same one provided by the repository for the simple API. You'll note that in the example of [Test PyPI](https://test.pypi.org/), both the host (`test.pypi.org`) as well as the path (`/legacy`) are different to its simple API (`https://test.pypi.org/simple`). From a1f4191c2e401d29a35562a7eade3d64c02d3a36 Mon Sep 17 00:00:00 2001 From: Aria Ghasedi Date: Sun, 6 Sep 2026 14:42:36 +0330 Subject: [PATCH 2/2] docs: rename link text to match its new destination The link now points at docs.pypi.org rather than warehouse.pypa.io, so 'warehouse documentation' no longer describes where it lands. --- docs/cli.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cli.md b/docs/cli.md index 4deef4c6c94..6ae01de6328 100644 --- a/docs/cli.md +++ b/docs/cli.md @@ -949,7 +949,7 @@ poetry search requests pendulum PyPI no longer allows for the search of packages without a browser. Please use https://pypi.org/search (via a browser) instead. -For more information, please see [warehouse documentation](https://docs.pypi.org/api/#api-preference) +For more information, please see [PyPI API documentation](https://docs.pypi.org/api/#api-preference) and this [discussion](https://discuss.python.org/t/fastly-interfering-with-pypi-search/73597/6). {{% /note %}}