Skip to content

v2.0.1

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 19 Oct 10:09
v2.0.1
b505714
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

embedded-postgres v2.0.0

Run real PostgreSQL in Go tests with automatic cleanup, or use the CLI with any
test runner. v2 requires Go 1.26+ and has no third-party production Go dependencies.

Start here

  • Go tests: add github.com/fergusstrange/embedded-postgres/v2 at this release's
    tag, then call eptest.Start(t). PostgreSQL and the matching supervisor download
    automatically on first use and are cached for later tests.
  • Other test runners: install the CLI and run embedded-postgres exec -- YOUR_TEST_COMMAND.
    It supplies DATABASE_URL, runs your tests and closes PostgreSQL afterward.
  • Upgrading from v1: follow the migration guide.
    This is a major-version migration; use the /v2 import path.

The quick start and
CLI guide
cover installation and configuration.

Corrected PostgreSQL distributions

The default and supported distribution pins are PostgreSQL 18.6.1, 17.11.1,
16.15.1 and 15.19.1. These upstream packaging revisions include the Windows and
relocatable-library fixes. New downloads use the corresponding SHA-256 pins;
explicit older distribution versions retain their existing catalog entries.
Windows ARM64 continues to select x64 PostgreSQL under emulation.

See the published-binary regression report
for the platform matrix and verification evidence. The
clean Arch regression
also verifies PostgreSQL 15–18 without libxml2-legacy, including XML, extensions,
offline reuse and persistent restart. The old bundle reproduces the original error.

Included in v2

  • PostgreSQL 15–18; Linux, macOS and Windows on AMD64 and ARM64. Windows ARM64 uses
    x64 PostgreSQL under emulation.
  • Isolated test instances, available ports, a shared verified binary cache and
    explicit persistent-data storage. Caller-supplied data is never automatically erased.
  • Independent supervision for cleanup after owner exit or panic, and explicit
    Unix UID/GID support for tests running as root.
  • Restricted Windows child tokens work from PowerShell and detached Node launches
    while keeping administrator groups disabled.
  • Custom binary providers and lifecycle hooks for migrations and extensions.
  • CLI foreground, command-scoped and background modes, plus protocol 1 for wrappers.

PostgreSQL's native runtime requirements
still apply. Source checkouts and local module replacements need an explicitly
selected supervisor. The stable release follows downstream migration testing and
verification of the published Go module, CLI and Node wrapper on supported platforms.

Assets 14
Loading