- Posts: 1
Question
webtrees Testing Platform v1.0.0 — an open test stack for webtrees & its modules
- xf01213
-
Topic Author
- Offline
- New Member
-
Less
More
1 month 3 weeks ago - 1 month 3 weeks ago #116642
by xf01213
webtrees Testing Platform v1.0.0 — an open test stack for webtrees & its modules was created 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
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
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
- Repository on GitHub
- Features & Capabilities — what it offers and what it covers
- Reference Manual — install, commands, using your own repository, known test failures
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.