funcguard 0.2.53__tar.gz → 0.2.54__tar.gz

{funcguard-0.2.53 → funcguard-0.2.54}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: funcguard
-Version: 0.2.53
+Version: 0.2.54
 Summary: FuncGuard是一个Python库，提供函数执行超时控制、重试机制、HTTP请求封装和格式化打印工具。
 Home-page: https://github.com/tinycen/funcguard
 Author: tinycen
@@ -589,8 +589,7 @@ print(f"当前价格: {current_price}, 变化: {price_change}")  # 输出: 当
 | `time_diff` | 耗时统计和计算 | [查看](docs/time_utils.md#time_diff) |
 | `time_monitor` | 函数执行时间监控和警告 | [查看](docs/time_utils.md#time_monitor) |
 | `time_wait` | 时间等待（带倒计时显示） | [查看](docs/time_utils.md#time_wait) |
-| `get_now` | 获取当前时间 | - |
-| `generate_timestamp` | 生成时间戳 | - |
+| `get_now` | 获取当前时间（支持多种格式输出） | - |
 | `cal_date_diff` | 计算日期差异 | - |
 
 ### 打印工具

{funcguard-0.2.53 → funcguard-0.2.54}/README.md

@@ -557,8 +557,7 @@ print(f"当前价格: {current_price}, 变化: {price_change}")  # 输出: 当
 | `time_diff` | 耗时统计和计算 | [查看](docs/time_utils.md#time_diff) |
 | `time_monitor` | 函数执行时间监控和警告 | [查看](docs/time_utils.md#time_monitor) |
 | `time_wait` | 时间等待（带倒计时显示） | [查看](docs/time_utils.md#time_wait) |
-| `get_now` | 获取当前时间 | - |
-| `generate_timestamp` | 生成时间戳 | - |
+| `get_now` | 获取当前时间（支持多种格式输出） | - |
 | `cal_date_diff` | 计算日期差异 | - |
 
 ### 打印工具

{funcguard-0.2.53 → funcguard-0.2.54}/funcguard/__init__.py

@@ -2,7 +2,7 @@ from .core import timeout_handler, retry_function, ask_select
 from .tools import send_request, curl_cffi_request, check_url_valid, encode_basic_auth, md5_hash
 from .time_utils import (
     time_log, time_diff, time_monitor, time_wait, color_logger,
-    get_now, generate_timestamp, cal_date_diff
+    get_now, cal_date_diff
 )
 
 from .printer import print_block, print_line, print_title, print_progress
@@ -68,7 +68,6 @@ __all__ = [
     "setup_logger",
     "color_logger",
     "get_now",
-    "generate_timestamp",
     "cal_date_diff",
 
     # 打印工具

{funcguard-0.2.53 → funcguard-0.2.54}/funcguard/time_utils.py

@@ -177,61 +177,62 @@ def time_monitor(warning_threshold=None, print_mode=2, func=None, *args, **kwarg
 
 
 # 获取当前的时间
-def get_now( from_timezone = "local", remove_tzinfo = True ):
+def get_now( from_timezone = "local", remove_tzinfo = True, fmt = None ):
+    """
+    获取当前时间，支持多种时区和输出格式。
+
+    :param from_timezone: 时区选择：
+        - "local": 本地时间（tz-naive，不含时区信息）。
+        - "utc": UTC时间（tz-aware，包含 UTC 时区信息）。
+        - "bj": 北京时间（tz-aware，包含 UTC+8 时区信息）。
+
+        naive vs aware 的区别：
+        - naive（无时区信息）：仅表示一个日期和时间，不知道自己处于哪个时区，其含义取决于运行环境。
+        - aware（有时区信息）：包含时区信息，能够准确定位自己在绝对时间轴上的位置。
+        - naive 和 aware 不能直接进行比较/计算，因为 naive 对象没有时区信息，无法确定其在时间轴上的具体位置。
+
+    :param remove_tzinfo: 是否移除时区信息，默认为 True（仅 fmt=None 时生效，影响返回的 datetime 对象）
+    :param fmt: 输出格式，默认为 None（返回 datetime 对象）：
+        - None: 返回 datetime 对象
+        - "millis": 返回毫秒级时间戳（int）
+        - "iso": 返回 ISO 8601 格式字符串，例如 2024-03-15T14:00:00；当 from_timezone="utc" 时自动追加 Z 后缀（Z = Zulu time = UTC+0）
+        - "str": 返回普通字符串，格式为 %Y-%m-%d %H:%M:%S
+    :return: datetime 对象 | int（毫秒时间戳） | str（格式化字符串）
+    """
     if from_timezone == "local" :
         now_time = datetime.now()  # 获取当前本地时间 (tz-naive) ，不包含时区信息
 
     elif from_timezone == "utc" :
         now_time = datetime.now( timezone.utc )  # 获取当前UTC时间 (tz-aware) ，包含时区信息
 
-    elif from_timezone == "beijing" :   # 固定北京时间 (tz-aware) ，包含时区信息
+    elif from_timezone == "bj" :   # 固定北京时间 (tz-aware) ，包含时区信息
         now_time = datetime.now( timezone( timedelta( hours = 8 ) ) )
 
-    else :    
-        raise ValueError( "Invalid timezone , must be 'local' , 'utc' , 'beijing' " )
-        
-    if remove_tzinfo:
-        return now_time.replace( tzinfo = None )
-
-    return now_time
-
-
-# 获取时间戳
-def generate_timestamp( from_timezone = "local", fmt = "millis", utc_z = False ) :
-    """
-    获取当前时间戳或格式化时间字符串
-    
-    :param from_timezone: 时区选择，决定返回的时间对象类型：
-        - "local": 返回本地时间的 naive 对象（不含时区信息）。
-        - "utc": 返回 UTC 时间的 aware 对象（包含 UTC 时区信息）。
-        - "beijing": 返回北京时间的 aware 对象（包含 UTC+8 时区信息）。
-        
-        naive vs aware 的区别：
-        - naive (无时区信息)：不包含时区信息的对象。它仅表示一个日期和时间，但不知道自己处于哪个时区。其含义取决于运行环境。
-        - aware (有时区信息)：包含时区信息的对象。它能够准确地定位自己在绝对时间轴上的位置。
-        - naive 和 aware 不能直接进行比较/计算，因为 naive 对象没有时区信息，无法确定其在时间轴上的具体位置。
+    else :
+        raise ValueError( "Invalid timezone , must be 'local' , 'utc' , 'bj' " )
 
-    :param utc_z: 是否在 UTC 的 iso 格式后追加 Z 标志 (仅在 fmt="iso" 且时区为 UTC 时有效)
-    :return: 根据 fmt 返回对应值
-    """
-    now_time = get_now( from_timezone, remove_tzinfo = False )
+    # 未指定 fmt 时，返回 datetime 对象
+    if fmt is None :
+        if remove_tzinfo :
+            return now_time.replace( tzinfo = None )
+        return now_time
 
-    # 格式化为ISO 8601标准格式
+    # 格式化为 ISO 8601 标准格式（UTC 时区自动追加 Z 后缀）
     if fmt == "iso" :
-        if from_timezone == "utc" and utc_z :
+        if from_timezone == "utc" :
             return now_time.strftime( '%Y-%m-%dT%H:%M:%SZ' )
-        
         return now_time.strftime( '%Y-%m-%dT%H:%M:%S' )
 
     # 转换为毫秒级时间戳
     elif fmt == "millis" :
         return int( now_time.timestamp() * 1000 )
 
+    # 格式化为普通字符串
     elif fmt == "str" :
         return now_time.strftime( '%Y-%m-%d %H:%M:%S' )
 
     else :
-        raise ValueError( "Invalid fmt , must be 'millis' , 'iso' or 'str'" )
+        raise ValueError( "Invalid fmt , must be None , 'millis' , 'iso' or 'str'" )
 
 
 # 计算日期差值

{funcguard-0.2.53 → funcguard-0.2.54}/funcguard.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: funcguard
-Version: 0.2.53
+Version: 0.2.54
 Summary: FuncGuard是一个Python库，提供函数执行超时控制、重试机制、HTTP请求封装和格式化打印工具。
 Home-page: https://github.com/tinycen/funcguard
 Author: tinycen
@@ -589,8 +589,7 @@ print(f"当前价格: {current_price}, 变化: {price_change}")  # 输出: 当
 | `time_diff` | 耗时统计和计算 | [查看](docs/time_utils.md#time_diff) |
 | `time_monitor` | 函数执行时间监控和警告 | [查看](docs/time_utils.md#time_monitor) |
 | `time_wait` | 时间等待（带倒计时显示） | [查看](docs/time_utils.md#time_wait) |
-| `get_now` | 获取当前时间 | - |
-| `generate_timestamp` | 生成时间戳 | - |
+| `get_now` | 获取当前时间（支持多种格式输出） | - |
 | `cal_date_diff` | 计算日期差异 | - |
 
 ### 打印工具

{funcguard-0.2.53 → funcguard-0.2.54}/setup.py

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