Luci-Code-Tools 1.1.3__py3-none-any.whl

Luci_code_tools.py

@@ -0,0 +1,179 @@
+from sys import platform, exit
+from subprocess import run
+from typing import Optional
+
+__version__ = "1.0.2"
+
+class _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:
+    """ 生成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:
+        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 字符 """
+    print(_ansi_rgb(data, r, g, b, mode))
+    if newline:
+        print()
+
+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)  # 黄字红底
+    """
+
+    print(_ansi_return(data, text_color, bg_color, mode))
+    if newline:
+        print()
+        
+""" newline: 提高观感
+        普通输出:
+            1
+            2
+            3
+            1-1
+            2-1
+            Input: Luci_Code
+        newline 输出:
+            1
+            2
+            3
+            
+            1-1
+            2-1
+            
+            Input: Luci_Code
+"""
+
+def clear_screen() -> None:
+    """ 跨平台兼容清屏 """
+    if platform == "win32":
+        run(['cmd', '/c', 'cls'])
+    else:
+        run(['clear'])
+
+def safe_input(prompt: str, text_color: Optional[int] = None, bg_color: Optional[int] = None, mode: int = 0) -> str:
+    """ 安全输出字符串 """
+    if text_color:
+        prompt = _ansi_return(prompt, text_color, bg_color, mode)
+    try:
+        return input(prompt)
+    except KeyboardInterrupt:
+        clear_screen()
+        color("退出成功(Ctrl + C)", 32, None, 1)
+        exit(0)
+    except EOFError:
+        clear_screen()
+        color("输入流关闭, 自动退出", 34, None, 1)
+        exit(0)
+
+def _safe_number(prompt: str, convert_func, text_color: Optional[int] = None, bg_color: Optional[int] = None, mode: int = 0):
+    """ 内部函数：安全的数字输入 """
+    if convert_func is None:
+        raise ValueError("convert_func cannot be None")
+    if text_color:
+        prompt = _ansi_return(prompt, text_color, bg_color, mode)
+    while True:
+        try:
+            return convert_func(input(prompt))
+        except ValueError:
+            color("\n输入类型错误", 34, None, 1)
+            continue
+        except KeyboardInterrupt:
+            clear_screen()
+            color("退出成功(Ctrl + C)", 34, None, 1)
+            exit(0)
+        except EOFError:
+            clear_screen()
+            color("输入流关闭, 自动退出", 34, None, 1)
+            exit(0)
+
+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)
+
+def cloudflare_play() -> None:
+    cloudflare_box = """
+    ┏━━━━━━━━━━━━━━┓
+    ┃ ┌┐ 请验证您是真人   ☁️           ┃
+    ┃ └┘                          cloudflare     ┃
+    ┗━━━━━━━━━━━━━━┛
+    """
+    color(cloudflare_box, 32, None, 1)
+
+# -- 测试部分 -- #
+if __name__ == "__main__":
+    print("=== 测试基本颜色 ===")
+    color("红色文本", text_color=31)
+    color("绿色加粗", text_color=32, mode=1)
+    color("黄字红底", text_color=33, bg_color=41)
+    
+    print("\n=== 测试RGB颜色 ===")
+    color_rgb("RGB红色", r=255, g=0, b=0)
+    color_rgb("RGB绿色加粗", r=0, g=255, b=0, mode=1)
+    
+    print("\n=== 测试清屏 ===")
+    input("按回车清屏...")
+    clear_screen()
+    color("清屏成功", text_color=32, mode=1)
+    
+    print("\n=== 测试CloudFlare样式 ===")
+    cloudflare_play()
+    
+    print("\n=== 测试输入函数 ===")
+    name = safe_input("请输入名字: ", text_color=36)
+    age = safe_int("请输入年龄: ", text_color=33)
+    height = safe_float("请输入身高(m): ", text_color=34)
+    
+    color(f"\n你好 {name}, 年龄 {age}, 身高 {height}m", text_color=32, mode=1)
+    
+    print("\n所有测试完成!")

luci_code_tools-1.1.3.dist-info/METADATA

@@ -0,0 +1,120 @@
+Metadata-Version: 2.4
+Name: Luci-Code-Tools
+Version: 1.1.3
+Summary: 安全输入工具库,支持彩色输出,KeyboardInterrupt保护等
+Home-page: https://github.com/Luci-Codeing/code_tools
+Author: Luci_Code
+Author-email: 3967742419@qq.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENCE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+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/)
+
+# Luci_Code_Tools
+
+## 介绍:
+
+给初学者制作的 *Python* 工具库, 基于 Python 3.13.3 制作
+
+### 安装 & 导入
+
+```bash
+pip install Luci-Code-Tools
+```
+
+```python
+from Luci_code_tools import *
+# 或者
+import Luci_code_tools
+```
+
+#  内容
+
+**函数**
+
+**safe_\*** = **safe_input, safe_int, safe_float**
+
+| 名称 | 作用 | 参数 |
+| --- | --- | --- |
+| color | 输出ANSI彩色字符 | data, text_color, bg_color, mode, newline |
+| color_rgb | 输出RGB彩色字符 | data, r, g, b, mode, newline |
+| clear_screen | 可跨平台的清屏 | None (没有参数) |
+| safe_* | 安全的输入, 防止Ctrl + C和输入流关闭等报错 | prompt, text_color, bg_color, mode |
+| cloudflare_play | 输出 CloudFlare 人机验证 | None (没有参数) |
+
+**提示**: ***参数需要按照顺序填***
+
+# < TODO >
+
+---
+
+# 其他
+
+**ANSI常用序列**
+*提示: 90-97 为亮色前景色，100-107 为亮色背景色*
+
+| 前景色 | 效果 |
+| --- | --- |
+| 30 | 黑色 |
+| 31 | 红色 |
+| 32 | 绿色 |
+| 33 | 黄色 |
+| 34 | 蓝色 |
+| 35 | 紫色 |
+| 36 | 青色 |
+| 37 | 白色 |
+
+| 显示方式 | 效果 |
+| --- | --- |
+| 0 | 默认 |
+| 1 | 粗体 + 高亮 |
+| 2 | 暗淡 |
+| 3 | 斜体(部分终端不支持) |
+| 4 | 下划线 |
+| 5 | 闪烁 |
+| 6 | 快闪(部分终端不支持)
+| 7 | 反色(前景色与背景色互换) |
+| 8 | 隐藏 |
+| 9 | 删除线 |
+
+| 背景色 | 效果 |
+| --- | --- |
+| 40 | 黑色 |
+| 41 | 红色 |
+| 42 | 绿色 |
+| 43 | 黄色 |
+| 44 | 蓝色 |
+| 45 | 紫色 |
+| 46 | 青色 |
+| 47 | 白色 |
+
+---
+
+# 制作者 & 感谢名单
+
+| 作者 | 分工 |
+| --- | --- |
+| DeepSeek | 检查 |
+| DeepSeek | 改进 |
+| Luci_Code | 代码 |
+| Luci_Code | 文档 |
+| Luci_Code | 思路 |
+| Luci_Code | 上传 |
+
+---
+
+# 感谢
+
+***<感谢您的阅读，我是Luci_Code， 一名2014年出生的开发者 >***

luci_code_tools-1.1.3.dist-info/RECORD

@@ -0,0 +1,6 @@
+Luci_code_tools.py,sha256=MEdfnmMIz0_Ut3uyZXs8JGitDs8Q41lcel0NsjBgcJc,6046
+luci_code_tools-1.1.3.dist-info/licenses/LICENCE,sha256=b2hWWCM1tFEAQ-J6ZOntAAIE5pXtuaeAYUvxGm0CGLA,1067
+luci_code_tools-1.1.3.dist-info/METADATA,sha256=7j98oRZAdA9--O6ewErla1ANduiSXSWQEHGpfRs0kMw,2561
+luci_code_tools-1.1.3.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+luci_code_tools-1.1.3.dist-info/top_level.txt,sha256=xbrPrFxDcMxHoPCiSfuJCZ2HjW995UF_lVB9BrSs7wo,16
+luci_code_tools-1.1.3.dist-info/RECORD,,

luci_code_tools-1.1.3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

luci_code_tools-1.1.3.dist-info/licenses/LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 [Luci_Code]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

luci_code_tools-1.1.3.dist-info/top_level.txt

@@ -0,0 +1 @@
+Luci_code_tools