sqlalchemy-cubrid 1.2.3__tar.gz → 1.3.0__tar.gz

{sqlalchemy_cubrid-1.2.3/sqlalchemy_cubrid.egg-info → sqlalchemy_cubrid-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlalchemy-cubrid
-Version: 1.2.3
+Version: 1.3.0
 Summary: CUBRID dialect for SQLAlchemy
 Author-email: Yeongseon Choe <yeongseon.choe@gmail.com>, Gyeongjun Paik <paikend@gmail.com>
 License-Expression: MIT
@@ -10,7 +10,7 @@ Project-URL: Documentation, https://github.com/cubrid-labs/sqlalchemy-cubrid/tre
 Project-URL: Changelog, https://github.com/cubrid-labs/sqlalchemy-cubrid/blob/main/CHANGELOG.md
 Project-URL: Issues, https://github.com/cubrid-labs/sqlalchemy-cubrid/issues
 Keywords: SQLAlchemy,CUBRID,dialect
-Classifier: Development Status :: 5 - Production/Stable
+Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
@@ -50,7 +50,7 @@ Dynamic: license-file
 
 # sqlalchemy-cubrid
 
-**SQLAlchemy 2.0–2.1 dialect for the CUBRID database** — Python ORM, schema reflection, Alembic migrations, and full type system support.
+**SQLAlchemy 2.0–2.1 dialect for the CUBRID database** — Python ORM, schema reflection, Alembic migrations, and type mapping for SQLAlchemy and CUBRID-specific types.
 
 [🇰🇷 한국어](docs/README.ko.md) · [🇺🇸 English](README.md) · [🇨🇳 中文](docs/README.zh.md) · [🇮🇳 हिन्दी](docs/README.hi.md) · [🇩🇪 Deutsch](docs/README.de.md) · [🇷🇺 Русский](docs/README.ru.md)
 
@@ -66,6 +66,8 @@ Dynamic: license-file
 
 ---
 
+> **Status: Beta.** The core public API follows semantic versioning; minor releases may add features and bug fixes while the project remains under active development.
+
 ## Why sqlalchemy-cubrid?
 
 CUBRID is a high-performance open-source relational database, widely adopted in
@@ -75,7 +77,7 @@ production-ready SQLAlchemy dialect that supports the modern 2.0–2.1 API.
 **sqlalchemy-cubrid** bridges that gap:
 
 - Full SQLAlchemy 2.0–2.1 dialect with **statement caching** and **PEP 561 typing**
-- **426 offline tests** with **99%+ code coverage** — no database required to run them
+- **577 offline tests** with **99%+ code coverage** — no database required to run them
 - Tested against **4 CUBRID versions** (10.2, 11.0, 11.2, 11.4) across **Python 3.10 -- 3.14**
 - CUBRID-specific DML constructs: `ON DUPLICATE KEY UPDATE`, `MERGE`, `REPLACE INTO`
 - Alembic migration support out of the box
@@ -181,14 +183,23 @@ async with AsyncSession(engine) as session:
 
 ## Features
 
-- Complete type system -- numeric, string, date/time, bit, LOB, collection, and JSON types
+- Type mapping for SQLAlchemy standard and CUBRID-specific types — numeric, string, date/time, bit, LOB, collection, and JSON types
 - SQL compilation -- SELECT, JOIN, CAST, LIMIT/OFFSET, subqueries, CTEs, window functions
 - DML extensions -- `ON DUPLICATE KEY UPDATE`, `MERGE`, `REPLACE INTO`, `FOR UPDATE`, `TRUNCATE`
 - DDL support -- `COMMENT`, `IF NOT EXISTS` / `IF EXISTS`, `AUTO_INCREMENT`
 - Schema reflection -- tables, views, columns, PKs, FKs, indexes, unique constraints, comments
 - Alembic migrations via `CubridImpl` (auto-discovered entry point)
 - All 6 CUBRID isolation levels (dual-granularity: class-level + instance-level)
-- Async support — `create_async_engine("cubrid+aiopycubrid://...")` via pycubrid.aio
+- Async support (available since v1.1.0) — `create_async_engine("cubrid+aiopycubrid://...")` via pycubrid.aio
+
+## Known Limitations
+
+- **No `RETURNING`** — `INSERT/UPDATE/DELETE ... RETURNING` not supported; use `cursor.lastrowid` or `LAST_INSERT_ID()`
+- **No sequences** — CUBRID uses `AUTO_INCREMENT` only
+- **No multi-schema** — single schema per database
+- **DDL auto-commits** — migrations are not transactional (`transactional_ddl = False`)
+- **SQLAlchemy 2.0–2.1 only** — pinned to `<2.2` due to internal API dependencies ([details](docs/ARCHITECTURE.md))
+- **Async requires pycubrid ≥ 1.1.0** — the `cubrid+aiopycubrid://` driver needs the async-capable pycubrid
 
 ## Documentation
 
@@ -214,6 +225,8 @@ async with AsyncSession(engine) as session:
 | CUBRID | 10.2, 11.0, 11.2, 11.4 |
 | SQLAlchemy | 2.0–2.1 |
 | Alembic | >=1.7 |
+| pycubrid (sync) | >=1.2.0 |
+| pycubrid (async) | >=1.2.0 |
 
 ## FAQ
 

{sqlalchemy_cubrid-1.2.3 → sqlalchemy_cubrid-1.3.0}/README.md

@@ -1,6 +1,6 @@
 # sqlalchemy-cubrid
 
-**SQLAlchemy 2.0–2.1 dialect for the CUBRID database** — Python ORM, schema reflection, Alembic migrations, and full type system support.
+**SQLAlchemy 2.0–2.1 dialect for the CUBRID database** — Python ORM, schema reflection, Alembic migrations, and type mapping for SQLAlchemy and CUBRID-specific types.
 
 [🇰🇷 한국어](docs/README.ko.md) · [🇺🇸 English](README.md) · [🇨🇳 中文](docs/README.zh.md) · [🇮🇳 हिन्दी](docs/README.hi.md) · [🇩🇪 Deutsch](docs/README.de.md) · [🇷🇺 Русский](docs/README.ru.md)
 
@@ -16,6 +16,8 @@
 
 ---
 
+> **Status: Beta.** The core public API follows semantic versioning; minor releases may add features and bug fixes while the project remains under active development.
+
 ## Why sqlalchemy-cubrid?
 
 CUBRID is a high-performance open-source relational database, widely adopted in
@@ -25,7 +27,7 @@ production-ready SQLAlchemy dialect that supports the modern 2.0–2.1 API.
 **sqlalchemy-cubrid** bridges that gap:
 
 - Full SQLAlchemy 2.0–2.1 dialect with **statement caching** and **PEP 561 typing**
-- **426 offline tests** with **99%+ code coverage** — no database required to run them
+- **577 offline tests** with **99%+ code coverage** — no database required to run them
 - Tested against **4 CUBRID versions** (10.2, 11.0, 11.2, 11.4) across **Python 3.10 -- 3.14**
 - CUBRID-specific DML constructs: `ON DUPLICATE KEY UPDATE`, `MERGE`, `REPLACE INTO`
 - Alembic migration support out of the box
@@ -131,14 +133,23 @@ async with AsyncSession(engine) as session:
 
 ## Features
 
-- Complete type system -- numeric, string, date/time, bit, LOB, collection, and JSON types
+- Type mapping for SQLAlchemy standard and CUBRID-specific types — numeric, string, date/time, bit, LOB, collection, and JSON types
 - SQL compilation -- SELECT, JOIN, CAST, LIMIT/OFFSET, subqueries, CTEs, window functions
 - DML extensions -- `ON DUPLICATE KEY UPDATE`, `MERGE`, `REPLACE INTO`, `FOR UPDATE`, `TRUNCATE`
 - DDL support -- `COMMENT`, `IF NOT EXISTS` / `IF EXISTS`, `AUTO_INCREMENT`
 - Schema reflection -- tables, views, columns, PKs, FKs, indexes, unique constraints, comments
 - Alembic migrations via `CubridImpl` (auto-discovered entry point)
 - All 6 CUBRID isolation levels (dual-granularity: class-level + instance-level)
-- Async support — `create_async_engine("cubrid+aiopycubrid://...")` via pycubrid.aio
+- Async support (available since v1.1.0) — `create_async_engine("cubrid+aiopycubrid://...")` via pycubrid.aio
+
+## Known Limitations
+
+- **No `RETURNING`** — `INSERT/UPDATE/DELETE ... RETURNING` not supported; use `cursor.lastrowid` or `LAST_INSERT_ID()`
+- **No sequences** — CUBRID uses `AUTO_INCREMENT` only
+- **No multi-schema** — single schema per database
+- **DDL auto-commits** — migrations are not transactional (`transactional_ddl = False`)
+- **SQLAlchemy 2.0–2.1 only** — pinned to `<2.2` due to internal API dependencies ([details](docs/ARCHITECTURE.md))
+- **Async requires pycubrid ≥ 1.1.0** — the `cubrid+aiopycubrid://` driver needs the async-capable pycubrid
 
 ## Documentation
 
@@ -164,6 +175,8 @@ async with AsyncSession(engine) as session:
 | CUBRID | 10.2, 11.0, 11.2, 11.4 |
 | SQLAlchemy | 2.0–2.1 |
 | Alembic | >=1.7 |
+| pycubrid (sync) | >=1.2.0 |
+| pycubrid (async) | >=1.2.0 |
 
 ## FAQ
 

{sqlalchemy_cubrid-1.2.3 → sqlalchemy_cubrid-1.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sqlalchemy-cubrid"
-version = "1.2.3"
+version = "1.3.0"
 description = "CUBRID dialect for SQLAlchemy"
 readme = "README.md"
 license = "MIT"
@@ -15,7 +15,7 @@ authors = [
 ]
 keywords = ["SQLAlchemy", "CUBRID", "dialect"]
 classifiers = [
-    "Development Status :: 5 - Production/Stable",
+    "Development Status :: 4 - Beta",
     "Environment :: Console",
     "Intended Audience :: Developers",
     "Operating System :: OS Independent",

{sqlalchemy_cubrid-1.2.3 → sqlalchemy_cubrid-1.3.0}/sqlalchemy_cubrid/__init__.py

@@ -52,7 +52,7 @@ from sqlalchemy.sql.sqltypes import (
     TIMESTAMP,
 )
 
-__version__ = "1.2.3"
+__version__ = "1.3.0"
 
 __all__ = (
     "insert",

{sqlalchemy_cubrid-1.2.3 → sqlalchemy_cubrid-1.3.0}/sqlalchemy_cubrid/alembic_impl.py

@@ -158,6 +158,40 @@ class CubridImpl(DefaultImpl):
 
         return set(inspector_values) != set(metadata_values)
 
+    def alter_column(
+        self,
+        table_name: str,
+        column_name: str,
+        nullable: Any = None,
+        server_default: Any = False,
+        name: str | None = None,
+        type_: Any = None,
+        **kw: Any,
+    ) -> None:
+        if type_ is not None:
+            raise NotImplementedError(
+                f"CUBRID does not support ALTER COLUMN TYPE for column "
+                f"'{column_name}' on table '{table_name}'. "
+                f"Use batch_alter_table() as a workaround: "
+                f"https://alembic.sqlalchemy.org/en/latest/batch.html"
+            )
+        if name is not None:
+            raise NotImplementedError(
+                f"CUBRID does not support RENAME COLUMN for column "
+                f"'{column_name}' on table '{table_name}'. "
+                f"Use batch_alter_table() as a workaround: "
+                f"https://alembic.sqlalchemy.org/en/latest/batch.html"
+            )
+        super().alter_column(
+            table_name,
+            column_name,
+            nullable=nullable,
+            server_default=server_default,
+            name=name,
+            type_=type_,
+            **kw,
+        )
+
     @classmethod
     def _is_unbounded_string_match(
         cls, inspector_type: TypeEngine[Any], metadata_type: TypeEngine[Any]

{sqlalchemy_cubrid-1.2.3 → sqlalchemy_cubrid-1.3.0}/sqlalchemy_cubrid/base.py

@@ -9,13 +9,14 @@
 
 from __future__ import annotations
 
+import logging
 import re
 from typing import Any, cast
 
 from sqlalchemy.engine import default
 from sqlalchemy.sql import compiler
 
-
+log = logging.getLogger(__name__)
 AUTOCOMMIT_REGEXP = re.compile(
     r"\s*(?:UPDATE|INSERT|CREATE|DELETE|DROP|ALTER|MERGE|TRUNCATE)", re.I | re.UNICODE
 )
@@ -416,7 +417,7 @@ class CubridExecutionContext(default.DefaultExecutionContext):
                 last_id = raw_conn.get_last_insert_id()
                 return cast(int, None) if last_id is None else int(last_id)  # pyright: ignore[reportInvalidCast]
         except Exception:  # nosec B110 — fallback to SQL when driver lacks method
-            pass
+            log.debug("get_last_insert_id via driver failed, falling back to SQL", exc_info=True)
 
         # Fallback: use SQL function
         cursor = self.create_server_side_cursor()

{sqlalchemy_cubrid-1.2.3 → sqlalchemy_cubrid-1.3.0}/sqlalchemy_cubrid/compiler.py

@@ -11,6 +11,7 @@ from __future__ import annotations
 
 from typing import Any
 
+from sqlalchemy.exc import CompileError
 from sqlalchemy.sql import compiler, elements
 from sqlalchemy.sql import sqltypes
 
@@ -56,6 +57,8 @@ class CubridCompiler(compiler.SQLCompiler):
         **kwargs: Any,
     ) -> str:
         # https://www.cubrid.org/manual/en/11.0/sql/query/select.html#join-query
+        if getattr(join, "full", False):
+            raise CompileError("CUBRID does not support FULL OUTER JOIN")
         return "".join(
             (
                 self.process(join.left, asfrom=True, **kwargs),
@@ -66,6 +69,9 @@ class CubridCompiler(compiler.SQLCompiler):
             )
         )
 
+    def visit_lateral(self, lateral_: Any, **kw: Any) -> str:
+        raise CompileError("CUBRID does not support LATERAL")
+
     def for_update_clause(self, select: Any, **kw: Any) -> str:  # pyright: ignore[reportIncompatibleMethodOverride]
         """Render FOR UPDATE clause.
 

{sqlalchemy_cubrid-1.2.3 → sqlalchemy_cubrid-1.3.0}/sqlalchemy_cubrid/dialect.py

@@ -88,7 +88,9 @@ _RE_PRECISION_SCALE = re.compile(r"\((\d+)(?:,\s*(\d+))?\)")
 _RE_FOREIGN_KEY = re.compile(
     r"CONSTRAINT\s+\[(?P<name>[^\]]+)\]\s+FOREIGN\s+KEY\s*"
     r"\((?P<cols>[^)]+)\)\s+REFERENCES\s+"
-    r"\[(?P<ref_table>[^\]]+)\]\s*\((?P<ref_cols>[^)]+)\)",
+    r"\[(?P<ref_table>[^\]]+)\]\s*\((?P<ref_cols>[^)]+)\)"
+    r"(?:\s+ON\s+DELETE\s+(?P<ondelete>CASCADE|SET\s+NULL|NO\s+ACTION|RESTRICT))?"
+    r"(?:\s+ON\s+UPDATE\s+(?P<onupdate>CASCADE|SET\s+NULL|NO\s+ACTION|RESTRICT))?",
     re.IGNORECASE,
 )
 # Parses ``CONSTRAINT [name] UNIQUE KEY ([col1], [col2])`` from
@@ -195,6 +197,7 @@ class CubridDialect(default.DefaultDialect):
     supports_native_enum = False
     supports_native_boolean = False  # CUBRID uses SMALLINT for booleans
     supports_native_decimal = True
+    supports_native_lateral = False
 
     # Column options
     supports_sequences = False
@@ -341,6 +344,7 @@ class CubridDialect(default.DefaultDialect):
             )
             comment_map = {row[0]: row[1] for row in comment_result}
         except Exception:
+            log.debug("Column comment query failed for %s", table_name, exc_info=True)
             comment_map = {}
 
         for column in columns:
@@ -380,7 +384,7 @@ class CubridDialect(default.DefaultDialect):
                 if row:
                     constraint_name = row[0]
             except Exception:  # nosec B110 — constraint name is optional metadata
-                pass
+                log.debug("PK constraint name query failed for %s", table_name, exc_info=True)
 
         return {
             "name": constraint_name,
@@ -409,6 +413,11 @@ class CubridDialect(default.DefaultDialect):
             result = connection.execute(text(f"SHOW CREATE TABLE {quoted}"))
             row = result.fetchone()
         except Exception:  # nosec B110 — graceful fallback when DDL unavailable
+            log.warning(
+                "SHOW CREATE TABLE failed for %s; foreign keys will be empty",
+                table_name,
+                exc_info=True,
+            )
             return foreign_keys
         if row is None:
             return foreign_keys
@@ -425,10 +434,16 @@ class CubridDialect(default.DefaultDialect):
             referred_columns = [
                 col.strip() for col in _RE_BRACKET_IDENT.findall(fk_match.group("ref_cols"))
             ]
+            options: dict[str, str] = {}
+            if fk_match.group("ondelete"):
+                options["ondelete"] = fk_match.group("ondelete").upper()
+            if fk_match.group("onupdate"):
+                options["onupdate"] = fk_match.group("onupdate").upper()
             foreign_keys.append(
                 {
                     "name": constraint_name,
                     "constrained_columns": constrained_columns,
+                    "options": options,
                     "referred_schema": schema,
                     "referred_table": ref_table,
                     "referred_columns": referred_columns,
@@ -553,6 +568,11 @@ class CubridDialect(default.DefaultDialect):
             result = connection.execute(text(f"SHOW CREATE TABLE {quoted}"))
             row = result.fetchone()
         except Exception:  # nosec B110 — graceful fallback when DDL unavailable
+            log.warning(
+                "SHOW CREATE TABLE failed for %s; unique constraints will be empty",
+                table_name,
+                exc_info=True,
+            )
             return unique_constraints
         if row is None:
             return unique_constraints
@@ -574,7 +594,9 @@ class CubridDialect(default.DefaultDialect):
         **kw: Any,
     ) -> list[ReflectedCheckConstraint]:
         """Return check constraints for *table_name*."""
-        # CUBRID does not expose check constraint expressions easily
+        # CUBRID parses CHECK constraint syntax but does not enforce them
+        # at runtime (official CUBRID behavior). Reflecting them would be
+        # misleading, so we return an empty list.
         return []
 
     @reflection.cache
@@ -624,14 +646,18 @@ class CubridDialect(default.DefaultDialect):
         schema: str | None = None,
         **kw: Any,
     ) -> bool:
-        """Check if an index exists on *table_name*."""
+        """Check if an index named *index_name* exists on *table_name*."""
         try:
             result = connection.execute(
-                text("SELECT COUNT(*) FROM _db_index WHERE index_name = :name"),
-                {"name": index_name},
+                text(
+                    "SELECT COUNT(*) FROM _db_index "
+                    "WHERE class_of.class_name = :table AND index_name = :name"
+                ),
+                {"table": table_name, "name": index_name},
             )
             return bool(result.scalar())
         except Exception:
+            log.debug("has_index query failed for %s.%s", table_name, index_name, exc_info=True)
             return False
 
     def has_sequence(
@@ -708,7 +734,7 @@ class CubridDialect(default.DefaultDialect):
         cursor.execute("SELECT X")
         row = cursor.fetchone()
         if row is None:
-            return "READ COMMITTED"
+            return "REPEATABLE READ SCHEMA, READ COMMITTED INSTANCES"
         val = row[0]
         cursor.close()
         # CUBRID returns numeric level; map to string for SA
@@ -755,10 +781,8 @@ class CubridDialect(default.DefaultDialect):
         cursor.close()
 
     def reset_isolation_level(self, dbapi_conn: DBAPIConnection) -> None:
-        """Revert isolation level to the default."""
-        # CUBRID server default is typically level 4
-        # (REPEATABLE READ SCHEMA, READ COMMITTED INSTANCES)
-        self.set_isolation_level(dbapi_conn, "READ COMMITTED")
+        """Revert isolation level to the CUBRID default (level 4)."""
+        self.set_isolation_level(dbapi_conn, "REPEATABLE READ SCHEMA, READ COMMITTED INSTANCES")
 
     def do_release_savepoint(self, connection: Any, name: str) -> None:
         """CUBRID does not support RELEASE SAVEPOINT; no-op."""

{sqlalchemy_cubrid-1.2.3 → sqlalchemy_cubrid-1.3.0/sqlalchemy_cubrid.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlalchemy-cubrid
-Version: 1.2.3
+Version: 1.3.0
 Summary: CUBRID dialect for SQLAlchemy
 Author-email: Yeongseon Choe <yeongseon.choe@gmail.com>, Gyeongjun Paik <paikend@gmail.com>
 License-Expression: MIT
@@ -10,7 +10,7 @@ Project-URL: Documentation, https://github.com/cubrid-labs/sqlalchemy-cubrid/tre
 Project-URL: Changelog, https://github.com/cubrid-labs/sqlalchemy-cubrid/blob/main/CHANGELOG.md
 Project-URL: Issues, https://github.com/cubrid-labs/sqlalchemy-cubrid/issues
 Keywords: SQLAlchemy,CUBRID,dialect
-Classifier: Development Status :: 5 - Production/Stable
+Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
@@ -50,7 +50,7 @@ Dynamic: license-file
 
 # sqlalchemy-cubrid
 
-**SQLAlchemy 2.0–2.1 dialect for the CUBRID database** — Python ORM, schema reflection, Alembic migrations, and full type system support.
+**SQLAlchemy 2.0–2.1 dialect for the CUBRID database** — Python ORM, schema reflection, Alembic migrations, and type mapping for SQLAlchemy and CUBRID-specific types.
 
 [🇰🇷 한국어](docs/README.ko.md) · [🇺🇸 English](README.md) · [🇨🇳 中文](docs/README.zh.md) · [🇮🇳 हिन्दी](docs/README.hi.md) · [🇩🇪 Deutsch](docs/README.de.md) · [🇷🇺 Русский](docs/README.ru.md)
 
@@ -66,6 +66,8 @@ Dynamic: license-file
 
 ---
 
+> **Status: Beta.** The core public API follows semantic versioning; minor releases may add features and bug fixes while the project remains under active development.
+
 ## Why sqlalchemy-cubrid?
 
 CUBRID is a high-performance open-source relational database, widely adopted in
@@ -75,7 +77,7 @@ production-ready SQLAlchemy dialect that supports the modern 2.0–2.1 API.
 **sqlalchemy-cubrid** bridges that gap:
 
 - Full SQLAlchemy 2.0–2.1 dialect with **statement caching** and **PEP 561 typing**
-- **426 offline tests** with **99%+ code coverage** — no database required to run them
+- **577 offline tests** with **99%+ code coverage** — no database required to run them
 - Tested against **4 CUBRID versions** (10.2, 11.0, 11.2, 11.4) across **Python 3.10 -- 3.14**
 - CUBRID-specific DML constructs: `ON DUPLICATE KEY UPDATE`, `MERGE`, `REPLACE INTO`
 - Alembic migration support out of the box
@@ -181,14 +183,23 @@ async with AsyncSession(engine) as session:
 
 ## Features
 
-- Complete type system -- numeric, string, date/time, bit, LOB, collection, and JSON types
+- Type mapping for SQLAlchemy standard and CUBRID-specific types — numeric, string, date/time, bit, LOB, collection, and JSON types
 - SQL compilation -- SELECT, JOIN, CAST, LIMIT/OFFSET, subqueries, CTEs, window functions
 - DML extensions -- `ON DUPLICATE KEY UPDATE`, `MERGE`, `REPLACE INTO`, `FOR UPDATE`, `TRUNCATE`
 - DDL support -- `COMMENT`, `IF NOT EXISTS` / `IF EXISTS`, `AUTO_INCREMENT`
 - Schema reflection -- tables, views, columns, PKs, FKs, indexes, unique constraints, comments
 - Alembic migrations via `CubridImpl` (auto-discovered entry point)
 - All 6 CUBRID isolation levels (dual-granularity: class-level + instance-level)
-- Async support — `create_async_engine("cubrid+aiopycubrid://...")` via pycubrid.aio
+- Async support (available since v1.1.0) — `create_async_engine("cubrid+aiopycubrid://...")` via pycubrid.aio
+
+## Known Limitations
+
+- **No `RETURNING`** — `INSERT/UPDATE/DELETE ... RETURNING` not supported; use `cursor.lastrowid` or `LAST_INSERT_ID()`
+- **No sequences** — CUBRID uses `AUTO_INCREMENT` only
+- **No multi-schema** — single schema per database
+- **DDL auto-commits** — migrations are not transactional (`transactional_ddl = False`)
+- **SQLAlchemy 2.0–2.1 only** — pinned to `<2.2` due to internal API dependencies ([details](docs/ARCHITECTURE.md))
+- **Async requires pycubrid ≥ 1.1.0** — the `cubrid+aiopycubrid://` driver needs the async-capable pycubrid
 
 ## Documentation
 
@@ -214,6 +225,8 @@ async with AsyncSession(engine) as session:
 | CUBRID | 10.2, 11.0, 11.2, 11.4 |
 | SQLAlchemy | 2.0–2.1 |
 | Alembic | >=1.7 |
+| pycubrid (sync) | >=1.2.0 |
+| pycubrid (async) | >=1.2.0 |
 
 ## FAQ
 

{sqlalchemy_cubrid-1.2.3 → sqlalchemy_cubrid-1.3.0}/sqlalchemy_cubrid.egg-info/SOURCES.txt

@@ -29,8 +29,10 @@ test/test_dialect_offline.py
 test/test_dialects.py
 test/test_integration.py
 test/test_json.py
+test/test_packaging.py
 test/test_pycubrid_dialect.py
 test/test_requirements.py
+test/test_show_create_table.py
 test/test_suite.py
 test/test_trace.py
 test/test_types.py