feat: add files delimiter option to browse dialogs

Co-authored-by: kujirahand <2153829+kujirahand@users.noreply.github.com>

Author: Codex

TkEasyGUI/dialogs.py

@@ -712,6 +712,7 @@ def popup_get_file(
     multiple_files: bool = False,  # can select multiple files
     file_types: Optional[FileTypeList] = None,
     default_extension: Optional[str] = None,
+    files_delimiter: Optional[str] = ";",
     # pylint: disable=unused-argument
     no_window: Optional[bool] = None,  # for compatibility
     **kw,
@@ -779,6 +780,9 @@ def popup_get_file(
             multiple=multiple_files,  # type: ignore
             **kw,
         )
+    if multiple_files and isinstance(result, (tuple, list)):
+        if files_delimiter is not None:
+            result = files_delimiter.join(result)
     return result
 
 

TkEasyGUI/widgets.py

@@ -4688,6 +4688,7 @@ def __init__(
         save_as: bool = False,
         enable_events: bool = False,  # enable changing events
         # other
+        files_delimiter: Optional[str] = ";",
         metadata: Union[dict[str, Any], None] = None,
         **kw,
     ) -> None:
@@ -4705,6 +4706,7 @@ def __init__(
         self.save_as = save_as
         self.multiple_files = multiple_files
         self.initial_folder = initial_folder
+        self.files_delimiter = files_delimiter
         self.props["text"] = button_text
         self.enable_events = enable_events
 
@@ -4756,9 +4758,12 @@ def show_dialog(self, *args) -> Union[Any, None]:
             save_as=self.save_as,
             file_types=self.file_types,
             multiple_files=self.multiple_files,
+            files_delimiter=self.files_delimiter,
         )
         if isinstance(result, (list, tuple)):
-            result = ";".join(result)
+            delimiter = self.files_delimiter
+            if delimiter is not None:
+                result = delimiter.join(result)
         if (target is not None) and (result is not None) and (result != ""):
             target.update(result)  # type: ignore [call-arg]
             if self.enable_events:
@@ -4791,20 +4796,25 @@ def __init__(
         target_key: Union[str, None] = None,
         title: str = "",
         file_types: Optional[FileTypeList] = None,
+        files_delimiter: Optional[str] = "|",
         enable_events: bool = False,  # enable changing events
         # other
         metadata: Union[dict[str, Any], None] = None,
         **kw,
     ) -> None:
         """Create a FilesBrowse element."""
-        super().__init__(button_text=button_text, key=key, metadata=metadata, **kw)
-        self.target_key = target_key
-        self.title = title
-        self.file_types = (
-            file_types if file_types is not None else [("All Files", "*.*")]
+        super().__init__(
+            button_text=button_text,
+            key=key,
+            target_key=target_key,
+            title=title,
+            file_types=file_types,
+            multiple_files=True,
+            files_delimiter=files_delimiter,
+            enable_events=enable_events,
+            metadata=metadata,
+            **kw,
         )
-        self.props["text"] = button_text
-        self.enable_events = enable_events
         # force set params
         self.multiple_files = True
         self.save_as = False

docs/TkEasyGUI/dialogs-py.md

@@ -363,12 +363,15 @@ def popup_get_file(
     multiple_files: bool = False,  # can select multiple files
     file_types: Optional[FileTypeList] = None,
     default_extension: Optional[str] = None,
+    files_delimiter: Optional[str] = ";",
     # pylint: disable=unused-argument
     no_window: Optional[bool] = None,  # for compatibility
     **kw,
 ) -> Union[str, tuple[str], None]:
 ```
 
+When selecting multiple files, the returned paths are joined using `files_delimiter` (default `";"`). Set `files_delimiter=None` to receive the raw tuple from the file dialog.
+
 - [source](https://github.com/kujirahand/tkeasygui-python/blob/main/TkEasyGUI/dialogs.py#L707)
 
 ## popup_get_folder
@@ -852,4 +855,3 @@ def show_message(message: str, title: Optional[str] = None) -> None:
 ```
 
 - [source](https://github.com/kujirahand/tkeasygui-python/blob/main/TkEasyGUI/dialogs.py#L1587)
-

docs/TkEasyGUI/widgets-py.md

@@ -2866,12 +2866,15 @@ class FileBrowse(
     initial_folder: Union[str, None] = None,
     save_as: bool = False,
     enable_events: bool = False,  # enable changing events
+    files_delimiter: Optional[str] = ";",
     # other
     metadata: Union[dict[str, Any], None] = None,
     **kw,
     ) 
 ```
 
+When `multiple_files` is enabled, selected paths are joined using `files_delimiter` (default `";"`).
+
 - [source](https://github.com/kujirahand/tkeasygui-python/blob/main/TkEasyGUI/widgets.py#L4679)
 
 ### Methods of FileBrowse
@@ -3697,6 +3700,8 @@ class FilesBrowse(
     ) 
 ```
 
+Multiple file selections are returned as a single string joined by `files_delimiter` (default `"|"`).
+
 - [source](https://github.com/kujirahand/tkeasygui-python/blob/main/TkEasyGUI/widgets.py#L4787)
 
 ### Methods of FilesBrowse
@@ -13644,4 +13649,3 @@ def valign_top(grid: list[list[Element]]) -> list[list[Element]]:
 ```
 
 - [source](https://github.com/kujirahand/tkeasygui-python/blob/main/TkEasyGUI/widgets.py#L5138)
-