feat: add Dameng database backend support

CHANGELOG.rst

@@ -10,6 +10,16 @@ Changelog
 0.25
 ====
 
+0.25.2
+------
+Added
+^^^^^
+- Add Dameng database backend support with `dm://` URL scheme
+- Add enterprise-grade connection pool for Dameng with health checks and connection reuse
+- Add complete type mapping between Tortoise ORM and Dameng database types
+- Add parameter conversion from `:1` format to `?` format for Dameng compatibility
+- Enhance Sanic contrib module with exception handlers and timezone support
+
 0.25.1
 ------------------
 Changed

Makefile

@@ -6,6 +6,7 @@ TORTOISE_MYSQL_PASS ?= 123456
 TORTOISE_POSTGRES_PASS ?= 123456
 TORTOISE_MSSQL_PASS ?= 123456
 TORTOISE_ORACLE_PASS ?= 123456
+TORTOISE_DAMENG_PASS ?= SYSDBA001
 
 help:
 	@echo  "Tortoise ORM development makefile"
@@ -24,10 +25,10 @@ up:
 	@poetry update
 
 deps:
-	@poetry install --all-groups -E asyncpg -E accel -E psycopg -E asyncodbc -E aiomysql
+	@poetry install --all-groups -E asyncpg -E accel -E psycopg -E asyncodbc -E aiomysql -E dameng
 
 deps_with_asyncmy:
-	@poetry install --all-groups -E asyncpg -E accel -E psycopg -E asyncodbc -E asyncmy
+	@poetry install --all-groups -E asyncpg -E accel -E psycopg -E asyncodbc -E asyncmy -E dameng
 
 check: build _check
 _check:
@@ -85,7 +86,10 @@ test_mssql:
 test_oracle:
 	$(py_warn) TORTOISE_TEST_DB="oracle://SYSTEM:$(TORTOISE_ORACLE_PASS)@127.0.0.1:1521/test_\{\}?driver=$(TORTOISE_ORACLE_DRIVER)" pytest $(pytest_opts) --cov-report=
 
-_testall: test_sqlite test_postgres_asyncpg test_postgres_psycopg test_mysql_myisam test_mysql test_mysql_asyncmy test_mssql
+test_dameng:
+	$(py_warn) TORTOISE_TEST_DB="dm://SYSDBA:$(TORTOISE_DAMENG_PASS)@127.0.0.1:5236/test_\{\}" pytest $(pytest_opts) --cov-report=
+
+_testall: test_sqlite test_postgres_asyncpg test_postgres_psycopg test_mysql_myisam test_mysql test_mysql_asyncmy test_mssql test_dameng
 
 	coverage report
 

README.rst

@@ -26,7 +26,7 @@ You can find the docs at `Documentation <https://tortoise.github.io>`_
    Tortoise ORM is a young project and breaking changes are to be expected.
    We keep a `Changelog <https://tortoise.github.io/CHANGELOG.html>`_ and it will have possible breakage clearly documented.
 
-Tortoise ORM supports CPython 3.9 and later for SQLite, MySQL, PostgreSQL, Microsoft SQL Server, and Oracle.
+Tortoise ORM supports CPython 3.9 and later for SQLite, MySQL, PostgreSQL, Microsoft SQL Server, Oracle, and Dameng.
 
 Why was Tortoise ORM built?
 ---------------------------
@@ -76,6 +76,8 @@ The following table shows the available installation options for different datab
      - ``pip install tortoise-orm[asyncodbc]``
    * - Oracle
      - ``pip install tortoise-orm[asyncodbc]``
+   * - Dameng
+     - ``pip install tortoise-orm[dameng]``
 
 
 Quick Tutorial

docs/CONTRIBUTING.rst

@@ -54,7 +54,7 @@ The code is structured in the following directories:
 ``tortoise/fields/``:
     The Fields are defined here.
 ``tortoise/backends/``:
-    DB Backends, such as ``sqlite``, ``asyncpg``, ``psycopg`` & ``mysql``
+    DB Backends, such as ``sqlite``, ``asyncpg``, ``psycopg``, ``mysql`` & ``dameng``
 ``tortoise/backends/base/``:
     Common DB Backend code
 ``tortoise/contrib/``:
@@ -113,7 +113,8 @@ Different types of tests
 - ``make test_postgres_psycopg``: Runs the psycopg tests on the postgres database
 - ``make test_mysql_myisam``: Runs the tests on the mysql database using the ``MYISAM`` storage engine (no transactions)
 - ``make test_mysql``: Runs the tests on the mysql database
-- ``make testall``: runs the tests on all 4 database types: sqlite (in memory), postgresql, MySQL-MyISAM and MySQL-InnoDB
+- ``make test_dameng``: Runs the tests on the dameng database
+- ``make testall``: runs the tests on all 5 database types: sqlite (in memory), postgresql, MySQL-MyISAM, MySQL-InnoDB and Dameng
 - ``green``: runs the same tests as ``make test``, ensures the green plugin works
 
 

docs/contrib.rst

@@ -14,4 +14,5 @@ Contrib
    contrib/aiohttp
    contrib/mysql
    contrib/postgres
+   contrib/dameng
    contrib/blacksheep