tablestore 3.0.0__tar.gz

tablestore-3.0.0/CHANGELOG.rst

@@ -0,0 +1,92 @@
+Tablestore SDK for Python 版本记录
+===========================
+
+Python SDK 的版本号遵循 `Semantic Versioning <http://semver.org/>`_ 规则。
+
+Version 6.1.0
+-------------
+- Support some timeseries api.
+- Update protobuf to ">=3.20.0,<=5.27.4"
+- Refine util shell 'protoc.sh'
+
+Version 6.0.1
+-------------
+- Fix incompatible changes in delete_row
+
+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.3
+-------------
+
+- Support SearchIndex Knn Vector Query
+
+Version 5.2.1
+-------------
+
+- Optimize SearchResponse
+
+Version 5.2.0
+-------------
+
+- Support ParallelScan API
+- Support Max/Min/Avg/Sum/Count/DistinctCount
+- Support GroupBy API
+
+Version 4.3.5
+-------------
+
+- Fix bytearray encode bug
+
+Version 4.3.4
+-------------
+
+- replace protobuf-py3 by protobuf
+
+Version 4.3.2
+-------------
+
+- remove crcmod
+
+Version 4.3.0
+-------------
+
+- Support Python 3.3+
+
+Version 4.2.0
+-------------
+
+- Support STS
+
+Version 4.1.0
+-------------
+
+- Support Python 2.6
+
+Version 4.0.0
+-------------
+
+- 支持主键列自增功能
+- 支持多版本
+- 支持TTL
+- 增大重试时间
+
+Version 2.0.8
+-------------
+
+- 支持https访问和证书验证
+
+Version 2.0.7
+-------------
+
+- 根据按量计费方式，调整了示例代码中的预留CU设置 
+
+Version 2.0.6
+-------------
+
+- 调整了部分异常情况下的重试退避策略
+

tablestore-3.0.0/LICENSE

@@ -0,0 +1,14 @@
+Copyright (c) 2017 aliyun.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
+Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

tablestore-3.0.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE README.rst CHANGELOG.rst
+recursive-include tests *.py
+recursive-include examples *.py

tablestore-3.0.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.1
+Name: tablestore
+Version: 3.0.0
+Summary: Aliyun TableStore(OTS) SDK
+Home-page: https://cn.aliyun.com/product/ots
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+License-File: LICENSE
+
+Aliyun Tablestore SDK for Python
+==================================
+
+.. image:: https://img.shields.io/badge/license-apache2-brightgreen.svg
+    :target: https://travis-ci.org/aliyun/aliyun-tablestore-python-sdk
+.. image:: https://badge.fury.io/gh/aliyun%2Faliyun-tablestore-python-sdk.svg
+    :target: https://travis-ci.org/aliyun/aliyun-tablestore-python-sdk
+.. image:: https://travis-ci.org/aliyun/aliyun-tablestore-python-sdk.svg
+    :target: https://travis-ci.org/aliyun/aliyun-tablestore-python-sdk
+
+概述
+----
+
+- 此 Python SDK 基于 `阿里云表格存储服务 <http://www.aliyun.com/product/ots/>`_  API 构建。
+- 阿里云表格存储是构建在阿里云飞天分布式系统之上的 NoSQL 数据存储服务，提供海量结构化数据的存储和实时访问。
+
+运行环境
+---------
+
+- 安装 Python 即可运行，支持 python3.8、Python3.9、python3.10、python3.11、python3.12。
+
+安装方法
+---------
+
+PIP安装
+--------
+
+.. code-block:: bash
+
+    $ pip install tablestore
+
+Github安装
+------------
+
+1. 下载源码
+
+
+.. code-block:: bash
+
+    $ git clone https://github.com/aliyun/aliyun-tablestore-python-sdk.git
+
+2. 安装
+
+.. code-block:: bash
+
+    $ python setup.py install
+
+
+源码安装
+--------
+
+1. 下载 SDK 发布包并解压
+2. 安装
+
+
+.. code-block:: bash
+
+    $ python setup.py install
+
+示例代码
+---------
+
+表（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>`_
+- `更新单行（更新某一行的部分字段） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/update_row.py>`_
+- `删除某行（从表内删除某一行数据） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/delete_row.py>`_
+- `批量写（向多张表，一次性写入多行数据） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/batch_write_row.py>`_
+- `批量读（从多张表，一次性读出多行数据） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/batch_get_row.py>`_
+- `范围扫描（给定一个范围，扫描出该范围内的所有数据） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/get_range.py>`_
+- `主键自增列（主键自动生成一个递增ID） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/pk_auto_incr.py>`_
+- `全局二级索引 <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/secondary_index_operations.py>`_
+- `局部事务（提交事务） <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>`_
+- `并发圈选数据 <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 中会有清理某个实例下所有表的动作，所以请使用专门的测试实例来测试。**
+
+1. 测试前准备
+
+.. code-block:: bash
+
+    $ /bin/bash tests_setup.sh
+
+2. 安装nosetests
+
+.. code-block:: bash
+
+    $ pip install nose
+
+3. 设置执行Case的配置
+
+.. code-block:: bash
+
+    $ 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=<tablestore instance name>
+
+4. 运行case
+
+python3.8、Python3.9、python3.10、python3.11可使用以下命令
+
+.. code-block:: bash
+
+    $ 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 官方网站 <http://www.aliyun.com/product/ots>`_
+- `阿里云官网联系方式 <https://help.aliyun.com/document_detail/61890.html>`_
+- `阿里云 Tablestore 官方文档 <https://help.aliyun.com/zh/tablestore/product-overview>`_
+
+

tablestore-3.0.0/README.rst

@@ -0,0 +1,144 @@
+Aliyun Tablestore SDK for Python
+==================================
+
+.. image:: https://img.shields.io/badge/license-apache2-brightgreen.svg
+    :target: https://travis-ci.org/aliyun/aliyun-tablestore-python-sdk
+.. image:: https://badge.fury.io/gh/aliyun%2Faliyun-tablestore-python-sdk.svg
+    :target: https://travis-ci.org/aliyun/aliyun-tablestore-python-sdk
+.. image:: https://travis-ci.org/aliyun/aliyun-tablestore-python-sdk.svg
+    :target: https://travis-ci.org/aliyun/aliyun-tablestore-python-sdk
+
+概述
+----
+
+- 此 Python SDK 基于 `阿里云表格存储服务 <http://www.aliyun.com/product/ots/>`_  API 构建。
+- 阿里云表格存储是构建在阿里云飞天分布式系统之上的 NoSQL 数据存储服务，提供海量结构化数据的存储和实时访问。
+
+运行环境
+---------
+
+- 安装 Python 即可运行，支持 python3.8、Python3.9、python3.10、python3.11、python3.12。
+
+安装方法
+---------
+
+PIP安装
+--------
+
+.. code-block:: bash
+
+    $ pip install tablestore
+
+Github安装
+------------
+
+1. 下载源码
+
+
+.. code-block:: bash
+
+    $ git clone https://github.com/aliyun/aliyun-tablestore-python-sdk.git
+
+2. 安装
+
+.. code-block:: bash
+
+    $ python setup.py install
+
+
+源码安装
+--------
+
+1. 下载 SDK 发布包并解压
+2. 安装
+
+
+.. code-block:: bash
+
+    $ python setup.py install
+
+示例代码
+---------
+
+表（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>`_
+- `更新单行（更新某一行的部分字段） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/update_row.py>`_
+- `删除某行（从表内删除某一行数据） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/delete_row.py>`_
+- `批量写（向多张表，一次性写入多行数据） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/batch_write_row.py>`_
+- `批量读（从多张表，一次性读出多行数据） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/batch_get_row.py>`_
+- `范围扫描（给定一个范围，扫描出该范围内的所有数据） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/get_range.py>`_
+- `主键自增列（主键自动生成一个递增ID） <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/pk_auto_incr.py>`_
+- `全局二级索引 <https://github.com/aliyun/aliyun-tablestore-python-sdk/blob/master/examples/secondary_index_operations.py>`_
+- `局部事务（提交事务） <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>`_
+- `并发圈选数据 <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 中会有清理某个实例下所有表的动作，所以请使用专门的测试实例来测试。**
+
+1. 测试前准备
+
+.. code-block:: bash
+
+    $ /bin/bash tests_setup.sh
+
+2. 安装nosetests
+
+.. code-block:: bash
+
+    $ pip install nose
+
+3. 设置执行Case的配置
+
+.. code-block:: bash
+
+    $ 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=<tablestore instance name>
+
+4. 运行case
+
+python3.8、Python3.9、python3.10、python3.11可使用以下命令
+
+.. code-block:: bash
+
+    $ 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 官方网站 <http://www.aliyun.com/product/ots>`_
+- `阿里云官网联系方式 <https://help.aliyun.com/document_detail/61890.html>`_
+- `阿里云 Tablestore 官方文档 <https://help.aliyun.com/zh/tablestore/product-overview>`_
+
+