Ich trage mich schon seit einer Weile mit dem Gedanken, einer größeren Leserschaft ein Werkzeug nahezubringen über das ich in einem der Projekte in meinem $dayjob gestolpert bin. Dabei handelt es sich um ein Testframework namens ArchUnit. Dieses Framework erlaubt es, diverse Metriken einer Codebasis zu testen, die sich grob in die Bereiche Architektur, Coding Style oder Model Check einordnen lassen.
Zu den einzelnen verfügbaren Tests zählen unter anderem solche wie Checks ob Package-Grenzen eingehalten werden oder ob bestimmte Namenskonventionen betreffend Klassen, Interfaces oder Methoden eingehalten werden. Des Weiteren ist es möglich, die Benutzung oder Nichtbenutzung bestimmter Apis zu überwachen.
Dazu schreibt man fluid Statements wie etwa diese beiden Beispiele hier, die Softwareentwicklern ohne weiteren Kommentar bereits sagen sollten, welche Kriterien der Codebasis hier vaslidiert werden sollen:
classes().that().resideInAPackage("..foo..")
.should().onlyHaveDependentClassesThat().resideInAnyPackage("..source.one..", "..foo..");
classes().that().areAssignableTo(EntityManager.class)
.should().onlyHaveDependentClassesThat().areAnnotatedWith(Transactional.class);
Hier noch ein nicht ganz so triviales Beispiel, das aber durchaus auch verständlich ist:
layeredArchitecture()
.consideringAllDependencies()
.layer("Controller").definedBy("..controller..")
.layer("Service").definedBy("..service..")
.layer("Persistence").definedBy("..persistence..")
.whereLayer("Controller").mayNotBeAccessedByAnyLayer()
.whereLayer("Service").mayOnlyBeAccessedByLayers("Controller")
.whereLayer("Persistence").mayOnlyBeAccessedByLayers("Service");
Am meisten (und positivsten) hat mich aber die Möglichkeit überrascht, Checks auf im Projekt vorhandene UML-Diagramme anzuwenden, die in PlantUML-Syntax vorliegen.
Den vollen Funktions- und Möglichkeitsumfang hier darzulegen würde viel zu weit führen - ich verweise dafür auf die hervorragende Dokumentation und diverse Tutorial- und Demonstrationsprojekte - in diesem hier kann man neben vielen anderen Validierungen auch Beispiele für die angesprochene PlantUML-Integration finden.
Es existieren Integrationen speziell für Junit4 und Junit5 - man kann das Framework aber auch mit beliebigen anderen Testframeworks benutzen - Beispiele dafür finden sich ebenfalls in der Dokumentation und dem Demonstrationsprojekt.
30.12.2024
Ich habe bereits verschiedentlich über esoterische numerische Probleme bei der Arbeit mit Computern berichtet.
23.11.2024
Ich wurde über einen Post auf Mastodon auf ein Projekt aufmerksam, das mir so interessant erschien, dass ich daraus meine neueste Fingerübung machte...
Die sozialen Medien des Web 1.0
15.09.2021
Na gut - das hier ist nicht wirklich und strenggenommen ein Linux-Thema. Es betrifft schon im eigentlichen Sinne alle Unixe und BSDs und was da noch so kreucht und fleucht und heutzutage kann man sogar einen Finger-Client für Windows selber bauen und Gopher-Browser gibts inzwischen auch für Windows...
WeiterlesenAI und ML Android Basteln C und C++ Chaos Datenbanken Docker dWb+ ESP Wifi Garten Geo Go GUI Hardware Java Jupyter JupyterBinder Komponenten Links Linux Markdown Markup Music Numerik OpenSource PKI-X.509-CA Präsentationen Python QBrowser Rants Raspi Revisited Security Software-Test sQLshell TeleGrafana Verschiedenes Video Virtualisierung Windows Upcoming...
Trump hat es sich ja zur Aufgabe gemacht, Chaos zu verbreiten und einfach irgendwelche Lügen rauszuhauen weil er denkt, dass - wenn er es nur schnell genug macht - wir gar nicht hinterherkommen, die Auswirkungen davon wieder zu kitten - und bisher hat er ja leider recht damit...
WeiterlesenDieses Mal ist meine soziale Blase schuld daran...
WeiterlesenIch wollte als Fingerübung wieder einmal einen Algorithmus umsetzen - dieses Mal doubledabble zum Encoding und Decoding von packed binary-coded decimal (BCD) Zahlen. Ich stellte zu meinem Erstaunen fest, dass das nicht einfach ist...
WeiterlesenManche nennen es Blog, manche Web-Seite - ich schreibe hier hin und wieder über meine Erlebnisse, Rückschläge und Erleuchtungen bei meinen Hobbies.
Wer daran teilhaben und eventuell sogar davon profitieren möchte, muss damit leben, daß ich hin und wieder kleine Ausflüge in Bereiche mache, die nichts mit IT, Administration oder Softwareentwicklung zu tun haben.
Ich wünsche allen Lesern viel Spaß und hin und wieder einen kleinen AHA!-Effekt...
PS: Meine öffentlichen Codeberg-Repositories findet man hier.