enh: move the taosws SQLAlchemy dialect into taos-ws-py (#387)

* feat: add AGENTS.md for project overview and setup instructions

* Refactor taos-ws-py integration and update SQLAlchemy dialect handling

- Removed TaosWsDialect from taos/sqlalchemy.py and moved it to taos-ws-py/taosws/sqlalchemy.py for better separation of concerns.
- Updated taos-ws-py/Cargo.toml to change the library name to _taosws for internal consistency.
- Adjusted import paths in examples and tests to reflect the new module structure.
- Added comprehensive tests for the taosws SQLAlchemy dialect to ensure compatibility and functionality.
- Updated AGENTS.md to clarify project structure and development setup for taos-ws-py.
- Removed deprecated taosws tests from the main test suite and integrated them into the new taos-ws-py test structure.

* chore: remove AGENTS.md as part of project restructuring

* refactor: clean up code formatting and remove unnecessary blank lines

* feat: update dependencies to include SQLAlchemy in workflow tests

* refactor: enhance native module loading and improve error handling in SQLAlchemy dialect

* fix: correct connection string formatting and enhance query parameter encoding in SQLAlchemy dialect tests

* Update dependency versions in pyproject.toml and clean up test script

- Adjusted requests and black dependencies to support specific Python versions.
- Updated pandas and sqlalchemy dependencies to ensure compatibility.
- Removed unnecessary newline in test_taospy.sh for cleaner script execution.

* fix: normalize handling of explicit empty passwords in connection args

* fix: correct SQL query formatting in get_indexes method

* feat: enhance SQLAlchemy dialect with improved SQL rendering and schema injection prevention

* fix: streamline classifiers in pyproject.toml by removing redundant entries

* fix: simplify native module loading logic in __init__.py

* refactor: simplify SQL execution and testing logic in sqlalchemy.py and test_sqlalchemy.py

* refactor: clean up comments and streamline code in sqlalchemy.py

* fix: update SQL query construction in BaseDialect to use f-strings for schema and table name

* refactor: remove unused tests and constants from test_sqlalchemy.py

* refactor: streamline test_sqlalchemy.py by removing unused code and enhancing test readability

* refactor: simplify assertions in test_decode_binary_in_tmq for clarity and correctness

* test: add test for legacy taosws submodule alias availability

* fix: update test_decode_binary_in_tmq to handle multiple values correctly

* refactor: remove unused import from sqlalchemy.py

* refactor: enhance test_read by parameterizing database name and improving resource management

* chore: update version to 0.6.7 and document enhancements in CHANGELOG

Author: qevolg

.github/workflows/taos-ws-py-compatibility.yml

@@ -111,5 +111,5 @@ jobs:
           WS_CLOUD_TOKEN: ${{ secrets.WS_CLOUD_TOKEN }}
           TEST_TD_3360: "true"
         run: |
-          pip3 install pytest toml
+          pip3 install pytest toml sqlalchemy
           pytest ./taos-ws-py/tests/

.github/workflows/taos-ws-py-enterprise.yml

@@ -117,5 +117,5 @@ jobs:
           WS_CLOUD_TOKEN: ${{ secrets.WS_CLOUD_TOKEN }}
           TEST_TD_ENTERPRISE: "true"
         run: |
-          pip3 install pytest toml
+          pip3 install pytest toml sqlalchemy
           pytest ./taos-ws-py/tests/

.github/workflows/taos-ws-py.yml

@@ -225,7 +225,7 @@ jobs:
           WS_CLOUD_TOKEN: ${{ secrets.WS_CLOUD_TOKEN }}
         run: |
           curl -L -u "$TDENGINE_TEST_USERNAME:$TDENGINE_TEST_PASSWORD" -d "show databases" localhost:6041/rest/sql
-          pip3 install pytest toml
+          pip3 install pytest toml sqlalchemy
           pip3 install ./
           pytest ./taos-ws-py/tests/
 

examples/pandas-read-sql.py

@@ -3,8 +3,8 @@
 
 protocol_and_port = {"taos": 6030, "taosrest": 6041, "taosws": 6041}
 
-for (protocol, port) in protocol_and_port.items():
-    engine = create_engine(f"{protocol}://root:taosdata@localhost")
+for protocol, port in protocol_and_port.items():
+    engine = create_engine(f"{protocol}://root:taosdata@localhost:{port}")
     conn = engine.connect()
     res = pandas.read_sql(text("show databases"), conn)
     conn.close()

poetry.lock

@@ -12,13 +12,15 @@ packages = [{ include = "taos" }, { include = "taosrest" }]
 [tool.poetry.plugins."sqlalchemy.dialects"]
 "taos" = "taos.sqlalchemy:TaosDialect"
 "taosrest" = "taosrest.sqlalchemy:TaosRestDialect"
-"taosws" = "taos.sqlalchemy:TaosWsDialect"
 
 [tool.poetry.dependencies]
 python = ">=3.7,<4.0"
 pytz = "*"
 iso8601 = "1.0.2"
-requests = ">=2.27.1"
+requests = [
+	{ version = ">=2.33.0", python = ">=3.10,<4.0" },
+	{ version = ">=2.27.1,<2.33.0", python = ">=3.7,<3.10" },
+]
 typing-extensions = ">=4.2.0,<4.15.0"
 
 [tool.poetry.dependencies.taos-ws-py]
@@ -36,7 +38,10 @@ typing = "*"
 pytest = [{ version = "^7.2.0", python = ">=3.7,<4.0" }]
 pytest-cov = "^4.0.0"
 mypy = { version = "^0.910", python = "^3.6" }
-black = [{ version = ">=21.0", python = ">=3.6.2,<4.0" }]
+black = [
+	{ version = ">=26.3.1", python = ">=3.10,<4.0" },
+	{ version = ">=21.0,<26.3.1", python = ">=3.6.2,<3.10" },
+]
 sqlalchemy = { version = "^2.0.0", python = ">=3.7,<4.0" }
 pandas = { version = ">=2.1.0", python = ">=3.9,<4.0" }
 python-dotenv = { version = "0.20.0" }
@@ -50,7 +55,10 @@ typing = "*"
 pytest = [{ version = "^7.2.0", python = ">=3.7,<4.0" }]
 pytest-cov = "^4.0.0"
 mypy = { version = "^0.910", python = "^3.6" }
-black = [{ version = ">=21.0", python = ">=3.6.2,<4.0" }]
+black = [
+	{ version = ">=26.3.1", python = ">=3.10,<4.0" },
+	{ version = ">=21.0,<26.3.1", python = ">=3.6.2,<3.10" },
+]
 sqlalchemy = { version = "^2.0.0", python = ">=3.7,<4.0" }
 pandas = { version = ">=2.1.0", python = ">=3.9,<4.0" }
 python-dotenv = { version = "0.20.0" }

pyproject.toml

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Conventional Changelog](https://www.conventionalcommits.org/en/v1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## v0.6.7 - 2026-03-31
+
+### Enhancements:
+
+- Move the `taosws` SQLAlchemy dialect into `taos-ws-py`, removing the need for a `taospy` dependency when using SQLAlchemy with `taosws`.
+
 ## v0.6.6 - 2026-03-05
 
 ### Features:

taos-ws-py/CHANGELOG.md

@@ -1,12 +1,12 @@
 [package]
 name = "taos-ws-py"
-version = "0.6.6"
+version = "0.6.7"
 edition = "2021"
 publish = false
 license = "MIT"
 
 [lib]
-name = "taosws"
+name = "_taosws"
 crate-type = ["cdylib"]
 
 [dependencies]

taos-ws-py/Cargo.lock

@@ -1,6 +1,6 @@
 #!
 import taosws
-from taosws.taosws import PySchemalessProtocol, PySchemalessPrecision
+from taosws import PySchemalessProtocol, PySchemalessPrecision
 
 import taos