Merge pull request #410 from Peefy/test-tool-fail-test-suite

docs: add more error suites for the test tool

Author: Peefy

docs/tools/cli/kcl/test.md

@@ -17,6 +17,9 @@ schema Person:
     name: str = "kcl"
     age: int = 1
 
+    check:
+        0 <= age <= 120, "age must be in [0, 120]"
+
 hello = Person {
     name = "hello kcl"
     age = 102
@@ -117,6 +120,33 @@ EvaluationError
 FAIL: 3/3
 ```
 
+If we want to test error cases correctly and check error messages, we can use the `runtime.catch` function.
+
+```python
+import runtime
+
+test_person_age_check_error_message = lambda {
+    msg = runtime.catch(lambda {
+        a = Person {age = 123}
+    }) 
+    assert msg == "age must be in [0, 120]"
+}
+```
+
+Run the command
+
+```shell
+kcl test
+```
+
+Output:
+
+```shell
+test_person_age_check_error_message: PASS (2ms)
+--------------------------------------------------------------------------------
+PASS: 1/1
+```
+
 ## Args
 
 - `kcl test path` Execute the test of the specified directory. It can be omitted if it's the same directory that the command is executed

i18n/zh-CN/docusaurus-plugin-content-docs/current/tools/cli/kcl/test.md

@@ -17,6 +17,9 @@ schema Person:
     name: str = "kcl"
     age: int = 1
 
+    check:
+        0 <= age <= 120, "age must be in [0, 120]"
+
 hello = Person {
     name = "hello kcl"
     age = 102
@@ -117,6 +120,33 @@ EvaluationError
 FAIL: 3/3
 ```
 
+如果我们想要正确测试错误情况并检查错误消息，我们可以使用 `runtime.catch` 函数。
+
+```python
+import runtime
+
+test_person_age_check_error_message = lambda {
+    msg = runtime.catch(lambda {
+        a = Person {age = 123}
+    }) 
+    assert msg == "age must be in [0, 120]"
+}
+```
+
+运行命令
+
+```shell
+kcl test
+```
+
+输出:
+
+```shell
+test_person_age_check_error_message: PASS (2ms)
+--------------------------------------------------------------------------------
+PASS: 1/1
+```
+
 ## 参数说明
 
 - `kcl test path` 执行指定目录的测试, 当前目录可以省略该参数

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.9/tools/cli/kcl/test.md

@@ -17,6 +17,9 @@ schema Person:
     name: str = "kcl"
     age: int = 1
 
+    check:
+        0 <= age <= 120, "age must be in [0, 120]"
+
 hello = Person {
     name = "hello kcl"
     age = 102
@@ -117,6 +120,33 @@ EvaluationError
 FAIL: 3/3
 ```
 
+如果我们想要正确测试错误情况并检查错误消息，我们可以使用 `runtime.catch` 函数。
+
+```python
+import runtime
+
+test_person_age_check_error_message = lambda {
+    msg = runtime.catch(lambda {
+        a = Person {age = 123}
+    }) 
+    assert msg == "age must be in [0, 120]"
+}
+```
+
+运行命令
+
+```shell
+kcl test
+```
+
+输出:
+
+```shell
+test_person_age_check_error_message: PASS (2ms)
+--------------------------------------------------------------------------------
+PASS: 1/1
+```
+
 ## 参数说明
 
 - `kcl test path` 执行指定目录的测试, 当前目录可以省略该参数

versioned_docs/version-0.9/tools/cli/kcl/test.md

@@ -17,6 +17,9 @@ schema Person:
     name: str = "kcl"
     age: int = 1
 
+    check:
+        0 <= age <= 120, "age must be in [0, 120]"
+
 hello = Person {
     name = "hello kcl"
     age = 102
@@ -117,6 +120,33 @@ EvaluationError
 FAIL: 3/3
 ```
 
+If we want to test error cases correctly and check error messages, we can use the `runtime.catch` function.
+
+```python
+import runtime
+
+test_person_age_check_error_message = lambda {
+    msg = runtime.catch(lambda {
+        a = Person {age = 123}
+    }) 
+    assert msg == "age must be in [0, 120]"
+}
+```
+
+Run the command
+
+```shell
+kcl test
+```
+
+Output:
+
+```shell
+test_person_age_check_error_message: PASS (2ms)
+--------------------------------------------------------------------------------
+PASS: 1/1
+```
+
 ## Args
 
 - `kcl test path` Execute the test of the specified directory. It can be omitted if it's the same directory that the command is executed