funcguard 0.1.4__tar.gz → 0.1.5__tar.gz

{funcguard-0.1.4/funcguard.egg-info → funcguard-0.1.5}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: funcguard
-Version: 0.1.4
-Summary: A funcguard for Python.
+Version: 0.1.5
+Summary: FuncGuard是一个Python库，提供函数执行超时控制、重试机制、HTTP请求封装和格式化打印工具。
 Home-page: https://github.com/tinycen/funcguard
 Author: tinycen
 Author-email: sky_ruocen@qq.com
@@ -144,18 +144,41 @@ from funcguard import time_log, time_diff
 # 获取开始时间
 start_time = time_diff()
 
-# 记录任务开始
-time_log("开始处理数据", 0, 100, start_time)
+# 记录任务开始（i从0开始）
+time_log("开始处理数据", 0, 100, 0, start_time)
 
 # 模拟处理过程
 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, 0, start_time)  # 显示进度和预计完成时间
 
 # 记录任务完成并打印统计信息
-time_log("数据处理完成", 100, 100, start_time)
+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)
+
+# 模拟处理过程
+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("数据处理完成", 100, 100, 1, start_time)
 time_diff(start_time, 100, "cn")  # 中文显示统计信息
 ```
 
@@ -164,6 +187,7 @@ time_diff(start_time, 100, "cn")  # 中文显示统计信息
 - 支持进度显示和预计完成时间计算
 - 提供中英文双语统计信息
 - 可显示总耗时、平均耗时等详细统计
+- 支持i从0或从1开始的计数方式
 
 ## API文档
 
@@ -206,12 +230,13 @@ 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, start_from=0, s_time=None)
 
 - **参数**:
   - `message`: 日志消息
-  - `i`: 当前进度（从0开始），默认为0
+  - `i`: 当前进度，默认为0
   - `max_num`: 总进度数量，默认为0
+  - `start_from`: i是否从0开始，0表示从0开始，1表示从1开始，默认为0
   - `s_time`: 开始时间，用于计算预计完成时间，默认为None
 - **返回值**: 无
 - **功能**: 打印带时间戳的日志信息，支持进度显示和预计完成时间计算

funcguard-0.1.4/PKG-INFO → funcguard-0.1.5/README.md

@@ -1,17 +1,3 @@
-Metadata-Version: 2.1
-Name: funcguard
-Version: 0.1.4
-Summary: A funcguard for Python.
-Home-page: https://github.com/tinycen/funcguard
-Author: tinycen
-Author-email: sky_ruocen@qq.com
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-
 # FuncGuard
 
 FuncGuard是一个Python库，提供了函数执行超时控制和重试机制的实用工具。
@@ -144,18 +130,41 @@ from funcguard import time_log, time_diff
 # 获取开始时间
 start_time = time_diff()
 
-# 记录任务开始
-time_log("开始处理数据", 0, 100, start_time)
+# 记录任务开始（i从0开始）
+time_log("开始处理数据", 0, 100, 0, start_time)
+
+# 模拟处理过程
+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("数据处理完成", 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)
 
 # 模拟处理过程
 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, 1, start_time)  # 显示进度和预计完成时间
 
 # 记录任务完成并打印统计信息
-time_log("数据处理完成", 100, 100, start_time)
+time_log("数据处理完成", 100, 100, 1, start_time)
 time_diff(start_time, 100, "cn")  # 中文显示统计信息
 ```
 
@@ -164,6 +173,7 @@ time_diff(start_time, 100, "cn")  # 中文显示统计信息
 - 支持进度显示和预计完成时间计算
 - 提供中英文双语统计信息
 - 可显示总耗时、平均耗时等详细统计
+- 支持i从0或从1开始的计数方式
 
 ## API文档
 
@@ -206,12 +216,13 @@ 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, start_from=0, s_time=None)
 
 - **参数**:
   - `message`: 日志消息
-  - `i`: 当前进度（从0开始），默认为0
+  - `i`: 当前进度，默认为0
   - `max_num`: 总进度数量，默认为0
+  - `start_from`: i是否从0开始，0表示从0开始，1表示从1开始，默认为0
   - `s_time`: 开始时间，用于计算预计完成时间，默认为None
 - **返回值**: 无
 - **功能**: 打印带时间戳的日志信息，支持进度显示和预计完成时间计算
@@ -247,4 +258,4 @@ time_diff(start_time, 100, "cn")  # 中文显示统计信息
 
 ## 许可证
 
-MIT License
+MIT License

{funcguard-0.1.4 → funcguard-0.1.5}/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, start_from = 0, s_time = None,) :
     """
     打印带时间戳的日志信息，支持进度显示和预计完成时间
     
     :param message: 日志消息
-    :param i: 当前进度（从0开始）
+    :param i: 当前进度
     :param max_num: 总进度数量
+    :param start_from: i是否从0开始，0表示从0开始，1表示从1开始
     :param s_time: 开始时间，用于计算预计完成时间
     :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/README.md → funcguard-0.1.5/funcguard.egg-info/PKG-INFO

@@ -1,3 +1,17 @@
+Metadata-Version: 2.1
+Name: funcguard
+Version: 0.1.5
+Summary: FuncGuard是一个Python库，提供函数执行超时控制、重试机制、HTTP请求封装和格式化打印工具。
+Home-page: https://github.com/tinycen/funcguard
+Author: tinycen
+Author-email: sky_ruocen@qq.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
 # FuncGuard
 
 FuncGuard是一个Python库，提供了函数执行超时控制和重试机制的实用工具。
@@ -130,18 +144,41 @@ from funcguard import time_log, time_diff
 # 获取开始时间
 start_time = time_diff()
 
-# 记录任务开始
-time_log("开始处理数据", 0, 100, start_time)
+# 记录任务开始（i从0开始）
+time_log("开始处理数据", 0, 100, 0, start_time)
+
+# 模拟处理过程
+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("数据处理完成", 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)
 
 # 模拟处理过程
 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, 1, start_time)  # 显示进度和预计完成时间
 
 # 记录任务完成并打印统计信息
-time_log("数据处理完成", 100, 100, start_time)
+time_log("数据处理完成", 100, 100, 1, start_time)
 time_diff(start_time, 100, "cn")  # 中文显示统计信息
 ```
 
@@ -150,6 +187,7 @@ time_diff(start_time, 100, "cn")  # 中文显示统计信息
 - 支持进度显示和预计完成时间计算
 - 提供中英文双语统计信息
 - 可显示总耗时、平均耗时等详细统计
+- 支持i从0或从1开始的计数方式
 
 ## API文档
 
@@ -192,12 +230,13 @@ 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, start_from=0, s_time=None)
 
 - **参数**:
   - `message`: 日志消息
-  - `i`: 当前进度（从0开始），默认为0
+  - `i`: 当前进度，默认为0
   - `max_num`: 总进度数量，默认为0
+  - `start_from`: i是否从0开始，0表示从0开始，1表示从1开始，默认为0
   - `s_time`: 开始时间，用于计算预计完成时间，默认为None
 - **返回值**: 无
 - **功能**: 打印带时间戳的日志信息，支持进度显示和预计完成时间计算
@@ -233,4 +272,4 @@ time_diff(start_time, 100, "cn")  # 中文显示统计信息
 
 ## 许可证
 
-MIT License
+MIT License

{funcguard-0.1.4 → funcguard-0.1.5}/setup.py

@@ -9,14 +9,14 @@ except FileNotFoundError:
 
 setup(
     name='funcguard',
-    version='0.1.4',
+    version='0.1.5',
     packages=find_packages(),
     install_requires=[
         'requests',
     ],
     author='tinycen',
     author_email='sky_ruocen@qq.com',
-    description='A funcguard for Python.',
+    description='FuncGuard是一个Python库，提供函数执行超时控制、重试机制、HTTP请求封装和格式化打印工具。',
     long_description=long_description,
     long_description_content_type='text/markdown',
     url='https://github.com/tinycen/funcguard',