Luci-Code-Tools 2.1.2__tar.gz → 2.1.4__tar.gz

{luci_code_tools-2.1.2 → luci_code_tools-2.1.4}/Luci_Code_Tools.egg-info/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: Luci-Code-Tools
-Version: 2.1.2
-Summary: 安全输入工具库,支持彩色输出,KeyboardInterrupt保护等
+Version: 2.1.4
+Summary: 一个简单的工具库 / A Eazy Tools Module
 Home-page: https://github.com/Luci-Codeing/code_tools
 Author: Luci_Code
 Author-email: 3967742419@qq.com
@@ -20,7 +20,7 @@ Dynamic: license-file
 Dynamic: requires-python
 Dynamic: summary
 
-[![PyPI version](https://badge.fury.io/py/luci-code-tools.svg)](https://pypi.org/project/luci-code-tools/)
+[![PyPI version](https://badge.fury.io/py/Luci_Code_Tools.svg)](https://pypi.org/project/Luci_Code_Tools/)
 
 [![Python Version](https://img.shields.io/badge/Python-3.6+-blue.svg)]()
 
@@ -118,8 +118,8 @@ MIT Licence (c) Luci_Code
 
 | 函数名 | 功能 | 参数列表 |
 | --- | --- | --- |
-| color_rgb | 输出真彩色文本, 支持 rgb 调色 | data, r, g, b, newline |
-| color | 输出 ANSI 转义序列固定颜色, 适合不会调色的开发者 | data, text_color, bg_color, mode, newline |
+| color_rgb | 输出真彩色文本, 支持 rgb 调色 | data, r, g, b, line |
+| color | 输出 ANSI 转义序列固定颜色, 适合不会调色的开发者 | data, text_color, bg_color, mode, line |
 | clear_screen | 在任意系统下都能清屏的函数 | 无参数 |
 | safe_input | 让用户安全的输入字符串 | prompt, text_color, bg_color, mode |
 | safe_int | 让用户安全的输入整数 | prompt, text_color, bg_color, mode |
@@ -129,27 +129,32 @@ MIT Licence (c) Luci_Code
 
 # 参数使用教程
 
-**newline** 是指在原本的基础上再输出一行, 默认为 True (多一行)
+**line** 是指在原本的基础上再输出 ** {num} ** 行, 默认为 2 (多一行)
 
 ***输出效果:***
 
-- newline=True :
+line = 1 : [
+    content1
+    content2
+    input: Luci
+]
 
-content-1 (此处为 False)
-content-2
+line = 2 : [
+    content1 (line = 1)
+    content2
 
-input: content
+    input: Luci
+]
 
-if-content-prompt
+line = 3 : [
+    content1 (line = 1)
+    content2
 
-- newline=False :
 
-content-1
-content-2
-input: content
-if-content-prompt
+    input: Luci
+]
 
-**这一改动让命令行的输出变得有辨识度, 高级**
+**这一改动让命令行的输出变得有辨识度**
 
 **data, prompt** 都是 *输出的文本* 的意思
 
@@ -157,13 +162,13 @@ if-content-prompt
 
 - **color_rgb**
 
-**color_rgb** 的参数有: data, r, g, b, newline
+**color_rgb** 的参数有: data, r, g, b, line
 
-**其中**, data 是数据的意思, 代表输出的内容, [r, g, b] 是 ***标准 rgb 调色*** 的用处, 所以 [r, g, b] 分别填入 r, g, b 的值, newline 不用讲解, 前面说了喵
+**其中**, data 是数据的意思, 代表输出的内容, [r, g, b] 是 ***标准 rgb 调色*** 的用处, 所以 [r, g, b] 分别填入 r, g, b 的值, line 不用讲解, 前面说了喵
 
 - **color**
 
-**color** 的参数有: data, text_color, bg_color, mode, newline
+**color** 的参数有: data, text_color, bg_color, mode, line
 
 **data** 和之前一样, ***[text_color, bg_color, mode]***, 这三个参数在 safe_\* 中也有, 意思相同, 暂不讲解, **text_color** 就是控制输出的文本的颜色**(前景色)**, bg_color** 是输出文本的**背景色**, **mode** 为输出的格式 **(显示方式)**, 这三个参数在最后会有**表格对照表**
 
@@ -259,6 +264,7 @@ if-content-prompt
 # 制作者 & 感谢名单
 
 | 制作 | 分工 |
+| --- | --- |
 | DeepSeek | 检查 |
 | DeepSeek | 改进方法 |
 | Luci_Code | 改进 |
@@ -371,8 +377,8 @@ MIT License (c) Luci_Code
 
 | Function Name | Functionality | Parameter List |
 | --- | --- | --- |
-| color_rgb | Outputs true-color text; supports RGB color customization. | data, r, g, b, newline |
-| color | Outputs text using fixed ANSI escape sequence colors; suitable for developers unfamiliar with color mixing. | data, text_color, bg_color, mode, newline |
+| color_rgb | Outputs true-color text; supports RGB color customization. | data, r, g, b, line |
+| color | Outputs text using fixed ANSI escape sequence colors; suitable for developers unfamiliar with color mixing. | data, text_color, bg_color, mode, line |
 | clear_screen | A function that clears the screen on any operating system. | No parameters |
 | safe_input | Safely prompts the user to input a string. | prompt, text_color, bg_color, mode |
 | safe_int | Safely prompts the user to input an integer. | prompt, text_color, bg_color, mode |
@@ -382,11 +388,11 @@ MIT License (c) Luci_Code
 
 # Parameter Usage Guide
 
-**newline** refers to whether an additional line break is added after the output; it defaults to `True` (adding an extra line).
+**line** refers to whether an additional line break is added after the output; it defaults to `True` (adding an extra line).
 
 ***Output Effect:***
 
-- `newline=True`:
+- `line=True`:
 
 content-1 (Here, this implies `False`)
 content-2
@@ -395,7 +401,7 @@ input: content
 
 if-content-prompt
 
-- `newline=False`:
+- `line=False`:
 
 content-1
 content-2
@@ -410,13 +416,13 @@ if-content-prompt
 
 - ​​**color_rgb**
 
-The parameters for **color_rgb** are: data, r, g, b, newline.
+The parameters for **color_rgb** are: data, r, g, b, line.
 
-**Specifically:** `data` refers to the actual content being output; `[r, g, b]` are used for ***standard RGB color mixing***—simply fill in the respective values ​​for r, g, and b. The `newline` parameter requires no further explanation, as it was covered earlier!
+**Specifically:** `data` refers to the actual content being output; `[r, g, b]` are used for ***standard RGB color mixing***—simply fill in the respective values ​​for r, g, and b. The `line` parameter requires no further explanation, as it was covered earlier!
 
 - **color**
 
-The parameters for **color** are: `data`, `text_color`, `bg_color`, `mode`, and `newline`.
+The parameters for **color** are: `data`, `text_color`, `bg_color`, `mode`, and `line`.
 
 **data**: As before, this takes the format `[text_color, bg_color, mode]`. These three parameters also appear in the `safe_*` functions with the same meanings, so we won't explain them again here. **text_color** controls the color of the output text (the **foreground color**); **bg_color** controls the **background color** of the output text; and **mode** specifies the output format (the **display style**). A **reference table** for these three parameters can be found at the end of this document.
 
@@ -512,6 +518,7 @@ The explanations for these two functions are essentially identical to that of **
 # Credits & Acknowledgments
 
 | Contributor | Role |
+| --- | --- |
 | DeepSeek | Review |
 | DeepSeek | Method Improvement |
 | Luci_Code | Improvements |

{luci_code_tools-2.1.2 → luci_code_tools-2.1.4}/Luci_code_tools.py

@@ -1,250 +1,246 @@
-from sys import platform, exit
-from subprocess import run
-from typing import Optional, Union
-import shutil
-
-__version__ = "2.1.2" # 明确版本号
-__all__ = [
-    'color', 'color_rgb', 'clear_screen',
-    'safe_input', 'safe_int', 'safe_float'
-] # 确定导出后的代码可用的函数
-
-class _AnsiCode: # AnsiCode 类
-    ESC = "\033"
-    RESET = f"{ESC}[0m"
-    @staticmethod # 我忘了这什么意思🤪 (并非忘了😂)
-    def build(mode: int = 0, fg: Optional[int] = None, bg: Optional[int] = None) -> str:
-        parts = []
-        if mode != 0:
-            parts.append(str(mode))
-        if fg is not None:
-            parts.append(str(fg))
-        if bg is not None:
-            parts.append(str(bg))
-        if parts:
-            return f"{_AnsiCode.ESC}[{';'.join(parts)}m"
-        return ""
-
-def _ansi_return(data: str, text_color: Optional[int] = None, bg_color: Optional[int] = None, mode: int = 0) -> str: # 6767676767 !
-    """ 生成ANSI彩色文本(不自动输出)
-
-    参数:
-        data: 要着色的文本内容
-        text_color: 前景色代码 (30-37普通色, 90-97亮色)
-        bg_color: 背景色代码 (40-47普通色, 100-107亮色)
-        mode: 显示方式 (0=默认,1=粗体,2=暗淡,3=斜体,4=下划线,5=闪烁,7=反色,8=隐藏,9=删除线)
-
-    返回:
-        带ANSI转义序列的字符串
-    """
-
-    if text_color is None and bg_color is None: # 如果 text_color 和 bg_color 不是 None
-        return data
-
-    ansi = _AnsiCode.build(mode, text_color, bg_color)
-    return f"{ansi}{data}{_AnsiCode.RESET}"
-
-def _ansi_rgb(data: str, r: int, g: int, b: int, mode: int = 0) -> str: # 这啥意思
-    """ 内部函数 """
-    if mode == 0:
-        return f"{_AnsiCode.ESC}[38;2;{r};{g};{b}m{data}{_AnsiCode.RESET}"
-    else:
-        return f"{_AnsiCode.ESC}[{mode};38;2;{r};{g};{b}m{data}{_AnsiCode.RESET}"
-
-def color_rgb(data: str, r: int, g: int, b: int, mode: int = 0, newline: bool = True) -> None: # 用户输出 RGB 彩色字符
-    """ 输出 rgb 字符 """
-    if newline:
-        end="\n\n"
-    else:
-        end="\n"
-    print(_ansi_rgb(data, r, g, b, mode), end=end)
-
-def color(data: str, text_color: Optional[int] = None, bg_color: Optional[int] = None, mode: int = 0, newline: bool =True) -> None: # 🤔
-    """ 输出彩色字符到控制台
-
-    参数:
-        data: 要输出的文本内容
-        text_color: 前景色代码 (30-37普通色, 90-97亮色)
-        bg_color: 背景色代码 (40-47普通色, 100-107亮色)
-        mode: 显示方式 (0=默认,1=粗体,2=暗淡,3=斜体,4=下划线,5=闪烁,7=反色,8=隐藏,9=删除线)
-        newline: 是否在输出后添加空行,默认True
-
-    示例:
-        color("错误信息", text_color=31, mode=1)  # 红色加粗
-        color("警告", text_color=33, bg_color=41)  # 黄字红底
-
-    newline 参数说明
-        普通输出:
-            1
-            2
-            3
-            1-1
-            2-1
-            Input: Luci_Code
-        newline 输出:
-            1
-            2
-            3
-
-            1-1
-            2-1
-
-            Input: Luci_Code
-
-    newline=True:
-    a
-
-    a
-
-    newline=False:
-    a
-    a
-    """
-    if newline:
-        end="\n\n"
-    else:
-        end="\n"
-    print(_ansi_return(data, text_color, bg_color, mode), end=end)
-
-def clear_screen() -> None: # 清屏: 兼容版
-    """ 跨平台兼容清屏 """
-    try: # 检测环境
-        if platform == "win32": # 环境为 Windows
-            run(['cmd', '/c', 'cls']) # 安全: 使用列表命令,  防注入
-        else: # 包括 MacOS, Linux (Android 也是 Linux 列)
-            run(['clear'], check=False) # check = 遇到错误我 自己来, 别报错
-    except Exception: # 非交互式环境 (.py 打包.exe类环境等没 有cmd命令的环境)
-        print("\n" * shutil.get_terminal_size().lines) # 根据终端输出相对应空行
-
-def safe_try_except(prompt, input_type = True, convert_func=None, text_color=None, bg_color=None, mode=0) -> Union[str, int, float]: # True = input 模式 : False = int / float 模式
-    if text_color is not None or bg_color is not None:
-        prompt = _ansi_return(prompt, text_color, bg_color, mode)
-    while True:
-        try:
-            if input_type:
-                return input(prompt)
-            else:
-                return convert_func(input(prompt))
-        except MemoryError:
-            color("OUT OF MEMORY !\n\nInsufficient memory to complete the operation.\n\nTry:\n\n· Close other apps and retry\n· Increase RAM or swap space\n· Restart the system if problem persists\nOperation terminated. (Error 0x0000005E)\n\n内存不足!\n\n内存不足,无法完成操作。\n\n请尝试:\n\n· 关闭其他应用后重试\n· 增加内存或交换空间\n· 如果问题仍然存在，请重启系 统\n操作已终止 (错误代码 0x0000005E)", 37, 44, 1)
-            exit(1)
-        except ValueError:
-            print("Invalid input value type\n无效的输入值类型")
-            continue
-        except KeyboardInterrupt:
-            clear_screen()
-            color("Program interrupted\n程序被中断", 33, None, 1)
-            exit(0)
-        except EOFError:
-            clear_screen()
-            color("Input stream terminated\n输入流已终止", 33, None, 1)
-            exit(0)
-        except TimeoutError:
-            color("Input timeout\n输入超时", 33, None, 1)
-            exit(0)
-        except UnicodeDecodeError:
-            color("Unicode encoding error\nUnicode 编码错误", 33, None, 1)
-            continue
-        except OSError:
-            color("OSError: System operation failed. Please check file path, permissions, or disk space.\nOSError:系统操作失败。请检查文件路径、权限或磁盘空间。", 37, 44, 1)
-            exit(1)
-        except OverflowError:
-            color("Value overflow\n数值溢出", 33, None, 1)
-            continue
-        except TypeError:
-            color("Type conversion failed\n类型转换失败", 33, None, 1)
-            continue
-        except RuntimeError as e:
-            color(f"Serious runtime error\nError message:\n{e}\n严重的运行时错误\n错误信息,\n{e}", 33, None, 1)
-            exit(1)
-        except SystemExit:
-            color("System exit\n系统退出", 33, None, 1)
-            exit(0)
-        except SystemError:
-            color("System error, please check Python interpreter\n系统错误,请检查 Python 解释器", 33, None, 1)
-            exit(0)
-        except AttributeError:
-            color("Object has no such attribute\n对象没有此属性", 33, None, 1)
-            continue
-        except NameError:
-            color("Variable or function not defined\n变量或函数未定义", 33, None, 1)
-            exit(1)
-        except SyntaxError:
-            color("Syntax error in code\n代码中的语法错误", 33, None, 1)
-            continue
-        except RecursionError:
-            color("Recursion depth exceeded\n超出递归深度", 33, None, 1)
-            exit(1)
-        except BrokenPipeError:
-            color("Input pipe closed by other end\n输入管道被另一端关闭", 33, None, 1)
-            exit(1)
-        except ConnectionError:
-            color("Input from network stream and connection lost\n来自网络流的输入,连接已丢失", 33, None, 1)
-            exit(1)
-        except FileNotFoundError:
-            color("Input source file not found\n未找到输入源 文件", 33, None, 1)
-            exit(1)
-        except IsADirectoryError:
-            color("Input source is a directory, not a file\n 输入源是一个目录,而不是文件", 33, None, 1)
-            exit(1)
-        except PermissionError:
-            color("Permission denied to read input source\n权限被拒绝,无法读取输入源", 33, None, 1)
-            exit(1)
-        except BlockingIOError:
-            color("No data to read in non-blocking mode\n非阻塞模式下没有数据可读", 33, None, 1)
-            continue
-        except ChildProcessError:
-            color("Child process operation failed\n子进程操作失败", 33, None, 1)
-            exit(1)
-        except InterruptedError:
-            color("System call interrupted by signal\n系统调 用被信号中断", 33, None, 1)
-            continue
-        except StopIteration:
-            color("Custom iterator input exhausted\n自定义迭 代器输入已耗尽", 33, None, 1)
-            continue
-        except GeneratorExit:
-            color("Generator closed\n生成器已关闭", 33, None, 1)
-            continue
-        except Exception as e:
-            color(f"Code error\nError message:\n{e}\n代码错误\n错误信息:\n{e}", 33, None, 1)
-            continue
-
-def safe_input(prompt, text_color=None, bg_color=None, mode=0) -> str:
-    return safe_try_except(prompt, True, None, text_color, bg_color, mode)
-
-def _safe_number(prompt, convert_func, text_color=None, bg_color=None, mode=0):
-    return safe_try_except(prompt, False, convert_func, text_color, bg_color, mode)
-
-def safe_int(prompt: str, text_color: Optional[int] = None, bg_color: Optional[int] = None, mode: int = 0) -> int:
-    """ 安全输出整数 """
-    return _safe_number(prompt, int, text_color, bg_color, mode)
-
-def safe_float(prompt: str, text_color: Optional[int] = None, bg_color: Optional[int] = None, mode: int = 0) -> float:
-    """ 安全输出浮点数 """
-    return _safe_number(prompt, float, text_color, bg_color, mode)
-
-# -- 测试部分 -- #
-if __name__ == "__main__":
-    print("=== 测试基本颜色 ===\n=== Test basic colors ===")
-    color("红色文本\nRed text", text_color=31)
-    color("绿色加粗\nGreen bold", text_color=32, mode=1)
-    color("黄字红底\nYellow text Red background", text_color=33, bg_color=41)
-    color("红字黄底加粗\nRed text Yellow background Bold", text_color=31, bg_color=43, mode=1)
-
-    print("\n=== 测试RGB颜色 ===\n=== Test RGB colors ===")
-    color_rgb("RGB红色\nRGB Red", r=255, g=0, b=0)
-    color_rgb("RGB绿色加粗\nRGB Green Bold", r=0, g=255, b=0, mode=1)
-
-    print("\n=== 测试清屏 ===\n=== Test Clear Screen ===")
-    safe_input("按回车清屏...\nPress Enter to clear screen", 32, None, 1)
-    clear_screen()
-    color("清屏成功\nScreen cleared successfully", text_color=32, mode=1)
-
-    print('\n=== 测试"输入"函数 ===\n=== Test "Input" Functions ===')
-    name = safe_input("请输入名字(Please Enter Name): ", text_color=36)
-    age = safe_int("请输入年龄(Please Enter Age): ", text_color=33)
-    height = safe_float("请输入身高(米) (Please Enter height (m)): ", text_color=34)
-
-    color(f"\n你好 {name}, 年龄 {age}, 身高 {height}m\nHello {name}, Age {age}, height {height}", text_color=32, mode=1)
-
+from sys import platform, exit
+from subprocess import run
+from typing import Optional, Union
+import shutil
+import os
+
+if os.name == "nt": # 系统名称 = "nt" 为 Windows
+    os.system("") # 激活 win10 / win7 的终端彩色显示功能
+
+__version__ = "2.1.4" # 明确版本号
+__all__ = [
+    'color', 'color_rgb', 'clear_screen',
+    'safe_input', 'safe_int', 'safe_float'
+] # 确定导出后的代码可用的函数
+
+class _AnsiCode: # AnsiCode 类
+    ESC = "\033"
+    RESET = f"{ESC}[0m"
+    @staticmethod
+    def build(mode: int = 0, fg: Optional[int] = None, bg: Optional[int] = None) -> str:
+        parts = []
+        if mode != 0:
+            parts.append(str(mode))
+        if fg is not None:
+            parts.append(str(fg))
+        if bg is not None:
+            parts.append(str(bg))
+        if parts:
+            return f"{_AnsiCode.ESC}[{';'.join(parts)}m"
+        return ""
+
+def _ansi_return(data: str, text_color: Optional[int] = None, bg_color: Optional[int] = None, mode: int = 0) -> str: # 6767676767 ! 🐱
+    """ 生成ANSI彩色文本(不自动输出)
+
+    参数:
+        data: 要着色的文本内容
+        text_color: 前景色代码 (30-37普通色, 90-97亮色)
+        bg_color: 背景色代码 (40-47普通色, 100-107亮色)
+        mode: 显示方式 (0=默认,1=粗体,2=暗淡,3=斜体,4=下划线,5=闪烁,7=反色,8=隐藏,9=删除线)
+
+    返回:
+        带ANSI转义序列的字符串
+    """
+
+    if text_color is None and bg_color is None: # 如果 text_color 和 bg_color 不是 None
+        return data
+
+    ansi = _AnsiCode.build(mode, text_color, bg_color)
+    return f"{ansi}{data}{_AnsiCode.RESET}"
+
+def _ansi_rgb(data: str, r: int, g: int, b: int, mode: int = 0) -> str:
+    """ 内部函数 """
+    if mode == 0:
+        return f"{_AnsiCode.ESC}[38;2;{r};{g};{b}m{data}{_AnsiCode.RESET}"
+    else:
+        return f"{_AnsiCode.ESC}[{mode};38;2;{r};{g};{b}m{data}{_AnsiCode.RESET}"
+
+def color_rgb(data: str, r: int, g: int, b: int, mode: int = 0, line: int = 2) -> None: # 用户输出 RGB 彩色字符
+    """ 输出 rgb 字符 """
+    print(_ansi_rgb(data, r, g, b, mode), end="\n" * line)
+
+def color(data: str, text_color: Optional[int] = None, bg_color: Optional[int] = None, mode: int = 0, line: int = 2) -> None: # 🤔
+    """ 输出彩色字符到控制台
+
+    参数:
+        data: 要输出的文本内容
+        text_color: 前景色代码 (30-37普通色, 90-97亮色)
+        bg_color: 背景色代码 (40-47普通色, 100-107亮色)
+        mode: 显示方式 (0=默认,1=粗体,2=暗淡,3=斜体,4=下划线,5=闪烁,7=反色,8=隐藏,9=删除线)
+        line: 是否在输出后添加空行,默认 2 空行,0 = 无空行
+
+    示例:
+        color("错误信息", text_color=31, mode=1)  # 红色加粗
+        color("警告", text_color=33, bg_color=41)  # 黄字红底
+
+    line 参数说明:
+    line 函数填入 int 类型的数字, 填入几就输出几个空行(print自带一个, 但是你可以不用管print, end不带print自带的空行)
+    实现代码部分:
+    
+    < python
+        print(_ansi_return(data, text_color, bg_color, mode), end="\n" * line)
+    >
+    
+    end="\n" * line
+    比如:
+    line = 2
+    为"空行数 = 2"的意思
+    
+    line = 2
+    output:
+    content1 (This is line = 1)
+    content2
+    
+    input: Luci
+    
+    line = 0
+    HelloWorld (Hello和World是两个字符串)
+    """
+    print(_ansi_return(data, text_color, bg_color, mode), end="\n" * line)
+
+def clear_screen() -> None: # 清屏: 兼容版
+    """ 跨平台兼容清屏 """
+    try: # 检测环境
+        if platform == "win32": # 环境为 Windows
+            run(['cmd', '/c', 'cls']) # 安全: 使用列表命令,  防注入
+        else: # 包括 MacOS, Linux (Android 也是 Linux 列)
+            run(['clear'], check=False) # check = 遇到错误我 自己来, 别报错
+    except Exception: # 非交互式环境 (.py 打包.exe类环境等没 有cmd命令的环境)
+        try: # 最后一道防线
+            print("\n" * shutil.get_terminal_size().lines) # 根据终端输出相对应空行
+        except: # 为了防止用户让终端的长度无法获取
+            print("\n" * 250) # 防止获取不到终端长度的输出
+
+def _safe_try_except(prompt, input_type = True, convert_func=None, text_color=None, bg_color=None, mode=0) -> Union[str, int, float]: # True = input 模式 : False = int / float 模式
+    if text_color is not None or bg_color is not None:
+        prompt = _ansi_return(prompt, text_color, bg_color, mode)
+    while True:
+        try:
+            if input_type:
+                return input(prompt)
+            else:
+                return convert_func(input(prompt))
+        except MemoryError:
+            color("OUT OF MEMORY !\n\nInsufficient memory to complete the operation.\n\nTry:\n\n· Close other apps and retry\n· Increase RAM or swap space\n· Restart the system if problem persists\nOperation terminated. (Error 0x0000005E)\n\n内存不足!\n\n内存不足,无法完成操作。\n\n请尝试:\n\n· 关闭其他应用后重试\n· 增加内存或交换空间\n· 如果问题仍然存在，请重启系 统\n操作已终止 (错误代码 0x0000005E)", 37, 44, 1)
+            exit(1)
+        except ValueError:
+            print("Invalid input value type\n无效的输入值类型")
+            continue
+        except KeyboardInterrupt:
+            clear_screen()
+            color("Program interrupted\n程序被中断", 33, None, 1)
+            exit(0)
+        except EOFError:
+            clear_screen()
+            color("Input stream terminated\n输入流已终止", 33, None, 1)
+            exit(0)
+        except TimeoutError:
+            color("Input timeout\n输入超时", 33, None, 1)
+            exit(0)
+        except UnicodeDecodeError:
+            color("Unicode encoding error\nUnicode 编码错误", 33, None, 1)
+            continue
+        except OSError:
+            color("OSError: System operation failed. Please check file path, permissions, or disk space.\nOSError:系统操作失败。请检查文件路径、权限或磁盘空间。", 37, 44, 1)
+            exit(1)
+        except OverflowError:
+            color("Value overflow\n数值溢出", 33, None, 1)
+            continue
+        except TypeError:
+            color("Type conversion failed\n类型转换失败", 33, None, 1)
+            continue
+        except RuntimeError as e:
+            color(f"Serious runtime error\nError message:\n{e}\n严重的运行时错误\n错误信息,\n{e}", 33, None, 1)
+            exit(1)
+        except SystemExit:
+            color("System exit\n系统退出", 33, None, 1)
+            exit(0)
+        except SystemError:
+            color("System error, please check Python interpreter\n系统错误,请检查 Python 解释器", 33, None, 1)
+            exit(0)
+        except AttributeError:
+            color("Object has no such attribute\n对象没有此属性", 33, None, 1)
+            continue
+        except NameError:
+            color("Variable or function not defined\n变量或函数未定义", 33, None, 1)
+            exit(1)
+        except SyntaxError:
+            color("Syntax error in code\n代码中的语法错误", 33, None, 1)
+            continue
+        except RecursionError:
+            color("Recursion depth exceeded\n超出递归深度", 33, None, 1)
+            exit(1)
+        except BrokenPipeError:
+            color("Input pipe closed by other end\n输入管道被另一端关闭", 33, None, 1)
+            exit(1)
+        except ConnectionError:
+            color("Input from network stream and connection lost\n来自网络流的输入,连接已丢失", 33, None, 1)
+            exit(1)
+        except FileNotFoundError:
+            color("Input source file not found\n未找到输入源 文件", 33, None, 1)
+            exit(1)
+        except IsADirectoryError:
+            color("Input source is a directory, not a file\n 输入源是一个目录,而不是文件", 33, None, 1)
+            exit(1)
+        except PermissionError:
+            color("Permission denied to read input source\n权限被拒绝,无法读取输入源", 33, None, 1)
+            exit(1)
+        except BlockingIOError:
+            color("No data to read in non-blocking mode\n非阻塞模式下没有数据可读", 33, None, 1)
+            continue
+        except ChildProcessError:
+            color("Child process operation failed\n子进程操作失败", 33, None, 1)
+            exit(1)
+        except InterruptedError:
+            color("System call interrupted by signal\n系统调 用被信号中断", 33, None, 1)
+            continue
+        except StopIteration:
+            color("Custom iterator input exhausted\n自定义迭 代器输入已耗尽", 33, None, 1)
+            continue
+        except GeneratorExit:
+            color("Generator closed\n生成器已关闭", 33, None, 1)
+            continue
+        except Exception as e:
+            color(f"Code error\nError message:\n{e}\n代码错误\n错误信息:\n{e}", 33, None, 1)
+            continue
+        # 27 个 except
+
+def safe_input(prompt, text_color=None, bg_color=None, mode=0) -> str:
+    return _safe_try_except(prompt, True, None, text_color, bg_color, mode)
+
+def _safe_number(prompt, convert_func, text_color=None, bg_color=None, mode=0):
+    return _safe_try_except(prompt, False, convert_func, text_color, bg_color, mode)
+
+def safe_int(prompt: str, text_color: Optional[int] = None, bg_color: Optional[int] = None, mode: int = 0) -> int:
+    """ 安全输出整数 """
+    return _safe_number(prompt, int, text_color, bg_color, mode)
+
+def safe_float(prompt: str, text_color: Optional[int] = None, bg_color: Optional[int] = None, mode: int = 0) -> float:
+    """ 安全输出浮点数 """
+    return _safe_number(prompt, float, text_color, bg_color, mode)
+
+# -- 测试部分 -- #
+if __name__ == "__main__":
+    print("=== 测试基本颜色 ===\n=== Test basic colors ===")
+    color("红色文本\nRed text", text_color=31)
+    color("绿色加粗\nGreen bold", text_color=32, mode=1)
+    color("黄字红底\nYellow text Red background", text_color=33, bg_color=41)
+    color("红字黄底加粗\nRed text Yellow background Bold", text_color=31, bg_color=43, mode=1)
+
+    print("\n=== 测试RGB颜色 ===\n=== Test RGB colors ===")
+    color_rgb("RGB红色\nRGB Red", r=255, g=0, b=0)
+    color_rgb("RGB绿色加粗\nRGB Green Bold", r=0, g=255, b=0, mode=1)
+
+    print("\n=== 测试清屏 ===\n=== Test Clear Screen ===")
+    safe_input("按回车清屏...\nPress Enter to clear screen", 32, None, 1)
+    clear_screen()
+    color("清屏成功\nScreen cleared successfully", text_color=32, mode=1)
+
+    print('\n=== 测试"输入"函数 ===\n=== Test "Input" Functions ===')
+    name = safe_input("请输入名字(Please Enter Name): ", text_color=36)
+    age = safe_int("请输入年龄(Please Enter Age): ", text_color=33)
+    height = safe_float("请输入身高(米) (Please Enter height (m)): ", text_color=34)
+
+    color(f"\n你好 {name}, 年龄 {age}, 身高 {height}m\nHello {name}, Age {age}, height {height}", text_color=32, mode=1)
+
     print("\n所有测试完成!\nAll Tests successfully!")

{luci_code_tools-2.1.2 → luci_code_tools-2.1.4}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: Luci-Code-Tools
-Version: 2.1.2
-Summary: 安全输入工具库,支持彩色输出,KeyboardInterrupt保护等
+Version: 2.1.4
+Summary: 一个简单的工具库 / A Eazy Tools Module
 Home-page: https://github.com/Luci-Codeing/code_tools
 Author: Luci_Code
 Author-email: 3967742419@qq.com
@@ -20,7 +20,7 @@ Dynamic: license-file
 Dynamic: requires-python
 Dynamic: summary
 
-[![PyPI version](https://badge.fury.io/py/luci-code-tools.svg)](https://pypi.org/project/luci-code-tools/)
+[![PyPI version](https://badge.fury.io/py/Luci_Code_Tools.svg)](https://pypi.org/project/Luci_Code_Tools/)
 
 [![Python Version](https://img.shields.io/badge/Python-3.6+-blue.svg)]()
 
@@ -118,8 +118,8 @@ MIT Licence (c) Luci_Code
 
 | 函数名 | 功能 | 参数列表 |
 | --- | --- | --- |
-| color_rgb | 输出真彩色文本, 支持 rgb 调色 | data, r, g, b, newline |
-| color | 输出 ANSI 转义序列固定颜色, 适合不会调色的开发者 | data, text_color, bg_color, mode, newline |
+| color_rgb | 输出真彩色文本, 支持 rgb 调色 | data, r, g, b, line |
+| color | 输出 ANSI 转义序列固定颜色, 适合不会调色的开发者 | data, text_color, bg_color, mode, line |
 | clear_screen | 在任意系统下都能清屏的函数 | 无参数 |
 | safe_input | 让用户安全的输入字符串 | prompt, text_color, bg_color, mode |
 | safe_int | 让用户安全的输入整数 | prompt, text_color, bg_color, mode |
@@ -129,27 +129,32 @@ MIT Licence (c) Luci_Code
 
 # 参数使用教程
 
-**newline** 是指在原本的基础上再输出一行, 默认为 True (多一行)
+**line** 是指在原本的基础上再输出 ** {num} ** 行, 默认为 2 (多一行)
 
 ***输出效果:***
 
-- newline=True :
+line = 1 : [
+    content1
+    content2
+    input: Luci
+]
 
-content-1 (此处为 False)
-content-2
+line = 2 : [
+    content1 (line = 1)
+    content2
 
-input: content
+    input: Luci
+]
 
-if-content-prompt
+line = 3 : [
+    content1 (line = 1)
+    content2
 
-- newline=False :
 
-content-1
-content-2
-input: content
-if-content-prompt
+    input: Luci
+]
 
-**这一改动让命令行的输出变得有辨识度, 高级**
+**这一改动让命令行的输出变得有辨识度**
 
 **data, prompt** 都是 *输出的文本* 的意思
 
@@ -157,13 +162,13 @@ if-content-prompt
 
 - **color_rgb**
 
-**color_rgb** 的参数有: data, r, g, b, newline
+**color_rgb** 的参数有: data, r, g, b, line
 
-**其中**, data 是数据的意思, 代表输出的内容, [r, g, b] 是 ***标准 rgb 调色*** 的用处, 所以 [r, g, b] 分别填入 r, g, b 的值, newline 不用讲解, 前面说了喵
+**其中**, data 是数据的意思, 代表输出的内容, [r, g, b] 是 ***标准 rgb 调色*** 的用处, 所以 [r, g, b] 分别填入 r, g, b 的值, line 不用讲解, 前面说了喵
 
 - **color**
 
-**color** 的参数有: data, text_color, bg_color, mode, newline
+**color** 的参数有: data, text_color, bg_color, mode, line
 
 **data** 和之前一样, ***[text_color, bg_color, mode]***, 这三个参数在 safe_\* 中也有, 意思相同, 暂不讲解, **text_color** 就是控制输出的文本的颜色**(前景色)**, bg_color** 是输出文本的**背景色**, **mode** 为输出的格式 **(显示方式)**, 这三个参数在最后会有**表格对照表**
 
@@ -259,6 +264,7 @@ if-content-prompt
 # 制作者 & 感谢名单
 
 | 制作 | 分工 |
+| --- | --- |
 | DeepSeek | 检查 |
 | DeepSeek | 改进方法 |
 | Luci_Code | 改进 |
@@ -371,8 +377,8 @@ MIT License (c) Luci_Code
 
 | Function Name | Functionality | Parameter List |
 | --- | --- | --- |
-| color_rgb | Outputs true-color text; supports RGB color customization. | data, r, g, b, newline |
-| color | Outputs text using fixed ANSI escape sequence colors; suitable for developers unfamiliar with color mixing. | data, text_color, bg_color, mode, newline |
+| color_rgb | Outputs true-color text; supports RGB color customization. | data, r, g, b, line |
+| color | Outputs text using fixed ANSI escape sequence colors; suitable for developers unfamiliar with color mixing. | data, text_color, bg_color, mode, line |
 | clear_screen | A function that clears the screen on any operating system. | No parameters |
 | safe_input | Safely prompts the user to input a string. | prompt, text_color, bg_color, mode |
 | safe_int | Safely prompts the user to input an integer. | prompt, text_color, bg_color, mode |
@@ -382,11 +388,11 @@ MIT License (c) Luci_Code
 
 # Parameter Usage Guide
 
-**newline** refers to whether an additional line break is added after the output; it defaults to `True` (adding an extra line).
+**line** refers to whether an additional line break is added after the output; it defaults to `True` (adding an extra line).
 
 ***Output Effect:***
 
-- `newline=True`:
+- `line=True`:
 
 content-1 (Here, this implies `False`)
 content-2
@@ -395,7 +401,7 @@ input: content
 
 if-content-prompt
 
-- `newline=False`:
+- `line=False`:
 
 content-1
 content-2
@@ -410,13 +416,13 @@ if-content-prompt
 
 - ​​**color_rgb**
 
-The parameters for **color_rgb** are: data, r, g, b, newline.
+The parameters for **color_rgb** are: data, r, g, b, line.
 
-**Specifically:** `data` refers to the actual content being output; `[r, g, b]` are used for ***standard RGB color mixing***—simply fill in the respective values ​​for r, g, and b. The `newline` parameter requires no further explanation, as it was covered earlier!
+**Specifically:** `data` refers to the actual content being output; `[r, g, b]` are used for ***standard RGB color mixing***—simply fill in the respective values ​​for r, g, and b. The `line` parameter requires no further explanation, as it was covered earlier!
 
 - **color**
 
-The parameters for **color** are: `data`, `text_color`, `bg_color`, `mode`, and `newline`.
+The parameters for **color** are: `data`, `text_color`, `bg_color`, `mode`, and `line`.
 
 **data**: As before, this takes the format `[text_color, bg_color, mode]`. These three parameters also appear in the `safe_*` functions with the same meanings, so we won't explain them again here. **text_color** controls the color of the output text (the **foreground color**); **bg_color** controls the **background color** of the output text; and **mode** specifies the output format (the **display style**). A **reference table** for these three parameters can be found at the end of this document.
 
@@ -512,6 +518,7 @@ The explanations for these two functions are essentially identical to that of **
 # Credits & Acknowledgments
 
 | Contributor | Role |
+| --- | --- |
 | DeepSeek | Review |
 | DeepSeek | Method Improvement |
 | Luci_Code | Improvements |

{luci_code_tools-2.1.2 → luci_code_tools-2.1.4}/README.md

@@ -1,4 +1,4 @@
-[![PyPI version](https://badge.fury.io/py/luci-code-tools.svg)](https://pypi.org/project/luci-code-tools/)
+[![PyPI version](https://badge.fury.io/py/Luci_Code_Tools.svg)](https://pypi.org/project/Luci_Code_Tools/)
 
 [![Python Version](https://img.shields.io/badge/Python-3.6+-blue.svg)]()
 
@@ -96,8 +96,8 @@ MIT Licence (c) Luci_Code
 
 | 函数名 | 功能 | 参数列表 |
 | --- | --- | --- |
-| color_rgb | 输出真彩色文本, 支持 rgb 调色 | data, r, g, b, newline |
-| color | 输出 ANSI 转义序列固定颜色, 适合不会调色的开发者 | data, text_color, bg_color, mode, newline |
+| color_rgb | 输出真彩色文本, 支持 rgb 调色 | data, r, g, b, line |
+| color | 输出 ANSI 转义序列固定颜色, 适合不会调色的开发者 | data, text_color, bg_color, mode, line |
 | clear_screen | 在任意系统下都能清屏的函数 | 无参数 |
 | safe_input | 让用户安全的输入字符串 | prompt, text_color, bg_color, mode |
 | safe_int | 让用户安全的输入整数 | prompt, text_color, bg_color, mode |
@@ -107,27 +107,32 @@ MIT Licence (c) Luci_Code
 
 # 参数使用教程
 
-**newline** 是指在原本的基础上再输出一行, 默认为 True (多一行)
+**line** 是指在原本的基础上再输出 ** {num} ** 行, 默认为 2 (多一行)
 
 ***输出效果:***
 
-- newline=True :
+line = 1 : [
+    content1
+    content2
+    input: Luci
+]
 
-content-1 (此处为 False)
-content-2
+line = 2 : [
+    content1 (line = 1)
+    content2
 
-input: content
+    input: Luci
+]
 
-if-content-prompt
+line = 3 : [
+    content1 (line = 1)
+    content2
 
-- newline=False :
 
-content-1
-content-2
-input: content
-if-content-prompt
+    input: Luci
+]
 
-**这一改动让命令行的输出变得有辨识度, 高级**
+**这一改动让命令行的输出变得有辨识度**
 
 **data, prompt** 都是 *输出的文本* 的意思
 
@@ -135,13 +140,13 @@ if-content-prompt
 
 - **color_rgb**
 
-**color_rgb** 的参数有: data, r, g, b, newline
+**color_rgb** 的参数有: data, r, g, b, line
 
-**其中**, data 是数据的意思, 代表输出的内容, [r, g, b] 是 ***标准 rgb 调色*** 的用处, 所以 [r, g, b] 分别填入 r, g, b 的值, newline 不用讲解, 前面说了喵
+**其中**, data 是数据的意思, 代表输出的内容, [r, g, b] 是 ***标准 rgb 调色*** 的用处, 所以 [r, g, b] 分别填入 r, g, b 的值, line 不用讲解, 前面说了喵
 
 - **color**
 
-**color** 的参数有: data, text_color, bg_color, mode, newline
+**color** 的参数有: data, text_color, bg_color, mode, line
 
 **data** 和之前一样, ***[text_color, bg_color, mode]***, 这三个参数在 safe_\* 中也有, 意思相同, 暂不讲解, **text_color** 就是控制输出的文本的颜色**(前景色)**, bg_color** 是输出文本的**背景色**, **mode** 为输出的格式 **(显示方式)**, 这三个参数在最后会有**表格对照表**
 
@@ -237,6 +242,7 @@ if-content-prompt
 # 制作者 & 感谢名单
 
 | 制作 | 分工 |
+| --- | --- |
 | DeepSeek | 检查 |
 | DeepSeek | 改进方法 |
 | Luci_Code | 改进 |
@@ -349,8 +355,8 @@ MIT License (c) Luci_Code
 
 | Function Name | Functionality | Parameter List |
 | --- | --- | --- |
-| color_rgb | Outputs true-color text; supports RGB color customization. | data, r, g, b, newline |
-| color | Outputs text using fixed ANSI escape sequence colors; suitable for developers unfamiliar with color mixing. | data, text_color, bg_color, mode, newline |
+| color_rgb | Outputs true-color text; supports RGB color customization. | data, r, g, b, line |
+| color | Outputs text using fixed ANSI escape sequence colors; suitable for developers unfamiliar with color mixing. | data, text_color, bg_color, mode, line |
 | clear_screen | A function that clears the screen on any operating system. | No parameters |
 | safe_input | Safely prompts the user to input a string. | prompt, text_color, bg_color, mode |
 | safe_int | Safely prompts the user to input an integer. | prompt, text_color, bg_color, mode |
@@ -360,11 +366,11 @@ MIT License (c) Luci_Code
 
 # Parameter Usage Guide
 
-**newline** refers to whether an additional line break is added after the output; it defaults to `True` (adding an extra line).
+**line** refers to whether an additional line break is added after the output; it defaults to `True` (adding an extra line).
 
 ***Output Effect:***
 
-- `newline=True`:
+- `line=True`:
 
 content-1 (Here, this implies `False`)
 content-2
@@ -373,7 +379,7 @@ input: content
 
 if-content-prompt
 
-- `newline=False`:
+- `line=False`:
 
 content-1
 content-2
@@ -388,13 +394,13 @@ if-content-prompt
 
 - ​​**color_rgb**
 
-The parameters for **color_rgb** are: data, r, g, b, newline.
+The parameters for **color_rgb** are: data, r, g, b, line.
 
-**Specifically:** `data` refers to the actual content being output; `[r, g, b]` are used for ***standard RGB color mixing***—simply fill in the respective values ​​for r, g, and b. The `newline` parameter requires no further explanation, as it was covered earlier!
+**Specifically:** `data` refers to the actual content being output; `[r, g, b]` are used for ***standard RGB color mixing***—simply fill in the respective values ​​for r, g, and b. The `line` parameter requires no further explanation, as it was covered earlier!
 
 - **color**
 
-The parameters for **color** are: `data`, `text_color`, `bg_color`, `mode`, and `newline`.
+The parameters for **color** are: `data`, `text_color`, `bg_color`, `mode`, and `line`.
 
 **data**: As before, this takes the format `[text_color, bg_color, mode]`. These three parameters also appear in the `safe_*` functions with the same meanings, so we won't explain them again here. **text_color** controls the color of the output text (the **foreground color**); **bg_color** controls the **background color** of the output text; and **mode** specifies the output format (the **display style**). A **reference table** for these three parameters can be found at the end of this document.
 
@@ -490,6 +496,7 @@ The explanations for these two functions are essentially identical to that of **
 # Credits & Acknowledgments
 
 | Contributor | Role |
+| --- | --- |
 | DeepSeek | Review |
 | DeepSeek | Method Improvement |
 | Luci_Code | Improvements |

{luci_code_tools-2.1.2 → luci_code_tools-2.1.4}/setup.py

@@ -5,10 +5,10 @@ with open("README.md", "r", encoding="utf-8") as f:
 
 setup(
     name="Luci-Code-Tools",
-    version="2.1.2",
+    version="2.1.4",
     author="Luci_Code",
     author_email="3967742419@qq.com",
-    description="安全输入工具库,支持彩色输出,KeyboardInterrupt保护等",
+    description="一个简单的工具库 / A Eazy Tools Module",
     long_description=long_description,
     long_description_content_type="text/markdown",
     url="https://github.com/Luci-Codeing/code_tools",