coding-python-new-public-librarylisted

# New public Python library (from the bitranox template) ## Overview Do not hand-build a new public Python library. Clone the template `bitranox_template_py_lib` (https://github.com/bitranox/bitranox_template_py_lib), rename it to your package, and you inherit a working layout, strict typing, a CLI, and a full CI/test/release pipeline. This skill is the scaffold-install-use sequence plus the pitfalls that a from-memory guess gets wrong. ## When to use - Starting any new public bitranox Python library (a reusable package, optionally with a registered CLI command). - Installing or using a library that was built from this template. Not for: an application/service (use the app template, `github.com/bitranox/bitranox_template_py_cli`), or a one-off script. ## 1. Scaffold the repo The rename is driven by the **directory name**, so name the new directory for your package first. Copy the template, detach the template remote, rename, then reset the history. ```bash # copy the template into a new dir named for your package git clone --depth 1 https://github.com/bitranox/bitranox_template_py_lib.git lib_wombat cd lib_wombat git remote remove origin # detach from the template so nothing pushes back to it git branch -m master main # NEW repos use main, never master git config core.fileMode false # softdev mount: manage exec bits explicitly ./rename_dry.sh # PREVIEW: rename-project --dry-run. Confirm the detected name/paths # read "lib_womb