pep723-to-wheel

A small utility for converting PEP 723 inline dependency scripts into wheels and reconstructing scripts from wheels. Especially useful for taking reproducible Marimo notebooks to production environments.

CLI

Build a wheel from a script that has a PEP 723 inline block:

pep723-to-wheel build path/to/script.py --output-dir dist

Set an explicit wheel version (defaults to calendar versioning using the script mtime as the patch segment):

pep723-to-wheel build path/to/script.py --version 2024.12.25

Reconstruct a script from a wheel or package name:

pep723-to-wheel import path/to/package.whl --output reconstructed.py
pep723-to-wheel import requests --output reconstructed.py

Library

from pathlib import Path
from pep723_to_wheel import build_script_to_wheel, import_wheel_to_script

result = build_script_to_wheel(Path("script.py"))
print(result.wheel_path)

import_result = import_wheel_to_script("requests", Path("reconstructed.py"))
print(import_result.script_path)

Development

make test
make typecheck
make ruff

Release process

Releases are automated on pushes to main by the CD workflow in .github/workflows/cd.yml.

1. The workflow determines the latest v* Git tag and runs .github/workflows/cd_version.py to resolve the next version. If the latest tag matches the current major/minor, it bumps the patch to one higher than the max of the current patch and the tag patch.
2. If pyproject.toml changes, the workflow commits the version bump back to main.
3. It tags the release as v<version>, builds the wheel with uv build --wheel, publishes to PyPI, and creates a GitHub release with the wheel attached.

To trigger a release, merge or push changes to main and ensure PYPI_API_TOKEN is configured in the repository secrets.