funcguard 0.1.5__tar.gz → 0.1.7__tar.gz

{funcguard-0.1.5 → funcguard-0.1.7}/PKG-INFO

@@ -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
@@ -110,10 +110,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个'-'字符
@@ -145,41 +149,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")  # 中文显示统计信息
 ```
 
 时间日志功能特点：
@@ -230,14 +226,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
 - **返回值**: 无
 - **功能**: 打印带时间戳的日志信息，支持进度显示和预计完成时间计算
 
@@ -260,6 +256,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.5 → funcguard-0.1.7}/README.md

@@ -96,10 +96,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个'-'字符
@@ -131,41 +135,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")  # 中文显示统计信息
 ```
 
 时间日志功能特点：
@@ -216,14 +212,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
 - **返回值**: 无
 - **功能**: 打印带时间戳的日志信息，支持进度显示和预计完成时间计算
 
@@ -246,6 +242,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.5 → funcguard-0.1.7}/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-0.1.5 → funcguard-0.1.7}/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-0.1.5 → funcguard-0.1.7}/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 → funcguard-0.1.7}/funcguard.egg-info/PKG-INFO

@@ -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
@@ -110,10 +110,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个'-'字符
@@ -145,41 +149,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")  # 中文显示统计信息
 ```
 
 时间日志功能特点：
@@ -230,14 +226,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
 - **返回值**: 无
 - **功能**: 打印带时间戳的日志信息，支持进度显示和预计完成时间计算
 
@@ -260,6 +256,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.5 → funcguard-0.1.7}/setup.py

@@ -9,7 +9,7 @@ except FileNotFoundError:
 
 setup(
     name='funcguard',
-    version='0.1.5',
+    version='0.1.7',
     packages=find_packages(),
     install_requires=[
         'requests',