### Aperçu Ce complément est une implémentation de [Hamcrest](http://hamcrest.org/) pour JSL. Il fournit un cadre pour écrire des tests expressifs avec des messages d’échec informatifs. Ce cadre permet aux tests d’être plus autonomes et de réduire les fuites d’informations entre eux. #### Automatiser le test de JSL en utilisant Hamcrest Avez-vous écrit du JSL et en avez-vous assez de tester manuellement après chaque modification ? Avez-vous involontairement cassé une partie de votre application, ou la peur de le faire vous a-t-elle empêché de faire les changements que vous souhaitez faire ? Avec des tests automatisés, vous pouvez être plus confiant dans vos changements. Maintenant disponible est un ensemble d’outils pour automatiser le test de JSL. Ce cadre comprend la création de tests et de cas de test, ainsi qu’une implémentation de la célèbre bibliothèque d’assertions Hamcrest. Hamcrest offre des moyens flexibles pour affirmer ce que vous savez être vrai sur le comportement de votre JSL. Ces outils sont complets et peuvent être spécialisés pour répondre à vos besoins. En fait, JMP développement les utilise même pour tester JMP lui-même. #### Documentation Consultez notre site Internet de [documentation](https://sassoftware.github.io/jsl-hamcrest/#File:Matchers-Index.txt) pour des informations détaillées sur l’utilisation de JSL-Hamcrest. ### Utilisation #### Installation Ouvrez le fichier `JSL-Hamcrest.jmpaddin` dans JMP pour l’installer. #### Utilisation élémentaire JSL-Hamcrest a plusieurs pièces différentes que vous pouvez choisir d’utiliser pour des tests. Vous pouvez les utiliser séparément ou vous pouvez les combiner. Cela inclut des assertions (`ut assert that` and matchers), test cases (`ut test`, `ut test case`), mock functions (`ut mock function`), and the reporter (`ut global reporter`) qui sous-tendent tout cela. Le scénario le plus courant est une combinaison de cas de test et d’affirmations 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"); )); ``` `ut test case` allows a `Setup` and `Teardown` expressio*n th*at are run before and after *each* `ut test`. The `ut test` also ensures that all windows, tables, errors, and symbols get cleaned up so you can focus on the test itself. The `ut assert that` is how you write an actual assertion. The first argument (the test expression) should always be wrapped in `Expr` so we can test errors and report better test failures. The second argument (the expected) can be a value or a `matcher` like `ut starts with`. These are declarative descriptions of what you would like to test which give informative descriptions and failures. You can use `ut assert that` outside of `ut test` si vous le souhaitez. Les fonctions Mock peuvent être utilisées pour tester les rappels. Voici l’apparence : ```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 également dériver de la méthode `UtTypedMatcher` to have any type checking done for you. This simplifies a lot of what happens in the `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 auto-référence sur le matcher dans 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 )} ) ); ); ``` #### Usines multiples Vous pouvez avoir plusieurs fonctions d’usine pour un seul matcheur afin de modifier la méthode de comparaison (comme inférieur/supérieur) ou d’améliorer le libellé, tel que `ut on thursday()` instead of `ut day of week( 5 )`. ```jsl ut on thursday = Function( {}, ut day of week( 5 ); ); ``` ### Détails supplémentaires Veuillez visiter le [GitHub](https://github.com/sassoftware/jsl-hamcrest) pour plus de détails sur la mise en œuvre, l’utilisation et les contributions. #### Attribution Les icônes utilisées dans le complément JSL-Hamcrest ont été adaptées à partir du [Material Design Icons](https://github.com/google/material-design-icons) par Google sous leur [Apache 2.0licence ](https://github.com/google/material-design-icons/blob/master/LICENSE). #### Ressources complémentaires * Les documents de présentation originaux du sommet de la découverte de JMP Europe 2019 peuvent être trouvés [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/)

Langue

FAQ

Publier

JSL- Hamcrest

Aperçu

Commentaires

Q&R

Historique des versions