How to Build a Wheel with Hatchling in Python

import subprocess
import sys
import tempfile
from pathlib import Path


def build_wheel_with_hatchling(project_dir: str) -> str:
    """Build a wheel using hatchling and return the wheel file path."""
    project_path = Path(project_dir)

    # Simulate a minimal project structure if missing
    if not (project_path / "pyproject.toml").exists():
        pyproject = """[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "demo"
version = "0.1.0"
"""
        (project_path / "pyproject.toml").write_text(pyproject)
        (project_path / "src" / "demo").mkdir(parents=True, exist_ok=True)
        (project_path / "src" / "demo" / "__init__.py").write_text('__version__ = "0.1.0"\n')

    # Build the wheel
    result = subprocess.run(
        [sys.executable, "-m", "build", "--wheel", "--outdir", str(project_path / "dist")],
        cwd=str(project_path),
        capture_output=True,
        text=True,
        check=False,
    )

    if result.returncode != 0:
        raise RuntimeError(f"Build failed: {result.stderr}")

    wheel_files = list((project_path / "dist").glob("*.whl"))
    return str(wheel_files[0]) if wheel_files else "No wheel file produced"


if __name__ == "__main__":
    with tempfile.TemporaryDirectory() as tmpdir:
        wheel_path = build_wheel_with_hatchling(tmpdir)
        print(f"Built wheel: {wheel_path}")