xulbux 1.7.1__tar.gz → 1.7.3__tar.gz

{xulbux-1.7.1/src/xulbux.egg-info → xulbux-1.7.3}/PKG-INFO

@@ -1,22 +1,23 @@
 Metadata-Version: 2.4
 Name: xulbux
-Version: 1.7.1
+Version: 1.7.3
 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
-Project-URL: Bug Reports, https://github.com/XulbuX/PythonLibraryXulbuX/issues
-Project-URL: Changelog, https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md
-Project-URL: Documentation, https://github.com/XulbuX/PythonLibraryXulbuX/wiki
 Project-URL: Homepage, https://github.com/XulbuX/PythonLibraryXulbuX
-Project-URL: License, https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/LICENSE
+Project-URL: Documentation, https://github.com/XulbuX/PythonLibraryXulbuX/wiki
 Project-URL: Source Code, https://github.com/XulbuX/PythonLibraryXulbuX/tree/main/src
-Keywords: args,arguments,attributes,classes,cmd,client,code,codes,color,commands,console,consts,constants,convert,conversion,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: Intended Audience :: Developers
+Project-URL: Changelog, https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md
+Project-URL: Bug Reports, https://github.com/XulbuX/PythonLibraryXulbuX/issues
+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: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
+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
@@ -27,20 +28,22 @@ Requires-Dist: prompt_toolkit>=3.0.41
 Requires-Dist: pyperclip>=1.9.0
 Requires-Dist: regex>=2023.10.3
 Provides-Extra: dev
-Requires-Dist: pytest>=7.4.2; extra == "dev"
 Requires-Dist: black>=23.7.0; extra == "dev"
-Requires-Dist: isort>=5.12.0; extra == "dev"
-Requires-Dist: flake8>=6.1.0; extra == "dev"
 Requires-Dist: flake8-pyproject>=1.2.3; extra == "dev"
+Requires-Dist: flake8>=6.1.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: pytest>=7.4.2; extra == "dev"
 Dynamic: license-file
 
-# **$\Huge\textsf{XulbuX}$**
+# **XulbuX**
+
+![](https://img.shields.io/pypi/v/xulbux?labelColor=404560&color=7075FF) ![](https://img.shields.io/pypi/dm/xulbux?labelColor=405555&color=70FFEE) ![](https://img.shields.io/github/license/XulbuX/PythonLibraryXulbuX?labelColor=405555&color=70FFEE) ![](https://img.shields.io/github/last-commit/XulbuX/PythonLibraryXulbuX?labelColor=554045&color=FF6065) ![](https://img.shields.io/github/issues/XulbuX/PythonLibraryXulbuX?labelColor=554045&color=FF6065)
 
 **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 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).
 
 <br>

{xulbux-1.7.1 → xulbux-1.7.3}/README.md

@@ -1,10 +1,12 @@
-# **$\Huge\textsf{XulbuX}$**
+# **XulbuX**
+
+![](https://img.shields.io/pypi/v/xulbux?labelColor=404560&color=7075FF) ![](https://img.shields.io/pypi/dm/xulbux?labelColor=405555&color=70FFEE) ![](https://img.shields.io/github/license/XulbuX/PythonLibraryXulbuX?labelColor=405555&color=70FFEE) ![](https://img.shields.io/github/last-commit/XulbuX/PythonLibraryXulbuX?labelColor=554045&color=FF6065) ![](https://img.shields.io/github/issues/XulbuX/PythonLibraryXulbuX?labelColor=554045&color=FF6065)
 
 **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 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).
 
 <br>

{xulbux-1.7.1 → xulbux-1.7.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "xulbux"
-version = "1.7.1"
+version = "1.7.3"
 authors = [{ name = "XulbuX", email = "xulbux.real@gmail.com" }]
 description = "A Python library which includes lots of helpful classes, types and functions aiming to make common programming tasks simpler."
 readme = "README.md"
@@ -19,19 +19,20 @@ dependencies = [
   "regex>=2023.10.3",
 ]
 optional-dependencies = { dev = [
-  "pytest>=7.4.2",
   "black>=23.7.0",
-  "isort>=5.12.0",
-  "flake8>=6.1.0",
   "flake8-pyproject>=1.2.3",
+  "flake8>=6.1.0",
+  "isort>=5.12.0",
+  "pytest>=7.4.2",
 ] }
 classifiers = [
-  "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
-  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.13",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.10",
   "Operating System :: OS Independent",
+  "Intended Audience :: Developers",
   "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 keywords = [
@@ -39,17 +40,17 @@ keywords = [
   "arguments",
   "attributes",
   "classes",
-  "cmd",
   "client",
+  "cmd",
   "code",
   "codes",
   "color",
   "commands",
   "console",
-  "consts",
   "constants",
-  "convert",
+  "consts",
   "conversion",
+  "convert",
   "data",
   "debug",
   "easier",
@@ -96,12 +97,12 @@ keywords = [
 ]
 
 [project.urls]
-"Bug Reports" = "https://github.com/XulbuX/PythonLibraryXulbuX/issues"
-"Changelog" = "https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md"
-"Documentation" = "https://github.com/XulbuX/PythonLibraryXulbuX/wiki"
 "Homepage" = "https://github.com/XulbuX/PythonLibraryXulbuX"
-"License" = "https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/LICENSE"
+"Documentation" = "https://github.com/XulbuX/PythonLibraryXulbuX/wiki"
 "Source Code" = "https://github.com/XulbuX/PythonLibraryXulbuX/tree/main/src"
+"Changelog" = "https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md"
+"Bug Reports" = "https://github.com/XulbuX/PythonLibraryXulbuX/issues"
+"License" = "https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/LICENSE"
 
 
 [project.scripts]
@@ -152,8 +153,8 @@ addopts = "-ra -q"
 pythonpath = ["src"]
 testpaths = [
   "tests/test_code.py",
-  "tests/test_color.py",
   "tests/test_color_types.py",
+  "tests/test_color.py",
   "tests/test_console.py",
   "tests/test_data.py",
   "tests/test_env_path.py",

{xulbux-1.7.1 → xulbux-1.7.3}/src/xulbux/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "1.7.1"
+__version__ = "1.7.3"
 __author__ = "XulbuX"
 __email__ = "xulbux.real@gmail.com"
 __license__ = "MIT"

{xulbux-1.7.1 → xulbux-1.7.3}/src/xulbux/_consts_.py

@@ -94,8 +94,6 @@ class ANSI:
     """The separator between ANSI escape sequence parts."""
     END = end = "m"
     """The end of an ANSI escape sequence."""
-    default_color_modifiers: dict[str, str] = {"lighten": "+l", "darken": "-d"}
-    """Characters to modify the lightness of the default color with."""
 
     @classmethod
     def seq(cls, parts: int = 1) -> FormattableString:
@@ -107,7 +105,7 @@ class ANSI:
     seq_bg_color: FormattableString = CHAR + START + "48" + SEP + "2" + SEP + "{}" + SEP + "{}" + SEP + "{}" + END
     """The ANSI escape sequence for setting the background RGB color."""
 
-    color_map: list[str] = [
+    color_map: tuple[str, ...] = (
         ########### DEFAULT CONSOLE COLOR NAMES ############
         "black",
         "red",
@@ -117,7 +115,7 @@ class ANSI:
         "magenta",
         "cyan",
         "white",
-    ]
+    )
     """The console default color names."""
 
     codes_map: dict[str | tuple[str, ...], int] = {

{xulbux-1.7.1 → xulbux-1.7.3}/src/xulbux/xx_code.py

@@ -53,7 +53,7 @@ class Code:
         return list(Data.remove_duplicates(funcs + nested_func_calls))
 
     @staticmethod
-    def is_js(code: str, funcs: list = ["__", "$t", "$lang"]) -> bool:
+    def is_js(code: str, funcs: list[str] = ["__", "$t", "$lang"]) -> bool:
         """Will check if the code is very likely to be JavaScript."""
         if not code or len(code.strip()) < 3:
             return False

{xulbux-1.7.1 → xulbux-1.7.3}/src/xulbux/xx_console.py

@@ -25,20 +25,29 @@ import os as _os
 class _ConsoleWidth:
 
     def __get__(self, obj, owner=None):
-        return _os.get_terminal_size().columns
+        try:
+            return _os.get_terminal_size().columns
+        except OSError:
+            return 80
 
 
 class _ConsoleHeight:
 
     def __get__(self, obj, owner=None):
-        return _os.get_terminal_size().lines
+        try:
+            return _os.get_terminal_size().lines
+        except OSError:
+            return 24
 
 
 class _ConsoleSize:
 
     def __get__(self, obj, owner=None):
-        size = _os.get_terminal_size()
-        return (size.columns, size.lines)
+        try:
+            size = _os.get_terminal_size()
+            return (size.columns, size.lines)
+        except OSError:
+            return (80, 24)
 
 
 class _ConsoleUser:
@@ -231,13 +240,13 @@ class Console:
         exit_code: int = 0,
         reset_ansi: bool = False,
     ) -> None:
-        """Will print the `last_prompt` and then pause the program if `pause` is set
+        """Will print the `prompt` and then pause the program if `pause` is set
         to `True` and after the pause, exit the program if `exit` is set to `True`."""
         print(prompt, end="", flush=True)
         if reset_ansi:
             FormatCodes.print("[_]", end="")
         if pause:
-            _keyboard.read_event()
+            _keyboard.read_key(suppress=True)
         if exit:
             _sys.exit(exit_code)
 
@@ -344,8 +353,7 @@ class Console:
         format_linebreaks: bool = True,
         start: str = "",
         end: str = "\n",
-        title_bg_color: Rgba | Hexa = COLOR.yellow,
-        default_color: Rgba | Hexa = COLOR.text,
+        default_color: Optional[Rgba | Hexa] = COLOR.text,
         pause: bool = False,
         exit: bool = False,
     ) -> None:
@@ -353,7 +361,7 @@ class Console:
         at the message and exit the program after the message was printed.
         If `active` is false, no debug message will be printed."""
         if active:
-            Console.log("DEBUG", prompt, format_linebreaks, start, end, title_bg_color, default_color)
+            Console.log("DEBUG", prompt, format_linebreaks, start, end, COLOR.yellow, default_color)
             Console.pause_exit(pause, exit)
 
     @staticmethod
@@ -362,14 +370,13 @@ class Console:
         format_linebreaks: bool = True,
         start: str = "",
         end: str = "\n",
-        title_bg_color: Rgba | Hexa = COLOR.blue,
-        default_color: Rgba | Hexa = COLOR.text,
+        default_color: Optional[Rgba | Hexa] = COLOR.text,
         pause: bool = False,
         exit: bool = False,
     ) -> None:
         """A preset for `log()`: `INFO` log message with the options to pause
         at the message and exit the program after the message was printed."""
-        Console.log("INFO", prompt, format_linebreaks, start, end, title_bg_color, default_color)
+        Console.log("INFO", prompt, format_linebreaks, start, end, COLOR.blue, default_color)
         Console.pause_exit(pause, exit)
 
     @staticmethod
@@ -378,14 +385,13 @@ class Console:
         format_linebreaks: bool = True,
         start: str = "",
         end: str = "\n",
-        title_bg_color: Rgba | Hexa = COLOR.teal,
-        default_color: Rgba | Hexa = COLOR.text,
+        default_color: Optional[Rgba | Hexa] = COLOR.text,
         pause: bool = False,
         exit: bool = False,
     ) -> None:
         """A preset for `log()`: `DONE` log message with the options to pause
         at the message and exit the program after the message was printed."""
-        Console.log("DONE", prompt, format_linebreaks, start, end, title_bg_color, default_color)
+        Console.log("DONE", prompt, format_linebreaks, start, end, COLOR.teal, default_color)
         Console.pause_exit(pause, exit)
 
     @staticmethod
@@ -394,14 +400,13 @@ class Console:
         format_linebreaks: bool = True,
         start: str = "",
         end: str = "\n",
-        title_bg_color: Rgba | Hexa = COLOR.orange,
-        default_color: Rgba | Hexa = COLOR.text,
+        default_color: Optional[Rgba | Hexa] = COLOR.text,
         pause: bool = False,
         exit: bool = False,
     ) -> None:
         """A preset for `log()`: `WARN` log message with the options to pause
         at the message and exit the program after the message was printed."""
-        Console.log("WARN", prompt, format_linebreaks, start, end, title_bg_color, default_color)
+        Console.log("WARN", prompt, format_linebreaks, start, end, COLOR.orange, default_color)
         Console.pause_exit(pause, exit)
 
     @staticmethod
@@ -410,15 +415,14 @@ class Console:
         format_linebreaks: bool = True,
         start: str = "",
         end: str = "\n",
-        title_bg_color: Rgba | Hexa = COLOR.red,
-        default_color: Rgba | Hexa = COLOR.text,
+        default_color: Optional[Rgba | Hexa] = COLOR.text,
         pause: bool = False,
         exit: bool = True,
-        reset_ansi=True,
+        reset_ansi: bool = True,
     ) -> None:
         """A preset for `log()`: `FAIL` log message with the options to pause
         at the message and exit the program after the message was printed."""
-        Console.log("FAIL", prompt, format_linebreaks, start, end, title_bg_color, default_color)
+        Console.log("FAIL", prompt, format_linebreaks, start, end, COLOR.red, default_color)
         Console.pause_exit(pause, exit, reset_ansi=reset_ansi)
 
     @staticmethod
@@ -427,15 +431,14 @@ class Console:
         format_linebreaks: bool = True,
         start: str = "",
         end: str = "\n",
-        title_bg_color: Rgba | Hexa = COLOR.magenta,
-        default_color: Rgba | Hexa = COLOR.text,
+        default_color: Optional[Rgba | Hexa] = COLOR.text,
         pause: bool = False,
         exit: bool = True,
-        reset_ansi=True,
+        reset_ansi: bool = True,
     ) -> None:
         """A preset for `log()`: `EXIT` log message with the options to pause
         at the message and exit the program after the message was printed."""
-        Console.log("EXIT", prompt, format_linebreaks, start, end, title_bg_color, default_color)
+        Console.log("EXIT", prompt, format_linebreaks, start, end, COLOR.magenta, default_color)
         Console.pause_exit(pause, exit, reset_ansi=reset_ansi)
 
     @staticmethod
@@ -443,10 +446,11 @@ class Console:
         *values: object,
         start: str = "",
         end: str = "\n",
-        box_bg_color: Rgba | Hexa = "green",
-        default_color: Rgba | Hexa = "#000",
+        box_bg_color: str | Rgba | Hexa = "green",
+        default_color: Optional[Rgba | Hexa] = None,
         w_padding: int = 2,
         w_full: bool = False,
+        indent: int = 0,
     ) -> None:
         """Will print a box with a colored background, containing a formatted log message:
         - `*values` -⠀the box content (each value is on a new line)
@@ -455,7 +459,8 @@ class Console:
         - `box_bg_color` -⠀the background color of the box
         - `default_color` -⠀the default text color of the `*values`
         - `w_padding` -⠀the horizontal padding (in chars) to the box content
-        - `w_full` -⠀whether to make the box be the full console width or not\n
+        - `w_full` -⠀whether to make the box be the full console width or not
+        - `indent` -⠀the indentation of the box (in chars)\n
         -----------------------------------------------------------------------------------
         The box content can be formatted with special formatting codes. For more detailed
         information about formatting codes, see `xx_format_codes` module documentation."""
@@ -463,15 +468,16 @@ class Console:
         pad_w_full = (Console.w - (max_line_len + (2 * w_padding))) if w_full else 0
         if box_bg_color is not None and Color.is_valid(box_bg_color):
             box_bg_color = Color.to_hexa(box_bg_color)
+        spaces_l = " " * indent
         lines = [
-            f"[bg:{box_bg_color}]{' ' * w_padding}{line}" + " " *
-            ((w_padding + max_line_len - len(unfmt)) + pad_w_full) + "[*]" for line, unfmt in zip(lines, unfmt_lines)
+            f"{spaces_l}[bg:{box_bg_color}]{' ' * w_padding}"
+            + _COMPILED["formatting"].sub(lambda m: f"{m.group(0)}[bg:{box_bg_color}]", line) +
+            (" " * ((w_padding + max_line_len - len(unfmt)) + pad_w_full)) + "[*]" for line, unfmt in zip(lines, unfmt_lines)
         ]
         pady = " " * (Console.w if w_full else max_line_len + (2 * w_padding))
         FormatCodes.print(
-            f"{start}[bg:{box_bg_color}]{pady}[*]\n"
-            + _COMPILED["formatting"].sub(lambda m: f"{m.group(0)}[bg:{box_bg_color}]", "\n".join(lines))
-            + f"\n[bg:{box_bg_color}]{pady}[_]",
+            f"{start}{spaces_l}[bg:{box_bg_color}]{pady}[*]\n" + "\n".join(lines)
+            + f"\n{spaces_l}[bg:{box_bg_color}]{pady}[_]",
             default_color=default_color or "#000",
             sep="\n",
             end=end,
@@ -487,6 +493,7 @@ class Console:
         default_color: Optional[Rgba | Hexa] = None,
         w_padding: int = 1,
         w_full: bool = False,
+        indent: int = 0,
         _border_chars: Optional[tuple[str, str, str, str, str, str, str, str]] = None,
     ) -> None:
         """Will print a bordered box, containing a formatted log message:
@@ -494,9 +501,11 @@ class Console:
         - `start` -⠀something to print before the log box is printed (e.g. `\\n`)
         - `end` -⠀something to print after the log box is printed (e.g. `\\n`)
         - `border_type` -⠀one of the predefined border character sets
+        - `border_style` -⠀the style of the border (special formatting codes)
         - `default_color` -⠀the default text color of the `*values`
         - `w_padding` -⠀the horizontal padding (in chars) to the box content
         - `w_full` -⠀whether to make the box be the full console width or not
+        - `indent` -⠀the indentation of the box (in chars)
         - `_border_chars` -⠀define your own border characters set (overwrites `border_type`)\n
         ---------------------------------------------------------------------------------------
         The box content can be formatted with special formatting codes. For more detailed
@@ -524,18 +533,18 @@ class Console:
         }
         border_chars = borders.get(border_type, borders["standard"]) if _border_chars is None else _border_chars
         lines, unfmt_lines, max_line_len = Console.__prepare_log_box(values, default_color)
-        print(unfmt_lines)
         pad_w_full = (Console.w - (max_line_len + (2 * w_padding)) - (len(border_chars[1] * 2))) if w_full else 0
         if border_style is not None and Color.is_valid(border_style):
             border_style = Color.to_hexa(border_style)
+        spaces_l = " " * indent
         border_l = f"[{border_style}]{border_chars[7]}[*]"
         border_r = f"[{border_style}]{border_chars[3]}[_]"
         lines = [
-            f"{border_l}{' ' * w_padding}{line}[_]" + " " * ((w_padding + max_line_len - len(unfmt)) + pad_w_full) + border_r
-            for line, unfmt in zip(lines, unfmt_lines)
+            f"{spaces_l}{border_l}{' ' * w_padding}{line}[_]" + " " *
+            ((w_padding + max_line_len - len(unfmt)) + pad_w_full) + border_r for line, unfmt in zip(lines, unfmt_lines)
         ]
-        border_t = f"[{border_style}]{border_chars[0]}{border_chars[1] * (Console.w - (len(border_chars[1] * 2)) if w_full else max_line_len + (2 * w_padding))}{border_chars[2]}[_]"
-        border_b = f"[{border_style}]{border_chars[6]}{border_chars[5] * (Console.w - (len(border_chars[1] * 2)) if w_full else max_line_len + (2 * w_padding))}{border_chars[4]}[_]"
+        border_t = f"{spaces_l}[{border_style}]{border_chars[0]}{border_chars[1] * (Console.w - (len(border_chars[1] * 2)) if w_full else max_line_len + (2 * w_padding))}{border_chars[2]}[_]"
+        border_b = f"{spaces_l}[{border_style}]{border_chars[6]}{border_chars[5] * (Console.w - (len(border_chars[1] * 2)) if w_full else max_line_len + (2 * w_padding))}{border_chars[4]}[_]"
         FormatCodes.print(
             f"{start}{border_t}[_]\n" + "\n".join(lines) + f"\n{border_b}[_]",
             default_color=default_color,
@@ -559,7 +568,7 @@ class Console:
         prompt: object = "Do you want to continue?",
         start="",
         end="\n",
-        default_color: Rgba | Hexa = COLOR.cyan,
+        default_color: Optional[Rgba | Hexa] = COLOR.cyan,
         default_is_yes: bool = True,
     ) -> bool:
         """Ask a yes/no question.\n
@@ -569,7 +578,7 @@ class Console:
         confirmed = input(
             FormatCodes.to_ansi(
                 f'{start}  {str(prompt)} [_|dim](({"Y" if default_is_yes else "y"}/{"n" if default_is_yes else "N"}):  )',
-                default_color,
+                default_color=default_color,
             )
         ).strip().lower() in (("", "y", "yes") if default_is_yes else ("y", "yes"))
         if end:
@@ -581,7 +590,7 @@ class Console:
         prompt: object = "",
         start="",
         end="\n",
-        default_color: Rgba | Hexa = COLOR.cyan,
+        default_color: Optional[Rgba | Hexa] = COLOR.cyan,
         show_keybindings=True,
         input_prefix=" ⮡ ",
         reset_ansi=True,
@@ -616,7 +625,7 @@ class Console:
         prompt: object = "",
         start="",
         end="\n",
-        default_color: Rgba | Hexa = COLOR.cyan,
+        default_color: Optional[Rgba | Hexa] = COLOR.cyan,
         allowed_chars: str = CHARS.all,  # type: ignore[assignment]
         min_len: Optional[int] = None,
         max_len: Optional[int] = None,
@@ -720,7 +729,7 @@ class Console:
         prompt: object = "Password: ",
         start="",
         end="\n",
-        default_color: Rgba | Hexa = COLOR.cyan,
+        default_color: Optional[Rgba | Hexa] = COLOR.cyan,
         allowed_chars: str = CHARS.standard_ascii,
         min_len: Optional[int] = None,
         max_len: Optional[int] = None,

{xulbux-1.7.1 → xulbux-1.7.3}/src/xulbux/xx_format_codes.py

@@ -56,11 +56,13 @@ the formatting code:
   - `[(255, 0, 136)]`
   - `[255, 0, 136]`
 - HEX colors:
-  Change the text color directly with a HEX color inside the square brackets. (If `RGB` or `RRGGBB` formatting code is used,
+  Change the text color directly with a HEX color inside the square brackets. (Whether the `RGB` or `RRGGBB` HEX format is used,
   and if there's a `#` or `0x` prefix, doesn't matter.)
   Examples:
+  - `[0x7788FF]`
   - `[#7788FF]`
   - `[7788FF]`
+  - `[0x78F]`
   - `[#78F]`
   - `[78F]`
 - background RGB / HEX colors:
@@ -133,10 +135,13 @@ 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`
-  (*if no `default_color` it resets everything, including the text color*)
+  (if no `default_color` is set, it resets everything, exactly like `[_]`)
 2. `[*color]` `[*c]` will reset the text color, just like `[_color]`, but then also make it `default_color`
+  (if no `default_color` is set, both are treated as invalid formatting codes)
 3. `[default]` will just color the text in `default_color`
+  (if no `default_color` is set, it's treated as an invalid formatting code)
 4. `[background:default]` `[BG:default]` will color the background in `default_color`
+  (if no `default_color` is set, both are treated as invalid formatting codes)\n
 
 Unlike the standard console colors, the default color can be changed by using the following modifiers:
 
@@ -149,6 +154,7 @@ Unlike the standard console colors, the default color can be changed by using th
 - `[ddd]` will darken the `default_color` text by `3 × brightness_steps`%
 - ... etc.
 Per default, you can also use `+` and `-` to get lighter and darker `default_color` versions.
+All of these lighten/darken formatting codes are treated as invalid if no `default_color` is set.
 """
 
 from ._consts_ import ANSI
@@ -165,6 +171,11 @@ import re as _re
 
 _CONSOLE_ANSI_CONFIGURED: bool = False
 
+_ANSI_SEQ_1: str = ANSI.seq(1)
+_DEFAULT_COLOR_MODS: dict[str, str] = {
+    "lighten": "+l",
+    "darken": "-d",
+}
 _PREFIX: dict[str, set[str]] = {
     "BG": {"background", "bg"},
     "BR": {"bright", "br"},
@@ -190,7 +201,7 @@ _COMPILED: dict[str, Pattern] = {  # PRECOMPILE REGULAR EXPRESSIONS
     "modifier": _re.compile(
         r"(?i)((?:BG\s*:)?)\s*("
         + "|".join(
-            [f"{_re.escape(m)}+" for m in ANSI.default_color_modifiers["lighten"] + ANSI.default_color_modifiers["darken"]]
+            [f"{_re.escape(m)}+" for m in _DEFAULT_COLOR_MODS["lighten"] + _DEFAULT_COLOR_MODS["darken"]]
         )
         + r")$"
     ),
@@ -247,6 +258,7 @@ class FormatCodes:
         default_color: Optional[Rgba | Hexa] = None,
         brightness_steps: int = 20,
         _default_start: bool = True,
+        _validate_default: bool = True,
     ) -> str:
         """Convert the formatting codes inside a string to ANSI formatting.\n
         -------------------------------------------------------------------------
@@ -254,16 +266,20 @@ class FormatCodes:
         `xx_format_codes` module documentation."""
         if not isinstance(string, str):
             string = str(string)
-        if default_color and Color.is_valid_rgba(default_color, False):
-            use_default = True
-        elif default_color and Color.is_valid_hexa(default_color, False):
-            use_default, default_color = True, Color.to_rgba(default_color)
+        use_default, default_specified = False, default_color is not None
+        if _validate_default and default_specified:
+            if Color.is_valid_rgba(default_color, False):
+                use_default = True
+            elif Color.is_valid_hexa(default_color, False):
+                use_default, default_color = True, Color.to_rgba(default_color)  # type: ignore[assignment]
         else:
-            use_default = False
-        default_color = cast(rgba, default_color) if use_default else None
+            use_default = default_specified
+        default_color = cast(Optional[rgba], default_color)
         if use_default:
             string = _COMPILED["*"].sub(r"[\1_|default\2]", string)  # REPLACE `[…|*|…]` WITH `[…|_|default|…]`
-            string = _COMPILED["*color"].sub(r"[\1default\2]", string)  # REPLACE `[…|*color|…]` OR `[…|*c|…]` 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 `[…|_|…]`
 
@@ -277,11 +293,23 @@ class FormatCodes:
             if formats_escaped := bool(_COMPILED["escape_char_cond"].match(match.group(0))):
                 _formats = formats = _COMPILED["escape_char"].sub(r"\1", formats)  # REMOVE / OR \\
             if auto_reset_txt and auto_reset_txt.count("[") > 0 and auto_reset_txt.count("]") > 0:
-                auto_reset_txt = FormatCodes.to_ansi(auto_reset_txt, default_color, brightness_steps, False)
+                auto_reset_txt = FormatCodes.to_ansi(
+                    auto_reset_txt,
+                    default_color,
+                    brightness_steps,
+                    _default_start=False,
+                    _validate_default=False,
+                )
             if not formats:
                 return match.group(0)
             if formats.count("[") > 0 and formats.count("]") > 0:
-                formats = FormatCodes.to_ansi(formats, default_color, brightness_steps, False)
+                formats = FormatCodes.to_ansi(
+                    formats,
+                    default_color,
+                    brightness_steps,
+                    _default_start=False,
+                    _validate_default=False,
+                )
             format_keys = [k.strip() for k in formats.split("|") if k.strip()]
             ansi_formats = [
                 r if (r := FormatCodes.__get_replacement(k, default_color, brightness_steps)) != k else f"[{k}]"
@@ -323,13 +351,13 @@ class FormatCodes:
             else:
                 return (
                     "".join(ansi_formats) + (
-                        f"({FormatCodes.to_ansi(auto_reset_txt, default_color, brightness_steps, False)})"
+                        f"({FormatCodes.to_ansi(auto_reset_txt, default_color, brightness_steps, _default_start=False, _validate_default=False)})"
                         if auto_reset_escaped and auto_reset_txt else auto_reset_txt if auto_reset_txt else ""
                     ) + ("" if auto_reset_escaped else "".join(ansi_resets))
                 )
 
         string = "\n".join(_COMPILED["formatting"].sub(replace_keys, line) for line in string.split("\n"))
-        return (((FormatCodes.__get_default_ansi(default_color.values()) or "") if _default_start else "")
+        return (((FormatCodes.__get_default_ansi(default_color) or "") if _default_start else "")
                 + string) if default_color is not None else string
 
     @staticmethod
@@ -399,19 +427,21 @@ class FormatCodes:
 
     @staticmethod
     def __get_default_ansi(
-        default_color: tuple[int, int, int],
+        default_color: rgba,
         format_key: Optional[str] = None,
         brightness_steps: Optional[int] = None,
-        _modifiers: tuple[str, str] = (ANSI.default_color_modifiers["lighten"], ANSI.default_color_modifiers["darken"]),
+        _modifiers: tuple[str, str] = (_DEFAULT_COLOR_MODS["lighten"], _DEFAULT_COLOR_MODS["darken"]),
     ) -> Optional[str]:
         """Get the `default_color` and lighter/darker versions of it as ANSI code."""
-        if not brightness_steps or (format_key and _COMPILED["bg?_default"].search(format_key)):
+        if not isinstance(default_color, rgba):
+            return None
+        _default_color: tuple[int, int, int] = tuple(default_color)[:3]
+        if brightness_steps is None or (format_key and _COMPILED["bg?_default"].search(format_key)):
             return (ANSI.seq_bg_color if format_key and _COMPILED["bg_default"].search(format_key) else ANSI.seq_color).format(
-                *default_color[:3]
+                *_default_color
             )
         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
@@ -422,7 +452,7 @@ class FormatCodes:
             if adjust and adjust > 0:
                 modifiers = mod
                 break
-        new_rgb = default_color
+        new_rgb = _default_color
         if adjust == 0:
             return None
         elif modifiers in _modifiers[0]:
@@ -436,15 +466,13 @@ class FormatCodes:
         """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):
-                return new_default_color
+        if default_color and (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:
-                return ANSI.seq().format(
+                return _ANSI_SEQ_1.format(
                     next((
                         v for k, v in ANSI.codes_map.items() if format_key == k or (isinstance(k, tuple) and format_key in k)
                     ), None)

{xulbux-1.7.1 → xulbux-1.7.3/src/xulbux.egg-info}/PKG-INFO

@@ -1,22 +1,23 @@
 Metadata-Version: 2.4
 Name: xulbux
-Version: 1.7.1
+Version: 1.7.3
 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
-Project-URL: Bug Reports, https://github.com/XulbuX/PythonLibraryXulbuX/issues
-Project-URL: Changelog, https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md
-Project-URL: Documentation, https://github.com/XulbuX/PythonLibraryXulbuX/wiki
 Project-URL: Homepage, https://github.com/XulbuX/PythonLibraryXulbuX
-Project-URL: License, https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/LICENSE
+Project-URL: Documentation, https://github.com/XulbuX/PythonLibraryXulbuX/wiki
 Project-URL: Source Code, https://github.com/XulbuX/PythonLibraryXulbuX/tree/main/src
-Keywords: args,arguments,attributes,classes,cmd,client,code,codes,color,commands,console,consts,constants,convert,conversion,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: Intended Audience :: Developers
+Project-URL: Changelog, https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md
+Project-URL: Bug Reports, https://github.com/XulbuX/PythonLibraryXulbuX/issues
+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: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
+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
@@ -27,20 +28,22 @@ Requires-Dist: prompt_toolkit>=3.0.41
 Requires-Dist: pyperclip>=1.9.0
 Requires-Dist: regex>=2023.10.3
 Provides-Extra: dev
-Requires-Dist: pytest>=7.4.2; extra == "dev"
 Requires-Dist: black>=23.7.0; extra == "dev"
-Requires-Dist: isort>=5.12.0; extra == "dev"
-Requires-Dist: flake8>=6.1.0; extra == "dev"
 Requires-Dist: flake8-pyproject>=1.2.3; extra == "dev"
+Requires-Dist: flake8>=6.1.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: pytest>=7.4.2; extra == "dev"
 Dynamic: license-file
 
-# **$\Huge\textsf{XulbuX}$**
+# **XulbuX**
+
+![](https://img.shields.io/pypi/v/xulbux?labelColor=404560&color=7075FF) ![](https://img.shields.io/pypi/dm/xulbux?labelColor=405555&color=70FFEE) ![](https://img.shields.io/github/license/XulbuX/PythonLibraryXulbuX?labelColor=405555&color=70FFEE) ![](https://img.shields.io/github/last-commit/XulbuX/PythonLibraryXulbuX?labelColor=554045&color=FF6065) ![](https://img.shields.io/github/issues/XulbuX/PythonLibraryXulbuX?labelColor=554045&color=FF6065)
 
 **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 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).
 
 <br>

{xulbux-1.7.1 → xulbux-1.7.3}/src/xulbux.egg-info/requires.txt

@@ -5,8 +5,8 @@ pyperclip>=1.9.0
 regex>=2023.10.3
 
 [dev]
-pytest>=7.4.2
 black>=23.7.0
-isort>=5.12.0
-flake8>=6.1.0
 flake8-pyproject>=1.2.3
+flake8>=6.1.0
+isort>=5.12.0
+pytest>=7.4.2