Добавить проверку существования версии пакета перед публикацией в Gitea Packages и обновить документацию о переменных окружения

.gitea/workflows/ci.yml

@@ -93,15 +93,75 @@ jobs:
           test -n "$PACKAGE_USERNAME" || (echo "PACKAGE_USERNAME secret is required" && exit 1)
           test -n "$PACKAGE_TOKEN" || (echo "PACKAGE_TOKEN secret is required" && exit 1)
 
+      - name: Check whether this package version already exists
+        id: package_registry
+        env:
+          PYPI_REPOSITORY_URL: ${{ secrets.PYPI_REPOSITORY_URL }}
+          PACKAGE_USERNAME: ${{ secrets.PACKAGE_USERNAME }}
+          PACKAGE_TOKEN: ${{ secrets.PACKAGE_TOKEN }}
+          PACKAGE_NAME: ${{ steps.package_meta.outputs.name }}
+          PACKAGE_VERSION: ${{ steps.package_meta.outputs.version }}
+        run: |
+          $HOME/.local/bin/uv run python - <<'PY' >> "$GITHUB_OUTPUT"
+          import base64
+          import os
+          import re
+          from urllib.error import HTTPError, URLError
+          from urllib.request import Request, urlopen
+
+          repository_url = os.environ['PYPI_REPOSITORY_URL'].rstrip('/')
+          package_name = os.environ['PACKAGE_NAME']
+          package_version = os.environ['PACKAGE_VERSION']
+          normalized_name = re.sub(r'[-_.]+', '-', package_name).lower()
+          filename_candidates = {
+              f"{re.sub(r'[-_.]+', '_', package_name)}-{package_version}",
+              f'{normalized_name}-{package_version}',
+          }
+          index_url = f'{repository_url}/simple/{normalized_name}/'
+          credentials = f"{os.environ['PACKAGE_USERNAME']}:{os.environ['PACKAGE_TOKEN']}".encode()
+          authorization = base64.b64encode(credentials).decode()
+          request = Request(index_url, headers={'Authorization': f'Basic {authorization}'})
+
+          try:
+              with urlopen(request, timeout=15) as response:
+                  page = response.read().decode('utf-8', 'replace')
+          except HTTPError as exc:
+              if exc.code == 404:
+                  print('exists=false')
+                  print(f'index_url={index_url}')
+              else:
+                  raise
+          except URLError as exc:
+              raise SystemExit(f'Unable to query package registry: {exc}') from exc
+          else:
+              exists = any(candidate in page for candidate in filename_candidates)
+              print(f"exists={'true' if exists else 'false'}")
+              print(f'index_url={index_url}')
+          PY
+
+      - name: Show package publish decision
+        run: |
+          echo "Registry index: ${{ steps.package_registry.outputs.index_url }}"
+          echo "Version exists: ${{ steps.package_registry.outputs.exists }}"
+
       - name: Build distribution
+        if: steps.package_registry.outputs.exists != 'true'
         run: PATH="$HOME/.local/bin:$PATH" make build
 
       - name: Check built artifacts
+        if: steps.package_registry.outputs.exists != 'true'
         run: PATH="$HOME/.local/bin:$PATH" uv run --with twine twine check dist/*
 
+      - name: Skip upload for existing package version
+        if: steps.package_registry.outputs.exists == 'true'
+        run: |
+          echo "Version ${{ steps.package_meta.outputs.version }} already exists in Gitea Packages."
+          echo "Bump [project].version in pyproject.toml to publish a new release."
+
       - name: Publish to Gitea PyPI registry
+        if: steps.package_registry.outputs.exists != 'true'
         env:
           TWINE_REPOSITORY_URL: ${{ secrets.PYPI_REPOSITORY_URL }}
           TWINE_USERNAME: ${{ secrets.PACKAGE_USERNAME }}
           TWINE_PASSWORD: ${{ secrets.PACKAGE_TOKEN }}
-        run: PATH="$HOME/.local/bin:$PATH" uv run --with twine twine upload --skip-existing dist/*
+        run: PATH="$HOME/.local/bin:$PATH" uv run --with twine twine upload dist/*

Makefile

@@ -27,16 +27,19 @@ package-version:
 	$(UV) run python -c "import tomllib; from pathlib import Path; print(tomllib.loads(Path('pyproject.toml').read_text(encoding='utf-8'))['project']['version'])"
 
 publish-gitea:
-	@test -n "$$GITEA_PYPI_REPOSITORY_URL" || (echo "GITEA_PYPI_REPOSITORY_URL is required" && exit 1)
+	@repository_url="$${PYPI_REPOSITORY_URL:-$$GITEA_PYPI_REPOSITORY_URL}"; \
-	@test -n "$$GITEA_PACKAGE_USERNAME" || (echo "GITEA_PACKAGE_USERNAME is required" && exit 1)
+	username="$${PACKAGE_USERNAME:-$$GITEA_PACKAGE_USERNAME}"; \
-	@test -n "$$GITEA_PACKAGE_TOKEN" || (echo "GITEA_PACKAGE_TOKEN is required" && exit 1)
+	token="$${PACKAGE_TOKEN:-$$GITEA_PACKAGE_TOKEN}"; \
-	@echo "Publishing version $$($(MAKE) --no-print-directory package-version)"
+	test -n "$$repository_url" || (echo "PYPI_REPOSITORY_URL or GITEA_PYPI_REPOSITORY_URL is required" && exit 1); \
-	$(UV) build
+	test -n "$$username" || (echo "PACKAGE_USERNAME or GITEA_PACKAGE_USERNAME is required" && exit 1); \
-	$(UV) run --with twine twine check dist/*
+	test -n "$$token" || (echo "PACKAGE_TOKEN or GITEA_PACKAGE_TOKEN is required" && exit 1); \
-	TWINE_REPOSITORY_URL="$$GITEA_PYPI_REPOSITORY_URL" \
+	echo "Publishing version $$($(MAKE) --no-print-directory package-version)"; \
-	TWINE_USERNAME="$$GITEA_PACKAGE_USERNAME" \
+	$(UV) build; \
-	TWINE_PASSWORD="$$GITEA_PACKAGE_TOKEN" \
+	$(UV) run --with twine twine check dist/*; \
-	$(UV) run --with twine twine upload --skip-existing dist/*
+	TWINE_REPOSITORY_URL="$$repository_url" \
+	TWINE_USERNAME="$$username" \
+	TWINE_PASSWORD="$$token" \
+	$(UV) run --with twine twine upload dist/*
 
 clean-branches:
 ifeq ($(OS),Windows_NT)

README.md

@@ -88,23 +88,26 @@ make build
 
 Публикация настроена в Gitea PyPI registry по документации Gitea Packages.
 Версия пакета берётся из секции [project] -> version в pyproject.toml.
+Gitea не поддерживает повторную публикацию той же версии, поэтому CI сначала проверяет registry и пропускает upload, если эта версия уже существует.
 
 Нужные secrets для CI workflow:
 
-- GITEA_PYPI_REPOSITORY_URL: полный endpoint вида https://gitea.example.com/api/packages/<owner>/pypi
+- PYPI_REPOSITORY_URL: полный endpoint вида https://gitea.example.com/api/packages/<owner>/pypi
-- GITEA_PACKAGE_USERNAME: пользователь Gitea
+- PACKAGE_USERNAME: пользователь Gitea
-- GITEA_PACKAGE_TOKEN: personal access token с правом package write
+- PACKAGE_TOKEN: personal access token с правом package write
 
 Публикация идёт автоматически на push в main после успешных lint/typecheck/test jobs.
-Если версия пакета уже существует в registry, upload будет пропущен через --skip-existing.
+Если версия пакета уже существует в registry, upload будет пропущен до вызова twine upload.
 Если версия в pyproject.toml увеличена, в Gitea Packages появится новая версия пакета, а старые версии останутся доступными.
 
 Локально тот же сценарий можно выполнить так:
 
 ```bash
-export GITEA_PYPI_REPOSITORY_URL="https://gitea.example.com/api/packages/<owner>/pypi"
+export PYPI_REPOSITORY_URL="https://gitea.example.com/api/packages/<owner>/pypi"
-export GITEA_PACKAGE_USERNAME="<username>"
+export PACKAGE_USERNAME="<username>"
-export GITEA_PACKAGE_TOKEN="<token>"
+export PACKAGE_TOKEN="<token>"
 make package-version
 make publish-gitea
 ```
+
+Для обратной совместимости локальная команда publish-gitea также принимает переменные GITEA_PYPI_REPOSITORY_URL, GITEA_PACKAGE_USERNAME и GITEA_PACKAGE_TOKEN.