Files
thepraandClaude Opus 5.5 a5d493a8c9 Pasture: Friendica joins, in the scenarios and the town
Friendica 2026.05 on the shared MySQL and Redis, with its worker daemon as a sidecar. friendica_settle repairs what
its install leaves: the system user has no name, so the system account that signs its fetches is never made; the web
container cannot see the sidecar's daemon, so a queued job waits for the five-minute cron unless the daemon is
declared running; its log needs a file and debugging on. Accounts are saved through its API with locked=0 (a number:
"true" reads as 0, unlocked), which makes them soapbox pages that take followers without following back, and each
one's outbox is read once: a Follow that reaches an account Friendica has not cached makes it fetch the account from
itself, signed, and checking that signature recursed for five minutes, holding PrivaPub's first follow past its timeout.

scenarios/friendica.sh passes its 25 checks from a clean install: follows and unfollows, posts (a titled one with its
title), comments, likes, Friendica's dislike as a downvote, boosts, edits (through its web editor: its Mastodon API
never federates one) and deletes, both ways.

The town gets a Friendica driver (HTTP Basic, its MySQL read through mysql_json, edits in the web editor, no bookmark
on a reply) and specs/friendica-pair.json, which passes its 275 checks. On the way:
- the checker knows Friendica's thread model: a non-public reply reaches an account only under posts it holds, and a
  Friendica account's non-public reply in a thread another server owns reaches nobody else there;
- the seeder answers a follow request the target still holds whatever the follower's server says: Friendica reports a
  follow of someone already following its account as made at once (and shows that persona's followers-only posts
  while a locked persona still holds the request);
- the selftest skips polls where a platform has none; the shared MySQL helpers move to peers/shared.sh.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LsXgEaXee4GCU1hwYgPJXw
2026-10-05 10:14:02 +02:00

113 lines
3.7 KiB
Python

"""The pasture's containers from the workstation: commands, Postgres rows as JSON, Mongo documents as JSON, a copy of
GoToSocial's sqlite. Only reads go through here; nothing a peer does is faked in its database."""
import json
import os
import shutil
import sqlite3
import subprocess
import tempfile
def run(*args, input=None, check=True, timeout=300):
proc = subprocess.run(["podman", *args], input=input, capture_output=True, timeout=timeout,
text=isinstance(input, str) or input is None)
if check and proc.returncode != 0:
raise RuntimeError(f"podman {' '.join(args[:3])}… failed: {proc.stderr.strip()[:500]}")
return proc.stdout
def exec_(container, *cmd, input=None, check=True, timeout=300, workdir=None):
args = ["exec"]
if input is not None:
args.append("-i")
if workdir:
args += ["-w", workdir]
return run(*args, container, *cmd, input=input, check=check, timeout=timeout)
def exists(container):
return subprocess.run(["podman", "container", "exists", container]).returncode == 0
def running():
out = run("ps", "--format", "{{.Names}}")
return [n for n in out.split() if n.startswith("pasture-")]
def psql(db, sql, *params):
"""Rows of `sql` as a list of dicts. Parameters are bound by psql (:'p1', :'p2'...), never pasted into the SQL."""
args = ["exec", "-i", "pasture-postgres", "psql", "-U", "pasture", "-d", db, "-tAX", "-v", "ON_ERROR_STOP=1"]
for i, p in enumerate(params, 1):
args += ["-v", f"p{i}={p}"]
wrapped = f"select coalesce(json_agg(t), '[]'::json) from ({sql.rstrip().rstrip(';')}) t;\n"
out = run(*args, input=wrapped)
return json.loads(out.strip() or "[]")
def psql_value(db, sql, *params):
rows = psql(db, sql, *params)
if not rows:
return None
return next(iter(rows[0].values()))
def mysql_json(db, sql):
"""The JSON value one MySQL query returns (built with json_object/json_arrayagg, so text keeps its newlines), from the
shared MySQL. The mysql client binds nothing: values go in through `mysql_quote`."""
out = run("exec", "pasture-mysql", "mysql", "-upasture", "-ppasture", "--default-character-set=utf8mb4", "-N", "-B", "--raw", db,
"-e", sql)
text = "\n".join(line for line in out.splitlines() if not line.startswith("mysql: [Warning]")).strip()
return json.loads(text) if text and text != "NULL" else None
def mysql_quote(value):
return "'" + str(value).replace("\\", "\\\\").replace("'", "''") + "'"
def mongo(js, db="PrivaPub"):
"""The JSON value of a mongosh expression, e.g. `db.Post.find({...}).toArray()`."""
script = f"print(EJSON.stringify(({js}), {{relaxed: true}}))"
out = run("exec", "pasture-mongo", "mongosh", "--quiet", db, "--eval", script, timeout=120)
return json.loads(out.strip().splitlines()[-1]) if out.strip() else None
class SqliteCopy:
"""A consistent copy of a container's sqlite database (with its WAL), opened read-only on the workstation."""
def __init__(self, container, path):
self.dir = tempfile.mkdtemp(prefix="town-sqlite-")
local = os.path.join(self.dir, os.path.basename(path))
run("cp", f"{container}:{path}", local)
for suffix in ("-wal", "-shm"):
subprocess.run(["podman", "cp", f"{container}:{path}{suffix}", local + suffix], capture_output=True)
self.db = sqlite3.connect(local)
self.db.row_factory = sqlite3.Row
def rows(self, sql, *params):
return [dict(r) for r in self.db.execute(sql, params)]
def close(self):
self.db.close()
shutil.rmtree(self.dir, ignore_errors=True)
def __enter__(self):
return self
def __exit__(self, *exc):
self.close()
def logs(container, since=None):
args = ["logs"]
if since:
args += ["--since", since]
return run(*args, container, check=False)
def stats():
out = run("stats", "--no-stream", "--format", "json", *running(), check=False)
try:
return json.loads(out)
except ValueError:
return []