feat: add input state persistence

Add the ability to save and restore input text between sessions

- save input text to state.ron when window closes
- restore text when application launches
- clear state when match is selected
- add persist_state config option
- add state_ttl_secs config option to expiry a saved state after some time
- update documentation and examples
- add home-manager module support

Author: Tronix117

README.md

@@ -27,6 +27,10 @@ A wayland native krunner-like runner, made with customizability in mind.
     documentation of the [anyrun-plugin](anyrun-plugin) crate.
 - Responsive
   - Asynchronous running of plugin functions
+- State persistence
+  - Optional saving and restoring of input text between sessions
+  - Automatically clears state when selecting a match
+  - Can be configured to automatically discard state after a certain time
 - Wayland native
   - GTK layer shell for overlaying the window
   - data-control for managing the clipboard
@@ -117,6 +121,8 @@ You may use it in your system like this:
       hidePluginInfo = false;
       closeOnClick = false;
       showResultsImmediately = false;
+      persistState = false;
+      stateTtlSecs = null;
       maxEntries = null;
 
       plugins = [
@@ -229,13 +235,30 @@ the config directory is as follows and should be respected by plugins:
     - <plugin dynamic libraries>
   - config.ron
   - style.css
+  - state.ron    # Optional, used to retain state when state saving is enabled
   - <any plugin specific config files>
 ```
 
 The [default config file](examples/config.ron) contains the default values, and
 annotates all configuration options with comments on what they are and how to
 use them.
 
+### State Saving
+
+When `persist_state` is set to `true` in the config, Anyrun will:
+- Save the input text to `state.ron` when the window is closed
+- Restore this text when Anyrun is launched again
+- Clear the saved state when a match is selected
+
+You can optionally set `state_ttl_secs` to automatically discard saved state after a certain time. For example:
+```ron
+// Enable state persistence with 2-minute TTL
+persist_state: true,
+state_ttl_secs: Some(120)
+```
+
+This is useful for preserving your input between sessions, especially for longer queries or calculations.
+
 ## Styling
 
 Anyrun supports [GTK+ CSS](https://docs.gtk.org/gtk3/css-overview.html) styling.

anyrun/src/main.rs

@@ -1,20 +1,20 @@
 use std::{
     cell::RefCell,
     env, fs,
-    io::{self, Write},
+    io::{self, BufRead, BufReader, Read, Write},
     mem,
     path::PathBuf,
     rc::Rc,
     sync::Once,
-    time::Duration,
+    time::{Duration, SystemTime, UNIX_EPOCH},
 };
 
 use abi_stable::std_types::{ROption, RVec};
 use anyrun_interface::{HandleResult, Match, PluginInfo, PluginRef, PollResult};
 use clap::{Parser, ValueEnum};
 use gtk::{gdk, gdk_pixbuf, gio, glib, prelude::*};
 use nix::unistd;
-use serde::Deserialize;
+use serde::{Deserialize, Serialize};
 use wl_clipboard_rs::copy;
 
 #[anyrun_macros::config_args]
@@ -49,6 +49,10 @@ struct Config {
     max_entries: Option<usize>,
     #[serde(default = "Config::default_layer")]
     layer: Layer,
+    #[serde(default)]
+    persist_state: bool,
+    #[serde(default)]
+    state_ttl_secs: Option<u64>,
 }
 
 impl Config {
@@ -97,6 +101,8 @@ impl Default for Config {
             show_results_immediately: false,
             max_entries: None,
             layer: Self::default_layer(),
+            persist_state: false,
+            state_ttl_secs: None,
         }
     }
 }
@@ -178,6 +184,67 @@ struct RuntimeData {
     config_dir: String,
 }
 
+impl RuntimeData {
+    fn state_file(&self) -> String {
+        format!("{}/state.txt", self.config_dir)
+    }
+
+    fn save_state(&self, text: &str) -> io::Result<()> {
+        if !self.config.persist_state {
+            return Ok(());
+        }
+        let timestamp = SystemTime::now()
+            .duration_since(UNIX_EPOCH)
+            .unwrap()
+            .as_millis();
+        
+        let mut file = fs::File::create(self.state_file())?;
+        writeln!(file, "{}", timestamp)?;
+        write!(file, "{}", text)
+    }
+
+    fn load_state(&self) -> io::Result<String> {
+        if !self.config.persist_state {
+            return Ok(String::new());
+        }
+        match fs::File::open(self.state_file()) {
+            Ok(file) => {
+                let mut reader = BufReader::new(file);
+                
+                // Read timestamp from first line
+                let mut timestamp_str = String::new();
+                reader.read_line(&mut timestamp_str)?;
+                let timestamp = timestamp_str.trim().parse::<u128>().unwrap_or(0);
+                
+                // Check if state has expired
+                if let Some(expiry_secs) = self.config.state_ttl_secs {
+                    let now = SystemTime::now()
+                        .duration_since(UNIX_EPOCH)
+                        .unwrap()
+                        .as_millis();
+                    if now - timestamp > u128::from(expiry_secs) * 1000 {
+                        return Ok(String::new());
+                    }
+                }
+                
+                // Read text from second line to end
+                let mut text = String::new();
+                reader.read_to_string(&mut text)?;
+                Ok(text)
+            }
+            Err(e) if e.kind() == io::ErrorKind::NotFound => Ok(String::new()),
+            Err(e) => Err(e),
+        }
+    }
+
+    fn clear_state(&self) -> io::Result<()> {
+        if !self.config.persist_state {
+            return Ok(());
+        }
+        fs::write(self.state_file(), "0\n")
+    }
+}
+
 /// The naming scheme for CSS styling
 ///
 /// Refer to [GTK 3.0 CSS Overview](https://docs.gtk.org/gtk3/css-overview.html)
@@ -251,7 +318,7 @@ fn main() {
 
     config.merge_opt(args.config);
 
-    let runtime_data: Rc<RefCell<RuntimeData>> = Rc::new(RefCell::new(RuntimeData {
+    let runtime_data = Rc::new(RefCell::new(RuntimeData {
         exclusive: None,
         plugins: Vec::new(),
         post_run_action: PostRunAction::None,
@@ -465,10 +532,21 @@ fn activate(app: &gtk::Application, runtime_data: Rc<RefCell<RuntimeData>>) {
         .name(style_names::ENTRY)
         .build();
 
-    // Refresh the matches when text input changes
+    // Set initial text from loaded state
+    if let Ok(initial_text) = runtime_data.borrow().load_state() {
+        entry.set_text(&initial_text);
+    } else {
+        eprintln!("Failed to load state");
+    }
+
+    // Update last_input, save state and refresh matches when text changes
     let runtime_data_clone = runtime_data.clone();
     entry.connect_changed(move |entry| {
-        refresh_matches(entry.text().to_string(), runtime_data_clone.clone())
+        let text = entry.text().to_string();
+        if let Err(e) = runtime_data_clone.borrow().save_state(&text) {
+            eprintln!("Failed to save state: {}", e);
+        }
+        refresh_matches(text, runtime_data_clone.clone());
     });
 
     // Handle other key presses for selection control and all other things that may be needed
@@ -584,6 +662,9 @@ fn activate(app: &gtk::Application, runtime_data: Rc<RefCell<RuntimeData>>) {
                     (*selected_match.data::<Match>("match").unwrap().as_ptr()).clone()
                 }) {
                     HandleResult::Close => {
+                        if let Err(e) = _runtime_data_clone.clear_state() {
+                            eprintln!("Failed to clear state: {}", e);
+                        }
                         window.close();
                         Inhibit(true)
                     }
@@ -599,13 +680,19 @@ fn activate(app: &gtk::Application, runtime_data: Rc<RefCell<RuntimeData>>) {
                     }
                     HandleResult::Copy(bytes) => {
                         _runtime_data_clone.post_run_action = PostRunAction::Copy(bytes.into());
+                        if let Err(e) = _runtime_data_clone.clear_state() {
+                            eprintln!("Failed to clear state: {}", e);
+                        }
                         window.close();
                         Inhibit(true)
                     }
                     HandleResult::Stdout(bytes) => {
                         if let Err(why) = io::stdout().lock().write_all(&bytes) {
                             eprintln!("Error outputting content to stdout: {}", why);
                         }
+                        if let Err(e) = _runtime_data_clone.clear_state() {
+                            eprintln!("Failed to clear state: {}", e);
+                        }
                         window.close();
                         Inhibit(true)
                     }
@@ -679,11 +766,17 @@ fn activate(app: &gtk::Application, runtime_data: Rc<RefCell<RuntimeData>>) {
                 main_vbox.add(&main_list);
                 main_list.show();
                 entry.grab_focus(); // Grab the focus so typing is immediately accepted by the entry box
+                entry.set_position(-1); // -1 moves cursor to end of text in case some text was restored
             }
 
-            if runtime_data.borrow().config.show_results_immediately {
-                // Get initial matches
-                refresh_matches(String::new(), runtime_data);
+            // Show initial results if state restoration is enabled or immediate results are configured
+            let should_show_results = {
+                let data = runtime_data.borrow();
+                data.config.persist_state || data.config.show_results_immediately
+            };
+            
+            if should_show_results {
+                refresh_matches(entry.text().to_string(), runtime_data);
             }
         });
 

examples/config.ron

@@ -33,9 +33,16 @@ Config(
   // Show search results immediately when Anyrun starts
   show_results_immediately: false,
 
+  // Whether to save and restore input text between sessions
+  persist_state: false,
+
+  // Time in seconds after which saved state is discarded
+  // For example, set to 120 to clear state after 2 minutes of inactivity
+  state_ttl_secs: None,
+  
   // Limit amount of entries shown in total
   max_entries: None,
-  
+
   // List of plugins to be loaded by default, can be specified with a relative path to be loaded from the
   // `<anyrun config dir>/plugins` directory or with an absolute path to just load the file the path points to.
   plugins: [

nix/modules/home-manager.nix

@@ -144,6 +144,18 @@ in {
         description = "Show search results immediately when Anyrun starts";
       };
 
+      persistState = mkOption {
+        type = bool;
+        default = false;
+        description = "Whether to save and restore input text between sessions";
+      };
+
+      stateTtlSecs = mkOption {
+        type = nullOr int;
+        default = null;
+        description = "Time in seconds after which saved state is discarded";
+      };
+
       maxEntries = mkOption {
         type = nullOr int;
         default = null;
@@ -233,6 +245,12 @@ in {
             hide_plugin_info: ${boolToString cfg.config.hidePluginInfo},
             close_on_click: ${boolToString cfg.config.closeOnClick},
             show_results_immediately: ${boolToString cfg.config.showResultsImmediately},
+            persist_state: ${boolToString cfg.config.persistState},
+            state_ttl_secs: ${
+            if cfg.config.stateTtlSecs == null
+            then "None"
+            else "Some(${toString cfg.config.stateTtlSecs})"
+          },
             max_entries: ${
             if cfg.config.maxEntries == null
             then "None"