reydb 1.3.61__tar.gz

reydb-1.3.61/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

reydb-1.3.61/.python-version

@@ -0,0 +1 @@
+3.13

reydb-1.3.61/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 ReyXBo
+
+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.

reydb-1.3.61/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: reydb
+Version: 1.3.61
+Summary: Database method set.
+Project-URL: Homepage, https://www.reyxbo.com
+Project-URL: Repository, https://github.com/reyxbo/reydb-py.git
+Author-email: Rey <reyxbo@163.com>
+License: Copyright 2025 ReyXBo
+        
+        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.
+License-File: LICENSE
+Keywords: PostgreSQL,async,asynchronous,database,db,orm,postgres,rey,reyxbo
+Requires-Python: >=3.12
+Requires-Dist: asyncpg
+Requires-Dist: psycopg[binary]
+Requires-Dist: pydantic[email]
+Requires-Dist: reykit
+Requires-Dist: sqlalchemy==2.0.42
+Requires-Dist: sqlmodel
+Description-Content-Type: text/markdown
+
+# reydb
+
+> Backend database method set.
+
+## Install
+
+```
+pip install reydb
+```

reydb-1.3.61/README.md

@@ -0,0 +1,9 @@
+# reydb
+
+> Backend database method set.
+
+## Install
+
+```
+pip install reydb
+```

reydb-1.3.61/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "reydb"
+version = "1.3.61"
+description = "Database method set."
+readme = "README.md"
+requires-python = ">=3.12"
+license = {file = "LICENSE"}
+keywords = ["rey", "reyxbo", "PostgreSQL", "postgres", "db", "database", "orm", "async", "asynchronous"]
+authors = [
+    {name = "Rey", email = "reyxbo@163.com"}
+]
+dependencies = [
+    "asyncpg",
+    "psycopg[binary]",
+    "pydantic[email]",
+    "reykit",
+    "sqlalchemy==2.0.42",
+    "sqlmodel"
+]
+
+[project.urls]
+Homepage = "https://www.reyxbo.com"
+Repository = "https://github.com/reyxbo/reydb-py.git"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

reydb-1.3.61/src/reydb/__init__.py

@@ -0,0 +1,26 @@
+# !/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+@Time    : 2024-01-07
+@Author  : Rey
+@Contact : reyxbo@163.com
+@Explain : Backend database method set.
+
+Modules
+-------
+rall : All import methods.
+rbase : Base methods.
+rbuild : Database build methods.
+rconfig : Database config methods.
+rconn : Database connection methods.
+rdb : Database methods.
+rengine : Database engine methods.
+rerror : Database error methods.
+rexec : Database execute methods.
+rorm : Database ORM methods.
+rinfo : Database information methods.
+"""
+
+from .rdb import Database, DatabaseAsync
+from .rengine import DatabaseEngine, DatabaseEngineAsync

reydb-1.3.61/src/reydb/rall.py

@@ -0,0 +1,22 @@
+# !/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+@Time    : 2024-01-07
+@Author  : Rey
+@Contact : reyxbo@163.com
+@Explain : All import methods.
+"""
+
+# ruff: noqa: F403
+
+from .rbase import *
+from .rbuild import *
+from .rconfig import *
+from .rconn import *
+from .rdb import *
+from .rengine import *
+from .rerror import *
+from .rexec import *
+from .rorm import *
+from .rinfo import *

reydb-1.3.61/src/reydb/rbase.py

@@ -0,0 +1,314 @@
+# !/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+@Time    : 2025-07-18
+@Author  : Rey
+@Contact : reyxbo@163.com
+@Explain : Base methods.
+"""
+
+from typing import Any, TypedDict, Literal, TypeVar
+from enum import EnumType
+from sqlalchemy import Engine, Connection, Transaction, text as sqlalchemy_text, bindparam as sqlalchemy_bindparam
+from sqlalchemy.orm import Session, SessionTransaction
+from sqlalchemy.ext.asyncio import AsyncEngine, AsyncConnection, AsyncTransaction, AsyncSession, AsyncSessionTransaction
+from sqlalchemy.engine.url import URL
+from sqlalchemy.sql.elements import TextClause
+from reykit.rbase import Base, throw
+from reykit.rre import search
+from reykit.rdata import to_json
+from reykit.rre import findall
+
+__all__ = (
+    'DatabaseBase',
+    'handle_sql_data',
+    'extract_url',
+    'extract_engine',
+    'get_syntax',
+    'is_multi_sql'
+)
+
+EngineT = TypeVar('EngineT', Engine, AsyncEngine)
+ConnectionT = TypeVar('ConnectionT', Connection, AsyncConnection)
+TransactionT = TypeVar('TransactionT', Transaction, AsyncTransaction)
+SessionT = TypeVar('SessionT', Session, AsyncSession)
+SessionTransactionT = TypeVar('SessionTransactionT', SessionTransaction, AsyncSessionTransaction)
+
+URLParameters = TypedDict(
+    'URLParameters',
+    {
+        'drivername': str,
+        'backend': str,
+        'driver': str | None,
+        'username': str | None,
+        'password': str | None,
+        'host': str | None,
+        'port': str | None,
+        'database': str | None,
+        'query': dict[str, str] | None
+    }
+)
+
+class DatabaseBase(Base):
+    """
+    Database base type.
+    """
+
+def handle_sql_data(sql: str | TextClause, data: list[dict]) -> tuple[TextClause, list[dict]]:
+    """
+    Handle sql and data.
+
+    Parameters
+    ----------
+    sql : SQL in method `sqlalchemy.text` format, or TextClause object.
+    data : Data set for filling.
+
+    Returns
+    -------
+    TextClause instance and filled data.
+    """
+
+    # Parameter.
+    if type(sql) is TextClause:
+        sql = sql.text
+
+    ## Extract keys.
+    pattern = '(?<!\\\\):(\\w+)'
+    sql_keys = findall(pattern, sql)
+
+    ## Extract keys of syntax "in".
+    pattern = '[iI][nN]\\s+(?<!\\\\):(\\w+)'
+    sql_keys_in = findall(pattern, sql)
+
+    # Handle SQL.
+    sql = sql.strip()
+    if sql[-1] != ';':
+        sql += ';'
+    sql = sqlalchemy_text(sql)
+    if len(data) != 0:
+        row = data[0]
+        for key, value in row.items():
+            if key in sql_keys_in:
+                param = sqlalchemy_bindparam(key, expanding=True)
+                sql = sql.bindparams(param)
+
+    # Handle data.
+    for row in data:
+        if row == {}:
+            continue
+        for key in sql_keys:
+            value = row.get(key)
+
+            # Empty string.
+            if value == '':
+                value = None
+
+            # JSON.
+            elif (
+                isinstance(value, list)
+                and key not in sql_keys_in
+            ) or isinstance(value, dict):
+                value = to_json(value)
+
+            # Array.
+            elif isinstance(value, tuple):
+                value = list(value)
+
+            # Enum.
+            elif isinstance(type(value), EnumType):
+                value = value.value
+
+            row[key] = value
+
+    return sql, data
+
+def extract_url(url: str | URL) -> URLParameters:
+    """
+    Extract parameters from URL of string.
+
+    Parameters
+    ----------
+    url : URL of string.
+
+    Returns
+    -------
+    URL parameters.
+    """
+
+    # Extract.
+    match url:
+
+        ## Type str.
+        case str():
+            pattern_remote = r'^([^+]+)\+?([^:]+)??://([^:]+):([^@]+)@([^:]+):(\d+)[/]?([^\?]+)?\??(\S+)?$'
+            pattern_local = r'^([^+]+)\+?([^:]+)??:////?([^\?]+)[\?]?(\S+)?$'
+
+            ### Server.
+            if (result_remote := search(pattern_remote, url)) is not None:
+                (
+                    backend,
+                    driver,
+                    username,
+                    password,
+                    host,
+                    port,
+                    database,
+                    query_str
+                ) = result_remote
+                port = int(port)
+
+            ### SQLite.
+            elif (result_local := search(pattern_local, url)) is not None:
+                username = password = host = port = None
+                (
+                    backend,
+                    driver,
+                    database,
+                    query_str
+                ) = result_local
+
+            ### Throw exception.
+            else:
+                throw(ValueError, url)
+
+            if query_str is not None:
+                query = {
+                    key: value
+                    for query_item_str in query_str.split('&')
+                    for key, value in (query_item_str.split('=', 1),)
+                }
+            else:
+                query = {}
+
+        ## Type URL.
+        case URL():
+            drivername = url.drivername
+            username = url.username
+            password = url.password
+            host = url.host
+            port = url.port
+            database = url.database
+            query = dict(url.query)
+
+    ## Drivername.
+    if driver is None:
+        drivername = backend
+    else:
+        drivername = f'{backend}+{driver}'
+
+    # Generate parameter.
+    params = {
+        'drivername': drivername,
+        'backend': backend,
+        'driver': driver,
+        'username': username,
+        'password': password,
+        'host': host,
+        'port': port,
+        'database': database,
+        'query': query
+    }
+
+    return params
+
+def extract_engine(engine: Engine | Connection) -> dict[
+    Literal[
+        'drivername', 'username', 'password', 'host', 'port', 'database', 'query',
+        'pool_size', 'max_overflow', 'pool_timeout', 'pool_recycle'
+    ],
+    Any
+]:
+    """
+    Extract parameters from `Engine` or `Connection` object.
+
+    Parameters
+    ----------
+    engine : Engine or Connection object.
+
+    Returns
+    -------
+    Extracted parameters.
+    """
+
+    ## Extract Engine object from Connection boject.
+    if type(engine) is Connection:
+        engine = engine.engine
+
+    ## Extract.
+    drivername: str = engine.url.drivername
+    username: str | None = engine.url.username
+    password: str | None = engine.url.password
+    host: str | None = engine.url.host
+    port: str | None = engine.url.port
+    database: str | None = engine.url.database
+    query: dict[str, str] = dict(engine.url.query)
+    pool_size: int = engine.pool._pool.maxsize
+    max_overflow: int = engine.pool._max_overflow
+    pool_timeout: float = engine.pool._timeout
+    pool_recycle: int = engine.pool._recycle
+
+    # Generate parameter.
+    params = {
+        'drivername': drivername,
+        'username': username,
+        'password': password,
+        'host': host,
+        'port': port,
+        'database': database,
+        'query': query,
+        'pool_size': pool_size,
+        'max_overflow': max_overflow,
+        'pool_timeout': pool_timeout,
+        'pool_recycle': pool_recycle
+    }
+
+    return params
+
+def get_syntax(self, sql: str | TextClause) -> list[str]:
+    """
+    Extract SQL syntax type for each segment form SQL.
+
+    Parameters
+    ----------
+    sql : SQL text or TextClause object.
+
+    Returns
+    -------
+    SQL syntax type for each segment.
+    """
+
+    # Parameter.
+    if type(sql) is TextClause:
+        sql = sql.text
+
+    # Extract.
+    syntax = [
+        search('[a-zA-Z]+', sql_part).upper()
+        for sql_part in sql.split(';')
+        if sql_part != ''
+    ]
+
+    return syntax
+
+def is_multi_sql(self, sql: str | TextClause) -> bool:
+    """
+    Judge whether it is multi segment SQL.
+
+    Parameters
+    ----------
+    sql : SQL text or TextClause object.
+
+    Returns
+    -------
+    Judgment result.
+    """
+
+    # Parameter.
+    if type(sql) is TextClause:
+        sql = sql.text
+
+    # Judge.
+    if ';' in sql.rstrip()[:-1]:
+        return True
+    return False