uv Cheatsheet — Building & Publishing

# Build sdist + wheel into dist/
uv build

# Build only the sdist
uv build --sdist

# Build only the wheel
uv build --wheel

# Build a specific workspace member
uv build --package my-lib

# Build to a custom output directory
uv build --out-dir build/

[build-system]
requires = ["uv_build>=0.7,<0.11"]
build-backend = "uv_build"

uv init --build-backend uv my-pkg

[tool.uv.build-backend]
# Explicitly set module name (defaults to normalized package name)
module-name = "my_module"

# Set the root directory for module discovery
module-root = "src"

# Include / exclude patterns (PEP 639 glob syntax)
source-include = ["tests/**"]
source-exclude = ["tests/fixtures/**"]

# Publish to PyPI (replaces twine upload)
uv publish

# Publish from a specific dist directory
uv publish dist/

# Publish to TestPyPI
uv publish --index-url https://test.pypi.org/legacy/

# Publish to a custom registry
uv publish --index-url https://my-registry.com/upload/

# Provide credentials via flags
uv publish --username __token__ --password pypi-XXXX

# Or via environment variables
export UV_PUBLISH_USERNAME=__token__
export UV_PUBLISH_PASSWORD=pypi-XXXX
uv publish

# 1. Bump version
uv version 1.2.0

# 2. Build
uv build

# 3. Check the dist contents (optional)
ls dist/
# my_pkg-1.2.0.tar.gz
# my_pkg-1.2.0-py3-none-any.whl

# 4. Publish
uv publish

# 5. Tag the release
git tag v1.2.0
git push --tags

[tool.uv]
no-build-isolation-package = ["cchardet"]

[tool.uv.extra-build-dependencies]
cchardet = ["cython"]
deepspeed = [{ requirement = "torch", match-runtime = true }]