### 概述这个插件是JSL的一个实现。[Hamcrest](http://hamcrest.org/)它提供了一个框架，用于编写具有信息性故障消息的表达性测试。这个框架允许测试更加自我地包含，减少它们之间的信息溢出。 #### 自动化检验 JSL 使用 Hamcrest 你写过一些JSL并且厌倦了每次更改后手动测试吗？你是否无意中破坏了应用程序的某些内容，或者担心这样做阻止你做出想要的改变？通过自动化测试，您可以更加有信心地进行自己的更改。现在提供了一组工具，用于自动执行检验 JSL。该框架包括测试和测试用例的创建，以及著名的Hamcrest断言库的实现。Hamcrest 提供了灵活的方式来断言您所了解的有关 JSL 行为的真实情况。这些工具是全功能的，可以专门满足您的需求。实际上，JMP 开发甚至使用它们来测试 JMP 本身。 #### 文档请访问我们的 [文档](https://sassoftware.github.io/jsl-hamcrest/#File:Matchers-Index.txt) 网站，了解有关使用 JSL-Hamcrest 的详细信息。 ### 如何使用 #### 安装在 JMP 中打开 `JSL-Hamcrest.jmpaddin` 文件以安装。 #### 基本使用您可以选择几个不同的部分来进行检验。JSL-Hamcrest你可以单独使用大多数这些，也可以将它们组合起来。这些包括支持所有这些的断言（`ut assert that` and matchers), test cases (`ut test`, `ut test case`), mock functions (`ut mock function`), and the reporter (`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` 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` 模拟函数可以用来测试回调函数。这些看起来像： ```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` 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 )]^" ) ); ); ``` 使用 `UtTypedMatcher`，您需要在工厂函数中向匹配者注入一个对匹配者的自我引用。 ```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 )} ) ); ); ``` #### 多个因子您可以为单个匹配者拥有多个工厂函数，以改变比较方法（如小于/大于）或改善措辞，例如 `ut on thursday()` instead of `ut day of week( 5 )`。 ```jsl ut on thursday = Function( {}, ut day of week( 5 ); ); ``` ### 其他详细信息请访问 [GitHub](https://github.com/sassoftware/jsl-hamcrest) 了解更多关于执行、使用和贡献的细节。 #### 计数 JSL-Hamcrest 插件中使用的图标是 Google 根据其 [Apache 2.0 许可 ](https://github.com/google/material-design-icons) 从 [Material Design Icons](https://github.com/google/material-design-icons/blob/master/LICENSE) 改编的。 #### 其他资源 * 可 [在此处](https://community.jmp.com/t5/Discovery-Summit-Europe-2019/Automate-the-Testing-of-JSL-Using-Hamcrest-2019-EU-45MP-061/ta-p/110062) 找到来自JMP Discovery Summit 2019的原始演示材料。 * [Hamcrest.org](http://hamcrest.org/)

语言

支持

发布

JSL-Hamcrest

概述

评论

问答

版本历史