aboutsummaryrefslogtreecommitdiff
path: root/contrib/webmentions-ssg.example.cfg
diff options
context:
space:
mode:
authorDennis Fink2026-11-13 20:13:54 +0100
committerDennis Fink2026-11-13 20:13:54 +0100
commit1f784f2b87ed0b2fd478e46d0d292c33f3150a3b (patch)
tree7b74847c415916affb67e2c962da494ef64a29d2 /contrib/webmentions-ssg.example.cfg
parentdb7748111141d9d103f335fb8a0c647bce78b2cc (diff)
downloadwebmentions-ssg-1f784f2b87ed0b2fd478e46d0d292c33f3150a3b.tar.gz
webmentions-ssg-1f784f2b87ed0b2fd478e46d0d292c33f3150a3b.zip
fix(core): clarify Huey file path semantics
Document and test SQLAlchemy-style slash handling for file and SQLite Huey URLs, including distinct relative and absolute path forms. Update validation errors to show the supported three- and four-slash conventions.
Diffstat (limited to '')
-rw-r--r--contrib/webmentions-ssg.example.cfg5
1 files changed, 5 insertions, 0 deletions
diff --git a/contrib/webmentions-ssg.example.cfg b/contrib/webmentions-ssg.example.cfg
index 4beb678..dead041 100644
--- a/contrib/webmentions-ssg.example.cfg
+++ b/contrib/webmentions-ssg.example.cfg
@@ -164,6 +164,11 @@ MAX_TARGET_BYTES = 1_000_000
# legacy data from any backend that untrusted parties could have modified.
# Production startup refuses the implicit memory:// fallback, as well as
# blackhole://, since neither can reliably deliver work to a separate process.
+# File and SQLite backends follow SQLAlchemy's path convention, not RFC 8089:
+# three slashes for relative paths, four for absolute paths.
+# HUEY_URL = "file:///huey-queue" # Relative: ./huey-queue
+# HUEY_URL = "file:////var/lib/webmentions-ssg/huey-queue" # Absolute
+# HUEY_URL = "sqlite:////var/lib/webmentions-ssg/huey.db" # Absolute
HUEY_URL = "redis://127.0.0.1:6379/0"
# ---------------------------------------------------------------------------