xulbux 1.6.9__py3-none-any.whl → 1.7.1__py3-none-any.whl

xulbux/xx_format_codes.py

@@ -133,7 +133,8 @@ the formatting code:
 #### Additional Formatting Codes when a `default_color` is set
 
 1. `[*]` resets everything, just like `[_]`, but the text color will remain in `default_color`
-2. `[*color]` will reset the text color, just like `[_color]`, but then also make it `default_color`
+  (*if no `default_color` it resets everything, including the text color*)
+2. `[*color]` `[*c]` will reset the text color, just like `[_color]`, but then also make it `default_color`
 3. `[default]` will just color the text in `default_color`
 4. `[background:default]` `[BG:default]` will color the background in `default_color`
 
@@ -152,10 +153,10 @@ Per default, you can also use `+` and `-` to get lighter and darker `default_col
 
 from ._consts_ import ANSI
 from .xx_string import String
-from .xx_regex import Regex
-from .xx_color import Color, rgba, hexa
+from .xx_regex import Regex, Match, Pattern
+from .xx_color import Color, rgba, Rgba, Hexa
 
-from typing import Optional, Pattern
+from typing import Optional, cast
 import ctypes as _ctypes
 import regex as _rx
 import sys as _sys
@@ -174,7 +175,7 @@ _PREFIX_RX: dict[str, str] = {
 }
 _COMPILED: dict[str, Pattern] = {  # PRECOMPILE REGULAR EXPRESSIONS
     "*": _re.compile(r"\[\s*([^]_]*?)\s*\*\s*([^]_]*?)\]"),
-    "*color": _re.compile(r"\[\s*([^]_]*?)\s*\*color\s*([^]_]*?)\]"),
+    "*color": _re.compile(r"\[\s*([^]_]*?)\s*\*c(?:olor)?\s*([^]_]*?)\]"),
     "ansi_seq": _re.compile(ANSI.char + r"(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])"),
     "formatting": _rx.compile(
         Regex.brackets("[", "]", is_group=True, ignore_in_strings=False)
@@ -205,7 +206,7 @@ class FormatCodes:
     @staticmethod
     def print(
         *values: object,
-        default_color: rgba | hexa = None,
+        default_color: Optional[Rgba | Hexa] = None,
         brightness_steps: int = 20,
         sep: str = " ",
         end: str = "\n",
@@ -223,7 +224,7 @@ class FormatCodes:
     @staticmethod
     def input(
         prompt: object = "",
-        default_color: rgba | hexa = None,
+        default_color: Optional[Rgba | Hexa] = None,
         brightness_steps: int = 20,
         reset_ansi: bool = False,
     ) -> str:
@@ -243,7 +244,7 @@ class FormatCodes:
     @staticmethod
     def to_ansi(
         string: str,
-        default_color: rgba | hexa = None,
+        default_color: Optional[Rgba | Hexa] = None,
         brightness_steps: int = 20,
         _default_start: bool = True,
     ) -> str:
@@ -253,20 +254,23 @@ class FormatCodes:
         `xx_format_codes` module documentation."""
         if not isinstance(string, str):
             string = str(string)
-        if Color.is_valid_rgba(default_color, False):
+        if default_color and Color.is_valid_rgba(default_color, False):
             use_default = True
-        elif Color.is_valid_hexa(default_color, False):
+        elif default_color and Color.is_valid_hexa(default_color, False):
             use_default, default_color = True, Color.to_rgba(default_color)
         else:
             use_default = False
+        default_color = cast(rgba, default_color) if use_default else None
         if use_default:
             string = _COMPILED["*"].sub(r"[\1_|default\2]", string)  # REPLACE `[…|*|…]` WITH `[…|_|default|…]`
-            string = _COMPILED["*color"].sub(r"[\1default\2]", string)  # REPLACE `[…|*color|…]` WITH `[…|default|…]`
+            string = _COMPILED["*color"].sub(r"[\1default\2]", string)  # REPLACE `[…|*color|…]` OR `[…|*c|…]` WITH `[…|default|…]`
+        else:
+            string = _COMPILED["*"].sub(r"[\1_\2]", string)  # REPLACE `[…|*|…]` WITH `[…|_|…]`
 
         def is_valid_color(color: str) -> bool:
-            return color in ANSI.color_map or Color.is_valid_rgba(color) or Color.is_valid_hexa(color)
+            return bool((color in ANSI.color_map) or Color.is_valid_rgba(color) or Color.is_valid_hexa(color))
 
-        def replace_keys(match: _re.Match) -> str:
+        def replace_keys(match: Match) -> str:
             _formats = formats = match.group(1)
             auto_reset_escaped = match.group(2)
             auto_reset_txt = match.group(3)
@@ -292,7 +296,7 @@ class FormatCodes:
                         if k_set & _PREFIX["BR"]:
                             for i in range(len(k)):
                                 if is_valid_color(k[i:]):
-                                    reset_keys.extend(["_bg", "_color"])
+                                    reset_keys.extend(["_bg", "default"] if use_default else ["_bg", "_c"])
                                     break
                         else:
                             for i in range(len(k)):
@@ -302,7 +306,7 @@ class FormatCodes:
                     elif is_valid_color(k) or any(
                             k_lower.startswith(pref_colon := f"{prefix}:") and is_valid_color(k[len(pref_colon):])
                             for prefix in _PREFIX["BR"]):
-                        reset_keys.append("_color")
+                        reset_keys.append("default" if use_default else "_c")
                     else:
                         reset_keys.append(f"_{k}")
                 ansi_resets = [
@@ -325,7 +329,8 @@ class FormatCodes:
                 )
 
         string = "\n".join(_COMPILED["formatting"].sub(replace_keys, line) for line in string.split("\n"))
-        return ((FormatCodes.__get_default_ansi(default_color) if _default_start else "") + string) if use_default else string
+        return (((FormatCodes.__get_default_ansi(default_color.values()) or "") if _default_start else "")
+                + string) if default_color is not None else string
 
     @staticmethod
     def escape_ansi(ansi_string: str) -> str:
@@ -346,7 +351,7 @@ class FormatCodes:
         if get_removals:
             removals = []
 
-            def replacement(match: _re.Match) -> str:
+            def replacement(match: Match) -> str:
                 start_pos = match.start() - sum(len(removed) for _, removed in removals)
                 if removals and removals[-1][0] == start_pos:
                     start_pos = removals[-1][0]
@@ -364,6 +369,7 @@ class FormatCodes:
     @staticmethod
     def remove_formatting(
         string: str,
+        default_color: Optional[Rgba | Hexa] = None,
         get_removals: bool = False,
         _ignore_linebreaks: bool = False,
     ) -> str | tuple[str, tuple[tuple[int, str], ...]]:
@@ -373,7 +379,7 @@ class FormatCodes:
         Each tuple contains the position of the removed formatting code and the removed formatting code.\n
         If `_ignore_linebreaks` is true, linebreaks will be ignored for the removal positions."""
         return FormatCodes.remove_ansi(
-            FormatCodes.to_ansi(string),
+            FormatCodes.to_ansi(string, default_color=default_color),
             get_removals=get_removals,
             _ignore_linebreaks=_ignore_linebreaks,
         )
@@ -393,9 +399,9 @@ class FormatCodes:
 
     @staticmethod
     def __get_default_ansi(
-        default_color: tuple,
-        format_key: str = None,
-        brightness_steps: int = None,
+        default_color: tuple[int, int, int],
+        format_key: Optional[str] = None,
+        brightness_steps: Optional[int] = None,
         _modifiers: tuple[str, str] = (ANSI.default_color_modifiers["lighten"], ANSI.default_color_modifiers["darken"]),
     ) -> Optional[str]:
         """Get the `default_color` and lighter/darker versions of it as ANSI code."""
@@ -403,8 +409,9 @@ class FormatCodes:
             return (ANSI.seq_bg_color if format_key and _COMPILED["bg_default"].search(format_key) else ANSI.seq_color).format(
                 *default_color[:3]
             )
-        if not (format_key in _modifiers[0] or format_key in _modifiers[1]):
+        if format_key is None or not (format_key in _modifiers[0] or format_key in _modifiers[1]):
             return None
+        assert format_key is not None
         match = _COMPILED["modifier"].match(format_key)
         if not match:
             return None
@@ -415,23 +422,25 @@ class FormatCodes:
             if adjust and adjust > 0:
                 modifiers = mod
                 break
+        new_rgb = default_color
         if adjust == 0:
             return None
         elif modifiers in _modifiers[0]:
-            new_rgb = Color.adjust_lightness(default_color, (brightness_steps / 100) * adjust)
+            new_rgb = tuple(Color.adjust_lightness(default_color, (brightness_steps / 100) * adjust))
         elif modifiers in _modifiers[1]:
-            new_rgb = Color.adjust_lightness(default_color, -(brightness_steps / 100) * adjust)
+            new_rgb = tuple(Color.adjust_lightness(default_color, -(brightness_steps / 100) * adjust))
         return (ANSI.seq_bg_color if is_bg else ANSI.seq_color).format(*new_rgb[:3])
 
     @staticmethod
-    def __get_replacement(format_key: str, default_color: rgba = None, brightness_steps: int = 20) -> str:
+    def __get_replacement(format_key: str, default_color: Optional[rgba], brightness_steps: int = 20) -> str:
         """Gives you the corresponding ANSI code for the given format key.
         If `default_color` is not `None`, the text color will be `default_color` if all formats
         are reset or you can get lighter or darker version of `default_color` (also as BG)"""
         use_default = default_color and Color.is_valid_rgba(default_color, False)
+        _default_color = tuple(Color.to_rgba(default_color)) if default_color is not None else tuple()
         _format_key, format_key = format_key, FormatCodes.__normalize_key(format_key)  # NORMALIZE KEY AND SAVE ORIGINAL
         if use_default:
-            if new_default_color := FormatCodes.__get_default_ansi(default_color, format_key, brightness_steps):
+            if new_default_color := FormatCodes.__get_default_ansi(_default_color, format_key, brightness_steps):
                 return new_default_color
         for map_key in ANSI.codes_map:
             if (isinstance(map_key, tuple) and format_key in map_key) or format_key == map_key:
@@ -440,8 +449,8 @@ class FormatCodes:
                         v for k, v in ANSI.codes_map.items() if format_key == k or (isinstance(k, tuple) and format_key in k)
                     ), None)
                 )
-        rgb_match = _re.match(_COMPILED["rgb"], format_key)
-        hex_match = _re.match(_COMPILED["hex"], format_key)
+        rgb_match = _COMPILED["rgb"].match(format_key)
+        hex_match = _COMPILED["hex"].match(format_key)
         try:
             if rgb_match:
                 is_bg = rgb_match.group(1)

xulbux/xx_json.py

@@ -26,13 +26,15 @@ class Json:
         if not json_file.endswith(".json"):
             json_file += ".json"
         file_path = Path.extend_or_make(json_file, prefer_script_dir=True)
+        if file_path is None:
+            raise FileNotFoundError(f"Could not find JSON file: {json_file}")
         with open(file_path, "r") as f:
             content = f.read()
         try:
             data = _json.loads(content)
         except _json.JSONDecodeError as e:
             raise ValueError(f"Error parsing JSON in '{file_path}':  {str(e)}")
-        processed_data = Data.remove_comments(data, comment_start, comment_end)
+        processed_data = dict(Data.remove_comments(data, comment_start, comment_end))
         if not processed_data:
             raise ValueError(f"The JSON file '{file_path}' is empty or contains only comments.")
         return (processed_data, data) if return_original else processed_data
@@ -135,24 +137,23 @@ class Json:
                         raise TypeError(f"Cannot navigate through {type(current).__name__}")
             return data_obj
 
+        update = {}
         for value_path, new_value in update_values.items():
             try:
                 path_id = Data.get_path_id(
                     data=processed_data,
                     value_paths=value_path,
                     path_sep=path_sep,
-                    ignore_not_found=True,
                 )
                 if path_id is not None:
-                    if 'update' not in locals():
-                        update = {}
                     update[path_id] = new_value
                 else:
+                    keys = value_path.split(path_sep)
                     keys = value_path.split(path_sep)
                     data = create_nested_path(data, keys, new_value)
             except Exception:
                 keys = value_path.split(path_sep)
                 data = create_nested_path(data, keys, new_value)
-        if 'update' in locals() and update:
+        if "update" in locals() and update:
             data = Data.set_value_by_path_id(data, update)
-        Json.create(json_file=json_file, data=data, force=True)
+        Json.create(json_file=json_file, data=dict(data), force=True)

xulbux/xx_path.py

@@ -23,9 +23,9 @@ class _ScriptDir:
             base_path = _os.path.dirname(_sys.executable)
         else:
             main_module = _sys.modules["__main__"]
-            if hasattr(main_module, "__file__"):
+            if hasattr(main_module, "__file__") and main_module.__file__ is not None:
                 base_path = _os.path.dirname(_os.path.abspath(main_module.__file__))
-            elif (hasattr(main_module, "__spec__") and main_module.__spec__ and getattr(main_module.__spec__, "origin", None)):
+            elif (hasattr(main_module, "__spec__") and main_module.__spec__ and main_module.__spec__.origin is not None):
                 base_path = _os.path.dirname(_os.path.abspath(main_module.__spec__.origin))
             else:
                 raise RuntimeError("Can only get base directory if accessed from a file.")
@@ -34,15 +34,15 @@ class _ScriptDir:
 
 class Path:
 
-    cwd: str = _Cwd()
+    cwd: str = _Cwd()  # type: ignore[assignment]
     """The path to the current working directory."""
-    script_dir: str = _ScriptDir()
+    script_dir: str = _ScriptDir()  # type: ignore[assignment]
     """The path to the directory of the current script."""
 
     @staticmethod
     def extend(
         rel_path: str,
-        search_in: str | list[str] = None,
+        search_in: Optional[str | list[str]] = None,
         raise_error: bool = False,
         use_closest_match: bool = False,
     ) -> Optional[str]:
@@ -120,7 +120,7 @@ class Path:
     @staticmethod
     def extend_or_make(
         rel_path: str,
-        search_in: str | list[str] = None,
+        search_in: Optional[str | list[str]] = None,
         prefer_script_dir: bool = True,
         use_closest_match: bool = False,
     ) -> str:
@@ -136,7 +136,7 @@ class Path:
         If `use_closest_match` is true, it is possible to have typos in the `search_in` path/s
         and it will still find the file if it is under one of those paths."""
         try:
-            return Path.extend(rel_path, search_in, raise_error=True, use_closest_match=use_closest_match)
+            return str(Path.extend(rel_path, search_in, raise_error=True, use_closest_match=use_closest_match))
         except PathNotFoundError:
             normalized_rel_path = _os.path.normpath(rel_path)
             base = Path.script_dir if prefer_script_dir else _os.getcwd()

xulbux/xx_regex.py

@@ -1,18 +1,23 @@
+from typing import TypeAlias, Optional
 import regex as _rx
 import re as _re
 
 
+Pattern: TypeAlias = _re.Pattern[str] | _rx.Pattern[str]
+Match: TypeAlias = _re.Match[str] | _rx.Match[str]
+
+
 class Regex:
 
     @staticmethod
     def quotes() -> str:
-        """Matches everything inside quotes. (strings)\n
+        """Matches pairs of quotes. (strings)\n
         --------------------------------------------------------------------------------
         Will create two named groups:
         - `quote` the quote type (single or double)
         - `string` everything inside the found quote pair\n
-        --------------------------------------------------------------------------------
-        Attention: Requires non standard library `regex` not standard library `re`!"""
+        ---------------------------------------------------------------------------------
+        Attention: Requires non-standard library `regex`, not standard library `re`!"""
         return r'(?P<quote>[\'"])(?P<string>(?:\\.|(?!\g<quote>).)*?)\g<quote>'
 
     @staticmethod
@@ -23,16 +28,16 @@ class Regex:
         strip_spaces: bool = True,
         ignore_in_strings: bool = True,
     ) -> str:
-        """Matches everything inside brackets, including other nested brackets.\n
-        --------------------------------------------------------------------------------
+        """Matches everything inside pairs of brackets, including other nested brackets.\n
+        -----------------------------------------------------------------------------------
         If `is_group` is true, you will be able to reference the matched content as a
         group (e.g. `match.group(…)` or `r'\\…'`).
         If `strip_spaces` is true, it will ignore spaces around the content inside the
         brackets.
         If `ignore_in_strings` is true and a bracket is inside a string (e.g. `'...'`
         or `"..."`), it will not be counted as the matching closing bracket.\n
-        --------------------------------------------------------------------------------
-        Attention: Requires non standard library `regex` not standard library `re`!"""
+        -----------------------------------------------------------------------------------
+        Attention: Requires non-standard library `regex`, not standard library `re`!"""
         g, b1, b2, s1, s2 = (
             "" if is_group else "?:",
             _rx.escape(bracket1) if len(bracket1) == 1 else bracket1,
@@ -63,13 +68,13 @@ class Regex:
         return rf'({"" if is_group else "?:"}(?:(?!{ignore_pattern}).)*(?:(?!{Regex.outside_strings(disallowed_pattern)}).)*)'
 
     @staticmethod
-    def func_call(func_name: str = None) -> str:
+    def func_call(func_name: Optional[str] = None) -> str:
         """Match a function call, and get back two groups:
         1. function name
         2. the function's arguments\n
         If no `func_name` is given, it will match any function call.\n
-        --------------------------------------------------------------------------------
-        Attention: Requires non standard library `regex` not standard library `re`!"""
+        ---------------------------------------------------------------------------------
+        Attention: Requires non-standard library `regex`, not standard library `re`!"""
         return (
             r"(?<=\b)(" + (r"[\w_]+" if func_name is None else func_name) + r")\s*" + Regex.brackets("(", ")", is_group=True)
         )

xulbux/xx_system.py

@@ -14,7 +14,7 @@ class _IsElevated:
             if _os.name == "nt":
                 return _ctypes.windll.shell32.IsUserAnAdmin() != 0
             elif _os.name == "posix":
-                return _os.geteuid() == 0
+                return _os.geteuid() == 0  # type: ignore[attr-defined]
         except Exception:
             pass
         return False
@@ -22,7 +22,7 @@ class _IsElevated:
 
 class System:
 
-    is_elevated: bool = _IsElevated()
+    is_elevated: bool = _IsElevated()  # type: ignore[assignment]
     """Is `True` if the current process has
     elevated privileges and `False` otherwise."""
 
@@ -54,7 +54,7 @@ class System:
                 if len(processes) > 2:  # EXCLUDING THE PYTHON PROCESS AND PS
                     raise RuntimeError("Processes are still running. Use the parameter `force=True` to restart anyway.")
             if prompt:
-                _subprocess.Popen(["notify-send", "System Restart", prompt])
+                _subprocess.Popen(["notify-send", "System Restart", str(prompt)])
                 _time.sleep(wait)
             try:
                 _subprocess.run(["sudo", "shutdown", "-r", "now"])
@@ -95,7 +95,7 @@ class System:
             return missing
 
     @staticmethod
-    def elevate(win_title: Optional[str] = None, args: Optional[list] = None) -> bool:
+    def elevate(win_title: Optional[str] = None, args: list = []) -> bool:
         """Attempts to start a new process with elevated privileges.\n
         ---------------------------------------------------------------------------------
         The param `win_title` is window the title of the elevated process.
@@ -106,7 +106,7 @@ class System:
         ---------------------------------------------------------------------------------
         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 System.is_elevated():
+        if System.is_elevated:
             return True
         if _os.name == "nt":  # WINDOWS
             if win_title:

{xulbux-1.6.9.dist-info → xulbux-1.7.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xulbux
-Version: 1.6.9
+Version: 1.7.1
 Summary: A Python library which includes lots of helpful classes, types and functions aiming to make common programming tasks simpler.
 Author-email: XulbuX <xulbux.real@gmail.com>
 License-Expression: MIT
@@ -34,14 +34,14 @@ Requires-Dist: flake8>=6.1.0; extra == "dev"
 Requires-Dist: flake8-pyproject>=1.2.3; extra == "dev"
 Dynamic: license-file
 
-# **$\color{#8085FF}\Huge\textsf{XulbuX}$**
+# **$\Huge\textsf{XulbuX}$**
 
-**$\color{#8085FF}\textsf{XulbuX}$** is library that contains many useful classes, types, and functions,
+**XulbuX** is 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 [wiki page](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).
+For precise information about the library, see the library's [**wiki page**](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).
 
 <br>
 
@@ -81,20 +81,20 @@ from xulbux import rgba, hsla, hexa
 
 ## Modules
 
-| Module                                                                                                                                                            | Short Description                                                                                  |
-| :---------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------- |
-| [![xx_code](https://img.shields.io/badge/xx__code-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_code)                         | advanced code-string operations (*changing the indent, finding function calls, ...*)               |
-| [![xx_color](https://img.shields.io/badge/xx__color-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_color)                      | everything around colors (*converting, blending, searching colors in strings, ...*)                |
-| [![xx_console](https://img.shields.io/badge/xx__console-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_console)                | advanced actions related to the console (*pretty logging, advanced inputs, ...*)                   |
-| [![xx_data](https://img.shields.io/badge/xx__data-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_data)                         | advanced operations with data structures (*compare, generate path ID's, pretty print/format, ...*) |
+| Module                                                                                                                                                     | Short Description                                                                                  |
+| :--------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------- |
+| [![xx_code](https://img.shields.io/badge/xx__code-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_code)                          | advanced code-string operations (*changing the indent, finding function calls, ...*)               |
+| [![xx_color](https://img.shields.io/badge/xx__color-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_color)                       | everything around colors (*converting, blending, searching colors in strings, ...*)                |
+| [![xx_console](https://img.shields.io/badge/xx__console-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_console)                 | advanced actions related to the console (*pretty logging, advanced inputs, ...*)                   |
+| [![xx_data](https://img.shields.io/badge/xx__data-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_data)                          | advanced operations with data structures (*compare, generate path ID's, pretty print/format, ...*) |
 | [![xx_env_path](https://img.shields.io/badge/xx__env__path-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_env_path)             | getting and editing the PATH variable (*get paths, check for paths, add paths, ...*)               |
-| [![xx_file](https://img.shields.io/badge/xx__file-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_file)                         | advanced working with files (*create files, rename file-extensions, ...*)                          |
+| [![xx_file](https://img.shields.io/badge/xx__file-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_file)                          | advanced working with files (*create files, rename file-extensions, ...*)                          |
 | [![xx_format_codes](https://img.shields.io/badge/xx__format__codes-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_format_codes) | easy pretty printing with custom format codes (*print, inputs, custom format codes to ANSI, ...*)  |
-| [![xx_json](https://img.shields.io/badge/xx__json-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_json)                         | advanced working with json files (*read, create, update, ...*)                                     |
-| [![xx_path](https://img.shields.io/badge/xx__path-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_path)                         | advanced path operations (*get paths, smart-extend relative paths, delete paths, ...*)             |
-| ![xx_regex](https://img.shields.io/badge/xx__regex-6065FF?style=flat)                                                                                     | generated regex pattern-templates (*match bracket- and quote pairs, match colors, ...*)            |
-| [![xx_string](https://img.shields.io/badge/xx__string-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_string)                   | helpful actions when working with strings. (*normalize, escape, decompose, ...*)                   |
-| ![xx_system](https://img.shields.io/badge/xx__system-6065FF?style=flat)                                                                                   | advanced system actions (*restart with message, check installed Python libs, ...*)                 |
+| [![xx_json](https://img.shields.io/badge/xx__json-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_json)                          | advanced working with json files (*read, create, update, ...*)                                     |
+| [![xx_path](https://img.shields.io/badge/xx__path-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_path)                          | advanced path operations (*get paths, smart-extend relative paths, delete paths, ...*)             |
+| ![xx_regex](https://img.shields.io/badge/xx__regex-6065FF?style=flat)                                                                                      | generated regex pattern-templates (*match bracket- and quote pairs, match colors, ...*)            |
+| [![xx_string](https://img.shields.io/badge/xx__string-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_string)                    | helpful actions when working with strings. (*normalize, escape, decompose, ...*)                   |
+| ![xx_system](https://img.shields.io/badge/xx__system-6065FF?style=flat)                                                                                    | advanced system actions (*restart with message, check installed Python libs, ...*)                 |
 
 <br>
 
@@ -111,15 +111,15 @@ def main() -> None:
 
     # LET THE USER ENTER A HEXA COLOR IN ANY HEXA FORMAT
     input_clr = FormatCodes.input(
-      "\n[b](Enter a HEXA color in any format) [dim](>) "
+        "\n[b](Enter a HEXA color in any format) [dim](>) "
     )
 
     # ANNOUNCE INDEXING THE INPUT COLOR
     Console.log(
-      "INDEX",
-      "Indexing the input HEXA color...",
-      start="\n",
-      title_bg_color=COLOR.blue,
+        "INDEX",
+        "Indexing the input HEXA color...",
+        start="\n",
+        title_bg_color=COLOR.blue,
     )
 
     try:
@@ -129,16 +129,16 @@ def main() -> None:
     except ValueError:
         # ANNOUNCE THE ERROR AND EXIT THE PROGRAM
         Console.fail(
-          "The input HEXA color is invalid.",
-          end="\n\n",
-          exit=True,
+            "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",
+        "Converting the HEXA color into different types...",
+        title_bg_color=COLOR.tangerine,
     )
 
     # CONVERT THE HEXA COLOR INTO THE TWO OTHER COLOR TYPES
@@ -147,14 +147,16 @@ def main() -> None:
 
     # ANNOUNCE THE SUCCESSFUL CONVERSION
     Console.done(
-      "Successfully converted color into different types.",
-      end="\n\n",
+        "Successfully converted color into different types.",
+        end="\n\n",
     )
 
     # PRETTY PRINT THE COLOR IN DIFFERENT TYPES
-    FormatCodes.print(f"[b](HEXA:) [i|white]({hexa_color})")
-    FormatCodes.print(f"[b](RGBA:) [i|white]({rgba_color})")
-    FormatCodes.print(f"[b](HSLA:) [i|white]({hsla_color})\n")
+    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__":
@@ -165,4 +167,4 @@ if __name__ == "__main__":
 <br>
 
 --------------------------------------------------------------
-[View this library on PyPI](https://pypi.org/project/XulbuX/)
+[View this library on **PyPI**](https://pypi.org/project/XulbuX/)

xulbux-1.7.1.dist-info/RECORD

@@ -0,0 +1,21 @@
+xulbux/__init__.py,sha256=4qceHbARrYX-ui-kl5bufH3BlEvMwJpsXG1TQsbNHgA,815
+xulbux/_cli_.py,sha256=J4vfJHLJEYxCZzA_VJUB46w2WGShfdYFoetsLG5PfKo,3428
+xulbux/_consts_.py,sha256=AuYTTmqrP2lawyVGlPLUaP1syxOoPA-ejJGH7WlwFzk,6314
+xulbux/xx_code.py,sha256=w9yO-GPMeaE-xDi-L3VtpPpWpu5jOwagfMsG93aXANE,6106
+xulbux/xx_color.py,sha256=Thj7fFTc8x-VmYyULI3HQW0uCk9dIihwrGUwuXGn83s,49744
+xulbux/xx_console.py,sha256=mruEcbehVceXuDhIMV_WoFec8MxXf2orvlNQWkdI-zE,34367
+xulbux/xx_data.py,sha256=nEfVwK6-ILaL3K-bLezKpG1G7117CY5ZgC3BGwANrUE,30886
+xulbux/xx_env_path.py,sha256=x56mKK4lSvU5yMCAs8k0RVIqXWUJcpcHYz5HoZ_RklM,4160
+xulbux/xx_file.py,sha256=KerXOvKS93zIoAt36YTYuZboSmxVFVf2WcOrDcdwXfE,2627
+xulbux/xx_format_codes.py,sha256=NihbRkPjDSWJCL2itZBlvhbO0bWx8Mm2P-LpSeaG3po,23732
+xulbux/xx_json.py,sha256=V7vdfpvSe9wpktR_c8zG_Meix7x9IRmn66k5nB3HUyo,7457
+xulbux/xx_path.py,sha256=lLAEVZrW0TAwCewlONFVQcQ_8tVn9LTJZVOZpeGvE5s,7673
+xulbux/xx_regex.py,sha256=_BtMHRDNcD9zF4SL87dQuUVZcYGfZx9H5YNSDiEtzm8,8059
+xulbux/xx_string.py,sha256=QaTo0TQ9m_2USNgQNaVw5ivQt-A1E-e5x8OpIB3xIlY,5561
+xulbux/xx_system.py,sha256=Tsx4wgztUg46KloqcGeiFkarDoM3EgJLXw3XNxgHBmU,6460
+xulbux-1.7.1.dist-info/licenses/LICENSE,sha256=6NflEcvzFEe8_JFVNCPVwZBwBhlLLd4vqQi8WiX_Xk4,1084
+xulbux-1.7.1.dist-info/METADATA,sha256=rMdO8mHMOtT-oLsysIUup9myW_B93Z2UdG1Gvasu_rA,9209
+xulbux-1.7.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+xulbux-1.7.1.dist-info/entry_points.txt,sha256=a3womfLIMZKnOFiyy-xnVb4g2qkZsHR5FbKKkljcGns,94
+xulbux-1.7.1.dist-info/top_level.txt,sha256=FkK4EZajwfP36fnlrPaR98OrEvZpvdEOdW1T5zTj6og,7
+xulbux-1.7.1.dist-info/RECORD,,

{xulbux-1.6.9.dist-info → xulbux-1.7.1.dist-info}/WHEEL

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

xulbux-1.6.9.dist-info/RECORD

@@ -1,21 +0,0 @@
-xulbux/__init__.py,sha256=mpAtWO0eumk7FZt6QS1Wvp7KWBsZd8oseSxUPSpAVJk,815
-xulbux/_cli_.py,sha256=SaBlkIx73nfU6r2TbjQVWxOM-R0xTBqOAKtgi2FF-KA,3470
-xulbux/_consts_.py,sha256=b85O5sePS18z7CJgrVw0V7v88PIG9qnQ7G2bJL71odk,6287
-xulbux/xx_code.py,sha256=laA8osWgIW-QSv6P6Am_c6NocOPf8ZSm20EaVfgOC58,6100
-xulbux/xx_color.py,sha256=NdNh-J89PXPhVcdgKBXThbRTnq1UpBg3yn4aG0fmRAE,47602
-xulbux/xx_console.py,sha256=MJOE3giA6wZW0-VjJmBZaHqnUhOA6vRF41UdkAPIxgk,28019
-xulbux/xx_data.py,sha256=zp-DjMJ_VnC-BQQlqdzdgwhnSRzs0MV356AbIjeGgP4,30696
-xulbux/xx_env_path.py,sha256=A54TObZZwDvNZwv0iwHzEbNiCoEvz16OId-gMiUTHdo,4086
-xulbux/xx_file.py,sha256=Efd7-1FFsXYGd_cH95FwI8Mg6PaA7H11ArBpdBhyVhE,2597
-xulbux/xx_format_codes.py,sha256=QXb7ik_JyZJ6agtWykTerkb6NAPhOtOFh7nMpr-bpWo,22912
-xulbux/xx_json.py,sha256=-Wzlg8pUIsLlYJKrlxeoXoPprPn8lGJ2Uqc36WYyk6U,7390
-xulbux/xx_path.py,sha256=ZCnRJyIO5nigaKJjxNjfEz_4Z_mhBS0ELyJaLU7Lid0,7561
-xulbux/xx_regex.py,sha256=oJ7V2ccQNYbnavvCEIyYGVM8001_pjMV1BRu3NGmMJw,7884
-xulbux/xx_string.py,sha256=QaTo0TQ9m_2USNgQNaVw5ivQt-A1E-e5x8OpIB3xIlY,5561
-xulbux/xx_system.py,sha256=vHuNzxG6fakd4pJ0esJNfGglUtRbqpGJhPODVJqwcV0,6411
-xulbux-1.6.9.dist-info/licenses/LICENSE,sha256=6NflEcvzFEe8_JFVNCPVwZBwBhlLLd4vqQi8WiX_Xk4,1084
-xulbux-1.6.9.dist-info/METADATA,sha256=1wGLeAPcJPPDMfhB_JsLCM7mphazUEqyVE4HIfoUbHI,9222
-xulbux-1.6.9.dist-info/WHEEL,sha256=ooBFpIzZCPdw3uqIQsOo4qqbA4ZRPxHnOH7peeONza0,91
-xulbux-1.6.9.dist-info/entry_points.txt,sha256=a3womfLIMZKnOFiyy-xnVb4g2qkZsHR5FbKKkljcGns,94
-xulbux-1.6.9.dist-info/top_level.txt,sha256=FkK4EZajwfP36fnlrPaR98OrEvZpvdEOdW1T5zTj6og,7
-xulbux-1.6.9.dist-info/RECORD,,