Skip to content

observers: document disposable local Postgres tests - #16

Merged
YusefSyed merged 1 commit into
YusefSyed:mainfrom
Sinkleberg:codex/local-postgres-guide
Nov 4, 2026
Merged

YusefSyed merged 1 commit into
YusefSyed:mainfrom
Sinkleberg:codex/local-postgres-guide

Conversation

@Sinkleberg

Copy link
Copy Markdown
Contributor

What changes

Add a disposable PostgreSQL 17 Docker walkthrough with loopback publishing, logical WAL, test administrator and separate reader roles, exact single-file test commands, a SELECT-only profile example, and cleanup. Link it from the observer README and the live-test skip hint.

Closes #7.

The failing case

The existing pg.live.test.mjs permission-denied case rejects a role without SELECT. Local walkthrough verification also confirms the documented reader can SELECT but receives SQLSTATE 42501 on UPDATE. Both live files were exercised against PostgreSQL 17.11 with Node 24.22.2; the optional ALTER SYSTEM test remains skipped.

Actual live-suite output (Linux/amd64):

pg.live.test.mjs:     tests 18; pass 18; fail 0; skipped 0
pg-wal.live.test.mjs: tests 12; pass 11; fail 0; skipped 1

The fresh-start TCP readiness block passed; the same block pointed at a closed port exhausted its 30 attempts and exited 1. Full suite on the final head: 4,679 passed, 92 repository-defined skips, zero failures across all 330 files. CI helper tests: 92 passed, 4 skipped, zero failures.

Limits

This checks that server version and synthetic data only, with no application assessment or wider Postgres compatibility claim. Snapshot inserts/deletes remain net-only. No dependency or observer implementation change.

Checklist

  • ./scopehaven test --test-concurrency=4 --test-reporter=tap passes locally on the final head.
  • Tests and fixtures use loopback only; no new network site in code.
  • No new dependency.
  • Final commit carries the DCO sign-off.
  • Documentation states the measured version and limits.

Signed-off-by: Brad <1676751+Sinkleberg@users.noreply.github.com>
@Sinkleberg
Sinkleberg requested a review from YusefSyed as a code owner November 2, 2026 22:45
@YusefSyed
YusefSyed merged commit 271a3f3 into YusefSyed:main Nov 4, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Guide: run the pg-snapshot observer and its live tests against a disposable Postgres in Docker

2 participants