Add file input instead of text field

- The previous text field in the GUI toolbar was replaced by a
VFileInput object, which enables searching for the files locally. Thus,
a validation of the entered .dat path is not required anymore. Moreover,
the VFileInput object is currently designed to only search for .dat
files.
- The corresponding file objects do not contain the full local path
(not possible due to security reasons). Therefore, we now store the .dat
file name, its file lines, its size and the last modified data as state
variables to match the new file input structure. Nonetheless, the user
can see the full file path when clicking on the VFileInput object.
- Improved docstring documentation of several functions.

Author: dragos-ana

src/fourc_webviewer/gui_utils.py

@@ -6,14 +6,104 @@
 if CLIENT_TYPE == "vue2":
     from trame.widgets import vuetify2 as vuetify
     from trame.ui.vuetify2 import SinglePageWithDrawerLayout
+    from trame_vuetify.widgets.vuetify import HtmlElement
 else:
     from trame.widgets import vuetify3 as vuetify
     from trame.ui.vuetify3 import SinglePageWithDrawerLayout
+    from trame_vuetify.widgets.vuetify3 import HtmlElement
 from trame.widgets import html, plotly, vtk
 
 
+class VFileInput(HtmlElement):
+    """Custom VFileInput element, since the one provided by trame does not currently support all relevant attributes, such as e.g. 'accept'.
+    """
+
+
+    def __init__(self, children=None, **kwargs):
+        super().__init__("v-file-input", children, **kwargs)
+        self._attr_names += [
+            "accept",
+            "append_icon",
+            "append_outer_icon",
+            "autofocus",
+            "background_color",
+            "chips",
+            "clear_icon",
+            "clearable",
+            "color",
+            "counter",
+            "counter_size_string",
+            "counter_string",
+            "counter_value",  # JS functions unimplemented
+            "dark",
+            "dense",
+            "disabled",
+            "error",
+            "error_count",
+            "error_messages",
+            "filled",
+            "flat",
+            "full_width",
+            "height",
+            "hide_details",
+            "hide_input",
+            "hide_spin_buttons",
+            "hint",
+            "id",
+            "label",
+            "light",
+            "loader_height",
+            "loading",
+            "messages",
+            "multiple",
+            "outlined",
+            "persistent_hint",
+            "persistent_placeholder",
+            "placeholder",
+            "prefix",
+            "prepend_icon",
+            "prepend_inner_icon",
+            "reverse",
+            "rounded",
+            "rules",
+            "shaped",
+            "show_size",
+            "single_line",
+            "small_chips",
+            "solo",
+            "solo_inverted",
+            "success",
+            "success_messages",
+            "suffix",
+            "truncate_length",
+            "type",
+            "validate_on_blur",
+            "value",
+        ]
+        self._event_names += [
+            "blur",
+            "change",
+            "click",
+            ("click_append", "click:append"),
+            ("click_append_outer", "click:append-outer"),
+            ("click_clear", "click:clear"),
+            ("click_prepend", "click:prepend"),
+            ("click_prepend_inner", "click:prepend-inner"),
+            "focus",
+            "input",
+            "keydown",
+            "mousedown",
+            "mouseup",
+            ("update_error", "update:error"),
+        ]
+
 def _toolbar(server_controller):
-    vuetify.VTextField(label=".dat file", v_model=("DAT_PATH",))
+    VFileInput(
+        label=".dat file", 
+        v_model=("INPUT_FILE",),
+        update_modelValue="flushState('INPUT_FILE')",
+        accept = ".dat"
+        )
     vuetify.VBtn(
         text="CONVERT",
         v_show=("VTU_PATH == ''",),

src/fourc_webviewer/input_file_utils/dat_file_visualization.py

@@ -8,7 +8,6 @@
 
 from fourc_webviewer.input_file_utils.read_dat_file import (
     add_dat_file_data_to_dis,
-    validate_dat_file_path,
 )
 from pathlib import Path
 
@@ -28,9 +27,6 @@ def convert_to_vtu(dat_file_path, temp_dir):
         Path(temp_dir) / f"{os.path.splitext(os.path.basename(dat_file_path))[0]}.vtu"
     )
 
-    # validate the provided .dat file path
-    validate_dat_file_path(dat_file_path)
-
     # convert dat file to vtu file and return the path to the vtu file
     try:
         dis = lnmmeshio.read(dat_file_path)