Skip to main content

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.

Metadata

Release files for pico-tool-common 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pico-tool-common 0.1.1
File Size Uploaded Provenance Actions
pico_tool_common-0.1.1.tar.gz 60.1 kB Without provenance Details for pico_tool_common-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pico-tool-common 0.1.1
File Interpreter ABI Platform Actions
pico_tool_common-0.1.1-py3-none-any.whl Python 3 none any Details for pico_tool_common-0.1.1-py3-none-any.whl

Total release size: 69.5 kB

Release files / pico_tool_common-0.1.1.tar.gz

Download URL pico_tool_common-0.1.1.tar.gz
Size 60.1 kB
Tags Source
SHA-256 checksum
How to use checksums
dfa3f2db899924d7b7840d9d336cdd4d17160ecd85207a031ebd93a4e97572b6
BLAKE2b-256 checksum
How to use checksums
1582396e5d256e39098fcff2cf1d25a0afbe1f8c149c262719544e83aa54fd23
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Release files / pico_tool_common-0.1.1-py3-none-any.whl

Download URL pico_tool_common-0.1.1-py3-none-any.whl
Size 9.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6ea57d8ae002c16fd61b992cd3afdfb02934be88575d53f30625172292249bbb
BLAKE2b-256 checksum
How to use checksums
5db6ecbefafe5699a4732a701d3b46656cd0f19d51c4b36cc3edbc2f7133dc05
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Security for pico-tool-common 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page