upgrade version to 6.0.0: support Highlight; update protobuf from 3.19.0 to 4.25.0; support Python 3.8、Python 3.9、Python 3.10、Python 3.11、Python 3.12

Author: Yang8miao

CHANGELOG.rst

@@ -1,7 +1,14 @@
-TableStore SDK for Python 版本记录
+Tablestore SDK for Python 版本记录
 ===========================
 
-Python SDK的版本号遵循 `Semantic Versioning <http://semver.org/>`_ 规则。
+Python SDK 的版本号遵循 `Semantic Versioning <http://semver.org/>`_ 规则。
+
+Version 6.0.0
+-------------
+
+- Update protobuf from 3.19.0 to 4.25.0
+- Support Python 3.8、Python 3.9、Python 3.10、Python 3.11、Python 3.12
+- Support Highlight
 
 Version 5.4.4
 _____________

README.rst

@@ -15,13 +15,13 @@ Aliyun Tablestore SDK for Python
 概述
 ----
 
-- 此Python SDK基于 `阿里云表格存储服务 <http://www.aliyun.com/product/ots/>`_  API 构建。
+- 此 Python SDK 基于 `阿里云表格存储服务 <http://www.aliyun.com/product/ots/>`_  API 构建。
 - 阿里云表格存储是构建在阿里云飞天分布式系统之上的 NoSQL 数据存储服务，提供海量结构化数据的存储和实时访问。
 
 运行环境
 ---------
 
-- 安装Python即可运行，支持python2.6、Python2.7、python3.3、python3.4、python3.5 和 python3.6。
+- 安装 Python 即可运行，支持 python3.8、Python3.9、python3.10、python3.11、python3.12。
 
 安装方法
 ---------
@@ -53,7 +53,7 @@ Github安装
 源码安装
 --------
 
-1. 下载SDK发布包并解压
+1. 下载 SDK 发布包并解压
 2. 安装
 
 
@@ -64,6 +64,8 @@ Github安装
 示例代码
 ---------
 
+表（Table）示例：
+
 - `表操作（表的创建、获取、更新和删除） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/table_operations.py>`_
 - `单行写（向表内写入一行数据） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/put_row.py>`_
 - `单行读（从表内读出一样数据） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/get_row.py>`_
@@ -77,45 +79,70 @@ Github安装
 - `局部事务（提交事务） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/transaction_and_commit.py>`_
 - `局部事务（舍弃事务） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/transaction_and_abort.py>`_
 
-- `Search <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/search_index.py>`_
-- `Parallel Scan <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/parallel_scan.py>`_
-- `Max/Min/Sum/Avg/Count/DistinctCount/Percentiles <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/agg.py>`_
-- `GroupBy/Histogram <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/group_by.py>`_
-- `SQL <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/sql_query.py>`_
+多元索引（Search）示例：
 
+- `基础搜索 <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/search_index.py>`_
+- `并发圈选数据 <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/parallel_scan.py>`_
+- `全文检索 <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/full_text_search.py>`_
+- `向量检索 <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/parallel_scan.py>`_
+- `Max/Min/Sum/Avg/Count/DistinctCount 等 <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/agg.py>`_
+- `GroupBy/Histogram 等 <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/group_by.py>`_
 
 执行测试
 ---------
 
-**注意：测试case中会有清理某个实例下所有表的动作，所以请使用专门的测试实例来测试。**
+**注意：测试 case 中会有清理某个实例下所有表的动作，所以请使用专门的测试实例来测试。**
+
+1. 测试前准备
+
+.. code-block:: bash
+
+    $ /bin/bash tests_setup.sh
 
-1. 安装nosetests
+2. 安装nosetests
 
 .. code-block:: bash
 
     $ pip install nose
 
-2. 设置执行Case的配置
+3. 设置执行Case的配置
 
 .. code-block:: bash
 
-    $ export OTS_TEST_ACCESS_KEY_ID=<your access id>
-    $ export OTS_TEST_ACCESS_KEY_SECRET=<your access key>
+    $ export OTS_TEST_ACCESS_KEY_ID=<your access key id>
+    $ export OTS_TEST_ACCESS_KEY_SECRET=<your access key secret>
     $ export OTS_TEST_ENDPOINT=<tablestore service endpoint>
-    $ export OTS_TEST_INSTANCE=<your instance name>
+    $ export OTS_TEST_INSTANCE=<tablestore instance name>
+
+4. 运行case
 
-2. 运行case
+python3.8、Python3.9、python3.10、python3.11可使用以下命令
 
 .. code-block:: bash
 
-    $ nosetests tests/
+    $ export PYTHONPATH=$(pwd)/tests:$PYTHONPATH; nosetests tests/
+
+python3.12可使用以下命令
+
+.. code-block:: bash
+
+    $ /bin/bash tests_run.sh
+
+编译proto文件
+----------------
+.. code-block:: bash
+
+    $ /bin/bash protoc.sh
 
 贡献代码
 --------
-- 我们非常欢迎大家为Tablestore Python SDK以及其他Tablestore SDK贡献代码。
-- 非常感谢 `@Wall-ee <https://github.com/Wall-ee>`_ 对4.3.0版本的贡献。
+- 我们非常欢迎大家为 Tablestore Python SDK 以及其他 Tablestore SDK 贡献代码。
+- 非常感谢 `@Wall-ee <https://github.com/Wall-ee>`_ 对 4.3.0 版本的贡献。
 
 联系我们
 --------
-- `阿里云Tablestore官方网站 <http://www.aliyun.com/product/ots>`_
+- `阿里云 Tablestore 官方网站 <http://www.aliyun.com/product/ots>`_
 - `阿里云官网联系方式 <https://help.aliyun.com/document_detail/61890.html>`_
+- `阿里云 Tablestore 官方文档 <https://help.aliyun.com/zh/tablestore/product-overview>`_
+
+