terryutils 1.0.3__tar.gz

terryutils-1.0.3/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.1
+Name: terryutils
+Version: 1.0.3
+Summary: My personal python toolkit
+Author-email: Terry Zhu <596480606@qq.com>
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+
+# your-toolkit
+
+个人 Python 工具包
+
+## 安装
+
+```bash
+pip install TerryUtils

terryutils-1.0.3/README.md

@@ -0,0 +1,8 @@
+# your-toolkit
+
+个人 Python 工具包
+
+## 安装
+
+```bash
+pip install TerryUtils

terryutils-1.0.3/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "terryutils"               # pip install 用这个
+version = "1.0.3"
+description = "My personal python toolkit"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+  { name="Terry Zhu", email="596480606@qq.com" }
+]
+
+dependencies = [
+  "requests>=2.28.0"
+]
+
+[tool.setuptools.packages.find]
+where = ["."]

terryutils-1.0.3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

terryutils-1.0.3/terryutils/__init__.py

@@ -0,0 +1,2 @@
+from .mysql_util import MysqlUtil
+from .log import setup_logger

terryutils-1.0.3/terryutils/log.py

@@ -0,0 +1,32 @@
+import logging
+import os
+from logging.handlers import TimedRotatingFileHandler
+
+# 配置日志
+def setup_logger(app_name="MyApp", log_dir="./logs"):
+    os.makedirs(log_dir, exist_ok=True)
+    log_filename = os.path.join(log_dir, f'{app_name}.log')  # 固定名字，滚动文件自动加日期
+    logger = logging.getLogger(app_name)
+    logger.setLevel(logging.DEBUG)
+
+    # 每天生成一个新文件，保留30天
+    file_handler = TimedRotatingFileHandler(
+        log_filename, when='midnight', interval=1, backupCount=30, encoding='utf-8'
+    )
+    file_handler.setLevel(logging.DEBUG)
+
+    console_handler = logging.StreamHandler()
+    console_handler.setLevel(logging.INFO)
+
+    formatter = logging.Formatter(
+        '%(asctime)s - %(name)s - %(levelname)s - %(message)s',
+        datefmt='%Y-%m-%d %H:%M:%S'
+    )
+    file_handler.setFormatter(formatter)
+    console_handler.setFormatter(formatter)
+
+    logger.handlers = []
+    logger.addHandler(file_handler)
+    logger.addHandler(console_handler)
+
+    return logger

terryutils-1.0.3/terryutils/mysql_util.py

@@ -0,0 +1,108 @@
+import pymysql
+import traceback
+
+import pymysql
+from pymysql.cursors import DictCursor
+
+class MysqlUtil:
+    def __init__(self, host, user, password, database, port=3306, dict_result=False, debug=True):
+        """
+        初始化数据库连接
+        :param dict_result: 是否返回 dict
+        :param debug: 是否打印 SQL 调试信息
+        """
+        self.conn_params = {
+            "host": host,
+            "user": user,
+            "password": password,
+            "database": database,
+            "port": port,
+            "charset": "utf8mb4",
+            "autocommit": False,  # 手动事务管理
+        }
+        if dict_result:
+            self.conn_params["cursorclass"] = DictCursor
+
+        self.conn = None
+        self.debug = debug
+        self._connect()
+
+    def _connect(self):
+        """建立连接"""
+        self.conn = pymysql.connect(**self.conn_params)
+
+    def _ensure_connection(self):
+        """确保连接可用，失效时自动重连"""
+        try:
+            self.conn.ping(reconnect=True)
+        except Exception:
+            self._connect()
+
+    def _execute(self, func, sql=None, params=None):
+        """
+        通用执行器，保证 commit/rollback
+        """
+        self._ensure_connection()
+        try:
+            if self.debug and sql:
+                # print(f"[DEBUG SQL] {sql} | params={params}")
+                pass
+            result = func()
+            self.conn.commit()
+            return result
+        except Exception:
+            traceback.print_exc()
+            self.conn.rollback()
+            raise
+
+    def execute(self, sql, params=None):
+        """执行单条增删改"""
+        def run():
+            with self.conn.cursor() as cursor:
+                return cursor.execute(sql, params or ())
+        return self._execute(run, sql, params)
+
+    def execute_by_sqls(self, sqls):
+        """执行多条 SQL"""
+        def run():
+            with self.conn.cursor() as cursor:
+                for sql in sqls:
+                    if self.debug:
+                        print(f"[DEBUG SQL] {sql}")
+                    cursor.execute(sql)
+        return self._execute(run)
+
+    def executemany(self, sql, param_list):
+        """批量执行"""
+        def run():
+            with self.conn.cursor() as cursor:
+                return cursor.executemany(sql, param_list)
+        return self._execute(run, sql, param_list)
+
+    def fetchone(self, sql, params=None):
+        """查询一条"""
+        def run():
+            with self.conn.cursor() as cursor:
+                cursor.execute(sql, params or ())
+                return cursor.fetchone()
+        return self._execute(run, sql, params)
+
+    def fetchall(self, sql, params=None):
+        """查询多条"""
+        def run():
+            with self.conn.cursor() as cursor:
+                cursor.execute(sql, params or ())
+                return cursor.fetchall()
+        return self._execute(run, sql, params)
+
+    def close(self):
+        """关闭连接"""
+        if self.conn:
+            self.conn.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+

terryutils-1.0.3/terryutils.egg-info/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.1
+Name: terryutils
+Version: 1.0.3
+Summary: My personal python toolkit
+Author-email: Terry Zhu <596480606@qq.com>
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+
+# your-toolkit
+
+个人 Python 工具包
+
+## 安装
+
+```bash
+pip install TerryUtils

terryutils-1.0.3/terryutils.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+terryutils/__init__.py
+terryutils/log.py
+terryutils/mysql_util.py
+terryutils.egg-info/PKG-INFO
+terryutils.egg-info/SOURCES.txt
+terryutils.egg-info/dependency_links.txt
+terryutils.egg-info/requires.txt
+terryutils.egg-info/top_level.txt

terryutils-1.0.3/terryutils.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

terryutils-1.0.3/terryutils.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.28.0

terryutils-1.0.3/terryutils.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+dist
+terryutils