Principle:Wandb Weave Distribution Build
| Knowledge Sources | |
|---|---|
| Domains | Release_Engineering, Packaging |
| Last Updated | 2026-02-14 00:00 GMT |
Overview
A packaging mechanism that compiles source code into distributable artifacts (sdist and wheel) for PyPI upload.
Description
Distribution Build uses the Python build system (hatchling backend) to produce two distribution formats: a source distribution (sdist .tar.gz) and a wheel (.whl). The build reads the version from weave/version.py and packages only the weave/ directory, excluding tests, examples, and documentation.
Usage
Run this step after pushing commits and tags, immediately before uploading to PyPI.
Theoretical Basis
Python packaging follows PEP 517/518:
- Build backend: Defined in pyproject.toml (hatchling).
- Source distribution: Complete source code package.
- Wheel: Pre-built distribution for faster installation.
- Version: Read from weave/version.py via [tool.hatch.version] configuration.