python-gen-tarball
Rebuild the Python generator distribution after source or bundled scripts/pip-config.sh changes.
Source facts
- Repository
- block/proto-fleet
- Last source activity
- September 18, 2026 at 19:52
- Detected SKILL.md language
- English
- Stars
- 57
- Forks
- 18
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- python-gen-tarball
- description
- Rebuild the Python generator distribution after source or bundled scripts/pip-config.sh changes.
# python-gen-tarball
The tarball is the distribution unit. Local edits run against the venv, so
tests pass — but Hermit-bootstrapped environments and CI extract the
committed `proto-python-gen-<version>.tar.gz` and keep using the old code
until it's rebuilt. This is a quiet failure mode that's easy to miss.
## What to do
1. Decide whether to bump `version` in `packages/proto-python-gen/justfile`:
- Behavior change or new feature → bump.
- Pure refactor → optional. Ask if unclear.
2. Build:
```
cd packages/proto-python-gen && just package
```
Produces `proto-python-gen-<version>.tar.gz`.
3. Stage the tarball alongside the source change. A source-only commit will
fail to bootstrap fresh environments.
4. If the version was bumped, search for hard-coded references and update:
```
rg "proto-python-gen-[0-9]" -g '!*.tar.gz'
```
## What to avoid
- `just gen` does not rebuild this tarball. Only `just package` inside
`packages/proto-python-gen/` does.
View on GitHub