pascal create¶
Scaffold a new package or app inside the workspace.
Subcommands¶
create package¶
Creates a reusable library under packages/<NAME>/.
Files generated:
create app¶
Creates a deployable application under apps/<NAME>/.
Files generated:
apps/<NAME>/
pyproject.toml # includes [project.scripts]
src/
<name_snake>/
__init__.py
main.py
tests/
test_<name_snake>.py
Name rules¶
- Allowed characters: ASCII letters, digits, hyphens (
-), underscores (_) - Hyphens and underscores are equivalent for lookup; the
pyproject.tomlname uses hyphens, thesrc/directory uses underscores
Examples¶
pascal create package cart
pascal create package my-utils
pascal create app storefront
pascal create app data-pipeline
After creating¶
Run pascal sync to update the UV workspace root pyproject.toml and then uv sync to install the new member:
Errors¶
| Condition | Message |
|---|---|
| Directory already exists | Package 'x' already exists at … |
| Invalid name | Invalid name 'x': must contain only … |
| Not inside a workspace | pascal.toml not found |