### Visión general Este complemento es una implementación de [Hamcrest](http://hamcrest.org/) para JSL. Proporciona un marco para escribir pruebas expresivas con mensajes de fallo informativos. Este marco permite que las pruebas sean más autónomas y reduzcan la información que se filtra entre ellas. #### Automatizar la prueba de JSL mediante Hamcrest ¿ha escrito algún JSL y se ha cansado de probar manualmente después de cada cambio? ¿Ha roto inadvertidamente alguna pieza de su solicitud, o el miedo a hacerlo le ha impedido hacer los cambios que desea hacer? Con pruebas automatizadas, puedes tener más confianza en tus cambios. Ahora está disponible un conjunto de herramientas para automatizar las pruebas de JSL. Este marco incluye la creación de pruebas y casos de prueba, así como una implementación de la conocida biblioteca de aserciones Hamcrest. Hamcrest proporciona formas flexibles de afirmar lo que sabes que es verdadero sobre el comportamiento de tu JSL. Estas herramientas son completas y pueden ser especializadas para sus necesidades. De hecho, JMP desarrollo incluso los utiliza para probar JMP propio. #### Documentación Visita 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. ### Cómo utilizar #### Instalando Abra el archivo `JSL-Hamcrest.jmpaddin` en JMP para instalar. #### Uso básico JSL-Hamcrest tiene varias piezas diferentes que puede utilizar para realizar pruebas. Puedes usar la mayor parte de estos por separado o puedes combinarlos. Estas incluyen afirmaciones (`ut assert that` and matchers), test cases (`ut test`, `ut test case`), mock functions (`ut mock function`), and the reporter (`ut global reporter`) que subyace a todo esto. El escenario más común es una combinación de casos de prueba y afirmaciones 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"); )); ``` La `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 lo deseas. Las funciones simuladas pueden ser utilizadas para probar las devoluciones de llamada. Estos son los siguientes: ```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 puedes derivar del método `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 )]^" ) ); ); ``` Al derivar de `UtTypedMatcher`, se requiere inyectar una auto referencia en el comparador dentro de la función de fábrica. ```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 )} ) ); ); ``` #### Fábricas múltiples Puedes tener múltiples funciones de fábrica para un solo comparador para cambiar el método de comparación (como menor que/mayor que) o para mejorar la redacción, como `ut on thursday()` instead of `ut day of week( 5 )`. ```jsl ut on thursday = Function( {}, ut day of week( 5 ); ); ``` ### Detalles adicionales Por favor visite el [GitHub](https://github.com/sassoftware/jsl-hamcrest) para más detalles sobre implementación, uso y contribuciones. #### Atribuciones Los iconos utilizados en el complemento JSL-Hamcrest fueron adaptados del [Material Design Icons](https://github.com/google/material-design-icons) por Google bajo su [licenciaApache 2.0 ](https://github.com/google/material-design-icons/blob/master/LICENSE). #### Recursos adicionales * Los materiales de presentación originales del 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/)

Idioma

Soporte

Publicar

JSL-Hamcrest

Visión general

Opiniones

Preguntas y respuestas

Historial de versiones