### 概要 JSLに対する[Hamcrest](http://hamcrest.org/)の実行書き出したテストの内容は次のとおりです。失敗を知らせるメッセージ。検定をより分離し、省略するそれらの間の情報が比検定されない。 #### Hamcrestを使用したJSLのテストを自動化する JSLを作成して、変更のたびに手動でテストするのに手間がかかったことはありませんか。アプリケーションの一部を意図せずに中断してしまう可能性があるそうすると、必要な変更が行えませんか?オートメーション変更した点についてより信頼ができる。現在は一連のツールが使えます。JSLのテストを自動化するこのフレームワークには、テストの作成が含まれます。テストケース、およびよく知られているHamcrestアサーションの実装ライブラリ。 Hamcrestは、自分が真であるとわかっていることを柔軟にステートメントする方法を提供するJSLの動作これらのツールはさまざまな機能を備えており、ニーズに合わせて実際、 JMPの開発では、 JMP自体のテストにも使われています。 #### ドキュメント JSL\-Hamcrestの使い方の詳細[について](https://sassoftware.github.io/jsl-hamcrest/#File:Matchers-Index.txt)は、マニュアルWebサイトを参照してください。 ### 使用方法 #### インストール中 JMPの`JSL-Hamcrest.jmpaddin`ファイルを開き、インストールする。 #### 基本的な使用方法 JSL\-Hamcrestにはいくつかの点があり、それらをテストに使用することができます。これらの主効果は、個別に使用することも、組み合わせて使用することもできます。アセット（ `ut assert that`およびmatchers ）、テストケース（ `ut test` 、 `ut test case` ）、モコード関数（ `ut mock function` ）、そしてこのすべての根底にあるのはレポーター( `ut global reporter` )です。最も一般的なシナリオは、次のようなテストケースとアサーションの組み合わせです。 ```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`は、それぞれ`ut test`の前後にある`Setup`や`Teardown`の式を実行します。また、「 `ut test` 」を用いると、すべてのウィンドウ・テーブル・エラー・記号が綺麗になります。 `ut assert that`は、実際のアセットを書くときのものです。第1引数（テスト式）は、常に`Expr`で囲む必要があります。そうすることで、エラーをテストし、適切なテスト結果をレポートできるようになります。第2引数（期待される引数）は、数値または`matcher` （ `ut starts wit`hなど）です。これらは、何をテストするかについての宣言的な記述です。必要であれば、 `ut test`の外側に`ut assert that`を使用してもかまいません。コールバックをテストすることができます。これらは次のようになります。 ```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 また、 `UtTypedMatcher`を使ってタイプチェックを自動的に行うようにすることもできます。これにより、 `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 )]^" ) ); ); ``` `UtTypedMatcher`から派生した式では、自己参照を挿入する必要があります出荷時の関数内のMatcherに ```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 )} ) ); ); ``` #### 複数の因子 1つのマッチングに対して複数の因子関数を定義して、「以下」や「以上」などの似た単語や検定をする。代わりに`ut on thursday()` `ut day of week( 5 )`を使用してください。 ```jsl ut on thursday = Function( {}, ut day of week( 5 ); ); ``` ### その他詳細実装、使い方、寄与の詳細については、 [GitHub](https://github.com/sassoftware/jsl-hamcrest)を参照してください。 #### 属性 JSL\-Hamcrestアドインで使用されているアイコンは、[Material Design Icons](https://github.com/google/material-design-icons) by Google [Apache 2\.0 License](https://github.com/google/material-design-icons/blob/master/LICENSE). #### その他のリソース * JMP Discovery Summit Europe 2019のオリジナルのプレゼンテーション資料は[こちら](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/)

言語

FAQ

公開

JSL-Hamcrest

概要

レビュー

Q&A