funcguard 0.2.43__tar.gz → 0.2.45__tar.gz

{funcguard-0.2.43 → funcguard-0.2.45}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: funcguard
-Version: 0.2.43
+Version: 0.2.45
 Summary: FuncGuard是一个Python库，提供函数执行超时控制、重试机制、HTTP请求封装和格式化打印工具。
 Home-page: https://github.com/tinycen/funcguard
 Author: tinycen
@@ -34,7 +34,7 @@ FuncGuard是一个Python库，提供了函数执行超时控制和重试机制
 
 | 分类 | 功能描述 | 文档 |
 |------|----------|------|
-| **核心功能** | 函数执行超时控制、函数执行失败自动重试 | - |
+| **核心功能** | 函数执行超时控制、函数执行失败自动重试、交互式选择菜单 | - |
 | **网络请求** | HTTP请求封装（支持自动重试）、MD5哈希、Basic Auth编码 | [查看](./docs/network.md) |
 | **时间工具** | 时间日志记录、耗时统计、执行时间监控和警告、时间等待（带倒计时） | [查看](./docs/time_utils.md) |
 | **打印工具** | 格式化分隔线、块打印、标题打印、进度条显示 | - |
@@ -95,6 +95,41 @@ except Exception as e:
     print(f"重试后仍然失败: {e}")
 ```
 
+### 交互式选择菜单
+
+使用 `ask_select` 函数创建一个带数字编号的交互式选择菜单（编号从0开始），支持超时自动选择和倒计时动态显示：
+
+```python
+from funcguard import ask_select
+
+# 基础用法 - 选择属性填写模式
+result = ask_select(
+    options={True: "需要填写属性", False: "不需要填写属性", "all": "不限制"},
+    default_key="all",
+    prompt="请选择属性填写模式",
+    timeout=5
+)
+print(f"用户选择: {result}")  # 返回 True, False 或 "all"
+
+# 选择部署环境
+env = ask_select(
+    options={"dev": "开发环境", "test": "测试环境", "prod": "生产环境"},
+    default_key="dev",
+    prompt="请选择部署环境",
+    timeout=3
+)
+print(f"当前环境: {env}")
+
+# 选择数量（使用整数作为键）
+count = ask_select(
+    options={10: "10条", 50: "50条", 100: "100条"},
+    default_key=50,
+    prompt="查询数量",
+    timeout=5
+)
+print(f"查询 {count} 条数据")
+```
+
 ### HTTP请求
 
 FuncGuard 提供了强大的 HTTP 请求功能，支持自动重试、请求日志记录、以及 curl_cffi 兜底（用于绕过反爬虫检测）。详细文档请参考 [network.md](docs/network.md)。
@@ -496,6 +531,7 @@ print(f"当前价格: {current_price}, 变化: {price_change}")  # 输出: 当
 |-----------|----------|
 | `timeout_handler` | 函数执行超时控制 |
 | `retry_function` | 函数执行失败自动重试 |
+| `ask_select` | 交互式数字选择菜单（支持超时自动选择） |
 
 ### 网络请求
 

{funcguard-0.2.43 → funcguard-0.2.45}/README.md

@@ -7,7 +7,7 @@ FuncGuard是一个Python库，提供了函数执行超时控制和重试机制
 
 | 分类 | 功能描述 | 文档 |
 |------|----------|------|
-| **核心功能** | 函数执行超时控制、函数执行失败自动重试 | - |
+| **核心功能** | 函数执行超时控制、函数执行失败自动重试、交互式选择菜单 | - |
 | **网络请求** | HTTP请求封装（支持自动重试）、MD5哈希、Basic Auth编码 | [查看](./docs/network.md) |
 | **时间工具** | 时间日志记录、耗时统计、执行时间监控和警告、时间等待（带倒计时） | [查看](./docs/time_utils.md) |
 | **打印工具** | 格式化分隔线、块打印、标题打印、进度条显示 | - |
@@ -68,6 +68,41 @@ except Exception as e:
     print(f"重试后仍然失败: {e}")
 ```
 
+### 交互式选择菜单
+
+使用 `ask_select` 函数创建一个带数字编号的交互式选择菜单（编号从0开始），支持超时自动选择和倒计时动态显示：
+
+```python
+from funcguard import ask_select
+
+# 基础用法 - 选择属性填写模式
+result = ask_select(
+    options={True: "需要填写属性", False: "不需要填写属性", "all": "不限制"},
+    default_key="all",
+    prompt="请选择属性填写模式",
+    timeout=5
+)
+print(f"用户选择: {result}")  # 返回 True, False 或 "all"
+
+# 选择部署环境
+env = ask_select(
+    options={"dev": "开发环境", "test": "测试环境", "prod": "生产环境"},
+    default_key="dev",
+    prompt="请选择部署环境",
+    timeout=3
+)
+print(f"当前环境: {env}")
+
+# 选择数量（使用整数作为键）
+count = ask_select(
+    options={10: "10条", 50: "50条", 100: "100条"},
+    default_key=50,
+    prompt="查询数量",
+    timeout=5
+)
+print(f"查询 {count} 条数据")
+```
+
 ### HTTP请求
 
 FuncGuard 提供了强大的 HTTP 请求功能，支持自动重试、请求日志记录、以及 curl_cffi 兜底（用于绕过反爬虫检测）。详细文档请参考 [network.md](docs/network.md)。
@@ -469,6 +504,7 @@ print(f"当前价格: {current_price}, 变化: {price_change}")  # 输出: 当
 |-----------|----------|
 | `timeout_handler` | 函数执行超时控制 |
 | `retry_function` | 函数执行失败自动重试 |
+| `ask_select` | 交互式数字选择菜单（支持超时自动选择） |
 
 ### 网络请求
 

{funcguard-0.2.43 → funcguard-0.2.45}/funcguard/__init__.py

@@ -1,4 +1,4 @@
-from .core import timeout_handler, retry_function
+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,
@@ -50,6 +50,7 @@ __all__ = [
     # 核心功能
     "timeout_handler",
     "retry_function",
+    "ask_select",
 
     # 网络请求工具
     "md5_hash",

{funcguard-0.2.43 → funcguard-0.2.45}/funcguard/core.py

@@ -1,15 +1,17 @@
+import time
+from concurrent.futures import ThreadPoolExecutor , TimeoutError
+
+
 class FuncguardTimeoutError(Exception):
     """
     funcguard库专用的超时异常类。
-    
+
     为了避免与concurrent.futures.TimeoutError和Python内置TimeoutError的命名冲突，
     特定义此异常类来明确表示这是funcguard库抛出的函数执行超时异常。
     这样用户可以清晰地区分异常来源，并进行针对性的异常处理。
     """
     pass
 
-import time
-from concurrent.futures import ThreadPoolExecutor , TimeoutError
 
 # 计算函数运行时间
 def timeout_handler( func, args = (), kwargs = None, execution_timeout = 90 ):
@@ -86,3 +88,94 @@ def retry_function( func , max_retries = 5 , execute_timeout = 90 , task_name =
     if last_exception:
         raise last_exception  # 重新抛出最后一个异常
     return None
+
+
+# 交互式选择菜单
+def ask_select(
+    options: dict,
+    default_key = None,
+    prompt: str = "请选择",
+    timeout: int = 5,
+):
+    """
+    显示一个数字选择菜单，接受用户输入，超时自动返回默认值。
+
+    参数:
+        options: 字典，键为选项标识（任意类型），值为显示文本
+                 例如: {True: "需要填写属性", False: "不需要填写属性", "all": "不限制"}
+        default_key: 超时或输入无效时的默认返回值，若为None则使用最后一个选项的键
+        prompt: 提示语前缀
+        timeout: 超时时间（秒），默认5秒
+
+    返回:
+        用户选择的选项键（options中的某个键），或default_key
+
+    示例:
+        >>> result = ask_select(
+        ...     {True: "需要填写属性", False: "不需要填写属性", "all": "不限制"},
+        ...     default_key="all",
+        ...     prompt="请选择属性填写模式",
+        ...     timeout=5,
+        ... )
+    """
+    # 确保选项非空
+    if not options:
+        raise ValueError("options字典不能为空")
+
+    # 设置默认值
+    if default_key is None:
+        default_key = list(options.keys())[-1]
+
+    # 构建选项列表（保持字典顺序）
+    items = list(options.items())
+
+    # 显示选项
+    option_lines = ", ".join([f"{i}-{label}" for i, (_, label) in enumerate(items)])
+    default_label = options.get(default_key, default_key)
+
+    # 使用线程实现跨平台超时输入
+    from threading import Thread
+    from queue import Queue, Empty
+
+    result_queue = Queue()
+
+    def input_thread():
+        try:
+            user_input = input().strip()
+            result_queue.put(user_input)
+        except EOFError:
+            result_queue.put(None)
+
+    thread = Thread(target=input_thread, daemon=True)
+    thread.start()
+
+    # 倒计时显示
+    remaining = timeout
+    while remaining > 0 and thread.is_alive():
+        print(f"\r{prompt} ({option_lines})，{remaining} 秒后自动选择[{default_label}]: ", end="", flush=True)
+        time.sleep(1)
+        remaining -= 1
+
+    # 等待线程结束（如果用户已输入）或超时
+    thread.join(0)
+
+    try:
+        user_input = result_queue.get_nowait()
+    except Empty:
+        user_input = None
+
+    if user_input is None:
+        print(f"\n超时，自动选择[{default_label}]")
+        return default_key
+
+    # 验证输入
+    try:
+        choice = int(user_input)
+        if 1 <= choice <= len(items):
+            return items[choice - 1][0]
+    except ValueError:
+        pass
+
+    # 输入无效，返回默认值
+    print(f"输入无效，使用默认选项[{default_label}]")
+    return default_key

{funcguard-0.2.43 → funcguard-0.2.45}/funcguard.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: funcguard
-Version: 0.2.43
+Version: 0.2.45
 Summary: FuncGuard是一个Python库，提供函数执行超时控制、重试机制、HTTP请求封装和格式化打印工具。
 Home-page: https://github.com/tinycen/funcguard
 Author: tinycen
@@ -34,7 +34,7 @@ FuncGuard是一个Python库，提供了函数执行超时控制和重试机制
 
 | 分类 | 功能描述 | 文档 |
 |------|----------|------|
-| **核心功能** | 函数执行超时控制、函数执行失败自动重试 | - |
+| **核心功能** | 函数执行超时控制、函数执行失败自动重试、交互式选择菜单 | - |
 | **网络请求** | HTTP请求封装（支持自动重试）、MD5哈希、Basic Auth编码 | [查看](./docs/network.md) |
 | **时间工具** | 时间日志记录、耗时统计、执行时间监控和警告、时间等待（带倒计时） | [查看](./docs/time_utils.md) |
 | **打印工具** | 格式化分隔线、块打印、标题打印、进度条显示 | - |
@@ -95,6 +95,41 @@ except Exception as e:
     print(f"重试后仍然失败: {e}")
 ```
 
+### 交互式选择菜单
+
+使用 `ask_select` 函数创建一个带数字编号的交互式选择菜单（编号从0开始），支持超时自动选择和倒计时动态显示：
+
+```python
+from funcguard import ask_select
+
+# 基础用法 - 选择属性填写模式
+result = ask_select(
+    options={True: "需要填写属性", False: "不需要填写属性", "all": "不限制"},
+    default_key="all",
+    prompt="请选择属性填写模式",
+    timeout=5
+)
+print(f"用户选择: {result}")  # 返回 True, False 或 "all"
+
+# 选择部署环境
+env = ask_select(
+    options={"dev": "开发环境", "test": "测试环境", "prod": "生产环境"},
+    default_key="dev",
+    prompt="请选择部署环境",
+    timeout=3
+)
+print(f"当前环境: {env}")
+
+# 选择数量（使用整数作为键）
+count = ask_select(
+    options={10: "10条", 50: "50条", 100: "100条"},
+    default_key=50,
+    prompt="查询数量",
+    timeout=5
+)
+print(f"查询 {count} 条数据")
+```
+
 ### HTTP请求
 
 FuncGuard 提供了强大的 HTTP 请求功能，支持自动重试、请求日志记录、以及 curl_cffi 兜底（用于绕过反爬虫检测）。详细文档请参考 [network.md](docs/network.md)。
@@ -496,6 +531,7 @@ print(f"当前价格: {current_price}, 变化: {price_change}")  # 输出: 当
 |-----------|----------|
 | `timeout_handler` | 函数执行超时控制 |
 | `retry_function` | 函数执行失败自动重试 |
+| `ask_select` | 交互式数字选择菜单（支持超时自动选择） |
 
 ### 网络请求
 

{funcguard-0.2.43 → funcguard-0.2.45}/setup.py

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