xulbux 1.7.2__py3-none-any.whl → 1.8.0__py3-none-any.whl

xulbux/{xx_data.py → data.py}

@@ -1,6 +1,6 @@
-from ._consts_ import COLOR
-from .xx_format_codes import FormatCodes
-from .xx_string import String
+from .base.consts import COLOR
+from .format_codes import FormatCodes
+from .string import String
 
 from typing import TypeAlias, Optional, Union, Any
 import base64 as _base64
@@ -420,11 +420,11 @@ class Data:
             elif not isinstance(_syntax_highlighting, dict):
                 raise TypeError(f"Expected 'syntax_highlighting' to be a dict or bool. Got: {type(_syntax_highlighting)}")
             _syntax_hl = {
-                "str": (f"[{COLOR.blue}]", "[_c]"),
-                "number": (f"[{COLOR.magenta}]", "[_c]"),
-                "literal": (f"[{COLOR.cyan}]", "[_c]"),
-                "type": (f"[i|{COLOR.lightblue}]", "[_i|_c]"),
-                "punctuation": (f"[{COLOR.darkgray}]", "[_c]"),
+                "str": (f"[{COLOR.BLUE}]", "[_c]"),
+                "number": (f"[{COLOR.MAGENTA}]", "[_c]"),
+                "literal": (f"[{COLOR.CYAN}]", "[_c]"),
+                "type": (f"[i|{COLOR.LIGHT_BLUE}]", "[_i|_c]"),
+                "punctuation": (f"[{COLOR.DARK_GRAY}]", "[_c]"),
             }
             _syntax_hl.update({
                 k: (f"[{v}]", "[_]") if k in _syntax_hl and v not in ("", None) else ("", "")
@@ -564,14 +564,14 @@ class Data:
         part. The formatting can be changed by simply adding the key with the new
         value inside the `syntax_highlighting` dictionary.\n
         The keys with their default values are:
-        - `str: COLOR.blue`
-        - `number: COLOR.magenta`
-        - `literal: COLOR.cyan`
-        - `type: "i|" + COLOR.lightblue`
-        - `punctuation: COLOR.darkgray`\n
+        - `str: COLOR.BLUE`
+        - `number: COLOR.MAGENTA`
+        - `literal: COLOR.CYAN`
+        - `type: "i|" + COLOR.LIGHT_BLUE`
+        - `punctuation: COLOR.DARK_GRAY`\n
         For no syntax highlighting, set `syntax_highlighting` to `False` or `None`.\n
         ------------------------------------------------------------------------------
-        For more detailed information about formatting codes, see `xx_format_codes`
+        For more detailed information about formatting codes, see `format_codes`
         module documentation."""
         FormatCodes.print(
             Data.to_str(data, indent, compactness, max_width, sep, as_json, syntax_highlighting),

xulbux/{xx_env_path.py → env_path.py}

@@ -1,4 +1,4 @@
-from .xx_path import Path
+from .path import Path
 
 from typing import Optional
 import sys as _sys

xulbux/{xx_file.py → file.py}

@@ -1,4 +1,4 @@
-from .xx_string import String
+from .string import String
 
 import os as _os
 

xulbux/{xx_format_codes.py → 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:
@@ -155,10 +157,10 @@ Per default, you can also use `+` and `-` to get lighter and darker `default_col
 All of these lighten/darken formatting codes are treated as invalid if no `default_color` is set.
 """
 
-from ._consts_ import ANSI
-from .xx_string import String
-from .xx_regex import Regex, Match, Pattern
-from .xx_color import Color, rgba, Rgba, Hexa
+from .base.consts import ANSI
+from .string import String
+from .regex import Regex, Match, Pattern
+from .color import Color, rgba, Rgba, Hexa
 
 from typing import Optional, cast
 import ctypes as _ctypes
@@ -185,7 +187,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*\*c(?:olor)?\s*([^]_]*?)\]"),
-    "ansi_seq": _re.compile(ANSI.char + r"(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])"),
+    "ansi_seq": _re.compile(ANSI.CHAR + r"(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])"),
     "formatting": _rx.compile(
         Regex.brackets("[", "]", is_group=True, ignore_in_strings=False)
         + r"(?:\s*([/\\]?)\s*"
@@ -224,7 +226,7 @@ class FormatCodes:
         """A print function, whose print values can be formatted using formatting codes.\n
         -----------------------------------------------------------------------------------
         For exact information about how to use special formatting codes, see the
-        `xx_format_codes` module documentation."""
+        `format_codes` module documentation."""
         FormatCodes.__config_console()
         _sys.stdout.write(FormatCodes.to_ansi(sep.join(map(str, values)) + end, default_color, brightness_steps))
         if flush:
@@ -243,11 +245,11 @@ class FormatCodes:
         user confirms the input and the program continues to run.\n
         -------------------------------------------------------------------------
         For exact information about how to use special formatting codes, see the
-        `xx_format_codes` module documentation."""
+        `format_codes` module documentation."""
         FormatCodes.__config_console()
         user_input = input(FormatCodes.to_ansi(str(prompt), default_color, brightness_steps))
         if reset_ansi:
-            _sys.stdout.write(f"{ANSI.char}[0m")
+            _sys.stdout.write(f"{ANSI.CHAR}[0m")
         return user_input
 
     @staticmethod
@@ -261,7 +263,7 @@ class FormatCodes:
         """Convert the formatting codes inside a string to ANSI formatting.\n
         -------------------------------------------------------------------------
         For exact information about how to use special formatting codes, see the
-        `xx_format_codes` module documentation."""
+        `format_codes` module documentation."""
         if not isinstance(string, str):
             string = str(string)
         use_default, default_specified = False, default_color is not None
@@ -282,7 +284,7 @@ class FormatCodes:
             string = _COMPILED["*"].sub(r"[\1_\2]", string)  # REPLACE `[…|*|…]` WITH `[…|_|…]`
 
         def is_valid_color(color: str) -> bool:
-            return bool((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: Match) -> str:
             _formats = formats = match.group(1)
@@ -337,12 +339,12 @@ class FormatCodes:
                         reset_keys.append(f"_{k}")
                 ansi_resets = [
                     r for k in reset_keys if (r := FormatCodes.__get_replacement(k, default_color, brightness_steps)
-                                              ).startswith(f"{ANSI.char}{ANSI.start}")
+                                              ).startswith(f"{ANSI.CHAR}{ANSI.START}")
                 ]
             else:
                 ansi_resets = []
-            if not (len(ansi_formats) == 1 and ansi_formats[0].count(f"{ANSI.char}{ANSI.start}") >= 1) and not all(
-                    f.startswith(f"{ANSI.char}{ANSI.start}") for f in ansi_formats):  # FORMATTING WAS INVALID
+            if not (len(ansi_formats) == 1 and ansi_formats[0].count(f"{ANSI.CHAR}{ANSI.START}") >= 1) and not all(
+                    f.startswith(f"{ANSI.CHAR}{ANSI.START}") for f in ansi_formats):  # FORMATTING WAS INVALID
                 return match.group(0)
             elif formats_escaped:  # FORMATTING WAS VALID BUT ESCAPED
                 return f"[{_formats}]({auto_reset_txt})" if auto_reset_txt else f"[{_formats}]"
@@ -361,7 +363,7 @@ class FormatCodes:
     @staticmethod
     def escape_ansi(ansi_string: str) -> str:
         """Escapes all ANSI codes in the string, so they are visible when output to the console."""
-        return ansi_string.replace(ANSI.char, ANSI.escaped_char)
+        return ansi_string.replace(ANSI.CHAR, ANSI.ESCAPED_CHAR)
 
     @staticmethod
     def remove_ansi(
@@ -435,7 +437,7 @@ class FormatCodes:
             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(
+            return (ANSI.SEQ_BG_COLOR if format_key and _COMPILED["bg_default"].search(format_key) else ANSI.SEQ_COLOR).format(
                 *_default_color
             )
         if format_key is None or not (format_key in _modifiers[0] or format_key in _modifiers[1]):
@@ -457,7 +459,7 @@ class FormatCodes:
             new_rgb = tuple(Color.adjust_lightness(default_color, (brightness_steps / 100) * adjust))
         elif modifiers in _modifiers[1]:
             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])
+        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: Optional[rgba], brightness_steps: int = 20) -> str:
@@ -468,11 +470,11 @@ class FormatCodes:
         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:
+        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_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)
+                        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 = _COMPILED["rgb"].match(format_key)
@@ -482,13 +484,13 @@ class FormatCodes:
                 is_bg = rgb_match.group(1)
                 r, g, b = map(int, rgb_match.groups()[1:])
                 if Color.is_valid_rgba((r, g, b)):
-                    return ANSI.seq_bg_color.format(r, g, b) if is_bg else ANSI.seq_color.format(r, g, b)
+                    return ANSI.SEQ_BG_COLOR.format(r, g, b) if is_bg else ANSI.SEQ_COLOR.format(r, g, b)
             elif hex_match:
                 is_bg = hex_match.group(1)
                 rgb = Color.to_rgba(hex_match.group(2))
                 return (
-                    ANSI.seq_bg_color.format(rgb[0], rgb[1], rgb[2])
-                    if is_bg else ANSI.seq_color.format(rgb[0], rgb[1], rgb[2])
+                    ANSI.SEQ_BG_COLOR.format(rgb[0], rgb[1], rgb[2])
+                    if is_bg else ANSI.SEQ_COLOR.format(rgb[0], rgb[1], rgb[2])
                 )
         except Exception:
             pass

xulbux/{xx_json.py → json.py}

@@ -1,6 +1,6 @@
-from .xx_data import Data
-from .xx_file import File
-from .xx_path import Path
+from .data import Data
+from .file import File
+from .path import Path
 
 from typing import Any
 import json as _json

xulbux/{xx_system.py → system.py}

@@ -23,16 +23,16 @@ class _IsElevated:
 class System:
 
     is_elevated: bool = _IsElevated()  # type: ignore[assignment]
-    """Is `True` if the current process has
-    elevated privileges and `False` otherwise."""
+    """Is `True` if the current process has elevated privileges and `False` otherwise."""
 
     @staticmethod
-    def restart(prompt: object = None, wait: int = 0, continue_program: bool = False, force: bool = False) -> None:
-        """Starts a system restart:
-        - `prompt` is the message to be displayed in the systems restart notification.
-        - `wait` is the time to wait until restarting in seconds.
-        - `continue_program` is whether to continue the current Python program after calling this function.
-        - `force` is whether to force a restart even if other processes are still running."""
+    def restart(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"""
         system = _platform.system().lower()
         if system == "windows":
             if not force:
@@ -69,9 +69,9 @@ class System:
     @staticmethod
     def check_libs(lib_names: list[str], install_missing: bool = False, confirm_install: bool = True) -> Optional[list[str]]:
         """Checks if the given list of libraries are installed. If not:
-        - If `install_missing` is `False` the missing libraries will be returned as a list.
-        - If `install_missing` is `True` the missing libraries will be installed.
-        - If `confirm_install` is `True` the user will first be asked if they want to install the missing libraries."""
+        - If `install_missing` is false, the missing libraries will be returned as a list.
+        - If `install_missing` is true, the missing libraries will be installed.
+        - If `confirm_install` is true, the user will first be asked if they want to install the missing libraries."""
         missing = []
         for lib in lib_names:
             try:

xulbux-1.8.0.dist-info/METADATA

@@ -0,0 +1,190 @@
+Metadata-Version: 2.4
+Name: xulbux
+Version: 1.8.0
+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>
+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.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
+Requires-Dist: keyboard>=0.13.5
+Requires-Dist: prompt_toolkit>=3.0.41
+Requires-Dist: pyperclip>=1.9.0
+Requires-Dist: regex>=2023.10.3
+Provides-Extra: dev
+Requires-Dist: black>=23.7.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"
+
+# **XulbuX**
+
+[![](https://img.shields.io/pypi/v/xulbux?labelColor=404560&color=7075FF)](https://pypi.org/project/xulbux) [![](https://img.shields.io/pepy/dt/xulbux?labelColor=404560&color=7075FF)](https://clickpy.clickhouse.com/dashboard/xulbux) [![](https://img.shields.io/github/license/XulbuX/PythonLibraryXulbuX?labelColor=405555&color=70FFEE)](https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/LICENSE) [![](https://img.shields.io/github/last-commit/XulbuX/PythonLibraryXulbuX?labelColor=554045&color=FF6065)](https://github.com/XulbuX/PythonLibraryXulbuX/commits) [![](https://img.shields.io/github/issues/XulbuX/PythonLibraryXulbuX?labelColor=554045&color=FF6065)](https://github.com/XulbuX/PythonLibraryXulbuX/issues)
+
+**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-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/format_codes) [![console](https://img.shields.io/badge/console-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/console) [![color](https://img.shields.io/badge/color-FF7E58?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 constants, classes, methods, and types are accessible with `xx.CONSTANT.value`, `xx.Class.method()`, `xx.type()`:
+```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 CONSTANTS
+from xulbux.base.consts import COLOR, CHARS, ANSI
+# Main Classes
+from xulbux import Code, Color, Console, ...
+# module specific imports
+from xulbux.color import rgba, hsla, hexa
+```
+
+<br>
+
+## Modules
+
+| Module                                                                                                                                                    | Short Description                                                                           |
+| :-------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------ |
+| [![base](https://img.shields.io/badge/base-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/base)                          | includes more modules like library constants                                                |
+| [![code](https://img.shields.io/badge/code-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/code)                          | advanced code-string operations (*changing the indent, finding function calls, ...*)        |
+| [![color](https://img.shields.io/badge/color-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/color)                       | everything around colors (*converting, blending, searching colors in strings, ...*)         |
+| [![console](https://img.shields.io/badge/console-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/console)                 | advanced actions related to the console (*pretty logging, advanced inputs, ...*)            |
+| [![data](https://img.shields.io/badge/data-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/data)                          | advanced operations with data structures (*compare, generate path IDs, pretty print, ...*)  |
+| [![env_path](https://img.shields.io/badge/env__path-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/env_path)             | getting and editing the PATH variable (*get paths, check for paths, add paths, ...*)        |
+| [![file](https://img.shields.io/badge/file-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/file)                          | advanced working with files (*create files, rename file-extensions, ...*)                   |
+| [![format_codes](https://img.shields.io/badge/format__codes-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/format_codes) | easy pretty printing using custom format codes (*print, inputs, format codes to ANSI, ...*) |
+| [![json](https://img.shields.io/badge/json-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/json)                          | advanced working with json files (*read, create, update, ...*)                              |
+| [![path](https://img.shields.io/badge/path-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/path)                          | advanced path operations (*get paths, smart-extend relative paths, delete paths, ...*)      |
+| [![regex](https://img.shields.io/badge/regex-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/regex)                       | generated regex pattern-templates (*match bracket- and quote pairs, match colors, ...*)     |
+| [![string](https://img.shields.io/badge/string-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/string)                    | helpful actions when working with strings. (*normalize, escape, decompose, ...*)            |
+| [![system](https://img.shields.io/badge/system-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/system)                    | advanced system actions (*restart with message, check installed Python libs, ...*)          |
+
+<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 COLOR INTO A hexa() COLOR
+        hexa_color = hexa(input_clr)
+
+    except ValueError:
+        # ANNOUNCE THE ERROR 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 TYPES
+    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 TYPES
+    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.8.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+xulbux/__init__.py,sha256=ee9vPsQXG50BOKoVLqUmcClEs-94eYHN3572x0AC3BY,817
+xulbux/code.py,sha256=CLA3wh6mTvcXTlQgBeFaaLIBciHvXWqVM56rAtfO-JE,6102
+xulbux/color.py,sha256=XCB05xBSEz6-dpX9yVkMB2zTSdTH01MfUazJEthL_zM,49741
+xulbux/console.py,sha256=J--5Ma2H3-YPT21pT92J4mNgu-0h_vJJ8M1BLOKbHWc,42773
+xulbux/data.py,sha256=hB9JxrSC7_6kelJ_TwOaapNrlig-jiyNZS3YoiJX8F8,30884
+xulbux/env_path.py,sha256=HGOSffdIDubzczsXe6umyqotrzqhIW83QBkISAamXT8,4157
+xulbux/file.py,sha256=7pa0-WS_DpXq7HRB1fLS6Acd9CM-ozXPpNJvMqCW4fw,2624
+xulbux/format_codes.py,sha256=94VyxnUZI2dS1glteNs7izKYrTI_W2pukFGF5f9k72E,24720
+xulbux/json.py,sha256=Ei5FdCjfM0FrrAEBmuuTcexl7mUY4eirXr-QPct2OS0,7448
+xulbux/path.py,sha256=lLAEVZrW0TAwCewlONFVQcQ_8tVn9LTJZVOZpeGvE5s,7673
+xulbux/regex.py,sha256=_BtMHRDNcD9zF4SL87dQuUVZcYGfZx9H5YNSDiEtzm8,8059
+xulbux/string.py,sha256=QaTo0TQ9m_2USNgQNaVw5ivQt-A1E-e5x8OpIB3xIlY,5561
+xulbux/system.py,sha256=Y5x719Ocwi93VJ6DVE8NR_Js7FQ6QT5wmtjX9FAsw9U,6582
+xulbux-1.8.0.dist-info/METADATA,sha256=Gk3Oj08lJRZuRWrUZ5bkPVjjWy0HIGS4h9UazzDrzP8,11041
+xulbux-1.8.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+xulbux-1.8.0.dist-info/entry_points.txt,sha256=aYh89GfiBOB8vw2VPgC6rhBinhnJoAL1kig-3lq_zkg,58
+xulbux-1.8.0.dist-info/top_level.txt,sha256=FkK4EZajwfP36fnlrPaR98OrEvZpvdEOdW1T5zTj6og,7
+xulbux-1.8.0.dist-info/RECORD,,

xulbux-1.8.0.dist-info/entry_points.txt

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

xulbux/_cli_.py

@@ -1,46 +0,0 @@
-from ._consts_ import COLOR
-from . import __version__
-from .xx_format_codes import FormatCodes
-from .xx_console import Console
-
-
-def help_command():
-    """Show some info about the library, with a brief explanation of how to use it."""
-    color = {
-        "class": COLOR.tangerine,
-        "const": COLOR.red,
-        "func": COLOR.cyan,
-        "import": COLOR.neongreen,
-        "lib": COLOR.orange,
-        "punctuators": COLOR.darkgray,
-        "code_border": COLOR.gray,
-    }
-    FormatCodes.print(
-        rf"""  [_|b|#7075FF]               __  __
-  [b|#7075FF]  _  __ __  __/ / / /_  __  ___  __
-  [b|#7075FF] | |/ // / / / / / __ \/ / / | |/ /
-  [b|#7075FF] > , </ /_/ / /_/ /_/ / /_/ /> , <
-  [b|#7075FF]/_/|_|\____/\__/\____/\____//_/|_|  [*|BG:{COLOR.gray}|#000] v[b]{__version__} [*]
-
-  [i|{COLOR.coral}]A TON OF COOL FUNCTIONS, YOU NEED![*]
-
-  [b|#FCFCFF]Usage:[*]
-  [dim|{color['code_border']}](╭────────────────────────────────────────────────────╮)
-  [dim|{color['code_border']}](│) [{color['punctuators']}]# CONSTANTS[*]                                        [dim|{color['code_border']}](│)
-  [dim|{color['code_border']}](│) [{color['import']}]from [{color['lib']}]xulbux [{color['import']}]import [{color['const']}]COLOR[{color['punctuators']}], [{color['const']}]CHARS[{color['punctuators']}], [{color['const']}]ANSI[*]              [dim|{color['code_border']}](│)
-  [dim|{color['code_border']}](│) [{color['punctuators']}]# Classes[*]                                          [dim|{color['code_border']}](│)
-  [dim|{color['code_border']}](│) [{color['import']}]from [{color['lib']}]xulbux [{color['import']}]import [{color['class']}]Code[{color['punctuators']}], [{color['class']}]Color[{color['punctuators']}], [{color['class']}]Console[{color['punctuators']}], ...[*]       [dim|{color['code_border']}](│)
-  [dim|{color['code_border']}](│) [{color['punctuators']}]# types[*]                                            [dim|{color['code_border']}](│)
-  [dim|{color['code_border']}](│) [{color['import']}]from [{color['lib']}]xulbux [{color['import']}]import [{color['func']}]rgba[{color['punctuators']}], [{color['func']}]hsla[{color['punctuators']}], [{color['func']}]hexa[*]                [dim|{color['code_border']}](│)
-  [dim|{color['code_border']}](╰────────────────────────────────────────────────────╯)
-  [b|#FCFCFF]Documentation:[*]
-  [dim|{color['code_border']}](╭────────────────────────────────────────────────────╮)
-  [dim|{color['code_border']}](│) [#DADADD]For more information see the GitHub page.          [dim|{color['code_border']}](│)
-  [dim|{color['code_border']}](│) [u|#8085FF](https://github.com/XulbuX/PythonLibraryXulbuX/wiki) [dim|{color['code_border']}](│)
-  [dim|{color['code_border']}](╰────────────────────────────────────────────────────╯)
-  [_]
-  [dim](Press any key to exit...)
-  """,
-        default_color=COLOR.text
-    )
-    Console.pause_exit(pause=True)