### Übersicht Implementierung von [Hamcrest](http://hamcrest.org/) für JSL. Schreiben von aussagekräftigen Tests mit Informative Fehlermeldungen Stärken Sie die Anzahl der Tests in sich geschlossen und reduzieren Sie die Anzahl der Tests Informationsquellen zwischen ihnen. #### Test von JSL automatisieren mit Hamcrest Haben Sie versucht, JSL zu schreiben und es nicht mehr erforderlich, nach jeder Änderung manuell zu testen? Ist unbeabsichtigt ein Teil Ihrer Anwendung fehlerhaft, oder befürchten Sie haben Sie dadurch verhindert, dass Sie die gewünschten Änderungen vornehmen können? Mit automatisierten Verarbeitungseinstellungen können Sie sicherer bei Ihren Änderungen sein. Es stehen jetzt verschiedene Werkzeuge zur Verfügung zur Testautomatisierung von JSL. Dieser Framework umfasst die Erstellung von Tests und Testfälle sowie eine Implementierung der bekannten Hamcrest\-Behauptung Bibliothek. Hamcrest bietet flexible Möglichkeiten an, geltend zu machen, von welcher Seite Sie wissen, dass sie wahr sind das Verhalten von JSL. Diese Werkzeuge verfügen über alle Funktionen und können auf spezialisiert werden Ihren Anforderungen entsprechen. Tatsächlich werden sie von der Entwicklung JMP verwendet, um JMP selbst zu testen. #### Dokumentation Detaillierte Informationen zur Verwendung von JSL\-Hamcrest finden Sie auf unserer [Dokumentations](https://sassoftware.github.io/jsl-hamcrest/#File:Matchers-Index.txt) \-Website. ### Nutzung #### Installieren Öffnen Sie zur Installation die Datei `JSL-Hamcrest.jmpaddin` in JMP. #### Grundlegende Verwendung JSL\-Hamcrest enthält verschiedene Teile, die Sie für Tests verwenden können. Sie können die meisten davon einzeln verwenden oder sie kombinieren. Dazu gehören Aussage ( `ut assert that` und Übereinstimmungen), Testfälle ( `ut test` , `ut test case` ), Scheinfunktionen ( `ut mock function` ) und die. Reporter ( `ut global reporter` ), der all dies zugrunde liegt. Das am häufigsten vorkommende Szenario ist eine Kombination aus Testfällen und Annahmen wie diesen: ```jsl formulas test case = ut test case("Formulas") << Setup(Expr( dt = Open("$SAMPLE_DATA\Big Class.jmp"); )) << Teardown(Expr( Close(dt, NoSave); // Unnecessary )) << Skip If(Expr(Day Of Week(Today()) == 4), "It's Wednesday"); ut test(formulas test case, "Advance Row", Expr( dt << new column("Test", Formula(Row())); ut assert that(Expr(dt:Test << Get Values), (1::40)`); )); ut test(formulas test case, "Char", Expr( dt << new column("Test", Formula(Char(Row()))); ut assert that(Expr(dt:Test << Get Values), ut starts with({"1", "2", "3"})); )); ut test("Big Class", "Row Count", Expr( dt = Open("$SAMPLE_DATA\Big Class.jmp"); ut assert that(Expr(N Rows(dt)), ut greater than(38), "large"); )); ``` `ut test case` lässt einen `Setup` und `Teardown` \-Ausdruck zu, die vor und nach each `ut test` ausgeführt werden. `ut test` stellt sicher, dass alle Fenster, Tabellen, Fehler und Symbole aufgehoben werden, damit Sie sich auf den Test selbst konzentrieren können. `ut assert that` , wie eine tatsächliche Aussage zu schreiben ist. Das erste Argument (der Testausdruck) sollte immer in `Expr` werden, damit Fehler getestet und bessere Testfehler gemeldet werden können. Das zweite (erwartete) Argument kann ein Wert oder `matcher` ähnlich `ut starts with` sein. Hierbei handelt es sich um beschreibende Beschreibungen dessen, was Sie testen möchten. Die Informationen geben aussagekräftige Beschreibungen und Fehler. Sie können `ut assert that` außerhalb von `ut test` verwenden, wenn Sie möchten. Scheinfunktionen können zum Testen von Rückrufen verwendet werden. Diese sehen folgendermaßen aus: ```jsl Data Table List Subscription Test = ut test case("Data Table List Subscription") <. Example: ---JSL--- d = 01aug2019; ut assert that( Expr( d ), ut day of week( 5 ) ); --------- */ ut matcher factory( "ut day of week", Expr(Function( {val}, // Do necessary type checking of input variables // in factory function. If( !Is Number( val ), Throw( "ut day of week() requires a numeric date value as the argument" ), ); New Object( UtDayOfWeekMatcher( Name Expr( val ) ) ); )), "ut day of week( value )", //Prototype "Matches based on the day of the week of a given date value." // Description ); ``` #### UtTypedMatcher Sie können auch von `UtTypedMatcher` ableiten, um einen beliebigen Typ für Sie zu prüfen. Dies vereinfacht viele der Vorgänge bei der Methode `matches`. ```jsl Define Class( "UtDayOfWeekMatcher", Base Class( "UtTypedMatcher" ), value = .; days = {"Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"}; allowable types = {Date, Number}; _init_ = Method( {value}, this:value = value; ); // Method: typed matches // Handle a pre-evaluated and typed checked actual value. typed matches = Method( {actual}, day = Day of Week( actual ); If( day == this:value, ut match info success(), // else ut match info failure( Eval Insert( "^As Date( actual )^ was on ^this:days[Day of Week( actual )]^" ) ) ); ); describe = Method( {}, Eval Insert( "date falling on a ^this:days[Day of Week( this:value )]^" ) ); ); ``` Bei Ableitung von `UtTypedMatcher` müssen Sie eine Eigenreferenz einfügen auf den Matcher innerhalb der Factory\-Funktion. ```jsl ut day of week = Function( {val}, If( !Is Number( val ), Throw( "ut day of week() requires a numeric date value as the argument" ), ); ut new object( "UtDayOfWeekMatcher", Eval List( {Name Expr( val )} ) ); ); ``` #### Mehrere Factories Sie können mehrere Factory\-Funktionen für einen einzelnen Matcher verwenden, um entweder die zu ändern Vergleichsmethode (wie kleiner als/größer als) oder zur Verbesserung der Wortwahl, wie z als `ut on thursday()` anstelle von `ut day of week( 5 )`. ```jsl ut on thursday = Function( {}, ut day of week( 5 ); ); ``` ### Zusätzliche Details Details zu Implementation, Verwendung und Contributions finden Sie [GitHub](https://github.com/sassoftware/jsl-hamcrest). #### Attributionen Die im JSL\-Hamcrest Add\-in verwendeten Symbole wurden aus der übernommen [Material Design Icons](https://github.com/google/material-design-icons) von Google unter sie ein [Apache 2\.0 License](https://github.com/google/material-design-icons/blob/master/LICENSE). #### Zusätzliche Ressourcen * Originale Präsentationsmaterialien von JMP Discovery Summit Europe 2019 finden Sie [hier](https://community.jmp.com/t5/Discovery-Summit-Europe-2019/Automate-the-Testing-of-JSL-Using-Hamcrest-2019-EU-45MP-061/ta-p/110062). * [Hamcrest.org](http://hamcrest.org/)

Sprache

Häufig gestellte Fragen

Veröffentlichen

JSL-Hamcrest

Übersicht

Bewertungen

Fragen und Antworten