### Visión general Implementación de [Hamcrest](http://hamcrest.org/) para JSL. Escribir pruebas expresivas con mensajes de fallo informativos. Hacer que las pruebas sean más independientes y reducir desbordamiento de información entre ellos. #### Automatizar la prueba de JSL utilizando Hamcrest ¿Ha escrito algo JSL y se ha cansado de probar manualmente después de cada cambio? ¿Ha roto inadvertidamente alguna parte de la aplicación o tiene miedo de al hacerlo no pudo realizar los cambios que desea realizar? Con automatizado pruebas, puede tener más confianza en los cambios. Ahora está disponible un conjunto de herramientas para automatizar la prueba de JSL. Este marco incluye la creación de pruebas y casos de prueba, así como una implementación de la conocida aserción Hamcrest librería. Hamcrest proporciona formas flexibles de afirmar lo que se sabe que es cierto sobre el comportamiento de su JSL. Estas herramientas son completas y se pueden especializar para sus necesidades. De hecho, el desarrollo JMP incluso los utiliza para probar el propio JMP. #### Documentación Consulte nuestro sitio web de [documentación](https://sassoftware.github.io/jsl-hamcrest/#File:Matchers-Index.txt) para obtener información detallada sobre el uso de JSL\-Hamcrest. ### Forma de uso #### Instalación Abra el archivo `JSL-Hamcrest.jmpaddin` en JMP para instalarlo. #### Uso básico JSL\-Hamcrest tiene varias partes diferentes que se pueden elegir para usar en las pruebas. Puede utilizar la mayoría de ellos por separado o combinarlos. Estos incluyen aserciones ( `ut assert that` y matchers ), casos de prueba ( `ut test` , `ut test case` ), funciones simuladas ( `ut mock function` ) y el reporter ( `ut global reporter` ) que subyace a todo esto. El escenario más común es una combinación de casos de prueba y aserciones como: ```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` permite una expresión `Setup` y `Teardown` que se ejecutan antes y después de each `ut test`. El `ut test` también garantiza que todas las ventanas, tablas, errores y símbolos se limpien para que pueda centrarse en la prueba. El `ut assert that` es cómo se escribe una aserción real. El primer argumento (la expresión de prueba) debería estar siempre envuelto en `Expr` para que podamos probar errores e informar mejor de los fallos de prueba. El segundo argumento (el esperado) puede ser un valor o un `matcher` como `ut starts with`. Estas son descripciones declarativas de lo que le gustaría probar que proporcionan descripciones y fallos informativos. Puede utilizar `ut assert that` fuera de `ut test` si lo desea. Las funciones simuladas se pueden utilizar para probar las devoluciones de llamada. Parecen: ```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 También se puede derivar de `UtTypedMatcher` para que se realice cualquier comprobación de tipos. Esto simplifica mucho lo que sucede en el método `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 )]^" ) ); ); ``` Al derivar de `UtTypedMatcher` , es necesario inyectar una autorreferencia en el comparador dentro de la función factory. ```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 )} ) ); ); ``` #### Factorías múltiples Puede tener varias funciones de factoría para un único comparador para cambiar el método de comparación (como menor que/mayor que) o para mejorar la redacción, como como `ut on thursday()` en lugar de `ut day of week( 5 )`. ```jsl ut on thursday = Function( {}, ut day of week( 5 ); ); ``` ### Detalles adicionales Visite [GitHub](https://github.com/sassoftware/jsl-hamcrest) para obtener más detalles sobre la implementación, el uso y las contribuciones. #### Atribuciones Los iconos utilizados en el complemento JSL\-Hamcrest se han adaptado del [Material Design Icons](https://github.com/google/material-design-icons) por Google bajo su [Apache 2\.0 License](https://github.com/google/material-design-icons/blob/master/LICENSE). #### Recursos adicionales * Los materiales de presentación originales de JMP Discovery Summit Europe 2019 se pueden encontrar [aquí](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

Idioma

Crear

Publicar

JSL-Hamcrest

Visión general

Opiniones

Preguntas y respuestas