Implement Metadata/Information display for files (and preview)

Cargo.toml

@@ -35,10 +35,18 @@ serde = { version = "1", features = ["derive"], optional = true }
 # Used to canonicalize paths
 dunce = "1.0.5"
 
+# used for meta-data storage
+indexmap = { version = "2.6.0", features = ["serde"], optional = true }
+
+# Used for info panel
+image-meta = { version = "0.1.2", optional = true }
+chrono = { version = "0.4.38", optional = true }
+
 [features]
 default = ["serde", "default_fonts"]
 serde = ["dep:serde"]
 default_fonts = ["egui/default_fonts"]
+information_view = ["dep:chrono", "image-meta", "indexmap"]
 
 [lints.rust]
 unsafe_code = "warn"
@@ -60,3 +68,4 @@ struct_field_names = { level = "allow", priority = 13 }
 missing_fields_in_debug = { level = "allow", priority = 14 }
 missing_errors_doc = { level = "allow", priority = 15 }
 module_name_repetitions = { level = "allow", priority = 16 }
+cast_precision_loss = { level = "allow", priority = 17 }

examples/pick_file/Cargo.toml

@@ -7,4 +7,4 @@ edition = "2021"
 
 [dependencies]
 eframe = { workspace = true }
-egui-file-dialog = { path = "../../"}
+egui-file-dialog = { path = "../../"}

examples/select_file_with_information_view/Cargo.toml

@@ -0,0 +1,15 @@
+[package]
+name = "select_file_with_information_view"
+version = "0.1.0"
+edition = "2021"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[dependencies]
+eframe = { workspace = true }
+egui_extras = { version = "0.29", features = ["all_loaders"] }
+image = { version = "0.25.5", features = ["bmp", "jpeg", "gif", "png", "tiff", "rayon"] }
+egui-file-dialog = { path = "../../", features = ["information_view"] }
+
+[package.metadata.cargo-machete]
+ignored = ["image"]

examples/select_file_with_information_view/README.md

@@ -0,0 +1,7 @@
+Example showing how to select a file and display file information using the `InformationView`.
+
+```
+cargo run -p select_file_with_information_view
+```
+
+![](screenshot.png)

examples/select_file_with_information_view/src/main.rs

@@ -0,0 +1,71 @@
+use std::path::PathBuf;
+
+use eframe::egui;
+use egui_file_dialog::information_panel::InformationPanel;
+use egui_file_dialog::FileDialog;
+
+struct MyApp {
+    file_dialog: FileDialog,
+    information_panel: InformationPanel,
+    selected_file: Option<PathBuf>,
+}
+
+impl MyApp {
+    pub fn new(_cc: &eframe::CreationContext) -> Self {
+        Self {
+            file_dialog: FileDialog::new(),
+            information_panel: InformationPanel::default()
+                .add_file_preview("csv", |ui, item| {
+                    ui.label("CSV preview:");
+                    if let Some(mut content) = item.content() {
+                        egui::ScrollArea::vertical()
+                            .max_height(150.0)
+                            .show(ui, |ui| {
+                                ui.add(egui::TextEdit::multiline(&mut content).code_editor());
+                            });
+                    }
+                })
+                // add additional metadata loader
+                .add_metadata_loader("pdf", |other_meta_data, path| {
+                    // as a simple example, just show the Filename of the PDF
+                    other_meta_data.insert("PDF Filename".to_string(), format!("{:?}", path));
+                }),
+            selected_file: None,
+        }
+    }
+}
+
+impl eframe::App for MyApp {
+    fn update(&mut self, ctx: &egui::Context, _frame: &mut eframe::Frame) {
+        egui::CentralPanel::default().show(ctx, |ui| {
+            if ui.button("Select file").clicked() {
+                self.file_dialog.pick_file();
+            }
+
+            self.file_dialog.set_right_panel_width(300.0);
+
+            if let Some(path) = self
+                .file_dialog
+                .update_with_right_panel_ui(ctx, &mut |ui, dia| {
+                    self.information_panel.ui(ui, dia);
+                })
+                .picked()
+            {
+                self.selected_file = Some(path.to_path_buf());
+            }
+
+            ui.label(format!("Selected file: {:?}", self.selected_file));
+        });
+    }
+}
+
+fn main() -> eframe::Result<()> {
+    eframe::run_native(
+        "File dialog example",
+        eframe::NativeOptions::default(),
+        Box::new(|ctx| {
+            egui_extras::install_image_loaders(&ctx.egui_ctx);
+            Ok(Box::new(MyApp::new(ctx)))
+        }),
+    )
+}

src/config/mod.rs

@@ -188,6 +188,9 @@ pub struct FileDialogConfig {
     /// If the search input in the top panel should be visible.
     pub show_search: bool,
 
+    /// Set the width of the right panel, if used
+    pub right_panel_width: Option<f32>,
+
     /// If the sidebar with the shortcut directories such as
     /// “Home”, “Documents” etc. should be visible.
     pub show_left_panel: bool,
@@ -260,6 +263,7 @@ impl Default for FileDialogConfig {
             show_system_files_option: true,
             show_search: true,
 
+            right_panel_width: None,
             show_left_panel: true,
             show_pinned_folders: true,
             show_places: true,

src/data/directory_content.rs

@@ -1,20 +1,29 @@
+use crate::config::{FileDialogConfig, FileFilter};
+use egui::mutex::Mutex;
 use std::path::{Path, PathBuf};
 use std::sync::{mpsc, Arc};
 use std::time::SystemTime;
 use std::{fs, io, thread};
 
-use egui::mutex::Mutex;
-
-use crate::config::{FileDialogConfig, FileFilter};
-
 /// Contains the metadata of a directory item.
+#[derive(Debug, Default, Clone)]
+#[cfg_attr(feature = "serde", derive(serde::Deserialize, serde::Serialize))]
+pub struct Metadata {
+    pub size: Option<u64>,
+    pub last_modified: Option<SystemTime>,
+    pub created: Option<SystemTime>,
+    pub file_type: Option<String>,
+}
+
+/// Contains the information of a directory item.
 ///
-/// This struct is mainly there so that the metadata can be loaded once and not that
+/// This struct is mainly there so that the information and metadata can be loaded once and not that
 /// a request has to be sent to the OS every frame using, for example, `path.is_file()`.
 #[derive(Debug, Default, Clone)]
 #[cfg_attr(feature = "serde", derive(serde::Deserialize, serde::Serialize))]
 pub struct DirectoryEntry {
     path: PathBuf,
+    metadata: Metadata,
     is_directory: bool,
     is_system_file: bool,
     icon: String,
@@ -25,15 +34,30 @@ pub struct DirectoryEntry {
 impl DirectoryEntry {
     /// Creates a new directory entry from a path
     pub fn from_path(config: &FileDialogConfig, path: &Path) -> Self {
+        let mut metadata = Metadata::default();
+
+        if let Ok(md) = fs::metadata(path) {
+            metadata.size = Some(md.len());
+            metadata.last_modified = md.modified().ok();
+            metadata.created = md.created().ok();
+            metadata.file_type = Some(format!("{:?}", md.file_type()));
+        }
+
         Self {
             path: path.to_path_buf(),
+            metadata,
             is_directory: path.is_dir(),
             is_system_file: !path.is_dir() && !path.is_file(),
             icon: gen_path_icon(config, path),
             selected: false,
         }
     }
 
+    /// Returns the metadata of the directory entry.
+    pub const fn metadata(&self) -> &Metadata {
+        &self.metadata
+    }
+
     /// Checks if the path of the current directory entry matches the other directory entry.
     pub fn path_eq(&self, other: &Self) -> bool {
         other.as_path() == self.as_path()