ezKit 1.12.7__py3-none-any.whl → 1.12.9__py3-none-any.whl

ezKit/database.py

@@ -14,7 +14,7 @@ from typing import Any, Type
 
 import pandas as pd
 from loguru import logger
-from sqlalchemy import CursorResult, Index, create_engine, text
+from sqlalchemy import CursorResult, Engine, Index, create_engine, text
 from sqlalchemy.orm import DeclarativeBase, Session, declarative_base
 
 from . import utils
@@ -67,14 +67,71 @@ def orm_to_dict(obj, include: list | None = None) -> dict | list | None:
         return None
 
 
+def build_raw_where_clause(data: dict) -> tuple[str, list] | None:
+    """
+    将字段数据转换为 SQL WHERE 条件(使用原生 SQL)
+    支持字段后缀操作: __like, __gt, __lt, __ne, __in, __between
+    返回值: SQL字符串和参数列表 (为了避免 SQL 注入风险, 不直接返回 SQL 语句)
+    """
+
+    try:
+
+        sql_parts = []
+        params = []
+
+        for field, value in data.items():
+
+            if "__" in field:
+
+                base, op = field.split("__", 1)
+
+                if op == "like":
+                    sql_parts.append(f"{base} LIKE %s")
+                    params.append(f"%{value}%")
+                elif op == "gt":
+                    sql_parts.append(f"{base} > %s")
+                    params.append(value)
+                elif op == "lt":
+                    sql_parts.append(f"{base} < %s")
+                    params.append(value)
+                elif op == "ne":
+                    sql_parts.append(f"{base} != %s")
+                    params.append(value)
+                elif op == "in" and isinstance(value, list):
+                    placeholders = ", ".join(["%s"] * len(value))
+                    sql_parts.append(f"{base} IN ({placeholders})")
+                    params.extend(value)
+                elif op == "between" and isinstance(value, list) and len(value) == 2:
+                    sql_parts.append(f"{base} BETWEEN %s AND %s")
+                    params.extend(value)
+
+            else:
+
+                sql_parts.append(f"{field} = %s")
+                params.append(value)
+
+        where_clause = " AND ".join(sql_parts)
+
+        return where_clause, params
+
+    except Exception as e:
+        logger.exception(e)
+        return None
+
+
+# --------------------------------------------------------------------------------------------------
+
+
 class Database:
     """Database"""
 
     engine = create_engine("sqlite://")
 
-    def __init__(self, target: str | None = None, **options):
+    def __init__(self, engine: Engine | None = None, target: str | None = None, **options):
         """Initiation"""
-        if isinstance(target, str) and utils.isTrue(target, str):
+        if engine is not None:
+            self.engine = engine
+        elif isinstance(target, str) and utils.isTrue(target, str):
             if utils.isTrue(options, dict):
                 self.engine = create_engine(target, **options)
             else:

{ezkit-1.12.7.dist-info → ezkit-1.12.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ezKit
-Version: 1.12.7
+Version: 1.12.9
 Summary: Easy Kit
 Author: septvean
 Author-email: septvean@gmail.com

{ezkit-1.12.7.dist-info → ezkit-1.12.9.dist-info}/RECORD

@@ -3,7 +3,7 @@ ezKit/_file.py,sha256=0qRZhwYuagTgTGrhm-tzAMvEQT4HTJA_xZKqF2bo0ho,1207
 ezKit/bottle.py,sha256=43h4v1kzz6qrLvCt5IMN0H-gFtaT0koG9wETqteXsps,181666
 ezKit/bottle_extensions.py,sha256=27rogmfK7mL2qUSjXH79IMGZbCVULtYEikql_N9O6Zs,1165
 ezKit/cipher.py,sha256=7jBarRH7ukSYzkz-Anl8B8JzluhnRz4CLHidPRRj_cg,2939
-ezKit/database.py,sha256=1_RmCwLA6kzigcMcewkoOYStkhFd_w-Qn84vGy-tInI,15553
+ezKit/database.py,sha256=ELGWG865NREOPosU2vQ723juns9cWe9YM0IDAHYpfaE,17478
 ezKit/dockerhub.py,sha256=j-wQO-71BsOgExHZhYynuy2k_hCX3on-vg0TH7QCit4,1996
 ezKit/http.py,sha256=zhNxJF-x91UqGncXWxVXnhZVpFo_wmmpGnMXVT11y9E,1832
 ezKit/markdown_to_html.template,sha256=21G2sSVGJn6aJvHd0NN4zY5YiDteKe4UtW36AzBwSdk,22274
@@ -15,8 +15,8 @@ ezKit/token.py,sha256=Ac-i9xfq4TqpGyfCzakjrh4NYzxHiN2sCQrMk1tzVi8,1716
 ezKit/utils.py,sha256=VyAw2yEs15VER9RCpMgskx1l0zrSpRlV34X___eOia0,42416
 ezKit/xftp.py,sha256=-XQXyhMqeigT63P6sXkSS7r4GROXyqqlkzKxITLWG-g,8278
 ezKit/zabbix.py,sha256=PkMnfu7mcuotwwIIsHaC9FsNg-gap6hD1xvm0AwSL1Y,33777
-ezkit-1.12.7.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-ezkit-1.12.7.dist-info/METADATA,sha256=1uzq8FpjYS1rIP8iewgixWFGzahSaQe32exFrp2xYyc,316
-ezkit-1.12.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-ezkit-1.12.7.dist-info/top_level.txt,sha256=aYLB_1WODsqNTsTFWcKP-BN0KCTKcV-HZJ4zlHkCFw8,6
-ezkit-1.12.7.dist-info/RECORD,,
+ezkit-1.12.9.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+ezkit-1.12.9.dist-info/METADATA,sha256=YevXxco-dLFiNfXfl32UpHll2BRFUOQRcJ6k3JqIc_w,316
+ezkit-1.12.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ezkit-1.12.9.dist-info/top_level.txt,sha256=aYLB_1WODsqNTsTFWcKP-BN0KCTKcV-HZJ4zlHkCFw8,6
+ezkit-1.12.9.dist-info/RECORD,,