Softwarequalität für öffentliche TYPO3-Extensions

Transcript

1. Softwarequalität für öffentliche TYPO3-Extensions ein Überblick Oliver Klee & Anna Reiter oliverklee.de · @oliklee@chaos.social
2. Fahrplan > Warum automatisiert testen? > Welche Versionen wovon supporten? > Mit welchen Tools anfangen? > Welche Kombinationen minimal testen? > Wo lassen wir testen? > Wie ausführen lassen? Fragemodus: Köser-Regel Verständnisfragen sofort Diskussionsfragen am Ende eitle Selbstdarstellung im nächsten Slot
3. Wer hat versehentlich etwas mit einer Änderung in einer Extension kaputtgemacht, ohne es zu merken? Wer hat eine Extension installiert und dann später gemerkt, dass sie eine total niedrige Qualität hatte?
4. Warum automatisiert testen? Ihr wisst, ob die Basics eurer Extension korrekt funktionieren. Ihr kriegt schneller mit, wenn PRs etwas kaputt machen würden. Ihr habt eine Hilfe beim Debuggen, um die Fehlerursachen zu finden. Ihr kriegt mit, wenn neue Versionen von Dependencies (inklusive TYPO3Updates) etwas kaputt machen oder ihr etwas Deprecatetes nutzt. In eurem Repository ist sichtbar, dass eure Extension eine bestimmte Qualität hat → mehr Vertrauen bei der Entscheidung für/gegen eure Extension.
5. Welche Versionen wovon supporten? TYPO3 PHP DBMS Symfony Minimal: die aktuelle niedrigere LTSVersion alle PHP-Versionen, die von den unterstützten TYPO3-Versionen offiziell unterstützt werden alle DBMS, die von den kompatiblen TYPO3-Versionen offiziell unterstützt werden > SQLite (Default) > MySQL > MariaDB > Postgres alle MinorVersionen, die von den unterstützten TYPO3-Versionen kompatibel sind Empfohlen: auch die aktuell höhere LTS-Version Abhängigkeiten explizit machen (nicht auf transitive Abhängigkeiten verlassen) Versionen von Dev-Dependencies pinnen “10.5.45” statt “^10.5”
6. Mit welchen Tools anfangen? PHP-Linter PHP-CS-Fixer PHPStan findet Syntaxfehler Code Style findet potenzielle Fehler > -l > parallel-lint > mit den TYPO3Coding-Standards > mit TYPO3-Rules und PHPUnit-Rules Unit Tests Functional Tests testet einzelne Komponenten testet das Zusammenspiel > mit PHPUnit und dem TYPO3-Testing-Framework > mit PHPUnit und dem TYPO3-Testing-Framework > TYPO3-versionsspezifische Baselines
7. Welche Kombinationen minimal testen? Abwägung zwischen „Debugging einfacher machen“ und „schnelles Feedback von der CI und Energie sparen“
8. PHP-Linter PHPStan mit min-max PHP mit Max-Dependencies alle unterstützen TYPO3-Versionen
9. Unit-und Functional-Tests-Matrix (Functionals mit SQLite) > min-max PHP > min-max TYPO3 > min-max Composer-Dependencies Functional-Tests mit anderen DBMS > alle unterstützen TYPO3-Versionen > Max-Dependencies, Max-PHP > die anderen DBMS: MySQL, MariaDB, Postgres
10. Wo lassen wir testen? GitHub Actions GitLab CI main und in den Pull-/MergeRequests
11. GitHub Actions
12. GitLab CI
13. PullRequests
14. Wie ausführen lassen? runTests.sh (für Standalone-Extensions, die nicht Teil eines DDEV-Projekts sind) kopieren von Tea-Beispiel (von der Core-runTests.sh adaptiert)
15. runTests.sh
16. Danke & Fragen Oliver Klee & Anna Reiter oliverklee.de · @oliklee@chaos.social