Professional Python Project Explainer

A Marimo app that explains common files and folders in professional Python projects.

Open the App

• Professional Python Project Explainer

How It Works

• Repository choices are loaded from src/public/repos.toml.
• The selected repository tree is fetched live from GitHub.
• Common files and folders are explained using src/public/explainer-catalog.toml.
• The repository tree is not stored and reflects the current repository shape.

Run (CTRL c to quit)

uv sync
uv run marimo run src/app.py

Edit

uv run marimo edit src/app.py

Developers

Clone and Open in VS Code

Open a machine terminal where you want the project:

git clone https://github.com/pup-pack/professional-python-project-explainer

cd professional-python-project-explainer
code .

Update and Manage the

uvx pup-clean --delete
uv self update
uv python pin 3.14
uv python install
uv lock --upgrade
uv sync
uv audit

# set up and run git hooks
uvx prek install --force
uvx prek update
git add -A
uvx prek run --all-files
# repeat if changes were made
uvx prek run --all-files

# run locally to test
uv run marimo run src/app.py

# check types and run tests
uv run ty check
uv run python -m pytest
uv run python -m zensical build

# save progress
git add -A
git commit -m "update"
git push -u origin main

Explainer Catalog

Explainer Catalog

Annotations

Annotations

Citation

CITATION.cff)

License

MIT