Merge branch 'main' into ctty/static-provider

Author: CTTY

.github/workflows/release_python_nightly.yml

@@ -128,9 +128,36 @@ jobs:
       - name: List downloaded artifacts
         run: ls -R bindings/python/dist
       - name: Publish to TestPyPI
+        id: publish-testpypi
+        continue-on-error: true
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
           repository-url: https://test.pypi.org/legacy/
           skip-existing: true
           packages-dir: bindings/python/dist
           verbose: true
+      - name: Display error message on publish failure
+        if: steps.publish-testpypi.outcome == 'failure'
+        run: |
+          echo "::error::Failed to publish to TestPyPI"
+          echo ""
+          echo "⚠️  TestPyPI Publish Failed"
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          echo ""
+          echo "This may be due to TestPyPI storage limits."
+          echo "See: https://docs.pypi.org/project-management/storage-limits"
+          echo ""
+          echo "To resolve this issue, use the pypi-cleanup utility to clean up old TestPyPI artifacts:"
+          echo "https://pypi.org/project/pypi-cleanup/"
+          echo ""
+          echo "  uvx pypi-cleanup --package pyiceberg-core --host https://test.pypi.org/ \\"
+          echo "    --verbose -d 10 --do-it --username <username>"
+          echo ""
+          echo "Requirements:"
+          echo "  • Must be a maintainer for pyiceberg-core on TestPyPI"
+          echo "    (https://test.pypi.org/project/pyiceberg-core)"
+          echo "  • Requires TestPyPI password and 2FA"
+          echo "  • ⚠️  ONLY do this for TestPyPI, NOT for production PyPI!"
+          echo ""
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          exit 1