&cr;"> ]> Testen von Stylesheets Dieses Stylesheet enthält interne Templates und Funktionen zum Testen von XSLT-Stylesheets. Grundidee ist, einzelne Funktionen und Templates mit definierten Argumenten aufzurufen und die Rückgabewerte mit erwarteten Werten zu vergleichen. Dieses Stylesheet stellt Funktionen und Templates bereit, die diesen Prozess vereinfachen. Ein einzelner Test besteht aus dem Aufruf einer Funktion bzw. eines Templates und dem Vergleich des Ergebnisses mit einem Vorgabewert. Üblicherweise wird man mehrere Tests in einem Test-Template zusammenfassen, das dann unabhängig vom zu testenden Stylesheet aufgerufen wird. Test-Templates können in das zu testende Stylesheet selbst oder in externe Test-Stylesheets eingebunden werden. Tests sind unmittelbar mit dem zu testenden Code in einer Datei verbunden. Tests können schnell und unkompliziert beim Entwickeln erstellt und ausgeführt werden. Stylesheets werden kleiner Fehler in den Tests führen nicht zu Fehlern im Stylesheet Die Test-Stylesheets werden aus der Stylesheet-Hierarchie ausgekoppelt. Deshalb können für die Tests Stylesheets eingebunden werden, die aufgrund der Stylesheet-Hierarchie (zirkuläres <xsl:include/>/<xsl:import/>) nicht in das zu testende Stylesheet selbst eingebunden werden können. Ein Beispiel dafür ist strings.xsl, das (über internals.xsl und internals.logging.xsl) in internals.testing.xsl eingebunden wird. Die Tests für strings.xsl wurden deshalb nach strings_tests.xsl ausgelagert. In der XSLT-SB kommen beide Techniken zum Einsatz, wobei es keine festen Regeln gibt. In der Praxis wird man meist mit Tests innerhalb des Stylesheets anfangen und diese bei einem bestimmten Umfang oder bei Abschluss der Entwicklung auslagern. Wegen der engen Verknüpfung der Test-Infrastruktur mit internals.Stylecheck (welches das zu testenden Stylesheet als Eingabedokument erwartet) werden innerhalb der XSLT-SB die Tests durch eine Transformation des zu testenden Stylesheets mit dem Test-Stylesheet (das im Fall interner Test-Templates das zu testende Stylesheet selbst ist) im Mode internals.self-test ausgeführt. Externe Test-Stylesheets müssen wegen dieser Verknüfung nach dem Namensschema xxxxx_tests.xsl (wobei »xxxxx« für den Namen – ohne Erweiterung – des zu testenden Stylesheets steht) benannt werden. Verzichtet man auf den Einsatz von Stylecheck, können die Tests in beliebigen XSLT-Dateien abgelegt werden. Die Verwendung der Testumgebung ist dem Einsatz von Stylecheck ähnlich und erfolgt innerhalb der XSLT-SB meist gemeinsam, so dass bei Fragen ggfs. auch ein Blick dorthin lohnt. Autor: Stefan Krause Homepage: http://www.expedimentum.org/ Lizenz (duale Lizenzierung): Dieses Stylesheet und die dazugehörige Dokumentation sind unter einer Creative Commons-Lizenz (CC-BY 3.0) lizenziert. Die Weiternutzung ist bei Namensnennung erlaubt. Dieses Stylesheet und die dazugehörige Dokumentation sind unter der sogenannten Expat License (einer GPL-kompatiblen MIT License) lizensiert. Es darf – als Ganzes oder auszugweise – unter Beibehaltung der Copyright-Notiz kopiert, verändert, veröffentlicht und verbreitet werden. Die Copyright-Notiz steht im Quelltext des Stylesheets und auf der Startseite der Dokumentation. Stylesheet: &XSL-Base-Directory;/internals.testing.xsl Dokumentation: &doc-Base-Directory;/internals.testing.html Test-Stylesheet: &XSL-Base-Directory;/internals.testing_tests.xsl Test-Dokumentation: &doc-Base-Directory;/internals.testing_tests.html XSLT-SB: &XSL-Base-Directory;/ Google Code: http://code.google.com/p/xslt-sb/ 0.2.0 2011-05-14 Stf erste veröffentlichte Version 0.129 2011-02-27 Stf Erweiterung der Lizenz auf Expath/MIT license 0.82 2010-03-28 Stf initiale Version, ausgelagert aus internals.xsl Hilfsvariable, da dieser Wert häufig benötigt wird. aufrufende Funktion, wenn möglich inklusive der konkreten Parameter Ergebnis der getesteten Funktion. Im select-Attribut des <xsl:with-param/>-Elements sollte die Funktion aufgerufen werden. erwarteter Rückgabewert der getesteten Funktion Dieses Template dient zum Testen einer Funktion. Es nimmt den Namen der Funktion sowie Ist- und Soll-Wert entgegen und vergleicht sie. Je nach Ergebnis wird ein Bericht an das Logging-System ausgegeben. 0.2.34 2011-06-26 Stf Status: beta Fehlerausgabe: Typ bei xs:anyAtomicValue ergänzt 0.57 2009-10-25 Stf Status: beta initiale Version OK (erwartet und geliefert »«) DEBUG FEHLER (erwartet » « as , geliefert » « as ) ERROR ein Testknoten Name der getesteten Funktion. Der Funktionsname wird sowohl zur Ermittlung des Referenzwertes aus dem Testknoten als auch zur Ausgabe der Resultate an das Logging-System verwendet. aktuelles Ergebnis der getesteten Funktion. Im select-Attribut des <xsl:with-param/>-Elements sollte die getestete Funktion mit dem Inhalt des <value/>-Elements des Testknotens als Argument aufgerufen werden. Dieses Template unterstützt das Testen von Funktionen mit Testlisten, indem es einen Testknoten für das Template xsb:internals.test.Function aufbereitet. Manchmal sollen mehrere Funktionen mit einer größeren Anzahl von Parametern getestet werden. Ein Beispiel sind die Tests für files.xsl, wo die meisten Funktionen gegen Dutzende gültige und ungültige URLs geprüft werden. Test-Knoten und die Templates xsb:internals.test.function.withTestItem.BooleanResult, xsb:internals.test.function.withTestItem.StringResult und xsb:internals.test.function.withTestItem.NumericResult vereinfachen solche Massentests. Grundidee ist, in einer Liste von Testknoten jeweils Funktionsargumente und erwartetes Ergebnis abzulegen. Eine <xsl:for-each/>-Schleife kann dann über die Sequenz der Testknoten gehen, das Funktionsergebnis berechnen, es mit dem Vorgabewert vergleichen und positive und negative Ergebnisse loggen. Testknoten und internals.test.function.withTestItem…-Templates implementieren dafür eine Infrastruktur. Ein Testknoten ist ein Element (der Name ist egal), das mindestens zwei Kind-Elemente haben muss: eine Element mit dem Namen value, und ein Element mit dem qualifizierten Namen der zu testenden Funktion (das Test-Item). Mehrere Testknoten können in einer Testliste (Name ist wieder egal) zusammengefasst werden. Da Kinder von <xsl:stylesheet/> in einem beliebigen Namensraum ignoriert werden, kann man die Liste dort ablegen. Ein Beispiel: file:///server/path/test.txt true test.txt file:///server/path/test.txt/test true test ]]> Diese Testliste besteht aus zwei Testknoten. Jeder Testknoten hat ein <value/>-Element, dessen Inhalt (beim ersten Testkonten also »file:///server/path/test.txt«) von den Testroutinen als Parameter benutzt wird. In den beiden Test-Items <xsb:is-absolute-url/> und <xsb:fileName-and-fileExtention-from-url/> stehen die erwarteten Ergebnisse, wobei true von xsb:internals.test.function.withTestItem.BooleanResult als Wahrheitswert geparst und test.txt von xsb:internals.test.function.withTestItem.StringResult als String interpretiert wird. Die eigentliche Testroutine nimmt eine Sequenz von Testknoten und gibt diese einzeln an die Test-Templates weiter, etwa so: xsb:is-absolute-url xsb:fileName-and-fileExtention-from-url ]]> Die internals.test.function.withTestItem…-Templates nehmen einen Testknoten (im Template-Parameter test-node) und einen aktuellen Wert (im Template-Parameter actual-value) entgegen. Der Testknoten hat ein Kindelement mit dem Namen der zu testenden Funktion, das das erwartete Resultat als Textknoten enthält. An Hand des Template-Parameters function-name wird dieses Kind-Element ausgewählt, in einen Wert vom gewünschten Typ (boolean, string) ungewandelt und mit actual-value verglichen. Das Ergebnis des Vergleichs – OK- oder Fehlermeldung – wird an das Logging-System übergeben. Testknoten und Test-Items können für einen oder mehrere XSLT-Prozessoren ausgeschlossen werden. Dazu erhält der Testknoten oder das Test-Item ein intern:skip-Attribut, das eine leerzeichen-getrennte Liste der betreffenden Vendor-Hashs (siehe xsb:current-vendor-hash()) enthält. Auf betroffenen XSLT-Prozessoren wird der gesamte Testknoten oder das entsprechende Test-Item übersprungen und eine Warnung (per Template xsb:internals.testing.SkippedTests) ausgegeben. 0.145 2011-05-03 Stf Status: beta intern:skip-Attribut eingebaut 0.78 2010-03-06 Stf Status: beta ausgelagert aus files_temp_uri.xsl 0.70 2009-12-07 Stf Status: beta initiale Version in files_temp_uri.xsl ( '' ) ( '' ) ein Testknoten Name der getesteten Funktion. Der Funktionsname wird sowohl zur Ermittlung des Referenzwertes aus dem Testknoten als auch zur Ausgabe der Resultate an das Logging-System verwendet. aktuelles Ergebnis der getesteten Funktion. Im select-Attribut des <xsl:with-param/>-Elements sollte die getestete Funktion mit dem Inhalt des <value/>-Elements des Testknotens als Argument aufgerufen werden. Dieses Template unterstützt das Testen von Funktionen mit Testlisten, indem es einen Testknoten für das Template xsb:internals.test.Function aufbereitet. 0.145 2011-05-03 Stf Status: beta intern:skip-Attribut eingebaut 0.78 2010-03-06 Stf Status: beta ausgelagert aus files_temp_uri.xsl 0.70 2009-12-07 Stf Status: beta initiale Version in files_temp_uri.xsl ( '' ) ( '' ) ein Testknoten Name der getesteten Funktion. Der Funktionsname wird sowohl zur Ermittlung des Referenzwertes aus dem Testknoten als auch zur Ausgabe der Resultate an das Logging-System verwendet. aktuelles Ergebnis der getesteten Funktion. Im select-Attribut des <xsl:with-param/>-Elements sollte die getestete Funktion mit dem Inhalt des <value/>-Elements des Testknotens als Argument aufgerufen werden. Dieses Template unterstützt das Testen von Funktionen mit Testlisten, indem es einen Testknoten für das Template xsb:internals.test.Function aufbereitet. Um bei Umwandlung und Vergleich der vermeintlich numerischen actual-value bzw. $test-node/value/text() einen Abbruch bei gescheiterten Cast auf z.B. xs:double zu vermeiden (wie es etwa bei einem Leerstring der Fall wäre), wird auf string gecastet und dann die String-Werte verglichen. 0.0.25 2011-05-25 Stf Status: beta cast von reference-value auf type von actual-value eingebaut 0.94 2010-05-30 Stf Status: beta initiale Version ( '' ) ( '' ) zu testender test-node qualifizierter Name der Funktion, für die $test-node das erwartete Testergebnis beinhalten soll. Diese Funktion testet ein Element auf seine Eignung als Eingabe-Knoten für Funktionen wie xsb:internals.test.function.withTestItem.BooleanResult. 0.82 2010-03-28 Stf Status: beta initiale Version xsb:internals.test.function.withTestItem.Test-Node.Test, function-name="" test-Element ohne value-Element ERROR Fehler xsb:internals.test.function.withTestItem.Test-Node.Test, function-name="" test-Element ohne -Element ERROR Fehler xsb:internals.test.function.withTestItem.Test-Node.Test, function-name="" test-Element mit mehr als einem -Element ERROR Fehler Name und ggfs. arity der Funktion, für die der Test übersprungen wurde. Level für die Fehlerausgabe, Vorgabe: WARN Ausgabe einer Warnung für übersprungene Tests Bestimmte Funktionen erfordern Erweiterungen wie JAVA oder prozessorspezifische Funktionen, d.h. sie arbeiten nicht mit allen XSLT-Prozessoren zusammen. Andere Funktionen scheitern an prozessorspezifischen Inkompatibilitäten. Solche Tests müsen im Test-Template an Hand des Vendor-Hashs (siehe xsb:current-vendor-hash()) unterdrückt werden. Dies kann hart über eine xsl:if-Abfrage im Testtemplate oder einfacher über intern:skip-Attribute an Testknoten und Test-Items geschehen. Dieses Template gibt in diesen Fällen eine standardisierte Meldung aus. Ein Beispiel für die Verwendung (hart ausgeschlossen und per intern:skip-Attribut) findet sich in files_tests.xsl. 0.143 2011-04-26 Stf Status: beta initiale Version WARN ein oder mehrere Tests wurden übersprungen