update 1.8.2

Author: xulbux

CHANGELOG.md

@@ -16,6 +16,9 @@
 
 ## ... `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()`:
+  - <code>default_val: *Optional[T]* = None</code> the default value to return if the input is empty
+  - <code>output_type: *T* = str</code> the type (*class*) to convert the input to before returning it
 
 ## 20.08.2025 `v1.8.1`
 * **fixed a critical bug which caused the package to not install properly and make the whole library not work**

src/xulbux/console.py

@@ -730,7 +730,7 @@ def _(event):
         return input_string
 
     @staticmethod
-    def input(
+    def input[T](
         prompt: object = "",
         start="",
         end="",
@@ -742,7 +742,9 @@ def input(
         allowed_chars: str = CHARS.ALL,  #type: ignore[assignment]
         allow_paste: bool = True,
         validator: Optional[Callable[[str], Optional[str]]] = None,
-    ) -> str:
+        default_val: Optional[T] = None,
+        output_type: type[T] = str,  # type: ignore[assignment]
+    ) -> T:
         """Acts like a standard Python `input()` a bunch of cool extra features.\n
         ------------------------------------------------------------------------------------
         - `prompt` -⠀the input prompt
@@ -758,12 +760,15 @@ def input(
         - `allow_paste` -⠀whether to allow pasting text into the input or not
         - `validator` -⠀a function that takes the input string and returns a string error
           message if invalid, or nothing if valid
+        - `default_val` -⠀the default value to return if the input is empty
+        - `output_type` -⠀the type (class) to convert the input to before returning it\n
         ------------------------------------------------------------------------------------
         The input prompt can be formatted with special formatting codes. For more detailed
         information about formatting codes, see the `format_codes` module documentation."""
         result_text = ""
         tried_pasting = False
         filtered_chars = set()
+        has_default = default_val is not None
 
         class InputValidator(Validator):
 
@@ -905,4 +910,16 @@ def _(event: KeyPressEvent) -> None:
         FormatCodes.print(start, end="")
         session.prompt()
         FormatCodes.print(end, end="")
-        return result_text
+
+        if result_text in ("", None):
+            if has_default: return default_val
+            result_text = ""
+        
+        if output_type == str:
+            return result_text  # type: ignore[return-value]
+        else:
+            try:
+                return output_type(result_text)  # type: ignore[call-arg]
+            except (ValueError, TypeError):
+                if has_default: return default_val
+                raise