pgx run — one command to a ready database (stacked on #2)

[alexshapalov]

pgx run — one command to a ready database

Stacked on #2. The developer onboarding the public install promises:

curl -fsSL https://pgx.dev/install | sh
pgx run

pgx run initialises $PGX_HOME if needed, starts the runtime if it is not already up, ensures a default app database, and prints its connection URL. Every step is idempotent and safe to repeat; it never resets or overwrites an existing database.

$ pgx run
PGX is ready.

  postgres://postgres:…@127.0.0.1:5432/app

  database   app (created)
  runtime    started (pid 23469, port 5432)
  home       /home/you/.pgx

Connect:
  psql "postgres://postgres:…@127.0.0.1:5432/app"

Behaviour

• Idempotent: a second pgx run reports app (existing) / runtime already running and does not restart or duplicate anything.
• A run-level flock serialises concurrent invocations, so even a first run from several processes at once cannot race in init; one engine starts, one app is created.
• --json emits a single object (ready, url, database, database_created, started, already_running, pid, port, …) for agents.
• Secure localhost-only defaults inherited from init: loopback listen_addresses, scram-sha-256 over TCP, a random password. The first run honours PGX_PORT / PGX_DURABILITY / PGX_PASSWORD.
• Engine untouched: the change is entirely within crates/bin/pgx; start/restart behaviour is unchanged (existing lifecycle tests stay green).

Tests (all green locally against the assembled distribution)

• tests/run.rs (8): fresh install → ready; idempotent, no duplicates; persistence across restart; existing databases untouched; localhost-only + password-protected; 8-way concurrent runs (one engine, one app); recovery after an engine crash.
• Full crate suite 104 tests; Python SQL regression 19; five app fixtures (psql/node/python/go/rails) PASS; installer end-to-end PASS.

Also contains a CI fix (inherited from #2): the Unit tests step is scoped to --bin pgx so it no longer pulls in the dist-dependent integration suites, and the run suite is added to the black-box step.

🤖 Generated with Claude Code