### Informazioni generali Implementazione di [Hamcrest](http://hamcrest.org/) per JSL. Scrivi test espressivi con messaggi informativi di errore. Rendi i test più autonomi e riduci informazioni che si riversano tra di loro. #### Automatizza il test di JSL utilizzando Hamcrest Hai scritto un po' di JSL e ti sei stancato di testare manualmente dopo ogni modifica? Hai inavvertitamente interrotto qualche pezzo della tua applicazione o hai paura di farlo ciò ha impedito di apportare le modifiche desiderate? Con automatizzato test, si può essere più sicuri delle modifiche apportate. È ora disponibile un insieme di strumenti per automatizzare il test di JSL. Questo framework include la creazione di test e casi di test, nonché un'implementazione della ben nota asserzione Hamcrest libreria. Hamcrest offre modi flessibili per affermare ciò che si sa essere vero il comportamento di JSL. Questi strumenti sono completi e possono essere specializzati per le tue esigenze. In effetti, lo sviluppo JMP li utilizza persino per testare lo stesso JMP. #### Documentazione Consultare il nostro sito Web della [documentazione](https://sassoftware.github.io/jsl-hamcrest/#File:Matchers-Index.txt) per informazioni dettagliate sull'utilizzo di JSL\-Hamcrest. ### Come si usa #### Installazione in corso Aprire il file `JSL-Hamcrest.jmpaddin` in JMP per installare. #### Utilizzo di base JSL\-Hamcrest ha diverse parti che è possibile scegliere di utilizzare per il test. È possibile utilizzare la maggior parte di essi separatamente o combinarli. Questi includono asserzioni ( `ut assert that` e matchers ), casi di test ( `ut test` , `ut test case` ), funzioni fittizie ( `ut mock function` ) e reporter ( `ut global reporter` ) che è alla base di tutto ciò. Lo scenario più comune è una combinazione di test case e asserzioni come: ```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` consente un'espressione `Setup` e `Teardown` che viene eseguita prima e dopo each `ut test`. `ut test` assicura inoltre che tutte le finestre, le tabelle, gli errori e i simboli vengano ripuliti in modo da potersi concentrare sul test stesso. `ut assert that` è il modo in cui si scrive un'asserzione effettiva. Il primo argomento (l'espressione di test) dovrebbe sempre essere racchiuso in `Expr` in modo da poter testare gli errori e segnalare errori di test migliori. Il secondo argomento (il previsto) può essere un valore o un `matcher` come `ut starts with`. Si tratta di descrizioni dichiarative di ciò che si desidera testare e forniscono descrizioni informative e errori. È possibile utilizzare `ut assert that` al di fuori di `ut test` se lo si desidera. Le funzioni fittizie possono essere utilizzate per testare i callback. Questi sono simili a: ```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 È anche possibile derivare da `UtTypedMatcher` per fare in modo che il controllo dei tipi venga eseguito automaticamente. Ciò semplifica molto di ciò che accade nel metodo `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 )]^" ) ); ); ``` Con la derivazione da `UtTypedMatcher` , è necessario inserire un riferimento personale sul matcher all'interno della funzione 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 )} ) ); ); ``` #### Fabbriche multiple È possibile avere più funzioni factory per un singolo matcher per cambiare metodo di confronto (come minore di/maggiore di) o per migliorare la formulazione, come `ut on thursday()` invece di `ut day of week( 5 )`. ```jsl ut on thursday = Function( {}, ut day of week( 5 ); ); ``` ### Dettagli aggiuntivi Visitare il [GitHub](https://github.com/sassoftware/jsl-hamcrest) per maggiori dettagli su implementazione, utilizzo e contributi. #### Attribuzioni Le icone utilizzate nell'add\-in JSL\-Hamcrest sono state adattate da [Material Design Icons](https://github.com/google/material-design-icons) di Google sotto il loro [Apache 2\.0 License](https://github.com/google/material-design-icons/blob/master/LICENSE). #### Risorse aggiuntive * I materiali di presentazione originali di JMP Discovery Summit Europe 2019 sono disponibili [qui](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

Lingua

Crea

Pubblica

JSL-Hamcrest

Informazioni generali

Recensioni

Domande e risposte