mirror of https://github.com/milvus-io/milvus.git
[skip ci] Replace ORM in Pytest readmes (#7378)
Signed-off-by: LocoRichard <lichen.wang@zilliz.com>pull/7380/head
parent
f0dbdd7f13
commit
72932a9ab5
|
@ -1,6 +1,6 @@
|
|||
# Guidelines for Test Framewrok
|
||||
|
||||
This document guides you through the pytest-based PyMilvus ORM test framework.
|
||||
This document guides you through the Pytest-based PyMilvus test framework.
|
||||
|
||||
> You can find the test code on [GitHub](https://github.com/milvus-io/milvus/tree/master/tests/python_client).
|
||||
|
||||
|
@ -10,7 +10,7 @@ This document guides you through the pytest-based PyMilvus ORM test framework.
|
|||
|
||||
### Deploy Milvus
|
||||
|
||||
To accommodate the variety of requirements, Milvus offers as much as four deployment methods. PyMilvus ORM supports Milvus deployed with any of the methods below:
|
||||
To accommodate the variety of requirements, Milvus offers as much as four deployment methods. PyMilvus supports Milvus deployed with any of the methods below:
|
||||
|
||||
1. [Build from source code](https://github.com/milvus-io/milvus#to-start-developing-milvus)
|
||||
2. Install with Docker Compose
|
||||
|
@ -71,9 +71,9 @@ To accommodate the variety of requirements, Milvus offers as much as four deploy
|
|||
|
||||
|
||||
|
||||
### PyMilvus ORM Test Environment Deployment and Case Execution
|
||||
### PyMilvus Test Environment Deployment and Case Execution
|
||||
|
||||
We recommend using Python 3 (3.6 or higher), consistent with the version supported by PyMilvus ORM.
|
||||
We recommend using Python 3 (3.6 or higher), consistent with the version supported by PyMilvus.
|
||||
|
||||
> Note: Procedures listed below will be completed automatically if you deployed Milvus using KinD.
|
||||
|
||||
|
@ -117,7 +117,7 @@ where `host` should be set as the IP address of the Milvus service, and `*.html`
|
|||
|
||||
### Working directories and files
|
||||
|
||||
- **base**: stores the encapsulated **PyMilvus ORM** **module** files, and setup & teardown functions for pytest framework.
|
||||
- **base**: stores the encapsulated **PyMilvus** **module** files, and setup & teardown functions for pytest framework.
|
||||
- **check**: stores the **check module** files for returned results from interface.
|
||||
- **common**: stores the files of **common methods and parameters** for test cases.
|
||||
- **config**: stores the **basic configuration file.**
|
||||
|
@ -168,7 +168,7 @@ This section specifies references while adding new test cases or framework tools
|
|||
|
||||
2. Notice
|
||||
|
||||
- Do not initialize ORM objects in the test case files.
|
||||
- Do not initialize PyMilvus objects in the test case files.
|
||||
- Generally, do not add log IDs to test case files.
|
||||
- Directly call the encapsulated methods or attributes in test cases, as shown below:
|
||||
|
||||
|
@ -206,7 +206,7 @@ This section specifies references while adding new test cases or framework tools
|
|||
|
||||
3. Adding test cases
|
||||
|
||||
- Find the encapsulated tested interface with the same name in the ***_wrapper.py** files under **base** directory. Each interface returns a list with two values, among which one is interface returned results of PyMilvus ORM, and the other is the assertion of normal/abnormal results, i.e. `True`/`False`. The returned judgment can be used in the extra result checking of test cases.
|
||||
- Find the encapsulated tested interface with the same name in the ***_wrapper.py** files under **base** directory. Each interface returns a list with two values, among which one is interface returned results of PyMilvus, and the other is the assertion of normal/abnormal results, i.e. `True`/`False`. The returned judgment can be used in the extra result checking of test cases.
|
||||
- Add the test cases in the corresponding test file of the tested interface in **testcases** folder. You can refer to all test files under this directory to create your own test cases as shown below:
|
||||
|
||||
```python
|
||||
|
@ -240,7 +240,7 @@ This section specifies references while adding new test cases or framework tools
|
|||
self.collection_schema_wrap = ApiCollectionSchemaWrapper()
|
||||
self.field_schema_wrap = ApiFieldSchemaWrapper()
|
||||
```
|
||||
- Pass the parameters with corresponding encapsulated methods when calling the interface you need to test on. As shown below, align all parameters with those in PyMilvus ORM interfaces except for `check_task` and `check_items`.
|
||||
- Pass the parameters with corresponding encapsulated methods when calling the interface you need to test on. As shown below, align all parameters with those in PyMilvus interfaces except for `check_task` and `check_items`.
|
||||
```
|
||||
def init_partition(self, collection, name, description="", check_task=None, check_items=None, **kwargs)
|
||||
```
|
||||
|
|
|
@ -1,11 +1,11 @@
|
|||
<h1 >测试框架使用指南</h1>
|
||||
<h3 >简介</h3>
|
||||
<p>基于 pytest 编写的 <strong>pymilvus-orm</strong> 的测试框架。</p>
|
||||
<p>基于 pytest 编写的 <strong>PyMilvus</strong> 的测试框架。</p>
|
||||
<p><strong><em>测试代码:</em></strong><em><a href='https://github.com/milvus-io/milvus/tree/master/tests/python_client' target='_blank' class='url'>https://github.com/milvus-io/milvus/tree/master/tests/python_client</a></em></p>
|
||||
<p> </p>
|
||||
<h3 >快速开始</h3>
|
||||
<h5 >部署 Milvus </h5>
|
||||
<p>Milvus 支持4种部署方式,请根据需求选择部署方式,pymilvus_orm 支持任意部署下的 Milvus。</p>
|
||||
<p>Milvus 支持4种部署方式,请根据需求选择部署方式,PyMilvus 支持任意部署下的 Milvus。</p>
|
||||
<ol>
|
||||
<li><a href='https://github.com/milvus-io/milvus/blob/master/DEVELOPMENT.md'>源码编译部署</a></li>
|
||||
<li>Docker Compose 部署(<a href='https://milvus.io/cn/docs/v2.0.0/install_standalone-docker.md'>单机版本</a> <a href='https://milvus.io/cn/docs/v2.0.0/install_cluster-docker.md'>分布式版本</a>)</li>
|
||||
|
@ -61,11 +61,11 @@
|
|||
<pre><code> kind export logs .
|
||||
</code></pre>
|
||||
<p> </p>
|
||||
<h5 >pymilvus_orm 测试环境部署及用例执行</h5>
|
||||
<p>推荐使用 <strong>Python 3(>= 3.6)</strong> ,与 <strong><a href='https://pymilvus-orm.readthedocs.io/en/latest/install.html'>pymilvus_orm</a></strong> 支持的 python 版本保持一致。</p>
|
||||
<h5 >PyMilvus 测试环境部署及用例执行</h5>
|
||||
<p>推荐使用 <strong>Python 3(>= 3.6)</strong> ,与 <strong><a href='https://pymilvus.readthedocs.io/en/latest/install.html'>PyMilvus</a></strong> 支持的 python 版本保持一致。</p>
|
||||
<p>Note: 如选择KinD部署方式,以下步骤可以自动完成。</p>
|
||||
<ol>
|
||||
<li>安装测试所需的 python 包,进入代码 <strong>*/milvus/tests/python_client/</strong> 目录,执行命令:</li>
|
||||
<li>安装测试所需的 Python 包,进入代码 <strong>*/milvus/tests/python_client/</strong> 目录,执行命令:</li>
|
||||
|
||||
<pre><code>pip install -r requirements.txt
|
||||
</code></pre>
|
||||
|
@ -93,7 +93,7 @@
|
|||
<p><img src="https://github.com/milvus-io/milvus/blob/master/tests/python_client/graphs/module_call_diagram.jpg" referrerpolicy="no-referrer" alt="img"></p>
|
||||
<h5 > 工作目录及文件介绍</h5>
|
||||
<ul>
|
||||
<li><strong>base</strong>:放置已封装好的 <strong>pymilvus-orm 模块文件</strong>,以及 pytest 框架的 setup 和 teardown 处理等</li>
|
||||
<li><strong>base</strong>:放置已封装好的 <strong>PyMilvus 模块文件</strong>,以及 Pytest 框架的 setup 和 teardown 处理等</li>
|
||||
<li><strong>check</strong>:接口返回结果的<strong>检查模块</strong></li>
|
||||
<li><strong>common</strong>:测试用例<strong>通用的方法和参数</strong></li>
|
||||
<li><strong>config</strong>:<strong>基础配置</strong>内容</li>
|
||||
|
@ -177,7 +177,7 @@
|
|||
</ol>
|
||||
<ul>
|
||||
<ul>
|
||||
<li>不能在测试用例文件中初始化 ORM 对象</li>
|
||||
<li>不能在测试用例文件中初始化 PyMilvus 对象</li>
|
||||
<li>一般情况下,不在测试用例文件中直接添加日志代码</li>
|
||||
<li>在测试用例中,应直接调用封装好的方法或者属性,如下所示:</li>
|
||||
</ul>
|
||||
|
@ -225,7 +225,7 @@ partition_w = self.init_partition_wrap(collection_w, partition_name, check_task=
|
|||
</ol>
|
||||
<ul>
|
||||
<ul>
|
||||
<li>在 base 文件夹的 wrapper 文件底下找到封装好的同名被测接口,各接口返回2个值的list,第一个是 pymilvus-orm 的接口返回结果,第二个是接口返回结果正常/异常的判断,为True/False。该返回可用于在用例中做额外的结果检查。</li>
|
||||
<li>在 base 文件夹的 wrapper 文件底下找到封装好的同名被测接口,各接口返回2个值的list,第一个是 PyMilvus 的接口返回结果,第二个是接口返回结果正常/异常的判断,为True/False。该返回可用于在用例中做额外的结果检查。</li>
|
||||
<li>在 testcases 文件夹下找到被测接口相应的测试文件,进行用例添加。如下所示,全部测试用例可直接参考 testcases 目录下的所有 test 文件:</li>
|
||||
</ul>
|
||||
|
||||
|
@ -268,7 +268,7 @@ self.field_schema_wrap = ApiFieldSchemaWrapper()
|
|||
</code></pre>
|
||||
|
||||
<ul>
|
||||
<li>调用需要测试的接口,应按照相应封装好的方法传入参数。如下所示,除了 check_task,check_items 两个参数外,其余参数与 pymilvus-orm 的接口参数一致。</li>
|
||||
<li>调用需要测试的接口,应按照相应封装好的方法传入参数。如下所示,除了 check_task,check_items 两个参数外,其余参数与 PyMilvus 的接口参数一致。</li>
|
||||
</ul>
|
||||
<pre><code>def init_partition(self, collection, name, description="", check_task=None, check_items=None, **kwargs)
|
||||
</code></pre>
|
||||
|
|
Binary file not shown.
Before Width: | Height: | Size: 308 KiB |
Loading…
Reference in New Issue