update 1.8.3

Author: xulbux

CHANGELOG.md

@@ -14,6 +14,10 @@
 
 # <br><b>Changelog</b><br>
 
+## ... `v1.8.3`
+* adjusted the look of the prompts and inputs of the `System.check_libs()` method
+* adjusted error messages throughout the whole library to all be structured about the same
+
 ## 11.09.2025 `v1.8.2`
 * the client command `xulbux-help` now tells you that there's a newer version of the library available, if you're not using the latest version
 * added two new params to `Console.input()`:

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "xulbux"
-version = "1.8.2"
+version = "1.8.3"
 authors = [{ name = "XulbuX", email = "xulbux.real@gmail.com" }]
 maintainers = [{ 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."

src/xulbux/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "1.8.2"
+__version__ = "1.8.3"
 
 __author__ = "XulbuX"
 __email__ = "xulbux.real@gmail.com"

src/xulbux/data.py

@@ -24,21 +24,24 @@ def serialize_bytes(data: bytes | bytearray) -> dict[str, str]:
             except UnicodeDecodeError:
                 pass
             return {key: _base64.b64encode(data).decode("utf-8"), "encoding": "base64"}
-        raise TypeError("Unsupported data type")
+        raise TypeError(f"Unsupported data type '{type(data)}'")
 
     @staticmethod
     def deserialize_bytes(obj: dict[str, str]) -> bytes | bytearray:
-        """Converts a JSON-compatible bytes/bytearray format (dictionary) back to its original type."""
+        """Tries to converts a JSON-compatible bytes/bytearray format (dictionary) back to its original type.\n
+        --------------------------------------------------------------------------------------------------------
+        If the serialized object was created with `Data.serialize_bytes()`, it will work.
+        If it fails to decode the data, it will raise a `ValueError`."""
         for key in ("bytes", "bytearray"):
             if key in obj and "encoding" in obj:
                 if obj["encoding"] == "utf-8":
                     data = obj[key].encode("utf-8")
                 elif obj["encoding"] == "base64":
                     data = _base64.b64decode(obj[key].encode("utf-8"))
                 else:
-                    raise ValueError("Unknown encoding method")
+                    raise ValueError(f"Unknown encoding method '{obj['encoding']}'")
                 return bytearray(data) if key == "bytearray" else data
-        raise ValueError("Invalid serialized data")
+        raise ValueError(f"Invalid serialized data: {obj}")
 
     @staticmethod
     def chars_count(data: DataStructure) -> int:
@@ -387,7 +390,7 @@ def update_nested(data: DataStructure, path: list[int], value: Any) -> DataStruc
 
         valid_entries = [(path_id, new_val) for path_id, new_val in update_values.items()]
         if not valid_entries:
-            raise ValueError(f"No valid update_values found in dictionary: {update_values}")
+            raise ValueError(f"No valid 'update_values' found in dictionary: {update_values}")
         for path_id, new_val in valid_entries:
             path = Data.__sep_path_id(path_id)
             data = update_nested(data, path, new_val)
@@ -581,7 +584,7 @@ def print(
     @staticmethod
     def __sep_path_id(path_id: str) -> list[int]:
         if path_id.count(">") != 1:
-            raise ValueError(f"Invalid path ID: {path_id}")
+            raise ValueError(f"Invalid path ID '{path_id}'")
         id_part_len = int(path_id.split(">")[0])
         path_ids_str = path_id.split(">")[1]
         return [int(path_ids_str[i:i + id_part_len]) for i in range(0, len(path_ids_str), id_part_len)]

src/xulbux/json.py

@@ -134,7 +134,7 @@ def create_nested_path(data_obj: dict, path_keys: list[str], value: Any) -> dict
                             current[idx] = [] if next_key.isdigit() else {}
                         current = current[idx]
                     else:
-                        raise TypeError(f"Cannot navigate through {type(current).__name__}")
+                        raise TypeError(f"Cannot navigate through '{type(current).__name__}'")
             return data_obj
 
         update = {}

src/xulbux/path.py

@@ -46,7 +46,7 @@ def extend(
         raise_error: bool = False,
         use_closest_match: bool = False,
     ) -> Optional[str]:
-        """Tries to locate and extend a relative path to an absolute path.\n
+        """Tries to resolve and extend a relative path to an absolute path.\n
         --------------------------------------------------------------------------------
         If the `rel_path` couldn't be located in predefined directories, it will be
         searched in the `search_in` directory/s. If the `rel_path` is still not found,

src/xulbux/system.py

@@ -1,3 +1,6 @@
+from .format_codes import FormatCodes
+from .console import Console
+
 from typing import Optional
 import subprocess as _subprocess
 import platform as _platform
@@ -68,10 +71,14 @@ def restart(prompt: object = "", wait: int = 0, continue_program: bool = False,
 
     @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."""
+        """Checks if the given list of libraries are installed and optionally installs missing libraries.\n
+        ------------------------------------------------------------------------------------------------------------
+        - `lib_names` -⠀a list of library names to check
+        - `install_missing` -⠀whether to directly missing libraries will be installed automatically using pip
+        - `confirm_install` -⠀whether the user will be asked for confirmation before installing missing libraries\n
+        ------------------------------------------------------------------------------------------------------------
+        If some libraries are missing or they could not be installed, their names will be returned as a list.
+        If all libraries are installed (or were installed successfully), `None` will be returned."""
         missing = []
         for lib in lib_names:
             try:
@@ -83,14 +90,18 @@ def check_libs(lib_names: list[str], install_missing: bool = False, confirm_inst
         elif not install_missing:
             return missing
         if confirm_install:
-            print("The following required libraries are missing:")
+            FormatCodes.print("[b](The following required libraries are missing:)")
             for lib in missing:
-                print(f"- {lib}")
-            if input("Do you want to install them now (Y/n):  ").strip().lower() not in ("", "y", "yes"):
-                raise ImportError("Missing required libraries.")
+                FormatCodes.print(f" [dim](•) [i]{lib}[_i]", end="\n\n")
+            if not Console.confirm("Do you want to install them now?"):
+                return missing
         try:
-            _subprocess.check_call([_sys.executable, "-m", "pip", "install"] + missing)
-            return None
+            for lib in missing:
+                _subprocess.check_call([_sys.executable, "-m", "pip", "install", lib])
+                missing.remove(lib)
+            if len(missing) == 0:
+                return None
+            return missing
         except _subprocess.CalledProcessError:
             return missing
 

tests/test_system.py

@@ -36,8 +36,10 @@ def test_check_libs_nonexistent_module():
 @patch('builtins.input', return_value='n')  # Decline installation
 def test_check_libs_decline_install(mock_input, mock_subprocess):
     """Test check_libs when user declines installation"""
-    with pytest.raises(ImportError, match="Missing required libraries"):
-        System.check_libs(["nonexistent_module_12345"], install_missing=True, confirm_install=True)
+    result = System.check_libs(["nonexistent_module_12345"], install_missing=True)
+    assert isinstance(result, list)
+    assert "nonexistent_module_12345" in result
+    mock_subprocess.assert_not_called()
 
 
 @pytest.mark.skipif(os.name != 'nt', reason="Windows-specific test")