Python Packaging with uv

Overview

Use uv build and publish commands to produce wheels/sdists and ship to PyPI. Core principle: build, verify, then publish.

Quick Reference

Workflow

1. Build artifacts in dist/.
2. Test install from wheel.
3. Publish to Test PyPI, validate, then publish to PyPI.

Example

uv build --no-sources
uv pip install dist/my_package-1.0.0-py3-none-any.whl
uv publish --publish-url https://test.pypi.org/legacy/ --token $TEST_PYPI_TOKEN

Common Mistakes

• Publishing before verifying wheel contents.
• Skipping Test PyPI for first release.

Red Flags

• Packaging guidance that ignores uv build/publish.

References

• references/packaging.md - Build and publish details