funcguard 0.1.4__py3-none-any.whl → 0.1.6__py3-none-any.whl

funcguard/tools.py

@@ -68,30 +68,31 @@ def send_request(
 
 
 # 打印时间
-def time_log(message, i = 0, max_num = 0, s_time = None) :
+def time_log(message, i = 0, max_num = 0, s_time = None, start_from = 0 ) :
     """
     打印带时间戳的日志信息，支持进度显示和预计完成时间
     
     :param message: 日志消息
-    :param i: 当前进度（从0开始）
+    :param i: 当前进度
     :param max_num: 总进度数量
     :param s_time: 开始时间，用于计算预计完成时间
+    :param start_from: i是否从0开始，0表示从0开始，1表示从1开始
     :return: None
     """
     now = datetime.now( timezone( timedelta( hours = 8 ) ) )
     time_log = "{:02d}:{:02d}:{:02d}".format( now.hour, now.minute, now.second )
-    if i < 2 :
+    if i < 2 or max_num < 2 :
         print( time_log + " " + message )
+
     else :
-        if max_num == 0 :
-            text = "{}".format( i )
-        else :
-            text = "{}/{}".format( i, max_num )
+        # 根据start_from参数计算实际处理的项目数
+        process_item = i + 1 if start_from == 0 else i
+        text = "{}/{}".format( process_item, max_num )
         # 检查是否应该显示预计完成时间和剩余时间
-        if i % 10 == 0 and s_time is not None and i < max_num :
+        if process_item % 10 == 0 and s_time is not None and process_item < max_num :
             duration = now - s_time
-            ev_duration = duration / i  # 每项平均耗时
-            remaining_items = max_num - i
+            ev_duration = duration / process_item  # 每项平均耗时
+            remaining_items = max_num - process_item
             time_left = ev_duration * remaining_items
             end_time = now + time_left
             end_time_str = end_time.strftime( "%Y-%m-%d %H:%M" )

{funcguard-0.1.4.dist-info → funcguard-0.1.6.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: funcguard
-Version: 0.1.4
-Summary: A funcguard for Python.
+Version: 0.1.6
+Summary: FuncGuard是一个Python库，提供函数执行超时控制、重试机制、HTTP请求封装和格式化打印工具。
 Home-page: https://github.com/tinycen/funcguard
 Author: tinycen
 Author-email: sky_ruocen@qq.com
@@ -145,26 +145,42 @@ from funcguard import time_log, time_diff
 # 获取开始时间
 start_time = time_diff()
 
-# 记录任务开始
-time_log("开始处理数据", 0, 100, start_time)
+# 记录任务开始（i从0开始）
+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, start_time)  # 显示进度和预计完成时间
+        time_log(f"处理进度", i, 100, start_time, 0)  # 显示进度和预计完成时间
 
 # 记录任务完成并打印统计信息
-time_log("数据处理完成", 100, 100, start_time)
 time_diff(start_time, 100, "cn")  # 中文显示统计信息
 ```
 
+或者当i从1开始时：
+
+```python
+
+# 记录任务开始（i从1开始）
+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, start_time, 1)  # 显示进度和预计完成时间
+
+```
+
 时间日志功能特点：
 - 自动显示北京时间（UTC+8）
 - 支持进度显示和预计完成时间计算
 - 提供中英文双语统计信息
 - 可显示总耗时、平均耗时等详细统计
+- 支持i从0或从1开始的计数方式
 
 ## API文档
 
@@ -207,13 +223,14 @@ time_diff(start_time, 100, "cn")  # 中文显示统计信息
 - **返回值**: 根据return_type参数返回不同格式的响应数据
 - **异常**: 当请求失败且重试次数用尽后，抛出相应的异常
 
-#### time_log(message, i=0, max_num=0, s_time=None)
+#### time_log(message, i=0, max_num=0, s_time=None, start_from=0)
 
 - **参数**:
   - `message`: 日志消息
-  - `i`: 当前进度（从0开始），默认为0
+  - `i`: 当前进度，默认为0
   - `max_num`: 总进度数量，默认为0
   - `s_time`: 开始时间，用于计算预计完成时间，默认为None
+  - `start_from`: i是否从0开始，0表示从0开始，1表示从1开始，默认为0
 - **返回值**: 无
 - **功能**: 打印带时间戳的日志信息，支持进度显示和预计完成时间计算
 

{funcguard-0.1.4.dist-info → funcguard-0.1.6.dist-info}/RECORD

@@ -1,13 +1,13 @@
 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=S7t46KurOedvVKCVoFLW_CoDvLSC__lfVLUYBse5ABM,5433
+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.4.dist-info/LICENSE,sha256=jgOquECfjiXp5xXQ2zuzItDr4XDBLan-bIzIXl1lS4Y,1064
-funcguard-0.1.4.dist-info/METADATA,sha256=ayz3u_YGwUqH3ziy-awhbPMjWgFdPWYCxSQmTZJF-HI,7175
-funcguard-0.1.4.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-funcguard-0.1.4.dist-info/top_level.txt,sha256=7wL9mWT062DttKNO7Wi1wYWTZilR2AOPRO0rE3gvtB4,16
-funcguard-0.1.4.dist-info/RECORD,,
+funcguard-0.1.6.dist-info/LICENSE,sha256=jgOquECfjiXp5xXQ2zuzItDr4XDBLan-bIzIXl1lS4Y,1064
+funcguard-0.1.6.dist-info/METADATA,sha256=sT6MGwKqp1CyIaKpsmOdzWC7eg-16FOsUMG4XF3t4bM,7723
+funcguard-0.1.6.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
+funcguard-0.1.6.dist-info/top_level.txt,sha256=7wL9mWT062DttKNO7Wi1wYWTZilR2AOPRO0rE3gvtB4,16
+funcguard-0.1.6.dist-info/RECORD,,