funcguard 0.1.5__py3-none-any.whl → 0.1.7__py3-none-any.whl

funcguard/__init__.py

@@ -1,6 +1,6 @@
 from .core import timeout_handler, retry_function
 from .tools import send_request, time_log, time_diff
-from .printer import print_block, print_line
+from .printer import print_block, print_line, print_title
 
 __author__ = "ruocen"
 
@@ -13,4 +13,5 @@ __all__ = [
     "time_diff",
     "print_block",
     "print_line",
+    "print_title",
 ]

funcguard/printer.py

@@ -1,5 +1,18 @@
 from typing import Any
 
+# 打印带等号的标题（如：=== 初始化分类器 ===）
+def print_title(title: str, separator_char: str = "=", padding_length: int = 3) -> None:
+    """
+    打印带分隔符的标题，格式如：=== 初始化分类器 ===
+    
+    :param title: 标题内容
+    :param separator_char: 分隔符字符，默认为'='
+    :param padding_length: 标题两侧的分隔符数量，默认为3
+    """
+    separator = separator_char * padding_length
+    print(f"{separator} {title} {separator}")
+
+
 # 打印分隔线
 def print_line(separator_char: str = "-", separator_length: int = 40) -> None:
     """

funcguard/tools.py

@@ -68,15 +68,15 @@ def send_request(
 
 
 # 打印时间
-def time_log(message, i = 0, max_num = 0, start_from = 0, s_time = None,) :
+def time_log(message, i = 0, max_num = 0, s_time = None, start_from = 0 ) :
     """
     打印带时间戳的日志信息，支持进度显示和预计完成时间
     
     :param message: 日志消息
     :param i: 当前进度
     :param max_num: 总进度数量
-    :param start_from: i是否从0开始，0表示从0开始，1表示从1开始
     :param s_time: 开始时间，用于计算预计完成时间
+    :param start_from: i是否从0开始，0表示从0开始，1表示从1开始
     :return: None
     """
     now = datetime.now( timezone( timedelta( hours = 8 ) ) )

{funcguard-0.1.5.dist-info → funcguard-0.1.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: funcguard
-Version: 0.1.5
+Version: 0.1.7
 Summary: FuncGuard是一个Python库，提供函数执行超时控制、重试机制、HTTP请求封装和格式化打印工具。
 Home-page: https://github.com/tinycen/funcguard
 Author: tinycen
@@ -111,10 +111,14 @@ print(response)
 
 ### 格式化打印
 
-使用`print_line`和`print_block`函数进行格式化打印，便于查看和调试：
+使用`print_line`、`print_block`和`print_title`函数进行格式化打印，便于查看和调试：
 
 ```python
-from funcguard import print_line, print_block
+from funcguard import print_line, print_block, print_title
+
+# 打印带等号的标题
+print_title("初始化分类器")  # 输出：=== 初始化分类器 ===
+print_title("训练完成", separator_char="*", padding_length=2)  # 输出：** 训练完成 **
 
 # 打印分隔线
 print_line()  # 默认使用40个'-'字符
@@ -146,41 +150,33 @@ from funcguard import time_log, time_diff
 start_time = time_diff()
 
 # 记录任务开始（i从0开始）
-time_log("开始处理数据", 0, 100, 0, start_time)
+time_log("开始处理数据", 0, 100, start_time, 0)
 
 # 模拟处理过程
 import time
 for i in range(1, 101):
     time.sleep(0.1)  # 模拟处理时间
     if i % 20 == 0:
-        time_log(f"处理进度", i, 100, 0, start_time)  # 显示进度和预计完成时间
+        time_log(f"处理进度", i, 100, start_time, 0)  # 显示进度和预计完成时间
 
 # 记录任务完成并打印统计信息
-time_log("数据处理完成", 100, 100, 0, start_time)
 time_diff(start_time, 100, "cn")  # 中文显示统计信息
 ```
 
 或者当i从1开始时：
 
 ```python
-from funcguard import time_log, time_diff
-
-# 获取开始时间
-start_time = time_diff()
 
 # 记录任务开始（i从1开始）
-time_log("开始处理数据", 1, 100, 1, start_time)
+time_log("开始处理数据", 1, 100, start_time, 1)
 
 # 模拟处理过程
 import time
 for i in range(1, 101):
     time.sleep(0.1)  # 模拟处理时间
     if i % 20 == 0:
-        time_log(f"处理进度", i, 100, 1, start_time)  # 显示进度和预计完成时间
+        time_log(f"处理进度", i, 100, start_time, 1)  # 显示进度和预计完成时间
 
-# 记录任务完成并打印统计信息
-time_log("数据处理完成", 100, 100, 1, start_time)
-time_diff(start_time, 100, "cn")  # 中文显示统计信息
 ```
 
 时间日志功能特点：
@@ -231,14 +227,14 @@ time_diff(start_time, 100, "cn")  # 中文显示统计信息
 - **返回值**: 根据return_type参数返回不同格式的响应数据
 - **异常**: 当请求失败且重试次数用尽后，抛出相应的异常
 
-#### time_log(message, i=0, max_num=0, start_from=0, s_time=None)
+#### time_log(message, i=0, max_num=0, s_time=None, start_from=0)
 
 - **参数**:
   - `message`: 日志消息
   - `i`: 当前进度，默认为0
   - `max_num`: 总进度数量，默认为0
-  - `start_from`: i是否从0开始，0表示从0开始，1表示从1开始，默认为0
   - `s_time`: 开始时间，用于计算预计完成时间，默认为None
+  - `start_from`: i是否从0开始，0表示从0开始，1表示从1开始，默认为0
 - **返回值**: 无
 - **功能**: 打印带时间戳的日志信息，支持进度显示和预计完成时间计算
 
@@ -261,6 +257,15 @@ time_diff(start_time, 100, "cn")  # 中文显示统计信息
 - **返回值**: 无
 - **功能**: 打印分隔线，用于分隔不同的打印块
 
+#### print_title(title: str, separator_char: str = "=", padding_length: int = 3) -> None
+
+- **参数**:
+  - `title`: 标题内容
+  - `separator_char`: 分隔符字符，默认为'='
+  - `padding_length`: 标题两侧的分隔符数量，默认为3
+- **返回值**: 无
+- **功能**: 打印带分隔符的标题，格式如：=== 初始化分类器 ===
+
 #### print_block(title: str, content: Any, separator_char: str = "-", separator_length: int = 40) -> None
 
 - **参数**:

funcguard-0.1.7.dist-info/RECORD

@@ -0,0 +1,13 @@
+funcguard/__init__.py,sha256=l8GqIAv1jbaq4fLEYsfrfm4Epk8EUoP1BfvwCdwr0Zw,374
+funcguard/core.py,sha256=-rFRkE-udxM0wxlcv9Qi_yIQBRdVrGgwza-LYQsVRLg,3632
+funcguard/printer.py,sha256=Iig_UO4h5LcL0BqCEEdxiu32h4rUq9GJbmf1pC_hd7o,1462
+funcguard/tools.py,sha256=YIrr1qFWEU61R5Plk5UXGAyp9yGJrm28-POhNsttZsg,5623
+tests/__init__.py,sha256=VW6FdWdSC_PL3zEtpkRQfUMf6yVD2OfwtSds82jawTs,26
+tests/run_test.py,sha256=-SLdUV7gDifLxuCCAlU8qLxYMx6KpK4cxfG4UYfUIgA,1005
+tests/test_core.py,sha256=aZNbQK4eTnnkCI4c2txYZNTcYIUhSJvII5Dvn0vNJKo,3732
+tests/test_tools.py,sha256=g9dK-WW1s5SIobscRuelufBfPrSgNLZU8d1AJteBpd0,5609
+funcguard-0.1.7.dist-info/LICENSE,sha256=jgOquECfjiXp5xXQ2zuzItDr4XDBLan-bIzIXl1lS4Y,1064
+funcguard-0.1.7.dist-info/METADATA,sha256=xx4YUVNhJ0F--Cmjm9eUAzxE-LNchoBnuuyeZ0kbw1Y,8304
+funcguard-0.1.7.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
+funcguard-0.1.7.dist-info/top_level.txt,sha256=7wL9mWT062DttKNO7Wi1wYWTZilR2AOPRO0rE3gvtB4,16
+funcguard-0.1.7.dist-info/RECORD,,

funcguard-0.1.5.dist-info/RECORD

@@ -1,13 +0,0 @@
-funcguard/__init__.py,sha256=iyM7STP-KSxUn7PUaBWEQcZus2XskiGTTweI4qjoETE,342
-funcguard/core.py,sha256=-rFRkE-udxM0wxlcv9Qi_yIQBRdVrGgwza-LYQsVRLg,3632
-funcguard/printer.py,sha256=c93x6Z-6a7nnead_Rk_f0Xe23kdVdSj4qaxsuBMKfd0,958
-funcguard/tools.py,sha256=jpmZFEEepzeEHLahbV0SwVZDy1I_mwB5MxeLFspMR6U,5623
-tests/__init__.py,sha256=VW6FdWdSC_PL3zEtpkRQfUMf6yVD2OfwtSds82jawTs,26
-tests/run_test.py,sha256=-SLdUV7gDifLxuCCAlU8qLxYMx6KpK4cxfG4UYfUIgA,1005
-tests/test_core.py,sha256=aZNbQK4eTnnkCI4c2txYZNTcYIUhSJvII5Dvn0vNJKo,3732
-tests/test_tools.py,sha256=g9dK-WW1s5SIobscRuelufBfPrSgNLZU8d1AJteBpd0,5609
-funcguard-0.1.5.dist-info/LICENSE,sha256=jgOquECfjiXp5xXQ2zuzItDr4XDBLan-bIzIXl1lS4Y,1064
-funcguard-0.1.5.dist-info/METADATA,sha256=pi5iZvJkeJKPh-Ix3uptlcLwxuDl5SnyGg8THa-PS0k,8027
-funcguard-0.1.5.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-funcguard-0.1.5.dist-info/top_level.txt,sha256=7wL9mWT062DttKNO7Wi1wYWTZilR2AOPRO0rE3gvtB4,16
-funcguard-0.1.5.dist-info/RECORD,,