Skip to content

refactor: rename b00t-py -> b00t-pyverse (PyPI naming collision) - #892

Merged
elasticdotventures merged 1 commit into
mainfrom
task/15-b00t-pyverse-rename
Aug 1, 2026
Merged

refactor: rename b00t-py -> b00t-pyverse (PyPI naming collision)#892
elasticdotventures merged 1 commit into
mainfrom
task/15-b00t-pyverse-rename

Conversation

@elasticdotventures

Copy link
Copy Markdown
Owner

Summary

  • b00t-py/b00t_py was rejected by PyPI as "too similar to an existing project" — a genuine collision with the pre-existing, unrelated boot-py/boot.py package (leetspeak 0-vs-o similarity check).
  • Renamed the crate, Python import package, and every reference across the repo to b00t-pyverse/b00t_pyverse (directory git mv'd, history preserved).
  • Along the way, found and fixed three real, pre-existing bugs that meant this package could never have worked as previously published: a native-module import-path mismatch (b00t_py.b00t_py vs the actual built b00t_py._core), a hardcoded stale __version__ string instead of the canonical workspace version, and a test file hardcoded to a Python 3.13 .so filename that never matched any installed interpreter. Also added the abi3-py38 PyO3 feature so one wheel now works across Python 3.8+ instead of needing a rebuild per minor version.
  • Updated the one real downstream consumer (b00t-j0b-py, which genuinely imports and calls into this package) via import b00t_pyverse as b00t_py so its many internal call sites didn't all need touching, plus its user-facing error/docstring text.
  • Updated build-breaking references (Dockerfile.b00t-cli, b00t-azure-cp/Dockerfile COPY paths) and living reference docs (_b00t_/*.skill.tomllm + skills/*/SKILL.md pairs, .claude-plugin/README.md, opencode context, PRD-ARCH-014/015 datums). Left the one dated historical plan doc alone.
  • Corrected (not just renamed) _b00t_/learn/b00t-py.mdb00t-pyverse.md, which had documented the actual bug as if it were the fix.

Test plan

  • maturin build --release succeeds — produces b00t_pyverse-0.10.2-cp38-abi3-manylinux_2_35_x86_64.whl
  • Fresh venv install of the wheel succeeds
  • Full test suite: pytest tests/ → 17/17 passed
  • README Quick Start example run verbatim, output confirmed accurate
  • twine check passes
  • cargo check -p b00t-cli --lib confirms the workspace member rename in root Cargo.toml didn't break the rest of the workspace
  • Repo-wide grep confirms no leftover b00t_py/b00t-py references outside the two files that intentionally alias it (import b00t_pyverse as b00t_py) and Cargo.lock (regenerates)

🤖 Generated with Claude Code

b00t-py/b00t_py was rejected by PyPI ("too similar to an existing
project") — a genuine collision with the pre-existing, unrelated
boot-py/boot.py package (leetspeak 0-vs-o similarity). Renamed the crate,
Python import package, and every reference across the repo to
b00t-pyverse/b00t_pyverse:

- b00t-py/ -> b00t-pyverse/ (git mv, history preserved)
- python/b00t_py/ -> python/b00t_pyverse/
- tests/test_b00t_py.py -> tests/test_b00t_pyverse.py
- Cargo.toml: [package] name, [lib] name
- pyproject.toml: [project] name = "b00t-pyverse", module-name = "b00t_pyverse._core"
- src/lib.rs: create_exception! module path, doc comments
- workspace Cargo.toml: member path
- b00t-j0b-py (real consumer — genuinely imports and calls into this
  package): both source files updated via `import b00t_pyverse as b00t_py`
  so the many internal b00t_py.func(...) call sites didn't all need
  touching, plus user-facing error/docstring text
- Dockerfile.b00t-cli, b00t-azure-cp/Dockerfile: COPY paths (would have
  broken the image build otherwise)
- _b00t_/*.skill.tomllm + skills/*/SKILL.md pairs, .claude-plugin/README.md,
  .opencode context, PRD-ARCH-014/015 datums: living reference docs and
  code examples
- _b00t_/learn/b00t-py.md -> b00t-pyverse.md: corrected, not just renamed —
  it had documented the actual bug (importing "b00t_py.b00t_py" instead of
  "b00t_py._core") as if it were the fix

Left alone: docs/superpowers/plans/2026-05-02-*.md (dated historical
record, not living documentation).

Verified fully operational under the new name: maturin build --release
succeeds (abi3 wheel, b00t_pyverse-0.10.2-cp38-abi3-*.whl), fresh venv
install works, full test suite 17/17 passes, README Quick Start example
run verbatim and confirmed accurate, twine check passes, and
`cargo check -p b00t-cli --lib` confirms the workspace member rename in
root Cargo.toml didn't break the rest of the workspace.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@elasticdotventures
elasticdotventures merged commit c1f828c into main Aug 1, 2026
14 checks passed
@elasticdotventures
elasticdotventures deleted the task/15-b00t-pyverse-rename branch August 1, 2026 12:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants