pascal-cli 0.1.0

Fast Python monorepo manager powered by Rust and UV

pascal

Fast Python monorepo manager powered by Rust and UV.

Pascal handles workspace scaffolding, dependency wiring, and UV workspace sync — so you can focus on code, not configuration.

Documentation · Installation · Quickstart · Commands

Heavily inspired by Polylith — packages map to Polylith's components, apps to its bases, brought to the Python/UV ecosystem with a minimal footprint.

---

Installation

uv tool install pascal-cli   # recommended
pipx install pascal-cli
pip install pascal-cli

pascal --version

---

Quickstart

# Bootstrap a workspace
mkdir shop && cd shop
pascal init shop

# Add a library and an app
pascal create package cart
pascal create app storefront

# Wire them together
pascal add cart --to storefront
uv sync

# Validate and inspect
pascal check
pascal info
pascal test

---

Workspace layout

After the quickstart above, your workspace looks like this:

shop/
  pascal.toml          # workspace manifest
  pyproject.toml       # UV workspace root — managed by pascal
  uv.lock              # lockfile — commit to git
  packages/
    cart/
      pyproject.toml
      src/cart/__init__.py
      tests/test_cart.py
  apps/
    storefront/
      pyproject.toml   # depends on cart
      src/storefront/__init__.py
      src/storefront/main.py
      tests/test_storefront.py

pascal.toml

[workspace]
name = "shop"
python = "3.12"
description = "My Python monorepo"

# Optional — pascal auto-discovers from packages/ and apps/ if omitted
packages = ["packages/cart"]
apps     = ["apps/storefront"]

apps/storefront/pyproject.toml (after pascal add cart --to storefront)

[project]
name = "storefront"
version = "0.1.0"
requires-python = ">=3.12"
dependencies = ["cart"]

[project.scripts]
storefront = "storefront.main:main"

[tool.uv.sources]
cart = { workspace = true }

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

---

Command reference

Command	Description
pascal init [name]	Bootstrap a new workspace
pascal create package <name>	Scaffold a reusable library
pascal create app <name>	Scaffold a deployable app
pascal add <pkg> --to <app>	Add a workspace package as a dependency
pascal info	Print workspace overview
pascal deps [--graph]	Show the dependency tree
pascal check	Validate workspace health
pascal diff [--since <ref>]	Show changed packages since a git ref
pascal test [--changed] [name]	Run tests via UV
pascal build <app>	Build an app wheel
pascal run <app> [-- args]	Run an app entry-point
pascal sync	Regenerate UV workspace config

---

Development

Prerequisites

Tool	Purpose
Rust ≥ 1.75	Compile the binary
pre-commit	Git hook runner (uv tool install pre-commit)
maturin (optional)	Test PyPI packaging locally

Build

git clone https://github.com/sandeep-selvaraj/pascal
cd pascal
cargo build

Test

cargo test          # unit + integration
cargo test --lib    # unit tests only
cargo test --test integration  # integration tests only

Integration tests in tests/integration.rs spawn the real binary against tempfile directories — no mocking.

Lint and format

cargo fmt
cargo clippy -- -D warnings

Pre-commit hooks

Install once after cloning:

pre-commit install

Every git commit will then run cargo fmt and cargo clippy automatically.

Test PyPI packaging

pip install maturin
maturin build
pip install target/wheels/*.whl
pascal --version

Serve docs locally

pip install zensical
zensical serve

---

License

MIT — see LICENSE.