uv Verified current stable Not installed? Package Management

Uv / Publish Specific Distribution Files

Publish Specific Distribution Files

Publish specific distribution files to the repository.

$
Terminal
uv publish <path/to/dist/*.whl> <path/to/dist/*.tar.gz>

When To Use

When targeting specific artifacts for publishing while ignoring others.

Pro Tip

Ensure you're using the correct file formats; incorrect formats will cause publish failures.

Command Builder

Tune the command before you copy it

Back to syntax
$
Generated Command
uv publish <path/to/dist/*.whl> <path/to/dist/*.tar.gz>

Anatomy of Output

Understanding the result

Publishing files... Status

Indicates the publishing process for specified files has started.

Files published: {{num_files}} Published Files Count

Indicates how many files were published successfully.

No errors reported during the publish process. Publishing Outcome

All specified files were published without issues.

Troubleshooting

Common pitfalls

ERROR: Specified distribution files not found.

Solution: Check paths and ensure files exist.

ERROR: Unsupported file format for publishing.

Solution: Publish only `.whl` or `.tar.gz` files.

ERROR: Publish failed due to network issue.

Solution: Verify network connectivity and retry the publishing command.

Command Breakdown

What each part is doing

uv
Base Command
The executable that performs this operation. Here it runs Uv before the shell applies any redirect operators.
<path/to/dist/*.whl>
path to dist *.whl
The value supplied for path to dist *.whl.
<path/to/dist/*.tar.gz>
path to dist *.tar.gz
The value supplied for path to dist *.tar.gz.

Alternative Approaches

Comparable commands in other tools

Alternative package management tools for the same job.