From e7521ec96a6380c0f527c4bf60f1fc0bf5ae7ff1 Mon Sep 17 00:00:00 2001 From: Todd Green Date: Thu, 28 May 2026 19:45:10 +0000 Subject: [PATCH 1/2] docs: add a short pg_durable / duroxide-pg disambiguator to README Adds a single-blockquote callout near the top of the README so a reader can immediately tell pg_durable apart from duroxide-pg. Replaces the earlier draft that added a full "Duroxide family" overview here; the overview is now kept only in the duroxide hub README. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index f427f0e2..52abcfa2 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,8 @@ pg_durable brings durable execution to PostgreSQL. Define long-running, fault-tolerant functions entirely in SQL—no external orchestrators, no YAML, no separate deployment. +> **Not to be confused with [duroxide-pg](https://github.com/microsoft/duroxide-pg).** duroxide-pg is the lower-level PostgreSQL provider for the [duroxide](https://github.com/microsoft/duroxide) Rust durable-execution runtime, aimed at developers writing workflows in Rust. pg_durable sits on top of both and exposes durable execution as a SQL-native PostgreSQL extension — reach for it when you want everything inside PG. + ## Features - **Durable** — Function state persists to PostgreSQL. Survives crashes, restarts, and failovers. From 431f704f8ba1faafe83d9989fde3cfd49c9c8858 Mon Sep 17 00:00:00 2001 From: Todd Green Date: Thu, 28 May 2026 22:56:58 +0000 Subject: [PATCH 2/2] Revise text --- README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 52abcfa2..d4ed46a6 100644 --- a/README.md +++ b/README.md @@ -4,8 +4,6 @@ pg_durable brings durable execution to PostgreSQL. Define long-running, fault-tolerant functions entirely in SQL—no external orchestrators, no YAML, no separate deployment. -> **Not to be confused with [duroxide-pg](https://github.com/microsoft/duroxide-pg).** duroxide-pg is the lower-level PostgreSQL provider for the [duroxide](https://github.com/microsoft/duroxide) Rust durable-execution runtime, aimed at developers writing workflows in Rust. pg_durable sits on top of both and exposes durable execution as a SQL-native PostgreSQL extension — reach for it when you want everything inside PG. - ## Features - **Durable** — Function state persists to PostgreSQL. Survives crashes, restarts, and failovers. @@ -30,6 +28,10 @@ SELECT df.start( 3. **Runtime executes durably** — each step is checkpointed, survives crashes via replay 4. **Query progress** anytime from standard PostgreSQL tables +## Relationship With duroxide-pg +* Use pg_durable when you want pipelines or durable functions directly in SQL and PostgreSQL, no other moving parts needed. +* Use [duroxide-pg](https://github.com/microsoft/duroxide-pg) when you prefer to define functions in Rust, Python, or Node, using PostgreSQL only as a persistent store. + ## Prerequisites - PostgreSQL 17