sqlalchemy-cubrid 1.0.0__tar.gz → 1.2.0__tar.gz

{sqlalchemy_cubrid-1.0.0/sqlalchemy_cubrid.egg-info → sqlalchemy_cubrid-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlalchemy-cubrid
-Version: 1.0.0
+Version: 1.2.0
 Summary: CUBRID dialect for SQLAlchemy
 Author-email: Yeongseon Choe <yeongseon.choe@gmail.com>, Gyeongjun Paik <paikend@gmail.com>
 License-Expression: MIT
@@ -78,7 +78,7 @@ production-ready SQLAlchemy dialect that supports the modern 2.0–2.1 API.
 - 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
-- **Two driver options** — C-extension (`cubrid://`) or pure Python (`cubrid+pycubrid://`)
+- **Three driver options** — C-extension (`cubrid://`), pure Python (`cubrid+pycubrid://`), or async pure Python (`cubrid+aiopycubrid://`)
 
 ## Architecture
 
@@ -88,8 +88,10 @@ flowchart TD
     sa --> dialect["CubridDialect"]
     dialect --> pycubrid["pycubrid driver"]
     dialect --> cext["CUBRIDdb driver"]
+    dialect --> aio["pycubrid.aio async driver"]
     pycubrid --> server["CUBRID Server"]
     cext --> server
+    aio --> server
 ```
 
 ```mermaid
@@ -163,15 +165,29 @@ with Session(engine) as session:
     session.commit()
 ```
 
+### Async
+
+```python
+from sqlalchemy.ext.asyncio import create_async_engine, AsyncSession
+from sqlalchemy import text
+
+engine = create_async_engine("cubrid+aiopycubrid://dba:password@localhost:33000/demodb")
+
+async with AsyncSession(engine) as session:
+    result = await session.execute(text("SELECT 1"))
+    print(result.scalar())
+```
+
 ## Features
 
-- Complete type system -- numeric, string, date/time, bit, LOB, and collection types
+- Complete type system -- 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
 
 ## Documentation
 
@@ -187,6 +203,7 @@ with Session(engine) as session:
 | [Development](docs/DEVELOPMENT.md) | Dev setup, testing, Docker, coverage, CI/CD |
 | [Driver Compatibility](docs/DRIVER_COMPAT.md) | CUBRID-Python driver versions and known issues |
 | [Troubleshooting](docs/TROUBLESHOOTING.md) | Common issues, error solutions, debugging techniques |
+| [Async Connection](docs/CONNECTION.md#async-connection) | Async engine setup with `cubrid+aiopycubrid://` |
 
 ## Compatibility Matrix
 
@@ -233,13 +250,17 @@ stmt = insert(users).values(name="Alice").on_duplicate_key_update(name="Alice Up
 
 ### What's the difference between `cubrid://` and `cubrid+pycubrid://`?
 
-`cubrid://` uses the C-extension driver (CUBRIDdb) which requires compilation. `cubrid+pycubrid://` uses the pure Python driver which installs with pip alone — no build tools needed.
+`cubrid://` uses the C-extension driver (CUBRIDdb) which requires compilation. `cubrid+pycubrid://` uses the pure Python driver which installs with pip alone — no build tools needed. `cubrid+aiopycubrid://` uses the async variant of the pure Python driver for use with `create_async_engine` and `AsyncSession`.
+
+### Does sqlalchemy-cubrid support async?
+
+Yes. Use `create_async_engine("cubrid+aiopycubrid://...")` with the pycubrid async driver. Requires `pycubrid>=1.1.0`. All Core and ORM features work with `AsyncSession`.
 
 
 ## Related Projects
 
 - [pycubrid](https://github.com/cubrid-labs/pycubrid) — Pure Python DB-API 2.0 driver for CUBRID
-- [cubrid-python-cookbook](https://github.com/cubrid-labs/cubrid-python-cookbook) — Production-ready Python examples for CUBRID
+- [cubrid-cookbook-python](https://github.com/cubrid-labs/cubrid-cookbook-python) — Production-ready Python examples for CUBRID
 
 ## Roadmap
 

{sqlalchemy_cubrid-1.0.0 → sqlalchemy_cubrid-1.2.0}/README.md

@@ -29,7 +29,7 @@ production-ready SQLAlchemy dialect that supports the modern 2.0–2.1 API.
 - 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
-- **Two driver options** — C-extension (`cubrid://`) or pure Python (`cubrid+pycubrid://`)
+- **Three driver options** — C-extension (`cubrid://`), pure Python (`cubrid+pycubrid://`), or async pure Python (`cubrid+aiopycubrid://`)
 
 ## Architecture
 
@@ -39,8 +39,10 @@ flowchart TD
     sa --> dialect["CubridDialect"]
     dialect --> pycubrid["pycubrid driver"]
     dialect --> cext["CUBRIDdb driver"]
+    dialect --> aio["pycubrid.aio async driver"]
     pycubrid --> server["CUBRID Server"]
     cext --> server
+    aio --> server
 ```
 
 ```mermaid
@@ -114,15 +116,29 @@ with Session(engine) as session:
     session.commit()
 ```
 
+### Async
+
+```python
+from sqlalchemy.ext.asyncio import create_async_engine, AsyncSession
+from sqlalchemy import text
+
+engine = create_async_engine("cubrid+aiopycubrid://dba:password@localhost:33000/demodb")
+
+async with AsyncSession(engine) as session:
+    result = await session.execute(text("SELECT 1"))
+    print(result.scalar())
+```
+
 ## Features
 
-- Complete type system -- numeric, string, date/time, bit, LOB, and collection types
+- Complete type system -- 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
 
 ## Documentation
 
@@ -138,6 +154,7 @@ with Session(engine) as session:
 | [Development](docs/DEVELOPMENT.md) | Dev setup, testing, Docker, coverage, CI/CD |
 | [Driver Compatibility](docs/DRIVER_COMPAT.md) | CUBRID-Python driver versions and known issues |
 | [Troubleshooting](docs/TROUBLESHOOTING.md) | Common issues, error solutions, debugging techniques |
+| [Async Connection](docs/CONNECTION.md#async-connection) | Async engine setup with `cubrid+aiopycubrid://` |
 
 ## Compatibility Matrix
 
@@ -184,13 +201,17 @@ stmt = insert(users).values(name="Alice").on_duplicate_key_update(name="Alice Up
 
 ### What's the difference between `cubrid://` and `cubrid+pycubrid://`?
 
-`cubrid://` uses the C-extension driver (CUBRIDdb) which requires compilation. `cubrid+pycubrid://` uses the pure Python driver which installs with pip alone — no build tools needed.
+`cubrid://` uses the C-extension driver (CUBRIDdb) which requires compilation. `cubrid+pycubrid://` uses the pure Python driver which installs with pip alone — no build tools needed. `cubrid+aiopycubrid://` uses the async variant of the pure Python driver for use with `create_async_engine` and `AsyncSession`.
+
+### Does sqlalchemy-cubrid support async?
+
+Yes. Use `create_async_engine("cubrid+aiopycubrid://...")` with the pycubrid async driver. Requires `pycubrid>=1.1.0`. All Core and ORM features work with `AsyncSession`.
 
 
 ## Related Projects
 
 - [pycubrid](https://github.com/cubrid-labs/pycubrid) — Pure Python DB-API 2.0 driver for CUBRID
-- [cubrid-python-cookbook](https://github.com/cubrid-labs/cubrid-python-cookbook) — Production-ready Python examples for CUBRID
+- [cubrid-cookbook-python](https://github.com/cubrid-labs/cubrid-cookbook-python) — Production-ready Python examples for CUBRID
 
 ## Roadmap
 

{sqlalchemy_cubrid-1.0.0 → sqlalchemy_cubrid-1.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sqlalchemy-cubrid"
-version = "1.0.0"
+version = "1.2.0"
 description = "CUBRID dialect for SQLAlchemy"
 readme = "README.md"
 license = "MIT"
@@ -67,6 +67,7 @@ Issues = "https://github.com/cubrid-labs/sqlalchemy-cubrid/issues"
 cubrid = "sqlalchemy_cubrid.dialect:CubridDialect"
 "cubrid.cubrid" = "sqlalchemy_cubrid.dialect:CubridDialect"
 "cubrid.pycubrid" = "sqlalchemy_cubrid.pycubrid_dialect:PyCubridDialect"
+"cubrid.aiopycubrid" = "sqlalchemy_cubrid.aio_pycubrid_dialect:PyCubridAsyncDialect"
 
 [project.entry-points."alembic.ddl"]
 cubrid = "sqlalchemy_cubrid.alembic_impl:CubridImpl"

{sqlalchemy_cubrid-1.0.0 → sqlalchemy_cubrid-1.2.0}/sqlalchemy_cubrid/__init__.py

@@ -25,6 +25,9 @@ from .types import (
     DOUBLE,
     DOUBLE_PRECISION,
     FLOAT,
+    JSON,
+    JSONIndexType,
+    JSONPathType,
     MONETARY,
     MULTISET,
     NCHAR,
@@ -49,7 +52,7 @@ from sqlalchemy.sql.sqltypes import (
     TIMESTAMP,
 )
 
-__version__ = "1.0.0"
+__version__ = "1.2.0"
 
 __all__ = (
     "insert",
@@ -82,4 +85,7 @@ __all__ = (
     "MULTISET",
     "SEQUENCE",
     "OBJECT",
+    "JSON",
+    "JSONIndexType",
+    "JSONPathType",
 )

sqlalchemy_cubrid-1.2.0/sqlalchemy_cubrid/aio_pycubrid_dialect.py

@@ -0,0 +1,125 @@
+# sqlalchemy_cubrid/aio_pycubrid_dialect.py
+# Copyright (C) 2021-2026 by sqlalchemy-cubrid authors and contributors
+# <see AUTHORS file>
+#
+# This module is part of sqlalchemy-cubrid and is released under
+# the MIT License: http://www.opensource.org/licenses/mit-license.php
+
+from __future__ import annotations
+
+from typing import Any, Callable, cast
+
+from sqlalchemy.connectors.asyncio import (
+    AsyncAdapt_dbapi_connection,
+    AsyncAdapt_dbapi_cursor,
+    AsyncAdapt_dbapi_module,
+)
+from sqlalchemy.engine.interfaces import ConnectArgsType, DBAPIModule
+from sqlalchemy.engine.url import URL
+from sqlalchemy.util.concurrency import await_only
+
+from sqlalchemy_cubrid.pycubrid_dialect import PyCubridDialect, PyCubridExecutionContext
+
+
+class AsyncAdapt_pycubrid_cursor(AsyncAdapt_dbapi_cursor):
+    _awaitable_cursor_close: bool = True
+
+    def setinputsizes(self, *inputsizes: Any) -> None:
+        pass
+
+    def nextset(self) -> None:
+        pass
+
+
+class AsyncAdapt_pycubrid_connection(AsyncAdapt_dbapi_connection):
+    _cursor_cls = AsyncAdapt_pycubrid_cursor
+
+    @property
+    def autocommit(self) -> bool:
+        return self._connection.autocommit  # type: ignore[union-attr]
+
+    @autocommit.setter
+    def autocommit(self, value: bool) -> None:
+        self.await_(self._connection.set_autocommit(value))  # type: ignore[union-attr]
+
+
+class AsyncAdapt_pycubrid_dbapi(AsyncAdapt_dbapi_module):
+    def __init__(self, aio_module: Any) -> None:
+        self._aio_module = aio_module
+
+        import pycubrid as sync_module
+
+        self.paramstyle = sync_module.paramstyle
+        self.Error = sync_module.Error
+        self.OperationalError = sync_module.OperationalError
+        self.InterfaceError = sync_module.InterfaceError
+        self.IntegrityError = sync_module.IntegrityError
+        self.ProgrammingError = sync_module.ProgrammingError
+        self.DatabaseError = sync_module.DatabaseError
+        self.InternalError = sync_module.InternalError
+        self.DataError = sync_module.DataError
+        self.NotSupportedError = sync_module.NotSupportedError
+        self.Warning = sync_module.Warning
+
+        self.STRING = sync_module.STRING
+        self.BINARY = sync_module.BINARY
+        self.NUMBER = sync_module.NUMBER
+        self.DATETIME = sync_module.DATETIME
+        self.ROWID = sync_module.ROWID
+
+    def connect(self, *arg: Any, **kw: Any) -> AsyncAdapt_pycubrid_connection:
+        creator_fn = kw.pop("async_creator_fn", self._aio_module.connect)
+        async_conn = await_only(creator_fn(*arg, **kw))
+        return AsyncAdapt_pycubrid_connection(self, async_conn)
+
+
+class PyCubridAsyncDialect(PyCubridDialect):
+    driver = "aiopycubrid"
+    is_async = True
+    supports_statement_cache = True
+    execution_ctx_cls = PyCubridExecutionContext
+
+    @classmethod
+    def import_dbapi(cls) -> DBAPIModule:
+        import pycubrid.aio as aio_module
+
+        return cast(DBAPIModule, AsyncAdapt_pycubrid_dbapi(aio_module))
+
+    @classmethod
+    def dbapi(cls) -> DBAPIModule:  # type: ignore[override]
+        return cls.import_dbapi()
+
+    def create_connect_args(self, url: URL) -> ConnectArgsType:
+        if url is None:
+            raise ValueError("Unexpected database URL format")
+
+        opts = url.translate_connect_args(username="user", database="database")
+        return (), {
+            "host": opts.get("host", "localhost"),
+            "port": opts.get("port", 33000),
+            "database": opts.get("database", ""),
+            "user": opts.get("user", "dba"),
+            "password": opts.get("password", ""),
+        }
+
+    def on_connect(self) -> Callable[[Any], None] | None:
+        isolation_level = self.isolation_level
+
+        def connect(conn: Any) -> None:
+            conn.autocommit = False
+            if isolation_level is not None:
+                self.set_isolation_level(conn, isolation_level)
+
+        return connect
+
+    def do_ping(self, dbapi_connection: Any) -> bool:
+        cursor = dbapi_connection.cursor()
+        try:
+            cursor.execute("SELECT 1")
+            cursor.fetchone()
+        finally:
+            cursor.close()
+        return True
+
+
+dialect = PyCubridAsyncDialect

{sqlalchemy_cubrid-1.0.0 → sqlalchemy_cubrid-1.2.0}/sqlalchemy_cubrid/compiler.py

@@ -11,7 +11,7 @@ from __future__ import annotations
 
 from typing import Any
 
-from sqlalchemy.sql import compiler
+from sqlalchemy.sql import compiler, elements
 from sqlalchemy.sql import sqltypes
 
 
@@ -320,6 +320,56 @@ class CubridCompiler(compiler.SQLCompiler):
             return "REPLACE" + text[len("INSERT") :]
         return text
 
+    def _render_json_extract_from_binary(
+        self, binary: elements.BinaryExpression[Any], operator: Any, **kw: Any
+    ) -> str:
+        if binary.type._type_affinity is sqltypes.JSON:
+            return "JSON_EXTRACT(%s, %s)" % (
+                self.process(binary.left, **kw),
+                self.process(binary.right, **kw),
+            )
+
+        # When the target type is not JSON, convert JSON 'null' to SQL NULL
+        case_expression = "CASE JSON_EXTRACT(%s, %s) WHEN 'null' THEN NULL" % (
+            self.process(binary.left, **kw),
+            self.process(binary.right, **kw),
+        )
+
+        if binary.type._type_affinity is sqltypes.Boolean:
+            type_expression = (
+                "WHEN 'true' THEN 1 WHEN 'false' THEN 0 ELSE CAST(JSON_EXTRACT(%s, %s) AS INTEGER)"
+            ) % (
+                self.process(binary.left, **kw),
+                self.process(binary.right, **kw),
+            )
+        elif binary.type._type_affinity is sqltypes.Integer:
+            type_expression = "ELSE CAST(JSON_EXTRACT(%s, %s) AS INTEGER)" % (
+                self.process(binary.left, **kw),
+                self.process(binary.right, **kw),
+            )
+        elif binary.type._type_affinity is sqltypes.Numeric:
+            type_expression = "ELSE CAST(JSON_EXTRACT(%s, %s) AS DOUBLE)" % (
+                self.process(binary.left, **kw),
+                self.process(binary.right, **kw),
+            )
+        else:
+            type_expression = "ELSE JSON_UNQUOTE(JSON_EXTRACT(%s, %s))" % (
+                self.process(binary.left, **kw),
+                self.process(binary.right, **kw),
+            )
+
+        return case_expression + " " + type_expression + " END"
+
+    def visit_json_getitem_op_binary(
+        self, binary: elements.BinaryExpression[Any], operator: Any, **kw: Any
+    ) -> str:
+        return self._render_json_extract_from_binary(binary, operator, **kw)
+
+    def visit_json_path_getitem_op_binary(
+        self, binary: elements.BinaryExpression[Any], operator: Any, **kw: Any
+    ) -> str:
+        return self._render_json_extract_from_binary(binary, operator, **kw)
+
 
 class CubridDDLCompiler(compiler.DDLCompiler):
     """DDLCompiler subclass for CUBRID.
@@ -534,3 +584,6 @@ class CubridTypeCompiler(compiler.GenericTypeCompiler):
             else:
                 parts.append(value.__visit_name__)
         return f"{collection_type}({','.join(parts)})"
+
+    def visit_JSON(self, type_: Any, **kw: Any) -> str:
+        return "JSON"

{sqlalchemy_cubrid-1.0.0 → sqlalchemy_cubrid-1.2.0}/sqlalchemy_cubrid/dialect.py

@@ -30,6 +30,7 @@ from sqlalchemy.engine.interfaces import (
 from sqlalchemy.engine.url import URL
 from sqlalchemy.sql import text
 from sqlalchemy.sql.compiler import IdentifierPreparer
+from sqlalchemy.sql.compiler import InsertmanyvaluesSentinelOpts
 
 from sqlalchemy_cubrid.base import CubridExecutionContext, CubridIdentifierPreparer
 from sqlalchemy_cubrid.compiler import (
@@ -47,6 +48,9 @@ from sqlalchemy_cubrid.types import (
     DOUBLE,
     DOUBLE_PRECISION,
     FLOAT,
+    JSON,
+    JSONIndexType,
+    JSONPathType,
     MULTISET,
     NCHAR,
     NUMERIC,
@@ -83,6 +87,9 @@ colspecs = {
     sqltypes.Numeric: NUMERIC,
     sqltypes.Float: FLOAT,
     sqltypes.Time: TIME,
+    sqltypes.JSON: JSON,
+    sqltypes.JSON.JSONIndexType: JSONIndexType,
+    sqltypes.JSON.JSONPathType: JSONPathType,
 }
 
 # ischema_names maps CUBRID type names from SHOW COLUMNS to SA types.
@@ -119,6 +126,8 @@ ischema_names = {
     "SET": SET,
     "MULTISET": MULTISET,
     "SEQUENCE": SEQUENCE,
+    # JSON (CUBRID 10.2+)
+    "JSON": JSON,
 }
 
 
@@ -177,6 +186,9 @@ class CubridDialect(default.DefaultDialect):
     supports_default_metavalue = True
     supports_empty_insert = True
     supports_multivalues_insert = True
+    use_insertmanyvalues = True
+    use_insertmanyvalues_wo_returning = True
+    insertmanyvalues_implicit_sentinel = InsertmanyvaluesSentinelOpts.ANY_AUTOINCREMENT
     supports_is_distinct_from = False
 
     # RETURNING
@@ -427,12 +439,16 @@ class CubridDialect(default.DefaultDialect):
         return [row[0] for row in result]
 
     @reflection.cache
-    def get_view_definition(self, connection: Any, view_name: str, schema: str | None = None, **kw: Any) -> str | None:  # type: ignore[override]  # pyright: ignore[reportIncompatibleMethodOverride]
+    def get_view_definition(  # type: ignore[override]
+        self, connection: Any, view_name: str, schema: str | None = None, **kw: Any
+    ) -> str:
         """Return the CREATE VIEW definition."""
         quoted = self.identifier_preparer.quote_identifier(view_name)
         result = connection.execute(text(f"SHOW CREATE VIEW {quoted}"))
         row = result.fetchone()
-        return row[1] if row else None
+        if row is None:
+            return ""
+        return str(row[1])
 
     @reflection.cache
     def get_indexes(
@@ -664,7 +680,9 @@ class CubridDialect(default.DefaultDialect):
             return self._ISOLATION_LEVEL_REVERSE.get(val, str(val))
         return str(val)
 
-    def get_isolation_level_values(self, dbapi_conn: DBAPIConnection | None = None) -> Sequence[str]:  # type: ignore[override]  # pyright: ignore[reportIncompatibleMethodOverride]
+    def get_isolation_level_values(  # type: ignore[override]  # pyright: ignore[reportIncompatibleMethodOverride]
+        self, dbapi_conn: DBAPIConnection | None = None
+    ) -> Sequence[str]:
         """Return the list of valid isolation level values."""
         del dbapi_conn
         return [
@@ -679,7 +697,11 @@ class CubridDialect(default.DefaultDialect):
             "READ COMMITTED SCHEMA, READ UNCOMMITTED INSTANCES",
         ]
 
-    def set_isolation_level(self, dbapi_connection: DBAPIConnection, level: str) -> None:  # pyright: ignore[reportIncompatibleMethodOverride]
+    def set_isolation_level(
+        self,
+        dbapi_connection: DBAPIConnection,
+        level: str,
+    ) -> None:  # pyright: ignore[reportIncompatibleMethodOverride]
         """Set the isolation level for *dbapi_conn*."""
         # Note: do NOT unwrap dbapi_conn.connection — the inner C-level
         # _cubrid.connection cursor cannot handle SET TRANSACTION SQL.

{sqlalchemy_cubrid-1.0.0 → sqlalchemy_cubrid-1.2.0}/sqlalchemy_cubrid/types.py

@@ -354,3 +354,92 @@ class OBJECT(sqltypes.TypeEngine[Any]):
     """
 
     __visit_name__ = "OBJECT"
+
+
+# ---------------------------------------------------------------------------
+# JSON Type (CUBRID 10.2+)
+# ---------------------------------------------------------------------------
+
+
+class _FormatTypeMixin:
+    """Mixin for formatting JSON path index/path values for bind parameters."""
+
+    def _format_value(self, value: Any) -> str:
+        raise NotImplementedError()
+
+    def bind_processor(self, dialect: Any) -> Any:
+        super_proc = self.string_bind_processor(dialect)  # type: ignore[attr-defined]  # noqa: E501
+
+        def process(value: Any) -> Any:
+            value = self._format_value(value)
+            if super_proc:
+                value = super_proc(value)
+            return value
+
+        return process
+
+    def literal_processor(self, dialect: Any) -> Any:
+        super_proc = self.string_literal_processor(dialect)  # type: ignore[attr-defined]  # noqa: E501
+
+        def process(value: Any) -> str:
+            value = self._format_value(value)
+            if super_proc:
+                value = super_proc(value)
+            return value
+
+        return process
+
+
+class JSONIndexType(_FormatTypeMixin, sqltypes.JSON.JSONIndexType):
+    """CUBRID JSON index type for single-key access.
+
+    Converts Python index values to CUBRID JSON path syntax:
+    - Integer index: ``$[0]``
+    - String key: ``$."key"``
+    """
+
+    def _format_value(self, value: Any) -> str:
+        if isinstance(value, int):
+            return "$[%s]" % value
+        else:
+            return '$."%s"' % str(value).replace('"', '""')
+
+
+class JSONPathType(_FormatTypeMixin, sqltypes.JSON.JSONPathType):
+    """CUBRID JSON path type for multi-level access.
+
+    Converts Python tuple paths to CUBRID JSON path syntax:
+    - ``("a", 1, "b")`` → ``$."a"[1]."b"``
+    """
+
+    def _format_value(self, value: Any) -> str:
+        return "$%s" % (
+            "".join(
+                "[%s]" % elem if isinstance(elem, int) else '."%s"' % str(elem).replace('"', '""')
+                for elem in value
+            )
+        )
+
+
+class JSON(sqltypes.JSON):  # type: ignore[type-arg]
+    """CUBRID JSON type.
+
+    CUBRID supports JSON as of version 10.2 (RFC 7159 compliant).
+
+    :class:`_cubrid.JSON` is used automatically whenever the base
+    :class:`_types.JSON` datatype is used against a CUBRID backend.
+
+    The :class:`.cubrid.JSON` type supports persistence of JSON values
+    as well as the core index operations provided by :class:`_types.JSON`
+    datatype, by adapting the operations to render the ``JSON_EXTRACT``
+    function at the database level.
+
+    .. seealso::
+
+        :class:`_types.JSON` - main documentation for the generic
+        cross-platform JSON datatype.
+
+    .. versionadded:: 1.2.0
+    """
+
+    __visit_name__ = "JSON"

{sqlalchemy_cubrid-1.0.0 → sqlalchemy_cubrid-1.2.0/sqlalchemy_cubrid.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlalchemy-cubrid
-Version: 1.0.0
+Version: 1.2.0
 Summary: CUBRID dialect for SQLAlchemy
 Author-email: Yeongseon Choe <yeongseon.choe@gmail.com>, Gyeongjun Paik <paikend@gmail.com>
 License-Expression: MIT
@@ -78,7 +78,7 @@ production-ready SQLAlchemy dialect that supports the modern 2.0–2.1 API.
 - 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
-- **Two driver options** — C-extension (`cubrid://`) or pure Python (`cubrid+pycubrid://`)
+- **Three driver options** — C-extension (`cubrid://`), pure Python (`cubrid+pycubrid://`), or async pure Python (`cubrid+aiopycubrid://`)
 
 ## Architecture
 
@@ -88,8 +88,10 @@ flowchart TD
     sa --> dialect["CubridDialect"]
     dialect --> pycubrid["pycubrid driver"]
     dialect --> cext["CUBRIDdb driver"]
+    dialect --> aio["pycubrid.aio async driver"]
     pycubrid --> server["CUBRID Server"]
     cext --> server
+    aio --> server
 ```
 
 ```mermaid
@@ -163,15 +165,29 @@ with Session(engine) as session:
     session.commit()
 ```
 
+### Async
+
+```python
+from sqlalchemy.ext.asyncio import create_async_engine, AsyncSession
+from sqlalchemy import text
+
+engine = create_async_engine("cubrid+aiopycubrid://dba:password@localhost:33000/demodb")
+
+async with AsyncSession(engine) as session:
+    result = await session.execute(text("SELECT 1"))
+    print(result.scalar())
+```
+
 ## Features
 
-- Complete type system -- numeric, string, date/time, bit, LOB, and collection types
+- Complete type system -- 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
 
 ## Documentation
 
@@ -187,6 +203,7 @@ with Session(engine) as session:
 | [Development](docs/DEVELOPMENT.md) | Dev setup, testing, Docker, coverage, CI/CD |
 | [Driver Compatibility](docs/DRIVER_COMPAT.md) | CUBRID-Python driver versions and known issues |
 | [Troubleshooting](docs/TROUBLESHOOTING.md) | Common issues, error solutions, debugging techniques |
+| [Async Connection](docs/CONNECTION.md#async-connection) | Async engine setup with `cubrid+aiopycubrid://` |
 
 ## Compatibility Matrix
 
@@ -233,13 +250,17 @@ stmt = insert(users).values(name="Alice").on_duplicate_key_update(name="Alice Up
 
 ### What's the difference between `cubrid://` and `cubrid+pycubrid://`?
 
-`cubrid://` uses the C-extension driver (CUBRIDdb) which requires compilation. `cubrid+pycubrid://` uses the pure Python driver which installs with pip alone — no build tools needed.
+`cubrid://` uses the C-extension driver (CUBRIDdb) which requires compilation. `cubrid+pycubrid://` uses the pure Python driver which installs with pip alone — no build tools needed. `cubrid+aiopycubrid://` uses the async variant of the pure Python driver for use with `create_async_engine` and `AsyncSession`.
+
+### Does sqlalchemy-cubrid support async?
+
+Yes. Use `create_async_engine("cubrid+aiopycubrid://...")` with the pycubrid async driver. Requires `pycubrid>=1.1.0`. All Core and ORM features work with `AsyncSession`.
 
 
 ## Related Projects
 
 - [pycubrid](https://github.com/cubrid-labs/pycubrid) — Pure Python DB-API 2.0 driver for CUBRID
-- [cubrid-python-cookbook](https://github.com/cubrid-labs/cubrid-python-cookbook) — Production-ready Python examples for CUBRID
+- [cubrid-cookbook-python](https://github.com/cubrid-labs/cubrid-cookbook-python) — Production-ready Python examples for CUBRID
 
 ## Roadmap