From c161b7baadf6b633954c1e2107ddbb4a59cf17f1 Mon Sep 17 00:00:00 2001 From: Herrtian <70463940+Herrtian@users.noreply.github.com> Date: Mon, 4 May 2026 20:08:24 +0200 Subject: [PATCH 1/3] Warn about artifact action behavior for wheel matrices --- ...-releases-using-github-actions-ci-cd-workflows.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst b/source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst index a3d893c9f..de7aedf49 100644 --- a/source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst +++ b/source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst @@ -107,6 +107,15 @@ build the distribution packages. First, we'll define the job for building the dist packages of your project and storing them for later use: +.. warning:: + + This artifact configuration is intended for a single build job that uploads + one source distribution and one wheel. If you adapt it for several + platform-specific wheel jobs, use separate artifact names for each job and + adjust the download step accordingly. The v4+ artifact actions do not support + multiple jobs uploading to the same artifact; see + `actions/upload-artifact#472`_. + .. literalinclude:: github-actions-ci-cd-sample/publish-to-pypi.yml :language: yaml :start-at: jobs: @@ -228,6 +237,8 @@ sure that your release pipeline remains healthy! https://github.com/actions/download-artifact .. _`upload-artifact`: https://github.com/actions/upload-artifact +.. _`actions/upload-artifact#472`: + https://github.com/actions/upload-artifact/issues/472 .. _Secrets: https://docs.github.com/en/actions/reference/encrypted-secrets .. _Trusted Publishing: https://docs.pypi.org/trusted-publishers/ From c2b117966ee647240e3f69217103f92f3b61f901 Mon Sep 17 00:00:00 2001 From: Herrtian <70463940+Herrtian@users.noreply.github.com> Date: Tue, 5 May 2026 10:23:53 +0200 Subject: [PATCH 2/3] Shorten artifact note --- ...eleases-using-github-actions-ci-cd-workflows.rst | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst b/source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst index de7aedf49..8af6f8c08 100644 --- a/source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst +++ b/source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst @@ -107,14 +107,11 @@ build the distribution packages. First, we'll define the job for building the dist packages of your project and storing them for later use: -.. warning:: +.. tip:: - This artifact configuration is intended for a single build job that uploads - one source distribution and one wheel. If you adapt it for several - platform-specific wheel jobs, use separate artifact names for each job and - adjust the download step accordingly. The v4+ artifact actions do not support - multiple jobs uploading to the same artifact; see - `actions/upload-artifact#472`_. + If you adapt this workflow to build multiple platform-specific wheels, use + uniquely named artifacts for each build job and adjust the download step + accordingly. .. literalinclude:: github-actions-ci-cd-sample/publish-to-pypi.yml :language: yaml @@ -237,8 +234,6 @@ sure that your release pipeline remains healthy! https://github.com/actions/download-artifact .. _`upload-artifact`: https://github.com/actions/upload-artifact -.. _`actions/upload-artifact#472`: - https://github.com/actions/upload-artifact/issues/472 .. _Secrets: https://docs.github.com/en/actions/reference/encrypted-secrets .. _Trusted Publishing: https://docs.pypi.org/trusted-publishers/ From abde967845ae11152687afa05bde062269fb8a03 Mon Sep 17 00:00:00 2001 From: TT <70463940+Herrtian@users.noreply.github.com> Date: Tue, 5 May 2026 16:57:45 +0200 Subject: [PATCH 3/3] Link cibuildwheel examples from artifact tip --- ...ibution-releases-using-github-actions-ci-cd-workflows.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst b/source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst index 8af6f8c08..3b5e6ed28 100644 --- a/source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst +++ b/source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst @@ -111,7 +111,8 @@ your project and storing them for later use: If you adapt this workflow to build multiple platform-specific wheels, use uniquely named artifacts for each build job and adjust the download step - accordingly. + accordingly. The `cibuildwheel GitHub Actions examples`_ show a fuller + wheel matrix layout. .. literalinclude:: github-actions-ci-cd-sample/publish-to-pypi.yml :language: yaml @@ -237,3 +238,5 @@ sure that your release pipeline remains healthy! .. _Secrets: https://docs.github.com/en/actions/reference/encrypted-secrets .. _Trusted Publishing: https://docs.pypi.org/trusted-publishers/ +.. _`cibuildwheel GitHub Actions examples`: + https://cibuildwheel.pypa.io/en/latest/ci-services/#github-actions