pycubrid 0.5.0__tar.gz

pycubrid-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Yeongseon Choe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pycubrid-0.5.0/PKG-INFO

@@ -0,0 +1,273 @@
+Metadata-Version: 2.4
+Name: pycubrid
+Version: 0.5.0
+Summary: Pure Python DB-API 2.0 driver for CUBRID database
+Author-email: Yeongseon Choe <yeongseon.choe@gmail.com>, Gyeongjun Paik <paikend@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/cubrid-labs/pycubrid
+Project-URL: Repository, https://github.com/cubrid-labs/pycubrid
+Project-URL: Documentation, https://github.com/cubrid-labs/pycubrid/tree/main/docs
+Keywords: CUBRID,database,driver,DB-API,PEP 249
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+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
+Classifier: Topic :: Database
+Classifier: Topic :: Database :: Front-Ends
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Dynamic: license-file
+
+# pycubrid
+
+**Pure Python DB-API 2.0 driver for the CUBRID database** — no C extensions, no compilation, PEP 249 compliant database connector.
+
+[🇰🇷 한국어](docs/README.ko.md) · [🇺🇸 English](README.md) · [🇨🇳 中文](docs/README.zh.md) · [🇮🇳 हिन्दी](docs/README.hi.md) · [🇩🇪 Deutsch](docs/README.de.md) · [🇷🇺 Русский](docs/README.ru.md)
+
+<!-- BADGES:START -->
+[![PyPI version](https://img.shields.io/pypi/v/pycubrid)](https://pypi.org/project/pycubrid)
+[![python version](https://img.shields.io/pypi/pyversions/pycubrid)](https://www.python.org)
+[![ci workflow](https://github.com/cubrid-labs/pycubrid/actions/workflows/ci.yml/badge.svg)](https://github.com/cubrid-labs/pycubrid/actions/workflows/ci.yml)
+[![license](https://img.shields.io/github/license/cubrid-labs/pycubrid)](https://github.com/cubrid-labs/pycubrid/blob/main/LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/cubrid-labs/pycubrid)](https://github.com/cubrid-labs/pycubrid)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![Coverage 99%](https://img.shields.io/badge/coverage-99%25-brightgreen.svg)](docs/DEVELOPMENT.md#code-coverage)
+<!-- BADGES:END -->
+
+---
+
+## Why pycubrid?
+
+CUBRID is a high-performance open-source relational database, widely adopted in
+Korean public-sector and enterprise applications. The existing C-extension driver
+(`CUBRIDdb`) had build dependencies and platform compatibility issues.
+
+**pycubrid** solves these problems:
+
+- **Pure Python implementation** — no C build dependencies, install with `pip install` only
+- **Full PEP 249 (DB-API 2.0) compliance** — standard exception hierarchy, type objects, cursor interface
+- **471 offline tests** with **99%+ code coverage** — no database required to run them
+- **PEP 561 typed package** — `py.typed` marker for modern IDE and static analysis support
+- **Direct CUBRID CAS protocol** implementation — no additional middleware required
+- **LOB (CLOB/BLOB) support** — handle large text and binary data
+
+## Requirements
+
+- Python 3.10+
+- CUBRID database server 10.2+
+
+## Installation
+
+```bash
+pip install pycubrid
+```
+
+## Quick Start
+
+### Basic Connection
+
+```python
+import pycubrid
+
+conn = pycubrid.connect(
+    host="localhost",
+    port=33000,
+    database="testdb",
+    user="dba",
+    password="",
+)
+
+cur = conn.cursor()
+cur.execute("SELECT 1 + 1")
+print(cur.fetchone())  # (2,)
+
+cur.close()
+conn.close()
+```
+
+### Context Manager
+
+```python
+import pycubrid
+
+with pycubrid.connect(host="localhost", port=33000, database="testdb", user="dba") as conn:
+    with conn.cursor() as cur:
+        cur.execute("CREATE TABLE IF NOT EXISTS cookbook_users (id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(100))")
+        cur.execute("INSERT INTO cookbook_users (name) VALUES (?)", ("Alice",))
+        conn.commit()
+
+        cur.execute("SELECT * FROM cookbook_users")
+        for row in cur:
+            print(row)
+```
+
+### Parameter Binding
+
+```python
+# qmark style (question marks)
+cur.execute("SELECT * FROM users WHERE name = ? AND age > ?", ("Alice", 25))
+
+# Batch insert with executemany
+data = [("Alice", 30), ("Bob", 25), ("Charlie", 35)]
+cur.executemany("INSERT INTO users (name, age) VALUES (?, ?)", data)
+conn.commit()
+```
+
+### Prepared Statements
+
+```python
+cur.prepare("SELECT * FROM users WHERE department = ?")
+cur.execute(None, ("Engineering",))
+engineers = cur.fetchall()
+
+cur.execute(None, ("Marketing",))
+marketers = cur.fetchall()
+```
+
+## PEP 249 Compliance
+
+| Attribute | Value |
+|---|---|
+| `apilevel` | `"2.0"` |
+| `threadsafety` | `1` (connections cannot be shared between threads) |
+| `paramstyle` | `"qmark"` (positional parameters `?`) |
+
+- Full standard exception hierarchy: `Warning`, `Error`, `InterfaceError`, `DatabaseError`, `OperationalError`, `IntegrityError`, `InternalError`, `ProgrammingError`, `NotSupportedError`
+- Standard type objects: `STRING`, `BINARY`, `NUMBER`, `DATETIME`, `ROWID`
+- Standard constructors: `Date()`, `Time()`, `Timestamp()`, `Binary()`, `DateFromTicks()`, `TimeFromTicks()`, `TimestampFromTicks()`
+
+## Features
+
+- **Pure Python** — no C extensions, no compilation, works everywhere Python runs
+- **Complete DB-API 2.0** — `connect()`, `Cursor`, `fetchone/many/all`, `executemany`, `callproc`
+- **Prepared statements** — `cursor.prepare()` / `cursor.execute()` for server-side preparation
+- **Batch operations** — `executemany()` and `executemany_batch()` for bulk inserts
+- **LOB support** — `create_lob()`, read/write CLOB and BLOB columns
+- **Schema introspection** — `get_schema_info()` for tables, columns, indexes, constraints
+- **Auto-commit control** — `connection.autocommit` property for transaction management
+- **Server version detection** — `connection.get_server_version()` returns version string (e.g., `"11.2.0.0378"`)
+- **Iterator protocol** — iterate over cursor results with `for row in cursor`
+- **Context managers** — `with` statements for both connections and cursors
+
+## Supported CUBRID Versions
+
+The project targets CUBRID 11.x series and is validated in CI against:
+
+- 11.2
+- 11.4
+
+## SQLAlchemy Integration
+
+pycubrid works as a driver for [sqlalchemy-cubrid](https://github.com/cubrid-labs/sqlalchemy-cubrid) — the SQLAlchemy 2.0 dialect for CUBRID:
+
+```bash
+pip install "sqlalchemy-cubrid[pycubrid]"
+```
+
+```python
+from sqlalchemy import create_engine, text
+
+engine = create_engine("cubrid+pycubrid://dba@localhost:33000/testdb")
+
+with engine.connect() as conn:
+    result = conn.execute(text("SELECT 1"))
+    print(result.scalar())
+```
+
+All SQLAlchemy features (ORM, Core, Alembic migrations, schema reflection) work transparently with the pycubrid driver.
+
+## Documentation
+
+| Guide | Description |
+|---|---|
+| [Connection](docs/CONNECTION.md) | Connection strings, URL format, configuration, connection pool |
+| [Type Mapping](docs/TYPES.md) | Full type mapping, CUBRID-specific types, collection types |
+| [API Reference](docs/API_REFERENCE.md) | Complete API documentation — modules, classes, functions |
+| [Protocol](docs/PROTOCOL.md) | CAS wire protocol reference |
+| [Development](docs/DEVELOPMENT.md) | Dev setup, testing, Docker, coverage, CI/CD |
+| [Examples](docs/EXAMPLES.md) | Practical usage examples with code |
+| [Troubleshooting](docs/TROUBLESHOOTING.md) | Connection errors, query problems, LOB handling, debugging |
+
+## Compatibility
+
+| | Python 3.10 | Python 3.11 | Python 3.12 | Python 3.13 |
+|---|:---:|:---:|:---:|:---:|
+| **Offline Tests** | ✅ | ✅ | ✅ | ✅ |
+| **CUBRID 11.4** | ✅ | -- | ✅ | -- |
+| **CUBRID 11.2** | ✅ | -- | ✅ | -- |
+
+## Architecture
+
+```
+pycubrid/
+├── __init__.py       # Public API — connect(), types, exceptions, __version__
+├── connection.py     # Connection class — connect, commit, rollback, cursor, LOB
+├── cursor.py         # Cursor class — execute, fetch, prepare, callproc, iterator
+├── types.py          # DB-API 2.0 type objects and constructors
+├── exceptions.py     # PEP 249 exception hierarchy
+├── constants.py      # CAS function codes, data types, protocol constants
+├── protocol.py       # CAS wire protocol packet classes (18 packet types)
+├── packet.py         # Low-level packet reader/writer
+├── lob.py            # LOB (Large Object) support
+└── py.typed          # PEP 561 marker
+```
+
+## FAQ
+
+### How do I connect to CUBRID with Python?
+
+```python
+import pycubrid
+conn = pycubrid.connect(host="localhost", port=33000, database="testdb", user="dba")
+```
+
+### How do I install pycubrid?
+
+`pip install pycubrid` — no C extensions or build tools required.
+
+### What parameter style does pycubrid use?
+
+Question mark (`qmark`) style: `cursor.execute("SELECT * FROM users WHERE id = ?", (1,))`
+
+### Does pycubrid work with SQLAlchemy?
+
+Yes. Install `pip install "sqlalchemy-cubrid[pycubrid]"` and use the connection URL `cubrid+pycubrid://dba@localhost:33000/testdb`.
+
+### What Python versions are supported?
+
+Python 3.10, 3.11, 3.12, and 3.13.
+
+### Does pycubrid support LOBs (CLOB/BLOB)?
+
+Yes. Insert strings/bytes directly into CLOB/BLOB columns. For reading, LOB columns return data that can be accessed through the cursor.
+
+### Is pycubrid thread-safe?
+
+pycubrid has `threadsafety = 1`, meaning connections cannot be shared between threads. Create a separate connection per thread.
+
+### What CUBRID versions are supported?
+
+CUBRID 10.2, 11.0, 11.2, and 11.4 are tested in CI.
+
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines and [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for development setup.
+
+## Security
+
+Report vulnerabilities via email — see [SECURITY.md](SECURITY.md). Do not open public issues for security concerns.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

pycubrid-0.5.0/README.md

@@ -0,0 +1,243 @@
+# pycubrid
+
+**Pure Python DB-API 2.0 driver for the CUBRID database** — no C extensions, no compilation, PEP 249 compliant database connector.
+
+[🇰🇷 한국어](docs/README.ko.md) · [🇺🇸 English](README.md) · [🇨🇳 中文](docs/README.zh.md) · [🇮🇳 हिन्दी](docs/README.hi.md) · [🇩🇪 Deutsch](docs/README.de.md) · [🇷🇺 Русский](docs/README.ru.md)
+
+<!-- BADGES:START -->
+[![PyPI version](https://img.shields.io/pypi/v/pycubrid)](https://pypi.org/project/pycubrid)
+[![python version](https://img.shields.io/pypi/pyversions/pycubrid)](https://www.python.org)
+[![ci workflow](https://github.com/cubrid-labs/pycubrid/actions/workflows/ci.yml/badge.svg)](https://github.com/cubrid-labs/pycubrid/actions/workflows/ci.yml)
+[![license](https://img.shields.io/github/license/cubrid-labs/pycubrid)](https://github.com/cubrid-labs/pycubrid/blob/main/LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/cubrid-labs/pycubrid)](https://github.com/cubrid-labs/pycubrid)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![Coverage 99%](https://img.shields.io/badge/coverage-99%25-brightgreen.svg)](docs/DEVELOPMENT.md#code-coverage)
+<!-- BADGES:END -->
+
+---
+
+## Why pycubrid?
+
+CUBRID is a high-performance open-source relational database, widely adopted in
+Korean public-sector and enterprise applications. The existing C-extension driver
+(`CUBRIDdb`) had build dependencies and platform compatibility issues.
+
+**pycubrid** solves these problems:
+
+- **Pure Python implementation** — no C build dependencies, install with `pip install` only
+- **Full PEP 249 (DB-API 2.0) compliance** — standard exception hierarchy, type objects, cursor interface
+- **471 offline tests** with **99%+ code coverage** — no database required to run them
+- **PEP 561 typed package** — `py.typed` marker for modern IDE and static analysis support
+- **Direct CUBRID CAS protocol** implementation — no additional middleware required
+- **LOB (CLOB/BLOB) support** — handle large text and binary data
+
+## Requirements
+
+- Python 3.10+
+- CUBRID database server 10.2+
+
+## Installation
+
+```bash
+pip install pycubrid
+```
+
+## Quick Start
+
+### Basic Connection
+
+```python
+import pycubrid
+
+conn = pycubrid.connect(
+    host="localhost",
+    port=33000,
+    database="testdb",
+    user="dba",
+    password="",
+)
+
+cur = conn.cursor()
+cur.execute("SELECT 1 + 1")
+print(cur.fetchone())  # (2,)
+
+cur.close()
+conn.close()
+```
+
+### Context Manager
+
+```python
+import pycubrid
+
+with pycubrid.connect(host="localhost", port=33000, database="testdb", user="dba") as conn:
+    with conn.cursor() as cur:
+        cur.execute("CREATE TABLE IF NOT EXISTS cookbook_users (id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(100))")
+        cur.execute("INSERT INTO cookbook_users (name) VALUES (?)", ("Alice",))
+        conn.commit()
+
+        cur.execute("SELECT * FROM cookbook_users")
+        for row in cur:
+            print(row)
+```
+
+### Parameter Binding
+
+```python
+# qmark style (question marks)
+cur.execute("SELECT * FROM users WHERE name = ? AND age > ?", ("Alice", 25))
+
+# Batch insert with executemany
+data = [("Alice", 30), ("Bob", 25), ("Charlie", 35)]
+cur.executemany("INSERT INTO users (name, age) VALUES (?, ?)", data)
+conn.commit()
+```
+
+### Prepared Statements
+
+```python
+cur.prepare("SELECT * FROM users WHERE department = ?")
+cur.execute(None, ("Engineering",))
+engineers = cur.fetchall()
+
+cur.execute(None, ("Marketing",))
+marketers = cur.fetchall()
+```
+
+## PEP 249 Compliance
+
+| Attribute | Value |
+|---|---|
+| `apilevel` | `"2.0"` |
+| `threadsafety` | `1` (connections cannot be shared between threads) |
+| `paramstyle` | `"qmark"` (positional parameters `?`) |
+
+- Full standard exception hierarchy: `Warning`, `Error`, `InterfaceError`, `DatabaseError`, `OperationalError`, `IntegrityError`, `InternalError`, `ProgrammingError`, `NotSupportedError`
+- Standard type objects: `STRING`, `BINARY`, `NUMBER`, `DATETIME`, `ROWID`
+- Standard constructors: `Date()`, `Time()`, `Timestamp()`, `Binary()`, `DateFromTicks()`, `TimeFromTicks()`, `TimestampFromTicks()`
+
+## Features
+
+- **Pure Python** — no C extensions, no compilation, works everywhere Python runs
+- **Complete DB-API 2.0** — `connect()`, `Cursor`, `fetchone/many/all`, `executemany`, `callproc`
+- **Prepared statements** — `cursor.prepare()` / `cursor.execute()` for server-side preparation
+- **Batch operations** — `executemany()` and `executemany_batch()` for bulk inserts
+- **LOB support** — `create_lob()`, read/write CLOB and BLOB columns
+- **Schema introspection** — `get_schema_info()` for tables, columns, indexes, constraints
+- **Auto-commit control** — `connection.autocommit` property for transaction management
+- **Server version detection** — `connection.get_server_version()` returns version string (e.g., `"11.2.0.0378"`)
+- **Iterator protocol** — iterate over cursor results with `for row in cursor`
+- **Context managers** — `with` statements for both connections and cursors
+
+## Supported CUBRID Versions
+
+The project targets CUBRID 11.x series and is validated in CI against:
+
+- 11.2
+- 11.4
+
+## SQLAlchemy Integration
+
+pycubrid works as a driver for [sqlalchemy-cubrid](https://github.com/cubrid-labs/sqlalchemy-cubrid) — the SQLAlchemy 2.0 dialect for CUBRID:
+
+```bash
+pip install "sqlalchemy-cubrid[pycubrid]"
+```
+
+```python
+from sqlalchemy import create_engine, text
+
+engine = create_engine("cubrid+pycubrid://dba@localhost:33000/testdb")
+
+with engine.connect() as conn:
+    result = conn.execute(text("SELECT 1"))
+    print(result.scalar())
+```
+
+All SQLAlchemy features (ORM, Core, Alembic migrations, schema reflection) work transparently with the pycubrid driver.
+
+## Documentation
+
+| Guide | Description |
+|---|---|
+| [Connection](docs/CONNECTION.md) | Connection strings, URL format, configuration, connection pool |
+| [Type Mapping](docs/TYPES.md) | Full type mapping, CUBRID-specific types, collection types |
+| [API Reference](docs/API_REFERENCE.md) | Complete API documentation — modules, classes, functions |
+| [Protocol](docs/PROTOCOL.md) | CAS wire protocol reference |
+| [Development](docs/DEVELOPMENT.md) | Dev setup, testing, Docker, coverage, CI/CD |
+| [Examples](docs/EXAMPLES.md) | Practical usage examples with code |
+| [Troubleshooting](docs/TROUBLESHOOTING.md) | Connection errors, query problems, LOB handling, debugging |
+
+## Compatibility
+
+| | Python 3.10 | Python 3.11 | Python 3.12 | Python 3.13 |
+|---|:---:|:---:|:---:|:---:|
+| **Offline Tests** | ✅ | ✅ | ✅ | ✅ |
+| **CUBRID 11.4** | ✅ | -- | ✅ | -- |
+| **CUBRID 11.2** | ✅ | -- | ✅ | -- |
+
+## Architecture
+
+```
+pycubrid/
+├── __init__.py       # Public API — connect(), types, exceptions, __version__
+├── connection.py     # Connection class — connect, commit, rollback, cursor, LOB
+├── cursor.py         # Cursor class — execute, fetch, prepare, callproc, iterator
+├── types.py          # DB-API 2.0 type objects and constructors
+├── exceptions.py     # PEP 249 exception hierarchy
+├── constants.py      # CAS function codes, data types, protocol constants
+├── protocol.py       # CAS wire protocol packet classes (18 packet types)
+├── packet.py         # Low-level packet reader/writer
+├── lob.py            # LOB (Large Object) support
+└── py.typed          # PEP 561 marker
+```
+
+## FAQ
+
+### How do I connect to CUBRID with Python?
+
+```python
+import pycubrid
+conn = pycubrid.connect(host="localhost", port=33000, database="testdb", user="dba")
+```
+
+### How do I install pycubrid?
+
+`pip install pycubrid` — no C extensions or build tools required.
+
+### What parameter style does pycubrid use?
+
+Question mark (`qmark`) style: `cursor.execute("SELECT * FROM users WHERE id = ?", (1,))`
+
+### Does pycubrid work with SQLAlchemy?
+
+Yes. Install `pip install "sqlalchemy-cubrid[pycubrid]"` and use the connection URL `cubrid+pycubrid://dba@localhost:33000/testdb`.
+
+### What Python versions are supported?
+
+Python 3.10, 3.11, 3.12, and 3.13.
+
+### Does pycubrid support LOBs (CLOB/BLOB)?
+
+Yes. Insert strings/bytes directly into CLOB/BLOB columns. For reading, LOB columns return data that can be accessed through the cursor.
+
+### Is pycubrid thread-safe?
+
+pycubrid has `threadsafety = 1`, meaning connections cannot be shared between threads. Create a separate connection per thread.
+
+### What CUBRID versions are supported?
+
+CUBRID 10.2, 11.0, 11.2, and 11.4 are tested in CI.
+
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines and [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for development setup.
+
+## Security
+
+Report vulnerabilities via email — see [SECURITY.md](SECURITY.md). Do not open public issues for security concerns.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

pycubrid-0.5.0/pycubrid/__init__.py

@@ -0,0 +1,113 @@
+"""pycubrid — Pure Python DB-API 2.0 driver for CUBRID."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+from pycubrid.exceptions import (
+    DatabaseError,
+    DataError,
+    Error,
+    IntegrityError,
+    InterfaceError,
+    InternalError,
+    NotSupportedError,
+    OperationalError,
+    ProgrammingError,
+    Warning,
+)
+from pycubrid.types import (
+    BINARY,
+    DATETIME,
+    NUMBER,
+    ROWID,
+    STRING,
+    Binary,
+    Date,
+    DateFromTicks,
+    Time,
+    Timestamp,
+    TimestampFromTicks,
+    TimeFromTicks,
+)
+from pycubrid.lob import Lob
+
+if TYPE_CHECKING:
+    from pycubrid.connection import Connection
+
+__version__ = "0.5.0"
+
+# PEP 249 module-level attributes
+apilevel = "2.0"
+threadsafety = 1  # Threads may share the module but not connections
+paramstyle = "qmark"  # Question mark style: WHERE name = ?
+
+
+def connect(
+    host: str = "localhost",
+    port: int = 33000,
+    database: str = "",
+    user: str = "dba",
+    password: str = "",
+    **kwargs: Any,
+) -> Connection:
+    """Create a new database connection.
+
+    PEP 249 module-level constructor.
+
+    Args:
+        host: CUBRID server hostname or IP address.
+        port: CUBRID broker port (default 33000).
+        database: Database name.
+        user: Database user (default ``"dba"``).
+        password: Database password (default ``""``).
+        **kwargs: Additional connection parameters.
+
+    Returns:
+        A new :class:`~pycubrid.connection.Connection` instance.
+    """
+    from pycubrid.connection import Connection
+
+    return Connection(
+        host=host,
+        port=port,
+        database=database,
+        user=user,
+        password=password,
+        **kwargs,
+    )
+
+
+__all__ = [
+    "__version__",
+    "apilevel",
+    "threadsafety",
+    "paramstyle",
+    "connect",
+    # Exceptions
+    "Warning",
+    "Error",
+    "InterfaceError",
+    "DatabaseError",
+    "DataError",
+    "OperationalError",
+    "IntegrityError",
+    "InternalError",
+    "ProgrammingError",
+    "NotSupportedError",
+    # Type objects
+    "STRING",
+    "BINARY",
+    "NUMBER",
+    "DATETIME",
+    "ROWID",
+    # Constructors
+    "Date",
+    "Time",
+    "Timestamp",
+    "DateFromTicks",
+    "TimeFromTicks",
+    "TimestampFromTicks",
+    "Binary",
+    "Lob",
+]