feat: open containing folder action (#1592)

Author: GeopJr

src/Application.vala

@@ -50,7 +50,8 @@ namespace Tuba {
 		public signal void refresh_featured ();
 		public signal void relationship_invalidated (API.Relationship new_relationship);
 		public signal void remove_user_id (string user_id);
-		public signal void toast (string title, uint timeout = 5);
+		// TODO: maybe just pass Adw.Toasts at this point
+		public signal void toast (string title, uint timeout = 5, string? action_name = null, GLib.Variant? action_target = null, string? action_label = null);
 
 		#if DEV_MODE
 			public signal void dev_new_post (Json.Node node);
@@ -94,7 +95,8 @@ namespace Tuba {
 			{ "open-scheduled-posts", open_scheduled_posts },
 			{ "open-draft-posts", open_draft_posts },
 			{ "open-admin-dashboard", open_admin_dashboard },
-			{ "open-last-fediwrapped", open_last_fediwrapped }
+			{ "open-last-fediwrapped", open_last_fediwrapped },
+			{ "open-containing-folder", open_containing_folder, "s" }
 		};
 
 		#if DEV_MODE
@@ -547,6 +549,11 @@ namespace Tuba {
 			accounts.active.open_latest_wrapped ();
 		}
 
+		public void open_containing_folder (GLib.SimpleAction action, GLib.Variant? value) {
+			if (value == null) return;
+			Utils.Host.open_containing_folder.begin (value.get_string ());
+		}
+
 		private void close_sidebar () {
 			var split_view = app.main_window.split_view;
 			if (split_view.collapsed)

src/Dialogs/MainWindow.vala

@@ -38,9 +38,12 @@ public class Tuba.Dialogs.MainWindow: Adw.ApplicationWindow, Saveable {
 		Tuba.toggle_css (split_view, settings.darken_images_on_dark_mode, "ttl-darken-images");
 	}
 
-	private void add_toast (string content, uint timeout = 0) {
+	private void add_toast (string content, uint timeout = 0, string? action_name = null, GLib.Variant? action_target = null, string? action_label = null) {
 		toast_overlay.add_toast (new Adw.Toast (content) {
-			timeout = timeout
+			timeout = timeout,
+			action_name = action_name,
+			action_target = action_target,
+			button_label = action_label
 		});
 	}
 

src/Dialogs/NewAccount.vala

@@ -73,9 +73,12 @@ public class Tuba.Dialogs.NewAccount: Adw.Window {
 		instance_entry.grab_focus ();
 	}
 
-	private void add_toast (string content, uint timeout = 0) {
+	private void add_toast (string content, uint timeout = 0, string? action_name = null, GLib.Variant? action_target = null, string? action_label = null) {
 		toast_overlay.add_toast (new Adw.Toast (content) {
-			timeout = timeout
+			timeout = timeout,
+			action_name = action_name,
+			action_target = action_target,
+			button_label = action_label
 		});
 	}
 

src/Utils/Host.vala

@@ -49,6 +49,16 @@ public class Tuba.Utils.Host {
 		return true;
 	}
 
+	public static async void open_containing_folder (string path) {
+		debug (@"Opening containing folder for $path");
+
+		try {
+			yield (new Gtk.FileLauncher (File.new_for_path (path))).open_containing_folder (app.active_window, null);
+		} catch (Error e) {
+			warning (@"Error opening containing folder for \"$path\": $(e.message)");
+		}
+	}
+
 	public static void copy (string str) {
 		Gdk.Display display = Gdk.Display.get_default ();
 		if (display == null) return;

src/Widgets/Attachment/Item.vala

@@ -41,7 +41,17 @@ public class Tuba.Widgets.Attachment.Item : Adw.Bin {
 			if (file != null) {
 				debug (@"Downloading file: $(url)…");
 				bool success = yield download (url, file);
-				app.toast (success ? _("Saved Media") : _("Couldn't Save Media"));
+
+				if (success) {
+					app.toast (
+						_("Saved Media"), 5, "app.open-containing-folder",
+						new GLib.Variant.string (file.get_path ()),
+						// translators: label on toast shown when downloading an attachment that opens the folder containing the file
+						_("Open Folder")
+					);
+				} else {
+					app.toast (_("Couldn't Save Media"));
+				}
 			}
 		} catch (Error e) {
 			// User dismissing the dialog also ends here so don't make it sound like