Linux command
uv-publish 命令
文本
复制后可按需替换文件名、目录或参数。
常用示例
Publish
uv publish
Publish to TestPyPI
uv publish --publish-url https://test.pypi.org/legacy/
Publish
uv publish --index [name]
Publish
uv publish --token [pypi-token]
Publish specific files
uv publish [dist/package-1.0.tar.gz] [dist/package-1.0-py3-none-any.whl]
Publish
uv publish --check-url https://pypi.org/simple/
说明
uv publish uploads Python packages to PyPI or other registries. It publishes wheel and source distributions found in the dist/ directory by default. Supports authentication via API token, username/password, trusted publishing (GitHub Actions, GitLab CI/CD), or keyring. When --check-url is provided, uv skips uploading files that are identical to those already on the registry, making it safe for parallel CI uploads.
参数
- --publish-url _url_
- URL of the upload endpoint for the target registry.
- --index _name_
- Publish to a named index configured in pyproject.toml.
- --token _token_
- Authentication token (e.g., PyPI API token). Env: UV_PUBLISH_TOKEN.
- --username _user_
- Repository username. Env: UV_PUBLISH_USERNAME.
- --password _pass_
- Repository password. Env: UV_PUBLISH_PASSWORD.
- --check-url _url_
- Index URL to check for existing packages; skips identical uploads and handles parallel races.
- --trusted-publishing _value_
- Configure trusted publishing (always, never). Supported in GitHub Actions and GitLab CI/CD.
- --keyring-provider _provider_
- Use keyring for authentication (subprocess).
- --no-attestations
- Disable automatic attestation uploads. Env: UV_PUBLISH_NO_ATTESTATIONS.
FAQ
What is the uv-publish command used for?
uv publish uploads Python packages to PyPI or other registries. It publishes wheel and source distributions found in the dist/ directory by default. Supports authentication via API token, username/password, trusted publishing (GitHub Actions, GitLab CI/CD), or keyring. When --check-url is provided, uv skips uploading files that are identical to those already on the registry, making it safe for parallel CI uploads.
How do I run a basic uv-publish example?
Run `uv publish` in a terminal, then adjust file names, paths, flags, or remote targets for your system.
What does --publish-url _url_ do in uv-publish?
URL of the upload endpoint for the target registry.