diff --git a/tests20/python_client/README_CN.md b/tests20/python_client/README_CN.md index 71a957b2be..c9997f1314 100644 --- a/tests20/python_client/README_CN.md +++ b/tests20/python_client/README_CN.md @@ -121,144 +121,123 @@
可参考添加新的测试用例或框架工具。
+
test类:每一个 test 文件中分两个类
+TestObjectParams :
+TestObjectOperations:
+test
--
类:每一个 test 文件中分两个类
-TestObjectParams :
-TestObjectOperations:
-testcase 命名
TestObjectParams 类
-TestObjectOperations 类
-如当需要创建多个 partition 对象时,可调用方法 self.init_partition_wrap(),该方法返回的结果就是新生成的 partition 对象。当无需创建多个对象时,直接使用 self.partition_wrap 即可
+# create partition -Call the default initialization method
-
partition_w = self.init_partition_wrap()
-
assert partition_w.is_empty
+
# create partition -Directly call the encapsulated object
-
self.partition_wrap.init_partition(collection=collection_name, name=partition_name)
-
assert self.partition_wrap.is_empty
+
验证接口返回错误或异常
# create partition with collection is None
+# create partition with collection is None
self.partition_wrap.init_partition(collection=None, name=partition_name, check_task=CheckTasks.err_res, check_items={ct.err_code: 1, ct.err_msg: "'NoneType' object has no attribute"})
+
验证接口返回正常返回值
-- check_task=CheckTasks.check_partition_property,可以在 CheckTasks 中新建校验方法,在用例中调用使用
-- 输入期望的结果,供校验方法使用
-
+ - check_task=CheckTasks.check_partition_property,可以在 CheckTasks 中新建校验方法,在用例中调用使用
+ - 输入期望的结果,供校验方法使用
-
-# create partition
+# create partition
partition_w = self.init_partition_wrap(collection_w, partition_name, check_task=CheckTasks.check_partition_property, check_items={"name": partition_name, "description": description, "is_empty": True, "num_entities": 0})
+
3. 测试用例添加
-
-- 在 base 文件夹的 wrapper 文件底下找到封装好的同名被测接口,各接口返回2个值的list,第一个是 pymilvus-orm 的接口返回结果,第二个是接口返回结果正常/异常的判断,为True/False。该返回可用于在用例中做额外的结果检查。
-- 在 testcases 文件夹下找到被测接口相应的测试文件,进行用例添加。如下所示,全部测试用例可直接参考 testcases 目录下的所有 test 文件:
-
+
+ - 在 base 文件夹的 wrapper 文件底下找到封装好的同名被测接口,各接口返回2个值的list,第一个是 pymilvus-orm 的接口返回结果,第二个是接口返回结果正常/异常的判断,为True/False。该返回可用于在用例中做额外的结果检查。
+ - 在 testcases 文件夹下找到被测接口相应的测试文件,进行用例添加。如下所示,全部测试用例可直接参考 testcases 目录下的所有 test 文件:
-
- @pytest.mark.tags(CaseLabel.L1)
+ @pytest.mark.tags(CaseLabel.L1)
@pytest.mark.parametrize("partition_name", [cf.gen_unique_str(prefix)])
def test_partition_dropped_collection(self, partition_name):
"""
@@ -278,16 +257,15 @@ partition_w = self.init_partition_wrap(collection_w, partition_name, check_task=
# create partition failed
self.partition_wrap.init_partition(collection_w.collection, partition_name, check_task=CheckTasks.err_res, check_items={ct.err_code: 1, ct.err_msg: "can't find collection"})
+
Tips
-
-- 用例注释分为三个部分:目标,测试方法及期望结果,依此说明相应内容
-- 在 base/client_base.py 文件 Base 类的 setup 方法中对被测试的类进行了初始化,如下图所示:
-
-
+
+ - 用例注释分为三个部分:目标,测试方法及期望结果,依此说明相应内容
+ - 在 base/client_base.py 文件 Base 类的 setup 方法中对被测试的类进行了初始化,如下图所示:
+
-
self.connection_wrap = ApiConnectionsWrapper()
self.utility_wrap = ApiUtilityWrapper()
self.collection_wrap = ApiCollectionWrapper()
@@ -296,24 +274,26 @@ self.index_wrap = ApiIndexWrapper()
self.collection_schema_wrap = ApiCollectionSchemaWrapper()
self.field_schema_wrap = ApiFieldSchemaWrapper()
-
-- 调用需要测试的接口,应按照相应封装好的方法传入参数。如下所示,除了 check_task,check_items 两个参数外,其余参数与 pymilvus-orm 的接口参数一致。
+
+ - 调用需要测试的接口,应按照相应封装好的方法传入参数。如下所示,除了 check_task,check_items 两个参数外,其余参数与 pymilvus-orm 的接口参数一致。
def init_partition(self, collection, name, description="", check_task=None, check_items=None, **kwargs)
-- check_task 用来选择 check/func_check.py 文件中 ResponseChecker 检查类中对应的接口检查方法,可选择的方法在 common/common_type.py 文件的 CheckTasks 类中。
-- check_items 传入检查方法所需的特定内容,具体内容由实现的检查方法所决定。
-- 默认不传这两个参数,则检查接口能正常返回请求结果。
-
+ - check_task 用来选择 check/func_check.py 文件中 ResponseChecker 检查类中对应的接口检查方法,可选择的方法在 common/common_type.py 文件的 CheckTasks 类中。
+ - check_items 传入检查方法所需的特定内容,具体内容由实现的检查方法所决定。
+ - 默认不传这两个参数,则检查接口能正常返回请求结果。
+
+
4. 框架功能添加
-
-- 在 utils 目录下添加需要的全局方法或者工具
-- 可将相应的配置内容加入 config 目录下
+
+ - 在 utils 目录下添加需要的全局方法或者工具
+ - 可将相应的配置内容加入 config 目录下
+