xulbux 1.9.5__cp311-cp311-macosx_11_0_arm64.whl

xulbux/system.py

@@ -0,0 +1,313 @@
+"""
+This module provides the `System` class, which includes
+methods to interact with the underlying operating system.
+"""
+
+from .base.types import MissingLibsMsgs
+from .base.decorators import mypyc_attr
+
+from .format_codes import FormatCodes
+from .console import Console
+
+from typing import Optional
+import subprocess as _subprocess
+import multiprocessing as _multiprocessing
+import platform as _platform
+import ctypes as _ctypes
+import getpass as _getpass
+import socket as _socket
+import time as _time
+import sys as _sys
+import os as _os
+
+
+@mypyc_attr(native_class=False)
+class _SystemMeta(type):
+
+    @property
+    def is_elevated(cls) -> bool:
+        """Whether the current process has elevated privileges or not."""
+        try:
+            if _os.name == "nt":
+                return getattr(_ctypes, "windll").shell32.IsUserAnAdmin() != 0
+            elif _os.name == "posix":
+                return _os.geteuid() == 0  # type: ignore[attr-defined]
+        except Exception:
+            pass
+        return False
+
+    @property
+    def is_win(cls) -> bool:
+        """Whether the current operating system is Windows or not."""
+        return _platform.system() == "Windows"
+
+    @property
+    def is_linux(cls) -> bool:
+        """Whether the current operating system is Linux or not."""
+        return _platform.system() == "Linux"
+
+    @property
+    def is_mac(cls) -> bool:
+        """Whether the current operating system is macOS or not."""
+        return _platform.system() == "Darwin"
+
+    @property
+    def is_unix(cls) -> bool:
+        """Whether the current operating system is a Unix-like OS (Linux, macOS, BSD, …) or not."""
+        return _os.name == "posix"
+
+    @property
+    def hostname(cls) -> str:
+        """The network hostname of the current machine."""
+        try:
+            return _socket.gethostname()
+        except Exception:
+            return "unknown"
+
+    @property
+    def username(cls) -> str:
+        """The name of the current user."""
+        try:
+            return _getpass.getuser()
+        except Exception:
+            try:
+                return _os.getlogin()
+            except Exception:
+                return "unknown"
+
+    @property
+    def os_name(cls) -> str:
+        """The name of the operating system (e.g. `Windows`, `Linux`, …)."""
+        return _platform.system()
+
+    @property
+    def os_version(cls) -> str:
+        """The version of the operating system."""
+        try:
+            return _platform.version()
+        except Exception:
+            return "unknown"
+
+    @property
+    def architecture(cls) -> str:
+        """The CPU architecture (e.g. `x86_64`, `ARM`, …)."""
+        return _platform.machine()
+
+    @property
+    def cpu_count(cls) -> int:
+        """The number of CPU cores available."""
+        try:
+            count = _multiprocessing.cpu_count()
+            return count if count is not None else 1
+        except (NotImplementedError, AttributeError):
+            return 1
+
+    @property
+    def python_version(cls) -> str:
+        """The version string of the currently running Python interpreter (e.g. `3.10.4`)."""
+        return _platform.python_version()
+
+
+class System(metaclass=_SystemMeta):
+    """This class provides methods to interact with the underlying operating system."""
+
+    @classmethod
+    def restart(cls, prompt: object = "", wait: int = 0, continue_program: bool = False, force: bool = False) -> None:
+        """Restarts the system with some advanced options\n
+        --------------------------------------------------------------------------------------------------
+        - `prompt` -⠀the message to be displayed in the systems restart notification
+        - `wait` -⠀the time to wait until restarting in seconds
+        - `continue_program` -⠀whether to continue the current Python program after calling this function
+        - `force` -⠀whether to force a restart even if other processes are still running"""
+        if wait < 0:
+            raise ValueError(f"The 'wait' parameter must be non-negative, got {wait!r}")
+
+        _SystemRestartHelper(prompt, wait, continue_program, force)()
+
+    @classmethod
+    def check_libs(
+        cls,
+        lib_names: list[str],
+        install_missing: bool = False,
+        missing_libs_msgs: MissingLibsMsgs = {
+            "found_missing": "The following required libraries are missing:",
+            "should_install": "Do you want to install them now?",
+        },
+        confirm_install: bool = True,
+    ) -> Optional[list[str]]:
+        """Checks if the given list of libraries are installed and optionally installs missing libraries.\n
+        ------------------------------------------------------------------------------------------------------------
+        - `lib_names` -⠀a list of library names to check
+        - `install_missing` -⠀whether to directly missing libraries will be installed automatically using pip
+        - `missing_libs_msgs` -⠀two messages: the first one is displayed when missing libraries are found,
+          the second one is the confirmation message before installing missing libraries
+        - `confirm_install` -⠀whether the user will be asked for confirmation before installing missing libraries\n
+        ------------------------------------------------------------------------------------------------------------
+        If some libraries are missing or they could not be installed, their names will be returned as a list.
+        If all libraries are installed (or were installed successfully), `None` will be returned."""
+        return _SystemCheckLibsHelper(lib_names, install_missing, missing_libs_msgs, confirm_install)()
+
+    @classmethod
+    def elevate(cls, win_title: Optional[str] = None, args: Optional[list] = None) -> bool:
+        """Attempts to start a new process with elevated privileges.\n
+        ---------------------------------------------------------------------------------
+        - `win_title` -⠀the window title of the elevated process (only on Windows)
+        - `args` -⠀a list of additional arguments to be passed to the elevated process\n
+        ---------------------------------------------------------------------------------
+        After the elevated process started, the original process will exit.<br>
+        This means, that this method has to be run at the beginning of the program or
+        or else the program has to continue in a new window after elevation.\n
+        ---------------------------------------------------------------------------------
+        Returns `True` if the current process already has elevated privileges and raises
+        a `PermissionError` if the user denied the elevation or the elevation failed."""
+        if cls.is_elevated:
+            return True
+
+        args_list = args or []
+
+        if _os.name == "nt":  # WINDOWS
+            if win_title:
+                args_str = f'-c "import ctypes; ctypes.windll.kernel32.SetConsoleTitleW(\\"{win_title}\\"); exec(open(\\"{_sys.argv[0]}\\").read())" {" ".join(args_list)}"'
+            else:
+                args_str = f'-c "exec(open(\\"{_sys.argv[0]}\\").read())" {" ".join(args_list)}'
+
+            result = getattr(_ctypes, "windll").shell32.ShellExecuteW(None, "runas", _sys.executable, args_str, None, 1)
+            if result <= 32:
+                raise PermissionError("Failed to launch elevated process.")
+            else:
+                _sys.exit(0)
+
+        else:  # POSIX
+            cmd = ["pkexec"]
+            if win_title:
+                cmd.extend(["--description", win_title])
+            cmd.extend([_sys.executable] + _sys.argv[1:] + args_list)
+
+            proc = _subprocess.Popen(cmd)
+            proc.wait()
+            if proc.returncode != 0:
+                raise PermissionError("Process elevation was denied.")
+            _sys.exit(0)
+
+
+class _SystemRestartHelper:
+    """Internal, callable helper class to handle system restart with platform-specific logic."""
+
+    def __init__(self, prompt: object, wait: int, continue_program: bool, force: bool):
+        self.prompt = prompt
+        self.wait = wait
+        self.continue_program = continue_program
+        self.force = force
+
+    def __call__(self) -> None:
+        if (system := _platform.system().lower()) == "windows":
+            self.restart_windows()
+        elif system in {"linux", "darwin"}:
+            self.restart_posix()
+        else:
+            raise NotImplementedError(f"Restart not implemented for '{system}' systems.")
+
+    def check_running_processes(self, command: str | list[str], skip_lines: int = 0) -> None:
+        """Check if processes are running and raise error if force is False."""
+        if self.force:
+            return
+
+        if isinstance(command, str):
+            output = _subprocess.check_output(command, shell=True).decode()
+        else:
+            output = _subprocess.check_output(command).decode()
+
+        processes = [line for line in output.splitlines()[skip_lines:] if line.strip()]
+        if len(processes) > 2:  # EXCLUDING PYTHON AND SHELL PROCESSES
+            raise RuntimeError("Processes are still running.\nTo restart anyway set parameter 'force' to True.")
+
+    def restart_windows(self) -> None:
+        """Handle Windows system restart."""
+        self.check_running_processes("tasklist", skip_lines=3)
+
+        if self.prompt:
+            _os.system(f'shutdown /r /t {self.wait} /c "{self.prompt}"')
+        else:
+            _os.system("shutdown /r /t 0")
+
+        if self.continue_program:
+            self.wait_for_restart()
+
+    def restart_posix(self) -> None:
+        """Handle Linux/macOS system restart."""
+        self.check_running_processes(["ps", "-A"], skip_lines=1)
+
+        if self.prompt:
+            _subprocess.Popen(["notify-send", "System Restart", str(self.prompt)])
+            _time.sleep(self.wait)
+
+        try:
+            _subprocess.run(["sudo", "shutdown", "-r", "now"])
+        except _subprocess.CalledProcessError:
+            raise PermissionError("Failed to restart: insufficient privileges.\nEnsure sudo permissions are granted.")
+
+        if self.continue_program:
+            self.wait_for_restart()
+
+    def wait_for_restart(self) -> None:
+        """Wait and print message before restart."""
+        print(f"Restarting in {self.wait} seconds...")
+        _time.sleep(self.wait)
+
+
+class _SystemCheckLibsHelper:
+    """Internal, callable helper class to check and install missing Python libraries."""
+
+    def __init__(
+        self,
+        lib_names: list[str],
+        install_missing: bool,
+        missing_libs_msgs: MissingLibsMsgs,
+        confirm_install: bool,
+    ):
+        self.lib_names = lib_names
+        self.install_missing = install_missing
+        self.missing_libs_msgs = missing_libs_msgs
+        self.confirm_install = confirm_install
+
+    def __call__(self) -> Optional[list[str]]:
+        missing = self.find_missing_libs()
+
+        if not missing:
+            return None
+        elif not self.install_missing:
+            return missing
+
+        if self.confirm_install and not self.confirm_installation(missing):
+            return missing
+
+        return self.install_libs(missing)
+
+    def find_missing_libs(self) -> list[str]:
+        """Find which libraries are missing."""
+        missing = []
+        for lib in self.lib_names:
+            try:
+                __import__(lib)
+            except ImportError:
+                missing.append(lib)
+        return missing
+
+    def confirm_installation(self, missing: list[str]) -> bool:
+        """Ask user for confirmation before installing libraries."""
+        FormatCodes.print(f"[b]({self.missing_libs_msgs['found_missing']})")
+        for lib in missing:
+            FormatCodes.print(f" [dim](•) [i]{lib}[_i]")
+        print()
+        return Console.confirm(self.missing_libs_msgs["should_install"], end="\n")
+
+    def install_libs(self, missing: list[str]) -> Optional[list[str]]:
+        """Install missing libraries using pip."""
+        for lib in missing[:]:
+            try:
+                _subprocess.check_call([_sys.executable, "-m", "pip", "install", lib])
+                missing.remove(lib)
+            except _subprocess.CalledProcessError:
+                pass
+
+        return None if len(missing) == 0 else missing

xulbux-1.9.5.dist-info/METADATA

@@ -0,0 +1,271 @@
+Metadata-Version: 2.4
+Name: xulbux
+Version: 1.9.5
+Summary: A Python library to simplify common programming tasks.
+Author-email: XulbuX <xulbux.real@gmail.com>
+Maintainer-email: XulbuX <xulbux.real@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/XulbuX/PythonLibraryXulbuX
+Project-URL: Documentation, https://github.com/XulbuX/PythonLibraryXulbuX/wiki
+Project-URL: Source Code, https://github.com/XulbuX/PythonLibraryXulbuX/tree/main/src
+Project-URL: Changelog, https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md
+Project-URL: Bug Reports, https://github.com/XulbuX/PythonLibraryXulbuX/issues
+Project-URL: Stats, https://clickpy.clickhouse.com/dashboard/xulbux
+Project-URL: License, https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/LICENSE
+Keywords: args,arguments,attributes,classes,client,cmd,code,codes,color,commands,console,constants,consts,conversion,convert,data,debug,easier,env,environment,error,file,format,formatting,functions,helper,hex,hexa,hsl,hsla,info,input,json,library,log,logging,methods,nice,operations,path,presets,pretty,printing,properties,python,re,regex,rgb,rgba,string,structures,system,tools,types,utility,warn,warning,xulbux
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: keyboard>=0.13.5
+Requires-Dist: prompt_toolkit>=3.0.41
+Requires-Dist: regex>=2023.10.3
+Provides-Extra: dev
+Requires-Dist: flake8-pyproject>=1.2.3; extra == "dev"
+Requires-Dist: flake8>=6.1.0; extra == "dev"
+Requires-Dist: pytest>=7.4.2; extra == "dev"
+Requires-Dist: toml>=0.10.2; extra == "dev"
+Dynamic: license-file
+
+> [!IMPORTANT]<br>
+> This library is compatible with Python 3.14, but **some dependencies may not yet support this version**.
+
+# **xulbux**
+
+[![](https://img.shields.io/pypi/v/xulbux?style=flat&labelColor=404560&color=7075FF)](https://pypi.org/project/xulbux) [![](https://img.shields.io/pepy/dt/xulbux?style=flat&labelColor=404560&color=7075FF)](https://clickpy.clickhouse.com/dashboard/xulbux) [![](https://img.shields.io/github/license/XulbuX/PythonLibraryXulbuX?style=flat&labelColor=405555&color=70FFEE)](https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/LICENSE) [![](https://img.shields.io/github/last-commit/XulbuX/PythonLibraryXulbuX?style=flat&labelColor=554045&color=FF6065)](https://github.com/XulbuX/PythonLibraryXulbuX/commits) [![](https://img.shields.io/github/issues/XulbuX/PythonLibraryXulbuX?style=flat&labelColor=554045&color=FF6065)](https://github.com/XulbuX/PythonLibraryXulbuX/issues) [![](https://img.shields.io/github/stars/XulbuX/PythonLibraryXulbuX?label=★&style=flat&labelColor=604A40&color=FF9673)](https://github.com/XulbuX/PythonLibraryXulbuX/stargazers)
+
+**`xulbux`** is a library that contains many useful classes, types, and functions,
+ranging from console logging and working with colors to file management and system operations.
+The library is designed to simplify common programming tasks and improve code readability through its collection of tools.
+
+For precise information about the library, see the library's [**documentation**](https://github.com/XulbuX/PythonLibraryXulbuX/wiki).<br>
+For the libraries latest changes and updates, see the [**change log**](https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md).
+
+### The best modules, you have to check out:
+
+[![format_codes](https://img.shields.io/badge/format__codes-B272FC?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/format_codes) [![console](https://img.shields.io/badge/console-B272FC?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/console) [![color](https://img.shields.io/badge/color-B272FC?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/color)
+
+<br>
+
+## Installation
+
+Run the following commands in a console with administrator privileges, so the actions take effect for all users.
+
+Install the library and all its dependencies with the command:
+```console
+pip install xulbux
+```
+
+Upgrade the library and all its dependencies to their latest available version with the command:
+```console
+pip install --upgrade xulbux
+```
+
+<br>
+
+## CLI Commands
+
+When the library is installed, the following commands are available in the console:
+| Command       | Description                              |
+| :------------ | :--------------------------------------- |
+| `xulbux-help` | shows some information about the library |
+
+<br>
+
+## Usage
+
+Import the full library under the alias `xx`, so its modules and main classes are accessible with `xx.module.Class`, `xx.MainClass.method()`:
+```python
+import xulbux as xx
+```
+
+So you don't have to import the full library under an alias, you can also import only certain parts of the library's contents:
+```python
+# LIBRARY SUB MODULES
+from xulbux.base.consts import COLOR, CHARS, ANSI
+# MODULE MAIN CLASSES
+from xulbux import Code, Color, Console, ...
+# MODULE SPECIFIC IMPORTS
+from xulbux.color import rgba, hsla, hexa
+```
+
+<br>
+
+## Modules
+
+<table>
+  <thead>
+    <tr>
+      <th align="left">Main Module</th>
+      <th align="left">Contents</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><a href="https://github.com/XulbuX/PythonLibraryXulbuX/wiki/base"><img src="https://img.shields.io/badge/base-B272FC?style=for-the-badge" alt="base"></a></td>
+      <td>
+        <table>
+          <thead>
+            <tr>
+              <th align="left">Sub Module</th>
+              <th align="left">Contents</th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr>
+              <td><a href="https://github.com/XulbuX/PythonLibraryXulbuX/wiki/base#consts"><img src="https://img.shields.io/badge/consts-B272FC?style=for-the-badge" alt="consts"></a></td>
+              <td>Constant values used throughout the library.</td>
+            </tr>
+            <tr>
+              <td><a href="https://github.com/XulbuX/PythonLibraryXulbuX/wiki/base#exceptions"><img src="https://img.shields.io/badge/exceptions-B272FC?style=for-the-badge" alt="exceptions"></a></td>
+              <td>Custom exception classes used throughout the library.</td>
+            </tr>
+            <tr>
+              <td><a href="https://github.com/XulbuX/PythonLibraryXulbuX/wiki/base#types"><img src="https://img.shields.io/badge/types-B272FC?style=for-the-badge" alt="types"></a></td>
+              <td>Custom type definitions used throughout the library.</td>
+            </tr>
+          </tbody>
+        </table>
+      </td>
+    </tr>
+    <tr>
+      <td><a href="https://github.com/XulbuX/PythonLibraryXulbuX/wiki/code"><img src="https://img.shields.io/badge/code-B272FC?style=for-the-badge" alt="code"></a></td>
+      <td><code>Code</code> class, which includes methods to work with code strings.</td>
+    </tr>
+    <tr>
+      <td><a href="https://github.com/XulbuX/PythonLibraryXulbuX/wiki/color"><img src="https://img.shields.io/badge/color-B272FC?style=for-the-badge" alt="color"></a></td>
+      <td><code>rgba</code> <code>hsla</code> <code>hexa</code> <code>Color</code> classes, which include methods to work with<br>
+        colors in various formats.</td>
+    </tr>
+    <tr>
+      <td><a href="https://github.com/XulbuX/PythonLibraryXulbuX/wiki/console"><img src="https://img.shields.io/badge/console-B272FC?style=for-the-badge" alt="console"></a></td>
+      <td><code>Console</code> <code>ProgressBar</code> classes, which include methods for logging<br>
+        and other actions within the console.</td>
+    </tr>
+    <tr>
+      <td><a href="https://github.com/XulbuX/PythonLibraryXulbuX/wiki/data"><img src="https://img.shields.io/badge/data-B272FC?style=for-the-badge" alt="data"></a></td>
+      <td><code>Data</code> class, which includes methods to work with nested data structures.</td>
+    </tr>
+    <tr>
+      <td><a href="https://github.com/XulbuX/PythonLibraryXulbuX/wiki/env_path"><img src="https://img.shields.io/badge/env__path-B272FC?style=for-the-badge" alt="env_path"></a></td>
+      <td><code>EnvPath</code> class, which includes methods to work with the PATH environment variable.</td>
+    </tr>
+    <tr>
+      <td><a href="https://github.com/XulbuX/PythonLibraryXulbuX/wiki/path"><img src="https://img.shields.io/badge/file__sys-B272FC?style=for-the-badge" alt="path"></a></td>
+      <td><code>FileSys</code> class, which includes methods to work with the file system and directories.</td>
+    </tr>
+    <tr>
+      <td><a href="https://github.com/XulbuX/PythonLibraryXulbuX/wiki/file"><img src="https://img.shields.io/badge/file-B272FC?style=for-the-badge" alt="file"></a></td>
+      <td><code>File</code> class, which includes methods to work with files and file paths.</td>
+    </tr>
+    <tr>
+      <td><a href="https://github.com/XulbuX/PythonLibraryXulbuX/wiki/format_codes"><img src="https://img.shields.io/badge/format__codes-B272FC?style=for-the-badge" alt="format_codes"></a></td>
+      <td><code>FormatCodes</code> class, which includes methods to print and work with strings that contain<br>
+        special formatting codes, which are then converted to ANSI codes for pretty console output.</td>
+    </tr>
+    <tr>
+      <td><a href="https://github.com/XulbuX/PythonLibraryXulbuX/wiki/json"><img src="https://img.shields.io/badge/json-B272FC?style=for-the-badge" alt="json"></a></td>
+      <td><code>Json</code> class, which includes methods to read, create and update JSON files,<br>
+        with support for comments inside the JSON data.</td>
+    </tr>
+    <tr>
+      <td><a href="https://github.com/XulbuX/PythonLibraryXulbuX/wiki/regex"><img src="https://img.shields.io/badge/regex-B272FC?style=for-the-badge" alt="regex"></a></td>
+      <td><code>Regex</code> class, which includes methods to dynamically generate complex regex patterns<br>
+        for common use cases.</td>
+    </tr>
+    <tr>
+      <td><a href="https://github.com/XulbuX/PythonLibraryXulbuX/wiki/string"><img src="https://img.shields.io/badge/string-B272FC?style=for-the-badge" alt="string"></a></td>
+      <td><code>String</code> class, which includes various utility methods for string manipulation and conversion.</td>
+    </tr>
+    <tr>
+      <td><a href="https://github.com/XulbuX/PythonLibraryXulbuX/wiki/system"><img src="https://img.shields.io/badge/system-B272FC?style=for-the-badge" alt="system"></a></td>
+      <td><code>System</code> class, which includes methods to interact with the underlying operating system.</td>
+    </tr>
+  </tbody>
+</table>
+
+<br>
+
+## Example Usage
+
+This is what it could look like using this library for a simple but ultra good-looking color converter:
+```python
+from xulbux.base.consts import COLOR, CHARS
+from xulbux.color import hexa
+from xulbux import Console
+
+
+def main() -> None:
+
+    # LET THE USER ENTER A HEXA COLOR IN ANY HEXA FORMAT
+    input_clr = Console.input(
+        "[b](Enter a HEXA color in any format) > ",
+        start="\n",
+        placeholder="#7075FF",
+        max_len=7,
+        allowed_chars=CHARS.HEX_DIGITS,
+    )
+
+    # ANNOUNCE INDEXING THE INPUT COLOR
+    Console.log(
+        "INDEX",
+        "Indexing the input HEXA color...",
+        start="\n",
+        title_bg_color=COLOR.BLUE,
+    )
+
+    try:
+        # TRY TO CONVERT THE INPUT STRING INTO A hexa() OBJECT
+        hexa_color = hexa(input_clr)
+
+    except ValueError:
+        # ANNOUNCE THE INVALID INPUT COLOR AND EXIT THE PROGRAM
+        Console.fail(
+            "The input HEXA color is invalid.",
+            end="\n\n",
+            exit=True,
+        )
+
+    # ANNOUNCE STARTING THE CONVERSION
+    Console.log(
+        "CONVERT",
+        "Converting the HEXA color into different types...",
+        title_bg_color=COLOR.TANGERINE,
+    )
+
+    # CONVERT THE HEXA COLOR INTO THE TWO OTHER COLOR FORMATS
+    rgba_color = hexa_color.to_rgba()
+    hsla_color = hexa_color.to_hsla()
+
+    # ANNOUNCE THE SUCCESSFUL CONVERSION
+    Console.done(
+        "Successfully converted color into different types.",
+        end="\n\n",
+    )
+
+    # PRETTY PRINT THE COLOR IN DIFFERENT FORMATS
+    Console.log_box_bordered(
+        f"[b](HEXA:) [i|white]({hexa_color})",
+        f"[b](RGBA:) [i|white]({rgba_color})",
+        f"[b](HSLA:) [i|white]({hsla_color})",
+    )
+
+
+if __name__ == "__main__":
+    main()
+
+```
+
+<br>
+<br>
+
+-----------------------------------------------------------------
+[View this library on **PyPI**](https://pypi.org/project/xulbux)

xulbux-1.9.5.dist-info/RECORD

@@ -0,0 +1,43 @@
+455848faf89d8974b22a__mypyc.cpython-311-darwin.so,sha256=069yox67z4jhxsxbIiNTej0gGpxwY2sjl8brGA_Q7ZM,3014240
+xulbux/file_sys.cpython-311-darwin.so,sha256=eEj2YbHSlXympHYG1WvdLyo3tqsTcH-ayMuARyWezPw,50656
+xulbux/console.py,sha256=v_u9rsD1Wx1izNhj8jpOMGP-Zys9wOGvL3HgqN-Zoi8,89527
+xulbux/file_sys.py,sha256=rDonTTpCpVIcpEkqGJynyB-uwvqN5G7Ukyq5yWS2Ql8,10848
+xulbux/system.py,sha256=oPC8sKhabrTBXI61cTaLvPp3SL1JZQa6e2ru_spXOL8,12272
+xulbux/color.py,sha256=bFkz5tApLNjhrfgp-4IRApCnO3co9sCs5olVTLTnkes,63549
+xulbux/json.cpython-311-darwin.so,sha256=yXhzNdsUbJQzGZ3WevjuH6F7cWE2_FnpfG18bdKCMSg,50632
+xulbux/console.cpython-311-darwin.so,sha256=W-S83oMjiii7350XrJbsCTQG7mpioYOaamSTxVGA-ic,50656
+xulbux/color.cpython-311-darwin.so,sha256=eVUpt0LvyWths-kqKGYIhF3Ab_VPb6ZRgnvfD7SfszU,50632
+xulbux/string.cpython-311-darwin.so,sha256=FDRhXesidLZIXmWjzxEJz_NYbyULom9VMrgC-v8C0dw,50640
+xulbux/code.cpython-311-darwin.so,sha256=ZzaXOC2S9Eh4-_NShqsGCRA6hPd4zGh48DBEnvci3PQ,50632
+xulbux/code.py,sha256=cuC01ZRcPEDLlZ-5whc27pJKsZ-YiLHQqdvlPxPHD80,6633
+xulbux/__init__.py,sha256=BDCeIoSfeMZNxgwailjuHXSzxURuuNn6448c_bJzX5I,980
+xulbux/system.cpython-311-darwin.so,sha256=Y3FUIM7tfRpZ0Z7fd2uam9xbRdxHUH5JiO3M9tEChYo,50640
+xulbux/file.py,sha256=vDo7LqyJ2gVShc9a45P1yvQ4Ral9GZ8FFkSiYg-FZ_o,3001
+xulbux/env_path.py,sha256=OXdHIriy0Qd7IekKiEzkR6SHFYNrVpmMq0LtIN51GJY,5768
+xulbux/file.cpython-311-darwin.so,sha256=6d52SmMXFYf8cLFLkNZWinzPKVil-BPYWneEnSAl9ts,50632
+xulbux/data.cpython-311-darwin.so,sha256=527ZPc9LJIEC-ARa7CbD0oAWQ-Yr1axoCFlgx74Oc8E,50632
+xulbux/format_codes.cpython-311-darwin.so,sha256=gPOj59JTyuOiCSoyKsvwOkDO1G9fu03ETwGaSKywRho,50672
+xulbux/regex.cpython-311-darwin.so,sha256=MQxEqEESNvZL_2dr16Az5qK9xHZE268cyAQ5-1n9aQ4,50632
+xulbux/string.py,sha256=p9c0f8MQmhNvgYiN4_d8iwMkstMLZ9bXtYE6kqReFVw,8095
+xulbux/__init__.cpython-311-darwin.so,sha256=OgrVBKFwglDLAoy_PNzGvfaaTpur5kViaBV2nJFhA_0,50640
+xulbux/format_codes.py,sha256=D-kw0BHVn-fW8YgpNbeIXDV59yC9VA4KoXtubMYJjFg,33048
+xulbux/json.py,sha256=1NGC6Uo_DtvNUAo_W4Ef5pnYlrWIZz9o1K4y0OjADY8,8816
+xulbux/regex.py,sha256=jxTeV_rHYKOU6wHEpZUqwXsR9Oa9pmrR6I7wQCYzwZ4,11088
+xulbux/data.py,sha256=aG6IqXDqKMzC5pjH-v-ust3_kgwAzbBmQpIMkbAzIuQ,37717
+xulbux/env_path.cpython-311-darwin.so,sha256=NSKDoRmHtpBhrvmtSpPjYlm01N_aMeAjjIqQ4qwO-c8,50656
+xulbux/cli/help.cpython-311-darwin.so,sha256=qoAS2Nqdw_R6u-0ETPV7wzojz5ipHxt9Oy_rQ4JzWyY,50648
+xulbux/cli/help.py,sha256=m8ESGfCC_dZ4K8IvGmB_jRIkQqzANDIAVO5rSEyMbi8,4694
+xulbux/base/consts.cpython-311-darwin.so,sha256=UC0pp974NpWhEvfn1dimL3ctZ8jU3SBe3U8bUgC0jF0,50656
+xulbux/base/exceptions.cpython-311-darwin.so,sha256=9FhSAg9Lh6gXVYCl3Y05byfZLmKjXrlJ3QhPfJqM_QM,50672
+xulbux/base/types.cpython-311-darwin.so,sha256=BJKbHX0W2xTgRsZU1VqzeQuRn-iQpuzcvS-6YIttiNY,50648
+xulbux/base/types.py,sha256=diE4gtfa4ZbHfHcmIupbAHl_brD5aCwYNLMs8opkzCY,4621
+xulbux/base/consts.py,sha256=iHWfXl_HBvN0ijCZZKRHnknkChACGVAqO0UJNW3_90I,6121
+xulbux/base/decorators.cpython-311-darwin.so,sha256=VU11Sh9c6sty5yom3yk4dbpx3BOIZ0GzD2BqMMBMj6U,50672
+xulbux/base/exceptions.py,sha256=vGVBMCz9kIG3uqKLb4wgJzivvRfmyMFN1q9_EgtyBMc,694
+xulbux/base/decorators.py,sha256=eG4jQuTRv6Xjuk8T3G-jBI5jt9JIMqnxlY8ZgqxpFco,1025
+xulbux-1.9.5.dist-info/RECORD,,
+xulbux-1.9.5.dist-info/WHEEL,sha256=kRQSXRktg6-1OW1dEVdlVLDFcaf4B6AUNRZVJD--zs8,137
+xulbux-1.9.5.dist-info/entry_points.txt,sha256=aYh89GfiBOB8vw2VPgC6rhBinhnJoAL1kig-3lq_zkg,58
+xulbux-1.9.5.dist-info/top_level.txt,sha256=0pBrA469P41tUFO2XpUoGuu2NFBXnRgpe0pbojAlxOM,35
+xulbux-1.9.5.dist-info/METADATA,sha256=KRsysgBxA4zqDkw379dEB7QWsUe8JaXZcAa238sIlMA,12819
+xulbux-1.9.5.dist-info/licenses/LICENSE,sha256=LHwUGQKA35mmTlOCvvcg9RAiMQUA3e_n3q0taRMKE5w,1063

xulbux-1.9.5.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.1)
+Root-Is-Purelib: false
+Tag: cp311-cp311-macosx_11_0_arm64
+Generator: delocate 0.13.0
+

xulbux-1.9.5.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+xulbux-help = xulbux.cli.help:show_help

xulbux-1.9.5.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 XulbuX
+
+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.

xulbux-1.9.5.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+455848faf89d8974b22a__mypyc
+xulbux