Web based family history software

file Question webtrees Testing Platform v1.0.0 — an open test stack for webtrees & its modules

  • xf01213
  • xf01213's Avatar Topic Author
  • Offline
  • New Member
  • New Member
More
1 month 3 weeks ago - 1 month 3 weeks ago #116642 by xf01213
Hi all,

First, a heartfelt thank-you to everyone who builds and maintains webtrees — and to Greg Roach in particular — for such a great genealogy system. This project only exists because webtrees is such a solid foundation to build on.

I've just published the webtrees Testing Platform, an open-source (AGPL-3.0) test infrastructure for webtrees and the modules people build on top of it. If you run a customised webtrees, maintain a module, or simply want a throwaway webtrees you can poke at safely, it may be useful to you.

What it is
A single command ('make setup') brings up a complete, disposable webtrees stack — Apache + PHP 8.5, MySQL, a headless browser — installs webtrees and loads sample trees. Everything runs in rootless Podman containers, so nothing touches your host and no root is required. Tests then run against the real application and a real database (real GEDCOM import, real SQL, a real browser), not mocks.

Why it might interest you
  • Module & fork authors: point it at your own webtrees fork/branch, or mount your own module, and test it continuously against webtrees main (the latest development line) — an early warning before an upstream change breaks you.
  • Upgrade confidence: five test layers — static analysis, component, integration (real MySQL), system (real browser, across all five bundled themes) and performance against a baseline.
  • Privacy & access control: the part that matters most for a genealogy site — living-person visibility, RESN, relationship privacy and the editor/moderator/manager tiers — is exercised end to end.
  • Observability: a four-layer OpenTelemetry trace chain links a browser action → PHP request → SQL query in one trace (viewable in Jaeger), with per-run MySQL timings.

Coverage today
The feature matrix tracks 219 webtrees features across nine domains (GEDCOM, search & navigation, privacy & access, security, data entry, administration, communication, utilities and middleware), 216 of them covered at one or more layers.

Have a look
It's early days (v1.0.0) and feedback is very welcome — especially from module authors who'd like to test against the latest webtrees. Happy to answer any questions here.

Cheers,
Boris
Last edit: 1 month 3 weeks ago by xf01213.

Please Log in or Create an account to join the conversation.

Powered by Kunena Forum