Fix outdated comments about artifact paths and skip behavior

Michał Kudela · Michał Kudela · commit 44c3fd880fc1 · 2026-04-02T07:33:00.000Z
diff --git a/scripts/ci-helpers/hiveio_api_package.gitlab-ci.yml b/scripts/ci-helpers/hiveio_api_package.gitlab-ci.yml
@@ -39,7 +39,7 @@
 #                               to the upstream (hive) project's registry
 #
 # Artifacts:
-#   - ${API_GENERATION_DIR}/python_api_package/dist/*.whl Built wheel (only present when built locally)
+#   - ${API_GENERATION_DIR}/python_api_package/dist/*.whl Built or downloaded wheel
 #   - build_wheel.env                                     Environment file with WHEEL_BUILD_VERSION (always)
 
 .hiveio_api_package_template:
diff --git a/scripts/ci-helpers/hiveio_api_package.sh b/scripts/ci-helpers/hiveio_api_package.sh
@@ -8,7 +8,8 @@
 #   3. If exists: creates env file and exits (skips generation/build entirely)
 #   4. If not: generates package, builds wheel, runs tests, and deploys to registry
 #
-# The output artifacts are identical regardless of build or download path.
+# The build_wheel.env artifact is always created with the resolved version.
+# When the version exists in the registry, generation and build are skipped entirely.
 #
 # Usage:
 #   ./hiveio_api_package.sh [options]

Original file line number	Diff line number	Diff line change
`@@ -39,7 +39,7 @@`
`39`	`39`	`# to the upstream (hive) project's registry`
`40`	`40`	`#`
`41`	`41`	`# Artifacts:`
`42`		`-# - ${API_GENERATION_DIR}/python_api_package/dist/*.whl Built wheel (only present when built locally)`
	`42`	`+# - ${API_GENERATION_DIR}/python_api_package/dist/*.whl Built or downloaded wheel`
`43`	`43`	`# - build_wheel.env Environment file with WHEEL_BUILD_VERSION (always)`
`44`	`44`
`45`	`45`	`.hiveio_api_package_template:`
Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,8 @@`
`8`	`8`	`# 3. If exists: creates env file and exits (skips generation/build entirely)`
`9`	`9`	`# 4. If not: generates package, builds wheel, runs tests, and deploys to registry`
`10`	`10`	`#`
`11`		`-# The output artifacts are identical regardless of build or download path.`
	`11`	`+# The build_wheel.env artifact is always created with the resolved version.`
	`12`	`+# When the version exists in the registry, generation and build are skipped entirely.`
`12`	`13`	`#`
`13`	`14`	`# Usage:`
`14`	`15`	`# ./hiveio_api_package.sh [options]`