sqlalchemy-cubrid 1.2.1__tar.gz → 1.2.2__tar.gz

sqlalchemy_cubrid-1.2.2/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: sqlalchemy-cubrid
+Version: 1.2.2
+Summary: CUBRID dialect for SQLAlchemy
+Author-email: Yeongseon Choe <yeongseon.choe@gmail.com>, Gyeongjun Paik <paikend@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/sqlalchemy-cubrid/sqlalchemy-cubrid
+Project-URL: Repository, https://github.com/sqlalchemy-cubrid/sqlalchemy-cubrid
+Project-URL: Documentation, https://github.com/sqlalchemy-cubrid/sqlalchemy-cubrid
+Keywords: SQLAlchemy,CUBRID,dialect
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS
+Requires-Dist: sqlalchemy<2.2,>=2.0
+Provides-Extra: cubrid
+Requires-Dist: CUBRID-Python; extra == "cubrid"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Provides-Extra: alembic
+Requires-Dist: alembic>=1.7; extra == "alembic"
+Dynamic: license-file
+
+# sqlalchemy-cubrid
+
+CUBRID dialect for SQLAlchemy 2.0+.
+
+[![CI](https://github.com/sqlalchemy-cubrid/sqlalchemy-cubrid/actions/workflows/ci.yml/badge.svg)](https://github.com/sqlalchemy-cubrid/sqlalchemy-cubrid/actions/workflows/ci.yml)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![SQLAlchemy 2.0](https://img.shields.io/badge/SQLAlchemy-2.0-green.svg)](https://www.sqlalchemy.org/)
+[![Coverage 99%](https://img.shields.io/badge/coverage-99%25-brightgreen.svg)](docs/DEVELOPMENT.md#code-coverage)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Requirements
+
+- Python 3.10+
+- SQLAlchemy 2.0 – 2.1
+- [CUBRID-Python](https://github.com/CUBRID/cubrid-python) driver
+
+## Install
+
+```bash
+pip install sqlalchemy-cubrid
+```
+
+## Quick Start
+
+```python
+from sqlalchemy import create_engine, text
+
+engine = create_engine("cubrid://dba:password@localhost:33000/demodb")
+
+with engine.connect() as conn:
+    result = conn.execute(text("SELECT 1"))
+    print(result.scalar())
+```
+
+## Features
+
+- Full SQLAlchemy 2.0 dialect with statement caching
+- Complete type system — numeric, string, date/time, bit, LOB, and collection types
+- SQL compilation — SELECT, JOIN, CAST, LIMIT/OFFSET, subqueries, CTEs, window functions
+- DML extensions — `ON DUPLICATE KEY UPDATE`, `MERGE`, `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
+- PEP 561 typed package
+
+## Documentation
+
+| Guide | Description |
+|---|---|
+| **[Connection](docs/CONNECTION.md)** | Connection strings, URL format, driver setup, troubleshooting |
+| **[Type Mapping](docs/TYPES.md)** | Full type mapping, CUBRID-specific types, collection types |
+| **[DML Extensions](docs/DML_EXTENSIONS.md)** | ON DUPLICATE KEY UPDATE, MERGE, GROUP_CONCAT, TRUNCATE, index hints |
+| **[Isolation Levels](docs/ISOLATION_LEVELS.md)** | All 6 CUBRID isolation levels, configuration, comparison |
+| **[Alembic Migrations](docs/ALEMBIC.md)** | Setup, configuration, limitations, batch workarounds |
+| **[Feature Support](docs/FEATURE_SUPPORT.md)** | Full comparison with MySQL, PostgreSQL, and SQLite |
+| **[Development](docs/DEVELOPMENT.md)** | Dev setup, testing, Docker, coverage, CI/CD |
+
+## Compatibility
+
+| | Python 3.10 | Python 3.11 | Python 3.12 | Python 3.13 |
+|---|:---:|:---:|:---:|:---:|
+| **Offline Tests** | ✅ | ✅ | ✅ | ✅ |
+| **CUBRID 11.4** | ✅ | — | ✅ | — |
+| **CUBRID 11.2** | ✅ | — | ✅ | — |
+| **CUBRID 11.0** | ✅ | — | ✅ | — |
+| **CUBRID 10.2** | ✅ | — | ✅ | — |
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for dev setup.
+
+## Security
+
+See [SECURITY.md](SECURITY.md).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

sqlalchemy_cubrid-1.2.2/README.md

@@ -0,0 +1,79 @@
+# sqlalchemy-cubrid
+
+CUBRID dialect for SQLAlchemy 2.0+.
+
+[![CI](https://github.com/sqlalchemy-cubrid/sqlalchemy-cubrid/actions/workflows/ci.yml/badge.svg)](https://github.com/sqlalchemy-cubrid/sqlalchemy-cubrid/actions/workflows/ci.yml)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![SQLAlchemy 2.0](https://img.shields.io/badge/SQLAlchemy-2.0-green.svg)](https://www.sqlalchemy.org/)
+[![Coverage 99%](https://img.shields.io/badge/coverage-99%25-brightgreen.svg)](docs/DEVELOPMENT.md#code-coverage)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Requirements
+
+- Python 3.10+
+- SQLAlchemy 2.0 – 2.1
+- [CUBRID-Python](https://github.com/CUBRID/cubrid-python) driver
+
+## Install
+
+```bash
+pip install sqlalchemy-cubrid
+```
+
+## Quick Start
+
+```python
+from sqlalchemy import create_engine, text
+
+engine = create_engine("cubrid://dba:password@localhost:33000/demodb")
+
+with engine.connect() as conn:
+    result = conn.execute(text("SELECT 1"))
+    print(result.scalar())
+```
+
+## Features
+
+- Full SQLAlchemy 2.0 dialect with statement caching
+- Complete type system — numeric, string, date/time, bit, LOB, and collection types
+- SQL compilation — SELECT, JOIN, CAST, LIMIT/OFFSET, subqueries, CTEs, window functions
+- DML extensions — `ON DUPLICATE KEY UPDATE`, `MERGE`, `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
+- PEP 561 typed package
+
+## Documentation
+
+| Guide | Description |
+|---|---|
+| **[Connection](docs/CONNECTION.md)** | Connection strings, URL format, driver setup, troubleshooting |
+| **[Type Mapping](docs/TYPES.md)** | Full type mapping, CUBRID-specific types, collection types |
+| **[DML Extensions](docs/DML_EXTENSIONS.md)** | ON DUPLICATE KEY UPDATE, MERGE, GROUP_CONCAT, TRUNCATE, index hints |
+| **[Isolation Levels](docs/ISOLATION_LEVELS.md)** | All 6 CUBRID isolation levels, configuration, comparison |
+| **[Alembic Migrations](docs/ALEMBIC.md)** | Setup, configuration, limitations, batch workarounds |
+| **[Feature Support](docs/FEATURE_SUPPORT.md)** | Full comparison with MySQL, PostgreSQL, and SQLite |
+| **[Development](docs/DEVELOPMENT.md)** | Dev setup, testing, Docker, coverage, CI/CD |
+
+## Compatibility
+
+| | Python 3.10 | Python 3.11 | Python 3.12 | Python 3.13 |
+|---|:---:|:---:|:---:|:---:|
+| **Offline Tests** | ✅ | ✅ | ✅ | ✅ |
+| **CUBRID 11.4** | ✅ | — | ✅ | — |
+| **CUBRID 11.2** | ✅ | — | ✅ | — |
+| **CUBRID 11.0** | ✅ | — | ✅ | — |
+| **CUBRID 10.2** | ✅ | — | ✅ | — |
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for dev setup.
+
+## Security
+
+See [SECURITY.md](SECURITY.md).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

{sqlalchemy_cubrid-1.2.1 → sqlalchemy_cubrid-1.2.2}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sqlalchemy-cubrid"
-version = "1.2.1"
+version = "1.2.2"
 description = "CUBRID dialect for SQLAlchemy"
 readme = "README.md"
-license = "MIT"
+license = {text = "MIT"}
 requires-python = ">=3.10"
 authors = [
     {name = "Yeongseon Choe", email = "yeongseon.choe@gmail.com"},
@@ -15,21 +15,16 @@ authors = [
 ]
 keywords = ["SQLAlchemy", "CUBRID", "dialect"]
 classifiers = [
-    "Development Status :: 5 - Production/Stable",
+    "Development Status :: 3 - Alpha",
     "Environment :: Console",
     "Intended Audience :: Developers",
-    "Operating System :: OS Independent",
+    "License :: OSI Approved :: MIT License",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3 :: Only",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
-    "Programming Language :: Python :: 3.14",
-    "Programming Language :: SQL",
-    "Topic :: Database",
-    "Topic :: Database :: Front-Ends",
 ]
 dependencies = [
     "sqlalchemy>=2.0,<2.2",
@@ -41,33 +36,20 @@ cubrid = [
 ]
 dev = [
     "pytest>=7.0",
-    "pytest-cov",
-    "ruff==0.15.8",
-    "mypy==1.19.1",
-    "bandit[toml]==1.9.4",
-    "pre-commit",
-    "tox",
-    "alembic>=1.7",
+    "ruff>=0.4",
 ]
 alembic = [
     "alembic>=1.7",
 ]
-pycubrid = [
-    "pycubrid>=1.0,<2.0",
-]
 
 [project.urls]
-Homepage = "https://github.com/cubrid-labs/sqlalchemy-cubrid"
-Repository = "https://github.com/cubrid-labs/sqlalchemy-cubrid"
-Documentation = "https://github.com/cubrid-labs/sqlalchemy-cubrid/tree/main/docs"
-Changelog = "https://github.com/cubrid-labs/sqlalchemy-cubrid/blob/main/CHANGELOG.md"
-Issues = "https://github.com/cubrid-labs/sqlalchemy-cubrid/issues"
+Homepage = "https://github.com/sqlalchemy-cubrid/sqlalchemy-cubrid"
+Repository = "https://github.com/sqlalchemy-cubrid/sqlalchemy-cubrid"
+Documentation = "https://github.com/sqlalchemy-cubrid/sqlalchemy-cubrid"
 
 [project.entry-points."sqlalchemy.dialects"]
 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"
@@ -80,30 +62,6 @@ include-package-data = true
 line-length = 100
 target-version = "py310"
 
-[tool.ruff.lint.isort]
-known-first-party = ["sqlalchemy_cubrid"]
-
-[tool.mypy]
-python_version = "3.10"
-strict = true
-warn_return_any = true
-warn_unused_configs = true
-
-[[tool.mypy.overrides]]
-module = "test.*"
-ignore_errors = true
-
-[tool.bandit]
-exclude_dirs = ["test"]
-skips = ["B101"]
-
-[tool.coverage.run]
-source = ["sqlalchemy_cubrid"]
-
-[tool.coverage.report]
-show_missing = true
-fail_under = 95
-
 [tool.pytest.ini_options]
 testpaths = ["test"]
 addopts = "--tb native -v -r fxX --maxfail=25 -p no:warnings"

{sqlalchemy_cubrid-1.2.1 → sqlalchemy_cubrid-1.2.2}/sqlalchemy_cubrid/__init__.py

@@ -25,15 +25,10 @@ from .types import (
     DOUBLE,
     DOUBLE_PRECISION,
     FLOAT,
-    JSON,
-    JSONIndexType,
-    JSONPathType,
-    MONETARY,
     MULTISET,
     NCHAR,
     NUMERIC,
     NVARCHAR,
-    OBJECT,
     REAL,
     SEQUENCE,
     SET,
@@ -41,8 +36,7 @@ from .types import (
     STRING,
     VARCHAR,
 )
-from .dml import insert, merge, replace
-from .trace import trace_query
+from .dml import insert, merge
 
 from sqlalchemy.sql.sqltypes import (
     DATE,
@@ -52,13 +46,11 @@ from sqlalchemy.sql.sqltypes import (
     TIMESTAMP,
 )
 
-__version__ = "1.2.1"
+__version__ = "1.2.2"
 
 __all__ = (
     "insert",
     "merge",
-    "replace",
-    "trace_query",
     "SMALLINT",
     "INTEGER",
     "BIGINT",
@@ -68,7 +60,6 @@ __all__ = (
     "REAL",
     "DOUBLE",
     "DOUBLE_PRECISION",
-    "MONETARY",
     "DATE",
     "TIME",
     "TIMESTAMP",
@@ -84,8 +75,4 @@ __all__ = (
     "SET",
     "MULTISET",
     "SEQUENCE",
-    "OBJECT",
-    "JSON",
-    "JSONIndexType",
-    "JSONPathType",
 )

sqlalchemy_cubrid-1.2.2/sqlalchemy_cubrid/alembic_impl.py

@@ -0,0 +1,69 @@
+# sqlalchemy_cubrid/alembic_impl.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
+
+"""Alembic migration support for the CUBRID dialect.
+
+This module provides the Alembic ``DefaultImpl`` subclass that enables
+Alembic migrations against a CUBRID database.  It is registered as an
+entry-point under ``alembic.ddl`` so that Alembic auto-discovers it
+when the target database URL uses the ``cubrid://`` scheme.
+
+Usage::
+
+    # alembic.ini
+    [alembic]
+    sqlalchemy.url = cubrid://dba:password@localhost:33000/demodb
+
+    # That's it — Alembic will pick up the CUBRID implementation
+    # automatically via the ``alembic.ddl`` entry point.
+
+CUBRID-specific notes
+---------------------
+* **DDL is auto-committed** — CUBRID implicitly commits every DDL
+  statement, so ``transactional_ddl`` is set to ``False``.
+* **No ALTER COLUMN TYPE** — CUBRID does not support changing a
+  column's data type via ``ALTER TABLE … MODIFY``.  Alembic's
+  ``alter_column(type_=…)`` will raise.  Use ``batch_alter_table``
+  (table recreate) as a workaround.
+* **No RENAME COLUMN** — CUBRID ≤ 11.x does not support
+  ``ALTER TABLE … RENAME COLUMN``.  Alembic's ``alter_column(new_column_name=…)``
+  will raise.  Use ``batch_alter_table`` (table recreate) as a
+  workaround.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+try:
+    from alembic.ddl.impl import DefaultImpl
+except ImportError:  # pragma: no cover — optional dependency
+    raise ImportError(
+        "Alembic is required for migration support.  "
+        "Install it with:  pip install sqlalchemy-cubrid[alembic]"
+    ) from None
+
+if TYPE_CHECKING:
+    pass
+
+
+class CubridImpl(DefaultImpl):
+    """Alembic migration implementation for CUBRID.
+
+    Registered via the ``alembic.ddl`` entry-point so Alembic
+    auto-discovers it for ``cubrid://`` URLs.
+
+    Attributes
+    ----------
+    __dialect__ : str
+        ``"cubrid"`` — matches the SQLAlchemy dialect name.
+    transactional_ddl : bool
+        ``False`` — CUBRID implicitly commits DDL statements.
+    """
+
+    __dialect__ = "cubrid"
+    transactional_ddl = False

{sqlalchemy_cubrid-1.2.1 → sqlalchemy_cubrid-1.2.2}/sqlalchemy_cubrid/base.py

@@ -10,7 +10,6 @@
 from __future__ import annotations
 
 import re
-from typing import Any, cast
 
 from sqlalchemy.engine import default
 from sqlalchemy.sql import compiler
@@ -378,19 +377,19 @@ RESERVED_WORDS = frozenset(
 class CubridIdentifierPreparer(compiler.IdentifierPreparer):
     """Quoting logic for CUBRID identifiers."""
 
-    reserved_words = set(RESERVED_WORDS)
+    reserved_words = RESERVED_WORDS
 
     def __init__(
         self,
-        dialect: Any,
-        initial_quote: str = '"',
-        final_quote: str | None = None,
-        escape_quote: str = '"',
-        omit_schema: bool = False,
-    ) -> None:
+        dialect,
+        initial_quote='"',
+        final_quote=None,
+        escape_quote='"',
+        omit_schema=False,
+    ):
         super().__init__(dialect, initial_quote, final_quote, escape_quote, omit_schema)
 
-    def _quote_free_identifiers(self, *ids: str | None) -> tuple[str, ...]:
+    def _quote_free_identifiers(self, *ids):
         """Unilaterally identifier-quote any number of strings."""
         return tuple(self.quote_identifier(i) for i in ids if i is not None)
 
@@ -398,10 +397,10 @@ class CubridIdentifierPreparer(compiler.IdentifierPreparer):
 class CubridExecutionContext(default.DefaultExecutionContext):
     """Execution context for CUBRID connections."""
 
-    def should_autocommit_text(self, statement: str) -> Any:
+    def should_autocommit_text(self, statement):
         return AUTOCOMMIT_REGEXP.match(statement)
 
-    def get_lastrowid(self) -> int:
+    def get_lastrowid(self):
         """Return the last inserted row ID.
 
         CUBRID's Python driver does not expose ``cursor.lastrowid``.
@@ -412,10 +411,9 @@ class CubridExecutionContext(default.DefaultExecutionContext):
         try:
             # CUBRID Python driver exposes this on the raw connection
             raw_conn = self.root_connection.connection.dbapi_connection
-            if raw_conn is not None and hasattr(raw_conn, "get_last_insert_id"):
-                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
+            if hasattr(raw_conn, "get_last_insert_id"):
+                return raw_conn.get_last_insert_id()
+        except Exception:
             pass
 
         # Fallback: use SQL function
@@ -427,4 +425,4 @@ class CubridExecutionContext(default.DefaultExecutionContext):
                 return int(row[0])
         finally:
             cursor.close()
-        return cast(int, None)  # pyright: ignore[reportInvalidCast]
+        return None