blog.t8d.de

Vor einigen Wochen hatte ich an dieser Stelle über die Integration von PHPUnit berichtet. Gestern nun folgte die Einbindung von phpDocumentor, dem de facto Standardwerkzeug, wenn es um API-Dokumentationen für PHP-Applikationen geht. phpDocumentor wird ebenfalls als externes Tool eingebunden: Run -> External Tools. Über verschiedene Parameter bspw. für das Template oder den Titel der Dokumentation lässt sich das Ergebnis steuern. Eine Übersicht über die Optionen findet sich hier.

Der Screenshot zeigt die Einstellungen, mit der die API-Doku der aktuellen SVN-Version von PHPTMAPI 2.0 generiert worden ist (bitte anklicken für bessere Lesbarkeit):

“/var/www/phpdoc/PhpDocumentor-1.4.2/phpdoc” gibt den Pfad zum phpdoc Shell-Script an, “/home/johannes/apidoc/${project_name}” den Zielordner. Über einen Klick auf “Run” (External Tools) aus dem oberen Menü wird dann für das aktuell geöffnete Projekt die Dokumentation erzeugt.

Scott Davis erklärt hier anschaulich anhand von Groovy, was DSLs sind.

Seit kurzem ist eine neue Version von QuaaxTM im sourceforge SVN verfügbar, die PHPTMAPI 2.0 core implementiert.
Neu ist eine PHPUnit Testsuite mit 179 Tests und 1337 Einzelprüfungen, die als PHPTMAPI 2.0 core Testsuite ihre Verwendung finden soll.
Der Code ist komplett neu geschrieben, das DB Schema leicht überarbeitet worden.
Ich möchte an dieser Stelle Stefan Kesberg und Murray Woodman für wertvolle Hinweise danken.
Als nächste Schritte sind Deserializer auf Basis von Lars Heuers Streaming API sowie Serializer geplant; mindestens für XTM 2.0. JTM 1.0 strebe ich an, da dieses Format für die Verwendung im WWW einfach prädestiniert ist.

Mit dieser Version sind nun alle Beispiele aus dem TMAPI 2.0-Tutorial auf der TMRA 2008 ausführbar.

Mit Hilfe eines Artikels von Mind Patterns habe ich PHPUnit in mein Eclipse integriert. Dies funktioniert via “External Tools” (Run -> External Tools -> External Tools…). Hier legt man einfach ein neues Tool an; der Screenshot zeigt alle Einstellungen (bitte anklicken, falls schwer lesbar):

Dann öffnet man einfach einen Test oder eine Testsuite und kann über “Run” (External Tools) aus dem oberen Menü die Tests ausführen. Das Ergebnis wird dann in der Eclipse-Konsole ausgegeben: