ZOPEN-PUBLISH
NAME
zopen-publish - manual page for zopen-publish 0.8.6
SYNOPSIS
zopen-publish [OPTION] -p PAX_FILE -m METADATA_FILE -g TAG
DESCRIPTION
zopen-publish - Publish zopen package release to GitHub and/or Pulp.
zopen-publish [OPTION] --whl WHL_FILE --pulp-url URL
OPTIONS
-h, --help
print this help
-v, --verbose
run in verbose mode.
-f, --force
Force overwrite release if tag exists.
-p, --pax-file PAX_FILE
Path to the pax.Z file required for GitHub publish
-m, --metadata-file FILE
Path to the metadata.json file required for GitHub publish
-g, --tag TAG
Tag name for the release, e.g. DEV_mypackage_12345
-r, --repo REPO_URL
GitHub repository URL, optional, overrides metadata.json
-d, --description TEXT
Description for the GitHub release
-b, --build-line LINE
Build line: DEV or STABLE
-t, --github-token TOKEN
GitHub token, or set GITHUB_TOKEN
-o, --github-org ORG
GitHub Organization, default: zopencommunity
-l, --latest
Mark release as Latest / non-prerelease
--pulp | Push RPM artifacts to Pulp repository |
--pulp-repo REPO
Pulp repository name, default: zopen-stable or zopen-dev
-w, --whl WHL_FILE
Path to a Python wheel file to publish to Pulp PyPI
--pulp-url URL
Pulp PyPI repository URL
--pulp-user USER
Pulp username, or set PULP_USER
--pulp-password PASS
Pulp password, or set PULP_PASSWORD
--on-conflict POLICY
What to do when the same wheel filename is already published with different content: fail (default) or build-tag, which reuploads under the next PEP 427 build tag. Published wheels are never replaced.
--version
print version
Environment Variables:
GITHUB_TOKEN
GitHub Personal Access Token
PULP_URL
Pulp PyPI repository URL
PULP_USER
Pulp username
PULP_PASSWORD
Pulp password
EXAMPLES
zopen-publish -f -p install/mypackage.zos.pax.Z -m metadata.json -g DEV_mypackage_12345 -t <token> zopen-publish --whl dist/mypackage-1.0-py3-none-any.whl --pulp-url https://repo.zopen.community/pypi/wheels/legacy/ zopen-publish -f -p install/mypackage.zos.pax.Z -m metadata.json -g TAG -t <token> --pulp
Exit codes:
0 | Success | ||
1 | Failure; retrying may succeed | ||
2 | Failure that retrying cannot fix (for example, the same wheel filename is already published with different content) |
This is free software: you are free to change and redistribute it under the terms of the Apache License, Version 2.0. <https://www.apache.org/licenses/LICENSE-2.0.html> There is NO WARRANTY, to the extent permitted by law.
AUTHOR
Written by contributors to the zopen community. <https://github.com/zopencommunity/meta/graphs/contributors>