vebplib 1.0.0__tar.gz

vebplib-1.0.0/LICENSE.txt

@@ -0,0 +1,21 @@
+GPL-3.0 License
+
+Copyright (c) 2025 [Ndrzy]
+
+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.

vebplib-1.0.0/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: vebplib
+Version: 1.0.0
+Summary: python lib
+Author-email: ndrzy <dandan0019@outlook.com>
+License: MIT
+Project-URL: Homepage, https://github.com/meatdumplings0019/vebplib
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: colorama
+Dynamic: license-file
+
+# VebpLib

vebplib-1.0.0/README.md

@@ -0,0 +1 @@
+# VebpLib

vebplib-1.0.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools >= 48.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vebplib"
+version = "1.0.0"
+description = "python lib"
+authors = [
+    { name = "ndrzy", email = "dandan0019@outlook.com" }
+]
+readme = { file = "README.md", content-type = "text/markdown" }
+requires-python = ">=3.10"
+license = { text = "MIT" }
+dependencies = [
+    'colorama'
+]
+
+[project.urls]
+Homepage = "https://github.com/meatdumplings0019/vebplib"
+
+[tool.setuptools.packages.find]
+where = [""]

vebplib-1.0.0/scripts/build.py

@@ -0,0 +1,4 @@
+import os
+
+if __name__ == '__main__':
+    os.system('python -m build')

vebplib-1.0.0/scripts/install.py

@@ -0,0 +1,5 @@
+import os
+
+if __name__ == '__main__':
+    os.system('pip install -r requirements.txt')
+    print("\nAll packages installed")

vebplib-1.0.0/scripts/upload.py

@@ -0,0 +1,4 @@
+import os
+
+if __name__ == '__main__':
+    os.system('twine.exe upload .\dist\*')

vebplib-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

vebplib-1.0.0/test/message.py

@@ -0,0 +1,5 @@
+from vebplib.message import Message
+
+msg = Message(1, "Error xlk")
+
+print(msg)

vebplib-1.0.0/vebplib/__init__.py

@@ -0,0 +1,11 @@
+import vebplib.color
+import vebplib.file
+import vebplib.system
+import vebplib.venvs
+import vebplib.text
+import vebplib.args
+import vebplib.math
+import vebplib.message
+import vebplib.path
+import vebplib.func
+import vebplib.types

vebplib-1.0.0/vebplib/args.py

@@ -0,0 +1,12 @@
+import argparse
+
+from typing import Optional
+
+def parse_args(tokens: list[str], parser: argparse.ArgumentParser) -> Optional[argparse.Namespace]:
+    try:
+        return parser.parse_args(tokens)
+    except SystemExit:
+        return None
+    except Exception as e:
+        print(f"参数解析错误: {str(e)}")
+        return None

vebplib-1.0.0/vebplib/color/__init__.py

@@ -0,0 +1,203 @@
+from vebplib.color._console import *
+from vebplib.color.util import *
+
+
+class MColor:
+    CONSOLE_COLOR = ForeWhite()
+
+    def __init__(self, r: int = 255, g: int = 255, b: int = 255, a: int = 255):
+        """
+        增强版的Color, 支持rgb转hex, 可以直接作为pygame的Color
+        :param r: R
+        :param g: G
+        :param b: B
+        :param a: A
+        """
+        self._r, self._g, self._b, self._a = self.vali_rgba(r, g, b, a)
+
+    @staticmethod
+    def from_hex(hex_str: str = "#FFFFFF"):
+        """
+        将16进制颜色代码转为MColor
+        :param hex_str: 16进制string
+        :return: new MColor
+        """
+        r, g, b, a = hex_to_rgb(hex_str)
+        return MColor(r, g, b, a)
+
+    @staticmethod
+    def vali_rgba(r, g, b, a=255):
+        return vali_rgba(r, g, b, a)
+
+    @property
+    def r(self) -> int:
+        return self._r
+
+    @r.setter
+    def r(self, value: int) -> None:
+        if 0 < value <= 255:
+            self._r = value
+
+        self.r = 255
+
+    @property
+    def float_r(self) -> float:
+        return self.r / 255.0
+
+    @property
+    def g(self) -> int:
+        return self._g
+
+    @g.setter
+    def g(self, value: int) -> None:
+        if 0 < value <= 255:
+            self._g = value
+            return
+
+        self.g = 255
+
+    @property
+    def float_g(self) -> float:
+        return self.g / 255.0
+
+    @property
+    def b(self) -> int:
+        return self._b
+
+    @b.setter
+    def b(self, value: int) -> None:
+        if 0 < value <= 255:
+            self._b = value
+            return
+
+        self.b = 255
+
+    @property
+    def float_b(self) -> float:
+        return self.b / 255.0
+
+    @property
+    def a(self) -> int:
+        return self._a
+
+    @a.setter
+    def a(self, value: int) -> None:
+        if 0 < value <= 255:
+            self._a = value
+            return
+
+        self.a = 255
+
+    @property
+    def float_a(self) -> float:
+        return self.a / 255.0
+
+    @property
+    def rgb(self) -> tuple[int, int, int]:
+        return self.r, self.g, self.b
+
+    @property
+    def float_rgb(self) -> tuple[float, float, float]:
+        return self.float_r, self.float_g, self.float_b
+
+    @property
+    def rgba(self) -> tuple[int, int, int, int]:
+        return self.rgb[0], self.rgb[1], self.rgb[2], self.a
+
+    @property
+    def float_rgba(self) -> tuple[float, float, float, float]:
+        return self.float_rgb[0], self.float_rgb[1], self.float_rgb[2], self.float_a
+
+    @property
+    def hex(self) -> str:
+        return rgb_to_hex(self.r, self.g, self.b)
+
+    def __iter__(self):
+        yield self.r
+        yield self.g
+        yield self.b
+        yield self.a
+
+    def __len__(self):
+        return 4
+
+    def __getitem__(self, item):
+        prop = self.r, self.g, self.b, self.a
+
+        return prop[item]
+
+    def __add__(self, other):
+        if isinstance(other, MColor):
+            r, g, b, a = other
+            return MColor(self.r + r, self.g + g, self.b + b, self.a + a)
+
+        raise TypeError(other)
+
+    def __sub__(self, other):
+        if isinstance(other, MColor):
+            r, g, b, a = other
+            return MColor(self.r - r, self.g - g, self.b - b, self.a - a)
+
+        raise TypeError(other)
+
+    def __repr__(self):
+        return f"[MColor r={self.r} g={self.g} b={self.b} a={self.a}]"
+
+    def __str__(self):
+        return f'{self.CONSOLE_COLOR}'
+
+
+class Black(MColor):
+    CONSOLE_COLOR = ForeBlack()
+
+    def __init__(self, a: int = 255):
+        super().__init__(0, 0, 0, a)
+
+
+class Red(MColor):
+    CONSOLE_COLOR = ForeRed()
+
+    def __init__(self, a: int = 255):
+        super().__init__(255, 0, 0, a)
+
+
+class Green(MColor):
+    CONSOLE_COLOR = ForeGreen()
+
+    def __init__(self, a: int = 255):
+        super().__init__(0, 255, 0, a)
+
+
+class Yellow(MColor):
+    CONSOLE_COLOR = ForeYellow()
+
+    def __init__(self, a: int = 255):
+        super().__init__(255, 255, 0, a)
+
+
+class Blue(MColor):
+    CONSOLE_COLOR = ForeBlue()
+
+    def __init__(self, a: int = 255):
+        super().__init__(0, 0, 255, a)
+
+
+class Magenta(MColor):
+    CONSOLE_COLOR = ForeMagenta()
+
+    def __init__(self, a: int = 255):
+        super().__init__(255, 0, 255, a)
+
+
+class Cyan(MColor):
+    CONSOLE_COLOR = ForeCyan()
+
+    def __init__(self, a: int = 255):
+        super().__init__(0, 255, 255, a)
+
+
+class White(MColor):
+    CONSOLE_COLOR = ForeWhite()
+
+    def __init__(self, a: int = 255):
+        super().__init__(255, 255, 255, a)

vebplib-1.0.0/vebplib/color/_console/__init__.py

@@ -0,0 +1,53 @@
+from colorama import Fore
+
+
+class ConsoleColor:
+    def __init__(self, fore):
+        self._fore = fore
+
+    @property
+    def fore(self):
+        return self._fore
+
+    def __str__(self):
+        return self.fore
+
+
+class ForeBlack(ConsoleColor):
+    def __init__(self):
+        super().__init__(Fore.BLACK)
+
+
+class ForeRed(ConsoleColor):
+    def __init__(self):
+        super().__init__(Fore.RED)
+
+
+class ForeGreen(ConsoleColor):
+    def __init__(self):
+        super().__init__(Fore.GREEN)
+
+
+class ForeYellow(ConsoleColor):
+    def __init__(self):
+        super().__init__(Fore.YELLOW)
+
+
+class ForeBlue(ConsoleColor):
+    def __init__(self):
+        super().__init__(Fore.BLUE)
+
+
+class ForeMagenta(ConsoleColor):
+    def __init__(self):
+        super().__init__(Fore.MAGENTA)
+
+
+class ForeCyan(ConsoleColor):
+    def __init__(self):
+        super().__init__(Fore.CYAN)
+
+
+class ForeWhite(ConsoleColor):
+    def __init__(self):
+        super().__init__(Fore.WHITE)

vebplib-1.0.0/vebplib/color/util.py

@@ -0,0 +1,40 @@
+def vali_rgba(r, g, b, a=255):
+    return (
+        min(255, max(0, r)),
+        min(255, max(0, g)),
+        min(255, max(0, b)),
+        min(255, max(0, a))
+    )
+
+def hex_to_rgb(hex_str: str) -> tuple[int, int, int, int]:
+    r, g, b, a = 0, 0, 0, 255
+
+    hex_str = hex_str.lstrip('#')
+
+    if len(hex_str) not in (3, 4, 6, 8):
+        raise ValueError("十六进制颜色代码必须是3, 4, 6或8个字符")
+
+    if len(hex_str) == 3:
+        hex_str = ''.join([c * 2 for c in hex_str])
+    elif len(hex_str) == 4:
+        hex_str = ''.join([c * 2 for c in hex_str])
+        alpha_hex = hex_str[6:8]
+        a = int(alpha_hex, 16)
+        hex_str = hex_str[0:6]
+
+    if len(hex_str) == 8:
+        alpha_hex = hex_str[6:8]
+        a = int(alpha_hex, 16)
+        hex_str = hex_str[0:6]
+
+    try:
+        r = int(hex_str[0:2], 16)
+        g = int(hex_str[2:4], 16)
+        b = int(hex_str[4:6], 16)
+    except ValueError:
+        raise ValueError("无效的十六进制颜色代码")
+
+    return r, g, b, a
+
+def rgb_to_hex(r, g, b) -> str:
+    return '#%02x%02x%02x' % vali_rgba(r, g, b)[0:3]

vebplib-1.0.0/vebplib/file/__init__.py

@@ -0,0 +1,151 @@
+import os
+import shutil
+from pathlib import Path
+from typing import Optional, Iterator
+
+from vebplib.path import MPath
+from vebplib.types import path_type
+
+
+class Stream:
+    def __init__(self, path: path_type):
+        self._path = MPath.to_path(path)
+
+    @property
+    def name(self) -> str:
+        return self.path.name
+
+    @property
+    def path(self) -> Path:
+        return self._path
+
+    @property
+    def exists(self) -> bool:
+        return self.path.exists()
+
+    def copy(self, destination, ignore=None):
+        if ignore is None:
+            ignore = []
+
+        source = MPath.to_path(self.path)
+        destination = MPath.to_path(destination)
+
+        FolderStream(destination).create()
+
+        if not source.exists():
+            return False
+
+        if source.is_dir():
+            shutil.copytree(
+                source,
+                destination,
+                dirs_exist_ok=True,
+                ignore=shutil.ignore_patterns(*ignore),
+            )
+        else:
+            shutil.copy(
+                source,
+                destination,
+            )
+
+        return True
+
+    def delete(self):
+        source = MPath.to_path(self.path)
+
+        if source.is_dir():
+            shutil.rmtree(source, ignore_errors=True)
+        else:
+            source.unlink(missing_ok=True)
+
+    def __eq__(self, other):
+        return self.path == other.root
+
+    def __str__(self) -> str:
+        return str(self.path)
+
+    def __repr__(self) -> str:
+        return f"[{self.__class__.__name__} {self}]"
+
+
+class FileStream(Stream):
+    @property
+    def suffix(self) -> str:
+        return self.path.suffix
+
+    def read(self) -> Optional[str]:
+        if not self.exists:
+            raise FileNotFoundError("File not found")
+
+        with open(self.path, "r", encoding="utf-8") as f:
+            return f.read()
+
+    def write(self, text: str):
+        if not self.exists:
+            raise FileNotFoundError("File not found")
+
+        with open(self.path, "w", encoding="utf-8") as f:
+            f.write(text)
+
+    def create(self, value: str = ""):
+        if self.exists:
+            return
+
+        with open(self.path, "w", encoding="utf-8") as f:
+            f.write(value)
+
+
+class DirectoryInfo:
+    def __init__(self, path, folders, files) -> None:
+        self._path = os.path.normpath(path)
+        self._folders = folders
+        self._files = files
+
+    def __iter__(self) -> Iterator:
+        yield self._path
+        yield self._folders
+        yield self._files
+
+    def __repr__(self) -> str:
+        return f"<DirectoryInfo: {self._path}>"
+
+    @property
+    def path(self) -> str:
+        return self._path
+
+    @property
+    def folders(self) -> list["FolderStream"]:
+        return self._folders
+
+    @property
+    def files(self) -> list[FileStream]:
+        return self._files
+
+
+class FolderStream(Stream):
+    def create(self):
+        if self.exists:
+            return self
+
+        self.path.mkdir(parents=True, exist_ok=True)
+
+        return self
+
+    def walk(self) -> Optional[DirectoryInfo]:
+        if not self.exists: return None
+
+        folders = []
+        files = []
+
+        try:
+            with os.scandir(self._path) as entries:
+                for entry in entries:
+                    if entry.is_dir():
+                        sub_folder = FolderStream(entry.path)
+                        folders.append(sub_folder)
+                    elif entry.is_file():
+                        files.append(FileStream(entry.path))
+        except PermissionError:
+            pass
+
+        return DirectoryInfo(self._path, folders, files)

vebplib-1.0.0/vebplib/file/json.py

@@ -0,0 +1,24 @@
+import json
+from typing import Optional, Any
+
+from rushlib.file import FileStream
+
+
+class JsonStream(FileStream):
+    @property
+    def is_json(self) -> bool:
+        return self.suffix == ".json"
+
+    def read(self) -> Optional[dict[str, Any]]:
+        if not self.exists:
+            raise FileNotFoundError("File not found")
+
+        with open(self.path, mode='r', encoding='utf-8') as f:
+            return json.load(f)
+
+    def write(self, data: dict, indent=4) -> None:
+        if not self.exists:
+            raise FileNotFoundError("File not found")
+
+        with open(self._path, 'w', encoding="utf-8") as file:
+            json.dump(data, file, indent=indent, ensure_ascii=False)

vebplib-1.0.0/vebplib/file/plist.py

@@ -0,0 +1,24 @@
+import plistlib
+from typing import Optional, Any
+
+from vebplib.file import FileStream
+
+
+class PlistStream(FileStream):
+    @property
+    def is_plist(self) -> bool:
+        return self.suffix == ".json"
+
+    def read(self) -> Optional[dict[str, Any]]:
+        if not self.exists:
+            raise FileNotFoundError("File not found")
+
+        with open(self.path, mode='rb', encoding='utf-8') as f:
+            return plistlib.load(f)
+
+    def write(self, data: dict, indent=4) -> None:
+        if not self.exists:
+            raise FileNotFoundError("File not found")
+
+        with open(self._path, 'wb', encoding="utf-8") as file:
+            plistlib.dump(data, file)

vebplib-1.0.0/vebplib/func/__init__.py

@@ -0,0 +1,80 @@
+import inspect
+from inspect import Parameter
+from functools import wraps
+from typing import Callable, Any
+
+
+def smart_call(func: Callable, *args: Any, **kwargs: Any) -> Any:
+    """
+    智能调用函数，根据目标函数的参数签名自动匹配传入的参数
+
+    :param func: 要调用的目标函数
+    :return: 目标函数的执行结果
+    """
+    try:
+        # 获取函数签名
+        sig = inspect.signature(func)
+    except (ValueError, TypeError):
+        # 无法获取签名时直接尝试调用
+        return func(*args, **kwargs)
+
+    # 准备参数绑定
+    bound_args = {}
+    params = sig.parameters
+
+    # 处理位置参数
+    args_iter = iter(args)
+    for name, param in params.items():
+        if param.kind in (Parameter.POSITIONAL_ONLY,
+                          Parameter.POSITIONAL_OR_KEYWORD,
+                          Parameter.KEYWORD_ONLY):
+            # 尝试从位置参数获取值
+            if args_iter:
+                try:
+                    bound_args[name] = next(args_iter)
+                    continue
+                except StopIteration:
+                    pass
+
+            # 如果位置参数用完，尝试从关键字参数获取
+            if name in kwargs:
+                bound_args[name] = kwargs[name]
+            elif param.default is not Parameter.empty:
+                # 使用默认值
+                bound_args[name] = param.default
+            else:
+                # 必需参数缺失
+                raise TypeError(f"Missing required argument: {name}")
+
+        elif param.kind == Parameter.VAR_POSITIONAL:
+            # 处理 *args 参数
+            bound_args[name] = tuple(args_iter)
+            args_iter = None  # 标记位置参数已耗尽
+
+    # 处理剩余的关键字参数
+    for name, param in params.items():
+        if param.kind == Parameter.VAR_KEYWORD:
+            # 处理 **kwargs 参数
+            bound_args[name] = {
+                k: v for k, v in kwargs.items()
+                if k not in bound_args
+            }
+            break
+        elif name not in bound_args and param.kind == Parameter.KEYWORD_ONLY:
+            # 处理仅关键字参数
+            if name in kwargs:
+                bound_args[name] = kwargs[name]
+            elif param.default is not Parameter.empty:
+                bound_args[name] = param.default
+            else:
+                raise TypeError(f"Missing required keyword argument: {name}")
+
+    return func(**bound_args)
+
+
+def adapt_args(func):
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        return smart_call(func, *args, **kwargs)
+
+    return wrapper