### Aperçu Mise en oeuvre de [Hamcrest](http://hamcrest.org/) pour JSL. Écrire des tests expressifs avec messages d'échec informatifs. Rendre les tests plus autonomes et réduire se déversent d’informations. #### Automatiser les tests de JSL en utilisant Hamcrest Avez\-vous écrit des JSL et en avez assez de tester manuellement après chaque changement ? Avez\-vous rompu par erreur une partie de votre application, ou risquez\-vous vous a\-t\-il empêché d'effectuer les modifications souhaitées ? Avec Automatisation les tests, vous avez plus confiance dans vos modifications. À présent, un ensemble d'outils est disponible pour automatiser les tests de JSL. Ce cadre inclut la création de contrôles et cas de test, ainsi qu'une implémentation de l'assertion Hamcrest bien connue bibliothèque. Hamcrest fournit des manières souples d'exprimer ce que vous savez être vrai le comportement de votre JSL. Ces outils sont complets et peuvent être spécialisés vos besoins. En fait, le développement JMP les utilise même pour tester JMP lui\-même. #### Documentation Consultez notre site Internet de la [documentation](https://sassoftware.github.io/jsl-hamcrest/#File:Matchers-Index.txt) pour plus d'informations sur l'utilisation de JSL\-Hamcrest. ### Utilisation #### Installation de Ouvrez le fichier `JSL-Hamcrest.jmpaddin` dans JMP pour l'installation. #### Utilisation de base JSL\-Hamcrest a plusieurs pièces que vous pouvez choisir d'utiliser pour les tests. Vous pouvez utiliser la plupart de ces éléments séparément ou les combiner. Ceux\-ci incluent les assertions ( `ut assert that` et matchers ), les cas de test ( `ut test` , `ut test case` ), les fonctions fictives ( `ut mock function` ), et le Reporter ( `ut global reporter` ) sous\-jacent de tout cela. Le scénario le plus courant est une combinaison de cas de test et d'assertions telles que : ```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"); )); ``` L'expression `ut test case` permet une expression `Setup` et `Teardown` exécutée avant et après each `ut test`. Le `ut test` garantit également que toutes les fenêtres, tables, erreurs et symboles sont nettoyées afin que vous puissiez vous concentrer sur le test lui\-même. Le `ut assert that` est la façon dont vous écrivez une assertion réelle. Le premier argument (l'expression de test) doit toujours être dans `Expr` afin que nous puissiez tester les erreurs et rapporter de meilleurs échecs de tests. Le second argument (attendu) peut être une valeur ou un `matcher` comme `ut starts with`. Il s'agit de descriptions descriptives de ce que vous souhaitez tester et qui donnent des descriptions informatives et des défaillances. Vous pouvez utiliser `ut assert that` à l'extérieur de `ut test` si vous le voulez. Les fonctions fictives peuvent être utilisées pour tester les rappels. Cela ressemble à : ```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 Vous pouvez aussi dériver de `UtTypedMatcher` pour avoir n'importe quel type de vérification effectué pour vous. Cela simplifie beaucoup ce qui se passe dans la méthode `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 )]^" ) ); ); ``` En dérivant de `UtTypedMatcher` , vous devez injecter une référence de l'auto sur le système d'appariement à l'intérieur de la fonction d'usine. ```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 )} ) ); ); ``` #### Plusieurs fermes Vous pouvez avoir plusieurs fonctions d'usine pour un système d'appariement unique afin de pouvoir modifier le pour la méthode de comparaison (par exemple inférieur/supérieur à) ou pour améliorer la syntaxe, par exemple sous `ut on thursday()` au lieu de `ut day of week( 5 )`. ```jsl ut on thursday = Function( {}, ut day of week( 5 ); ); ``` ### Détails supplémentaires Visitez le [GitHub](https://github.com/sassoftware/jsl-hamcrest) pour plus de détails sur la mise en œuvre, l'utilisation et les contributions. #### Attributs Les icônes de l'Add\-in JSL\-Hamcrest ont été adaptées du format [Material Design Icons](https://github.com/google/material-design-icons) par Google sous leurs [Apache 2.0 License](https://github.com/google/material-design-icons/blob/master/LICENSE). #### Ressources complémentaires * Les documents de présentation originaux de JMP Discovery Summit Europe 2019 se trouvent [ici](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/)

Marketplace

Langue

Créer

Publier

JSL- utilisé

Aperçu

Commentaires

Q&R