| Name | taos-ws-py JSON |
| Version |
0.6.0
JSON |
| download |
| home_page | None |
| Summary | None |
| upload_time | 2025-07-25 07:38:21 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | None |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<!-- omit in toc -->
# The official TDengine Python websocket connector
[](https://github.com/taosdata/taos-connector-python/actions/workflows/build.yml)
[](https://codecov.io/gh/taosdata/taos-connector-python)
[](https://pypi.org/project/taospy/)
<br />
[](https://twitter.com/tdenginedb)
[](https://www.youtube.com/@tdengine)
[](https://discord.com/invite/VZdSuUg4pS)
[](https://www.linkedin.com/company/tdengine)
[](https://stackoverflow.com/questions/tagged/tdengine)
<!-- omit in toc -->
## Table of Contents
- [1. Introduction](#1-introduction)
- [2. Documentation](#2-documentation)
- [3. Prerequisites](#3-prerequisites)
- [4. Build](#4-build)
- [5. Testing](#5-testing)
- [5.1 Test Execution](#51-test-execution)
- [5.2 Test Case Addition](#52-test-case-addition)
- [5.3 Performance Testing](#53-performance-testing)
- [6. CI/CD](#6-cicd)
- [7. Submitting Issues](#7-submitting-issues)
- [8. Submitting PRs](#8-submitting-prs)
- [9. References](#9-references)
- [10. License](#10-license)
## 1. Introduction
`taospy` is the official Python Connector for TDengine, allowing Python developers to develop applications that access the TDengine database. It supports functions such as data writing, querying, subscription, schemaless writing, and parameter binding.
The API for `taospy` is compliant with the Python DB API 2.0 (PEP-249). It contains two modules:
1. The `taos` module. It uses TDengine C client library for client server communications.
2. The `taosrest` module. It wraps TDengine RESTful API to Python DB API 2.0 (PEP-249). With this module, you do not need to install the TDengine C client library.
## 2. Documentation
- To use Python Connector, please check [Developer Guide](https://docs.tdengine.com/developer-guide/), which includes how an application can introduce the Python Connector , as well as examples of data writing, querying, schemaless writing, parameter binding, and data subscription.
- For other reference information, please check [Reference Manual](https://docs.taosdata.com/reference/connector/python/), which includes version history, data types, example programs, API descriptions, and FAQs.
- This quick guide is mainly for developers who like to contribute/build/test the Python Connector by themselves. To learn about TDengine, you can visit the [official documentation](https://docs.tdengine.com).
## 3. Prerequisites
- Python runtime environment (taospy: Python >= 3.6.2, taos-ws-py: Python >= 3.7)
- TDengine has been deployed locally. For specific steps, please refer to [Deploy TDengine](https://docs.tdengine.com/get-started/deploy-from-package/), and taosd and taosAdapter have been started.
## 4. Build
Download the repository code and execute the following in root directory to build develop environment:
``` bash
maturin build
```
## 5. Testing
### 5.1 Test Execution
The Python Connector testing framework is `pytest`.
The testing directory for `taos-ws-py` is located in the root directory: taos-ws-py/tests/ .
The test code has been written into one bash file. You can open and view the detailed testing process.
The following command runs all test cases on Linux platform:
``` bash
# for taos-ws-py
bash ./test_taos-ws-py.sh
```
### 5.2 Test Case Addition
You can add new test files or add test cases in existing test files that comply with `pytest` standards
### 5.3 Performance Testing
Performance testing is in progress.
## 6. CI/CD
- [Build Workflow](https://github.com/taosdata/taos-connector-python/actions/workflows/taos-ws-py.yml)
- [Code Coverage](https://app.codecov.io/gh/taosdata/taos-connector-python)
## 7. Submitting Issues
We welcome the submission of [GitHub Issue](https://github.com/taosdata/taos-connector-python/issues/new?template=Blank+issue). When submitting, please provide the following information:
- Problem description, whether it always occurs, and it's best to include a detailed call stack.
- Python Connector version.
- Python Connection parameters (username and password not required).
- TDengine server version.
## 8. Submitting PRs
We welcome developers to contribute to this project. When submitting PRs, please follow these steps:
1. Fork this project, refer to ([how to fork a repo](https://docs.github.com/en/get-started/quickstart/fork-a-repo)).
2. Create a new branch from the main branch with a meaningful branch name (`git checkout -b my_branch`). Do not modify the main branch directly.
3. Modify the code, ensure all unit tests pass, and add new unit tests to verify the changes.
4. Push the changes to the remote branch (`git push origin my_branch`).
5. Create a Pull Request on GitHub ([how to create a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)).
6. After submitting the PR, you can find your PR through the [Pull Request](https://github.com/taosdata/taos-connector-python/pulls). Click on the corresponding link to see if the CI for your PR has passed. If it has passed, it will display "All checks have passed". Regardless of whether the CI passes or not, you can click "Show all checks" -> "Details" to view the detailed test case logs.
7. After submitting the PR, if CI passes, you can find your PR on the [codecov](https://app.codecov.io/gh/taosdata/taos-connector-python/pulls) page to check the test coverage.
## 9. References
- [TDengine Official Website](https://www.tdengine.com/)
- [TDengine GitHub](https://github.com/taosdata/TDengine)
## 10. License
[MIT License](../LICENSE)
Raw data
{
"_id": null,
"home_page": null,
"name": "taos-ws-py",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": null,
"download_url": null,
"platform": null,
"description": "<!-- omit in toc -->\n# The official TDengine Python websocket connector\n\n[](https://github.com/taosdata/taos-connector-python/actions/workflows/build.yml)\n[](https://codecov.io/gh/taosdata/taos-connector-python)\n\n\n\n[](https://pypi.org/project/taospy/)\n<br />\n[](https://twitter.com/tdenginedb)\n[](https://www.youtube.com/@tdengine)\n[](https://discord.com/invite/VZdSuUg4pS)\n[](https://www.linkedin.com/company/tdengine)\n[](https://stackoverflow.com/questions/tagged/tdengine)\n\n<!-- omit in toc -->\n## Table of Contents\n\n- [1. Introduction](#1-introduction)\n- [2. Documentation](#2-documentation)\n- [3. Prerequisites](#3-prerequisites)\n- [4. Build](#4-build)\n- [5. Testing](#5-testing)\n - [5.1 Test Execution](#51-test-execution)\n - [5.2 Test Case Addition](#52-test-case-addition)\n - [5.3 Performance Testing](#53-performance-testing)\n- [6. CI/CD](#6-cicd)\n- [7. Submitting Issues](#7-submitting-issues)\n- [8. Submitting PRs](#8-submitting-prs)\n- [9. References](#9-references)\n- [10. License](#10-license)\n\n## 1. Introduction\n\n`taospy` is the official Python Connector for TDengine, allowing Python developers to develop applications that access the TDengine database. It supports functions such as data writing, querying, subscription, schemaless writing, and parameter binding.\n\nThe API for `taospy` is compliant with the Python DB API 2.0 (PEP-249). It contains two modules:\n\n1. The `taos` module. It uses TDengine C client library for client server communications.\n2. The `taosrest` module. It wraps TDengine RESTful API to Python DB API 2.0 (PEP-249). With this module, you do not need to install the TDengine C client library.\n\n## 2. Documentation\n\n- To use Python Connector, please check [Developer Guide](https://docs.tdengine.com/developer-guide/), which includes how an application can introduce the Python Connector , as well as examples of data writing, querying, schemaless writing, parameter binding, and data subscription.\n- For other reference information, please check [Reference Manual](https://docs.taosdata.com/reference/connector/python/), which includes version history, data types, example programs, API descriptions, and FAQs.\n- This quick guide is mainly for developers who like to contribute/build/test the Python Connector by themselves. To learn about TDengine, you can visit the [official documentation](https://docs.tdengine.com).\n\n## 3. Prerequisites\n\n- Python runtime environment (taospy: Python >= 3.6.2, taos-ws-py: Python >= 3.7)\n- TDengine has been deployed locally. For specific steps, please refer to [Deploy TDengine](https://docs.tdengine.com/get-started/deploy-from-package/), and taosd and taosAdapter have been started.\n\n## 4. Build\n\nDownload the repository code and execute the following in root directory to build develop environment:\n``` bash\nmaturin build\n```\n\n## 5. Testing\n### 5.1 Test Execution\n\nThe Python Connector testing framework is `pytest`.\n\nThe testing directory for `taos-ws-py` is located in the root directory: taos-ws-py/tests/ .\n\nThe test code has been written into one bash file. You can open and view the detailed testing process.\n\nThe following command runs all test cases on Linux platform:\n\n``` bash\n# for taos-ws-py\nbash ./test_taos-ws-py.sh\n```\n\n### 5.2 Test Case Addition\nYou can add new test files or add test cases in existing test files that comply with `pytest` standards\n\n### 5.3 Performance Testing\nPerformance testing is in progress.\n\n## 6. CI/CD\n- [Build Workflow](https://github.com/taosdata/taos-connector-python/actions/workflows/taos-ws-py.yml)\n- [Code Coverage](https://app.codecov.io/gh/taosdata/taos-connector-python)\n\n## 7. Submitting Issues\nWe welcome the submission of [GitHub Issue](https://github.com/taosdata/taos-connector-python/issues/new?template=Blank+issue). When submitting, please provide the following information:\n\n- Problem description, whether it always occurs, and it's best to include a detailed call stack.\n- Python Connector version.\n- Python Connection parameters (username and password not required).\n- TDengine server version.\n\n## 8. Submitting PRs\nWe welcome developers to contribute to this project. When submitting PRs, please follow these steps:\n\n1. Fork this project, refer to ([how to fork a repo](https://docs.github.com/en/get-started/quickstart/fork-a-repo)).\n2. Create a new branch from the main branch with a meaningful branch name (`git checkout -b my_branch`). Do not modify the main branch directly.\n3. Modify the code, ensure all unit tests pass, and add new unit tests to verify the changes.\n4. Push the changes to the remote branch (`git push origin my_branch`).\n5. Create a Pull Request on GitHub ([how to create a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)).\n6. After submitting the PR, you can find your PR through the [Pull Request](https://github.com/taosdata/taos-connector-python/pulls). Click on the corresponding link to see if the CI for your PR has passed. If it has passed, it will display \"All checks have passed\". Regardless of whether the CI passes or not, you can click \"Show all checks\" -> \"Details\" to view the detailed test case logs.\n7. After submitting the PR, if CI passes, you can find your PR on the [codecov](https://app.codecov.io/gh/taosdata/taos-connector-python/pulls) page to check the test coverage.\n\n## 9. References\n- [TDengine Official Website](https://www.tdengine.com/)\n- [TDengine GitHub](https://github.com/taosdata/TDengine)\n\n## 10. License\n[MIT License](../LICENSE)\n\n",
"bugtrack_url": null,
"license": null,
"summary": null,
"version": "0.6.0",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "04c4d285abb6d93688955edaed9f28d9c7ace10232196807c0df026291807cea",
"md5": "b14d71b714d363bcbb42adafc12f8b1f",
"sha256": "0873c92e58207c4dab1bbc23e9087321e926ec95543edfeb1b22ae05fe22b785"
},
"downloads": -1,
"filename": "taos_ws_py-0.6.0-cp37-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl",
"has_sig": false,
"md5_digest": "b14d71b714d363bcbb42adafc12f8b1f",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 7018400,
"upload_time": "2025-07-25T07:38:21",
"upload_time_iso_8601": "2025-07-25T07:38:21.026179Z",
"url": "https://files.pythonhosted.org/packages/04/c4/d285abb6d93688955edaed9f28d9c7ace10232196807c0df026291807cea/taos_ws_py-0.6.0-cp37-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "df515faee0e730333352a45b2c6cce722d10e40bb32c692b37bf2dafc6abfabb",
"md5": "111b62167b90726aa7eae12b48fc6e4f",
"sha256": "f094d7c88ec44624ee7bc9451ba52a286da04382c3251cc48144ae3c9cec9bf8"
},
"downloads": -1,
"filename": "taos_ws_py-0.6.0-cp37-abi3-macosx_10_12_x86_64.whl",
"has_sig": false,
"md5_digest": "111b62167b90726aa7eae12b48fc6e4f",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 3598526,
"upload_time": "2025-07-25T07:38:22",
"upload_time_iso_8601": "2025-07-25T07:38:22.667729Z",
"url": "https://files.pythonhosted.org/packages/df/51/5faee0e730333352a45b2c6cce722d10e40bb32c692b37bf2dafc6abfabb/taos_ws_py-0.6.0-cp37-abi3-macosx_10_12_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e9013c9c8efe252a54ad61e7087acf9dfacd0fb11a6acab60da1347c9b3dfd7d",
"md5": "912bfd917af9a60a7dd3958b12679e6e",
"sha256": "b91d087fb0068df0294f8f0303ab91efd3e8ed502206d4f9cd2ae0aaf1fb477e"
},
"downloads": -1,
"filename": "taos_ws_py-0.6.0-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
"has_sig": false,
"md5_digest": "912bfd917af9a60a7dd3958b12679e6e",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 3627148,
"upload_time": "2025-07-25T07:38:24",
"upload_time_iso_8601": "2025-07-25T07:38:24.113528Z",
"url": "https://files.pythonhosted.org/packages/e9/01/3c9c8efe252a54ad61e7087acf9dfacd0fb11a6acab60da1347c9b3dfd7d/taos_ws_py-0.6.0-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "00dcd81d75fdeb255e48d88df4d408a2eeffe87abb8dc1bd108f0abf0ad117dd",
"md5": "45b6f7409352e28795406194af48c658",
"sha256": "2b680098f180de49d8ae3b67ac8372afdeddce4319ffe58013b9ff433ac70e89"
},
"downloads": -1,
"filename": "taos_ws_py-0.6.0-cp37-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl",
"has_sig": false,
"md5_digest": "45b6f7409352e28795406194af48c658",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 3430051,
"upload_time": "2025-07-25T07:38:25",
"upload_time_iso_8601": "2025-07-25T07:38:25.563645Z",
"url": "https://files.pythonhosted.org/packages/00/dc/d81d75fdeb255e48d88df4d408a2eeffe87abb8dc1bd108f0abf0ad117dd/taos_ws_py-0.6.0-cp37-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "df8062935babb8d5aa618b98424fbaace7d1682f4b027b1c87c048575bdcdc24",
"md5": "1c578a32d70a0df6801bece4f4758567",
"sha256": "c34fe6a4ca500cc3051e85a6527651dc9e42c6bbd6be872a23dca40bf9bc9f4c"
},
"downloads": -1,
"filename": "taos_ws_py-0.6.0-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "1c578a32d70a0df6801bece4f4758567",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 3868996,
"upload_time": "2025-07-25T07:38:27",
"upload_time_iso_8601": "2025-07-25T07:38:27.184541Z",
"url": "https://files.pythonhosted.org/packages/df/80/62935babb8d5aa618b98424fbaace7d1682f4b027b1c87c048575bdcdc24/taos_ws_py-0.6.0-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "780dbb2b9b001066ee6d2e638a4536441929cc2d69503638b870c7aad9876885",
"md5": "1ee821c4c55367bc6b848a8afcaf1183",
"sha256": "a4f44321a86843e33c7749838064b04e8f370bdf3002d0cdfd10669ac3b83406"
},
"downloads": -1,
"filename": "taos_ws_py-0.6.0-cp37-abi3-win_amd64.whl",
"has_sig": false,
"md5_digest": "1ee821c4c55367bc6b848a8afcaf1183",
"packagetype": "bdist_wheel",
"python_version": "cp37",
"requires_python": null,
"size": 4180417,
"upload_time": "2025-07-25T07:38:28",
"upload_time_iso_8601": "2025-07-25T07:38:28.598575Z",
"url": "https://files.pythonhosted.org/packages/78/0d/bb2b9b001066ee6d2e638a4536441929cc2d69503638b870c7aad9876885/taos_ws_py-0.6.0-cp37-abi3-win_amd64.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-25 07:38:21",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "taos-ws-py"
}
