Luci-Code-Tools 2.1.5__tar.gz → 2.1.6__tar.gz

{luci_code_tools-2.1.5 → luci_code_tools-2.1.6}/Luci_Code_Tools.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Luci-Code-Tools
-Version: 2.1.5
+Version: 2.1.6
 Summary: 一个简单的工具库 / A Eazy Tools Module
 Home-page: https://github.com/Luci-Code-2014
 Author: Luci_Code
@@ -55,7 +55,7 @@ Dynamic: summary
 ## ✨ 特性
 
 - 🎨 **ANSI 真彩色** + RGB 支持, 想要什么颜色就什么颜色
-- 🛡️ **20+ 异常处理**
+- 🛡️ **5+ 异常处理**
 - 🌐 **中英双语**, 谁都能看懂错误信息
 - 🐧 **跨平台**, 支持: Windows / macOS / Linux / Android
 - 📝 **注释比代码还多**, 不怕看不懂
@@ -110,7 +110,7 @@ cl("字符输出", 32, None, 1)
 
 ## 📃 许可证
 
-MIT Licence (c) Luci_Code
+MIT Licence (c) Luci_Code 2026
 
 ---
 
@@ -314,7 +314,7 @@ line = 3 : [
 ## ✨ Features
 
 - 🎨 **ANSI True Color** + RGB support—pick any color you desire!
-- 🛡️ **20+ Exception Handlers**
+- 🛡️ **5+ Exception Handlers**
 - 🌐 **Bilingual Support (Chinese/English)**—everyone can understand the error messages
 - 🐧 **Cross-Platform**—supports: Windows / macOS / Linux / Android
 - 📝 **More Comments Than Code**—no need to worry about not understanding it
@@ -369,7 +369,7 @@ cl("Character Output", 32, None, 1)
 
 ## 📃 License
 
-MIT License (c) Luci_Code
+MIT License (c) Luci_Code 2026
 
 ---
 
@@ -388,27 +388,32 @@ MIT License (c) Luci_Code
 
 # Parameter Usage Guide
 
-**line** refers to whether an additional line break is added after the output; it defaults to `True` (adding an extra line).
+**line** specifies the number of additional lines to output beyond the default; the default value is 2 (resulting in one extra line).
 
-***Output Effect:***
+***Output Examples:***
 
-- `line=True`:
+line = 1 : [
+content1
+content2
+input: Luci
+]
 
-content-1 (Here, this implies `False`)
-content-2
+line = 2 : [
+content1 (line = 1)
+content2
 
-input: content
+input: Luci
+]
 
-if-content-prompt
+line = 3 : [
+content1 (line = 1)
+content2
 
-- `line=False`:
 
-content-1
-content-2
-input: content
-if-content-prompt
+input: Luci
+]
 
-**This modification makes the command-line output more visually distinct and sophisticated.**
+**This modification makes the command-line output more visually distinct.**
 
 **data** and **prompt** both refer to the *text being output*.
 

{luci_code_tools-2.1.5 → luci_code_tools-2.1.6}/Luci_code_tools.py

@@ -5,13 +5,14 @@ import shutil
 import os
 
 if os.name == "nt": # 系统名称 = "nt" 为 Windows
-    os.system("") # 激活 win10 / win7 的终端彩色显示功能
+    os.system("") # 激活 win10 / win7 的终端彩色显示功能, 只是为了兼容 cmd , powershell 这类不支持彩色的终端
 
-__version__ = "2.1.5" # 明确版本号
+__version__ = "2.1.6" # 明确版本号
 __all__ = [
     'color', 'color_rgb', 'clear_screen',
     'safe_input', 'safe_int', 'safe_float'
-] # 确定导出后的代码可用的函数
+] # 用户可用函数
+
 
 class _AnsiCode: # AnsiCode 类
     ESC = "\033"
@@ -29,7 +30,8 @@ class _AnsiCode: # AnsiCode 类
             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 ! 🐱
+
+def _ansi_return(data: str, text_color: Optional[int] = None, bg_color: Optional[int] = None, mode: int = 0) -> str:
     """ 生成ANSI彩色文本(不自动输出)
 
     参数:
@@ -111,7 +113,7 @@ def clear_screen() -> None: # 清屏: 兼容版
         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 模式
+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:
@@ -205,18 +207,19 @@ def _safe_try_except(prompt, input_type = True, convert_func=None, text_color=No
             continue
         # 27 个 except
 
-def safe_input(prompt, text_color=None, bg_color=None, mode=0) -> str:
+def safe_input(prompt: str, text_color: Optional[int] = None, bg_color: Optional[int] = None, mode: int = 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) -> Union[int, float]:
+def _safe_number(prompt: str, convert_func: str, text_color: Optional[int] = None, bg_color: Optional[int] = None, mode: int = 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)
 
 # -- 测试部分 -- #

{luci_code_tools-2.1.5 → luci_code_tools-2.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Luci-Code-Tools
-Version: 2.1.5
+Version: 2.1.6
 Summary: 一个简单的工具库 / A Eazy Tools Module
 Home-page: https://github.com/Luci-Code-2014
 Author: Luci_Code
@@ -55,7 +55,7 @@ Dynamic: summary
 ## ✨ 特性
 
 - 🎨 **ANSI 真彩色** + RGB 支持, 想要什么颜色就什么颜色
-- 🛡️ **20+ 异常处理**
+- 🛡️ **5+ 异常处理**
 - 🌐 **中英双语**, 谁都能看懂错误信息
 - 🐧 **跨平台**, 支持: Windows / macOS / Linux / Android
 - 📝 **注释比代码还多**, 不怕看不懂
@@ -110,7 +110,7 @@ cl("字符输出", 32, None, 1)
 
 ## 📃 许可证
 
-MIT Licence (c) Luci_Code
+MIT Licence (c) Luci_Code 2026
 
 ---
 
@@ -314,7 +314,7 @@ line = 3 : [
 ## ✨ Features
 
 - 🎨 **ANSI True Color** + RGB support—pick any color you desire!
-- 🛡️ **20+ Exception Handlers**
+- 🛡️ **5+ Exception Handlers**
 - 🌐 **Bilingual Support (Chinese/English)**—everyone can understand the error messages
 - 🐧 **Cross-Platform**—supports: Windows / macOS / Linux / Android
 - 📝 **More Comments Than Code**—no need to worry about not understanding it
@@ -369,7 +369,7 @@ cl("Character Output", 32, None, 1)
 
 ## 📃 License
 
-MIT License (c) Luci_Code
+MIT License (c) Luci_Code 2026
 
 ---
 
@@ -388,27 +388,32 @@ MIT License (c) Luci_Code
 
 # Parameter Usage Guide
 
-**line** refers to whether an additional line break is added after the output; it defaults to `True` (adding an extra line).
+**line** specifies the number of additional lines to output beyond the default; the default value is 2 (resulting in one extra line).
 
-***Output Effect:***
+***Output Examples:***
 
-- `line=True`:
+line = 1 : [
+content1
+content2
+input: Luci
+]
 
-content-1 (Here, this implies `False`)
-content-2
+line = 2 : [
+content1 (line = 1)
+content2
 
-input: content
+input: Luci
+]
 
-if-content-prompt
+line = 3 : [
+content1 (line = 1)
+content2
 
-- `line=False`:
 
-content-1
-content-2
-input: content
-if-content-prompt
+input: Luci
+]
 
-**This modification makes the command-line output more visually distinct and sophisticated.**
+**This modification makes the command-line output more visually distinct.**
 
 **data** and **prompt** both refer to the *text being output*.
 

{luci_code_tools-2.1.5 → luci_code_tools-2.1.6}/README.md

@@ -33,7 +33,7 @@
 ## ✨ 特性
 
 - 🎨 **ANSI 真彩色** + RGB 支持, 想要什么颜色就什么颜色
-- 🛡️ **20+ 异常处理**
+- 🛡️ **5+ 异常处理**
 - 🌐 **中英双语**, 谁都能看懂错误信息
 - 🐧 **跨平台**, 支持: Windows / macOS / Linux / Android
 - 📝 **注释比代码还多**, 不怕看不懂
@@ -88,7 +88,7 @@ cl("字符输出", 32, None, 1)
 
 ## 📃 许可证
 
-MIT Licence (c) Luci_Code
+MIT Licence (c) Luci_Code 2026
 
 ---
 
@@ -292,7 +292,7 @@ line = 3 : [
 ## ✨ Features
 
 - 🎨 **ANSI True Color** + RGB support—pick any color you desire!
-- 🛡️ **20+ Exception Handlers**
+- 🛡️ **5+ Exception Handlers**
 - 🌐 **Bilingual Support (Chinese/English)**—everyone can understand the error messages
 - 🐧 **Cross-Platform**—supports: Windows / macOS / Linux / Android
 - 📝 **More Comments Than Code**—no need to worry about not understanding it
@@ -347,7 +347,7 @@ cl("Character Output", 32, None, 1)
 
 ## 📃 License
 
-MIT License (c) Luci_Code
+MIT License (c) Luci_Code 2026
 
 ---
 
@@ -366,27 +366,32 @@ MIT License (c) Luci_Code
 
 # Parameter Usage Guide
 
-**line** refers to whether an additional line break is added after the output; it defaults to `True` (adding an extra line).
+**line** specifies the number of additional lines to output beyond the default; the default value is 2 (resulting in one extra line).
 
-***Output Effect:***
+***Output Examples:***
 
-- `line=True`:
+line = 1 : [
+content1
+content2
+input: Luci
+]
 
-content-1 (Here, this implies `False`)
-content-2
+line = 2 : [
+content1 (line = 1)
+content2
 
-input: content
+input: Luci
+]
 
-if-content-prompt
+line = 3 : [
+content1 (line = 1)
+content2
 
-- `line=False`:
 
-content-1
-content-2
-input: content
-if-content-prompt
+input: Luci
+]
 
-**This modification makes the command-line output more visually distinct and sophisticated.**
+**This modification makes the command-line output more visually distinct.**
 
 **data** and **prompt** both refer to the *text being output*.
 

{luci_code_tools-2.1.5 → luci_code_tools-2.1.6}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as f:
 
 setup(
     name="Luci-Code-Tools",
-    version="2.1.5",
+    version="2.1.6",
     author="Luci_Code",
     author_email="3967742419@qq.com",
     description="一个简单的工具库 / A Eazy Tools Module",