pico-tool-common 0.1.0

Shared scaffolding for PICO dev tools (runners, ports, console helpers)

tools/common — pico_tool_common

Shared Python scaffolding for the PICO dev tools under tools/*.

Why

Every tool used to duplicate the same boilerplate: console helpers, default ports, repo-root discovery, uvicorn runners, Vite/npm orchestration, etc. This package consolidates that logic so bug fixes and UX improvements propagate to all tools.

What lives here

Module	Purpose
pico_tool_common.console	Shared rich console instance
pico_tool_common.ports	Canonical default ports for every tool
pico_tool_common.fs	find_repo_root, normalize_path
pico_tool_common.web.runner	run_app() for FastAPI/uvicorn tools
pico_tool_common.vite	run_vite() for Vite-based WASM tools

Development

Each tool consumes this package as an editable path dependency:

[project]
dependencies = ["pico-tool-common", ...]

[tool.uv.sources]
pico-tool-common = { path = "../common", editable = true }

Release

pico tool release <tool> builds the common wheel alongside the tool wheel and embeds both URLs in the generated install script, so standalone installs keep working without publishing to PyPI.