Solomon CLI

Solomon is an MVC-style framework CLI wired to Constellink (deploy/migrate) and UILoom (UI build). This page documents the available commands, flags, expected config files, and typical workflows.

python3 -m pip install -U pip
python3 -m pip install -e .   # from the repo root with pyproject.toml

python -m solomon --help
python -m solomon <command> --help

Prerequisites

• Constellink installed & on PATH (used by deploy / migrate)
• UILoom installed & on PATH (used by ui subcommands)
• PostgreSQL available if using create (auto user/db creation)
• Optional Redis if your app uses KV features

Configuration Files

[solomon]
name = my-app
models = ./app/models
views = ./app/ui/templates

[database]
type = postgres

[kv]
type = redis

export PROJECT="my-app"
export HOST_URL="127.0.0.1"
export PORT="4801"
export MAIN_FUNC="app.main"
export ENV="dev"

Global CLI Usage

solomon <command> [options]

Commands

deploy — Deploy with Constellink

Reads .solomon, takes [solomon].name, and runs constellink deploy <name>.

solomon deploy

migrate — Migrate models with Constellink

Reads [solomon].models and runs constellink migrate <models-path>.

solomon migrate

create — Scaffold a new app

Creates a basic app layout, seeds config files, generates Postgres user/db, copies defaults, and installs UILoom base assets.

solomon create <app-name> [--env PATH]

• <app-name> — required, becomes project name and DB prefix
• --env — optional target directory (default: .)

ui — UI subcommands (UILoom)

ui compile

Compile UILoom LML templates to a distribution directory.

solomon ui compile [--in PATH] [--out PATH]

• --in (default ./app/ui/templates)
• --out (default ./app/ui/dist/)

ui css

Generate UILoom CSS bundle.

solomon ui css [--in PATH] [--out PATH]

• --in (default ./app/ui/assets/uiloom/css/)
• --out (default ./app/ui/dist/assets/css)

repair — Restore defaults

Copies packaged defaults from solomon.defaults into the specified directory.

solomon repair --env PATH

Return Codes & Output

Most operations run via subprocess.run with check=True and a default timeout of 30s. On success the CLI prints:

✅ <NAME> ran successfully!

On failure you’ll see a red ❌ message with the command and the exit code, and the error is re-raised.

Examples

# Create a new app scaffold in the current directory
solomon create myshop --env .

# Build UI assets (defaults)
solomon ui compile
solomon ui css

# Migrate database models
solomon migrate

# Deploy the app specified in .solomon
solomon deploy

Troubleshooting

• Command not found: ensure constellink and loom are on your PATH.
• Postgres permission errors: update the admin user in create_user_and_db() or run with appropriate privileges.
• Timeouts: long operations can exceed 30s; raise the timeout default in solomon_pipe() if needed.
• Quoting in Python f-strings: in deploy()/migrate(), avoid f"{config["solomon"]["name"]}"; use name = config["solomon"]["name"] then format.