rtfm-filemanager 8.5.0 → 8.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f884960bd43345ca3368b1213be174efecf43943d20be674d722b70b848a7edf
-  data.tar.gz: 5c3b0d4c294ee89015df17b5b5adc4ba78b7080fee34fa5825d1a7a88f92531c
+  metadata.gz: 1a3688f47ab7f42eaf8488abfd1035d3ffa36fba99368ab2dc1846dda3119415
+  data.tar.gz: 2bf042038eee3c18c764c136d87848f15ff623389ff08625c1f5a6dd2564abba
 SHA512:
-  metadata.gz: ef00e7d08a4b579bb5a989cdbac6c30d02a77462401faeddaf30de42a464ccbbb547dcca7f369d050f0e64b83a8be8e4930eb38500d548bd010f4b77815f72c3
-  data.tar.gz: c063661025b9887def4c49f146042a78cc6dd3cf0dbc7fd5b42b929f3219fc64e5e79412bb2a6afa9cc2cfaa3188cf7f2f5380102573ecd4cd5ef0f07bd56544
+  metadata.gz: 89fec0164f4abec21cdcca454f77db2293dd4bed441f9edb26cb80148a7ffa0278b1af35c2e2d08eee19786ce1ff4fcc42afa128b6cd4349d71cf99695cca2d8
+  data.tar.gz: 827d9f52fb1cd639740b7f0d515ac076153f9bdde3ba4742f8d5bf71b1d9cc56df25029c25bd4e342a011707ee31ceb2c38edcfadebd75552bfbcede929edbd8

data/CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to RTFM will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [8.7.2] - 2026-05-19
+
+### Fixed
+- **`$` script-evaluator clears right pane first** - Short output (or `(no output)`) used to leave residual lines from the prior directory preview underneath. Now calls `@pR.clear` before painting the new content
+
+## [8.7.1] - 2026-05-19
+
+### Fixed
+- **`$` script-evaluator output now sticks** - The right pane was getting overwritten by the directory preview after the script returned. Mirrors `command_mode`'s pattern: explicit `@pR.full_refresh` + `@pR.update = false` so the script's output remains visible until the user navigates
+- **Directive trace footer** - Stderr directives (`cd:`, `select:`, `status:`) now produce a small `── directives applied ──` footer at the bottom of the output so it's clear *something* happened even when stdout is empty. Previously a pure-directive script just showed `(no output)`
+
+## [8.7.0] - 2026-05-19
+
+### Added
+- **Script evaluator (`$` key)** - Run any shell command (any language) with RTFM context exposed as environment variables. Output shows in the right pane. Variables: `RTFM_SELECTED` (full path), `RTFM_DIR` (cwd), `RTFM_TAGGED` (newline-separated tagged paths), `RTFM_INDEX` (0-based selection), `RTFM_COUNT` (file count), `RTFM_CONTEXT` (JSON object with all of the above). Scripts can control RTFM by emitting stderr directives one per line: `cd:/path` changes directory, `select:NAME` moves cursor onto NAME, `status:MSG` shows MSG in the bottom pane. The Ruby debug mode (`@`) is unchanged. Makes RTFM scriptable from Python, Bash, Perl, jq, anything — without writing Ruby plugins
+
+## [8.6.0] - 2026-05-19
+
+### Added
+- **`Terminal=true` in `.desktop` files honored** - When opening a file, if the resolved `.desktop` file declares `Terminal=true`, RTFM treats the program as interactive even when it isn't in `@interactive`. Newly installed TUI tools now "just work" without editing config. The `@interactive` whitelist still wins for programs whose `.desktop` files lie about being terminal apps
+
+### Fixed
+- **LS_COLORS fallback via `dircolors -b`** - When `$LS_COLORS` is unset or empty (cron launches, minimal login envs, some macOS setups), RTFM now seeds it from `dircolors -b` at startup so `ls --color` still emits ANSI. Directory listings stay colored in environments that don't export LS_COLORS
+
 ## [8.5.0] - 2026-05-19
 
 ### Added

data/bin/rtfm

@@ -18,7 +18,7 @@
 #             get a great understanding of the code itself by simply sending
 #             or pasting this whole file into you favorite AI for coding with
 #             a prompt like this: "Help me understand every part of this code".
-@version    = '8.5.0' # Crash log, persistent per-dir cursor, Claude AI, non-blocking `:` commands
+@version    = '8.7.2' # $ script-eval clears right pane before writing output
 
 # SAVE & STORE TERMINAL {{{1
 ORIG_STTY = `stty -g`.chomp
@@ -59,6 +59,18 @@ rescue LoadError
   # bootsnap not installed — proceed without compile cache
 end
 
+# LS_COLORS FALLBACK {{{1
+# RTFM relies on `ls --color` ANSI output for left/right pane colors, and
+# `ls` itself reads $LS_COLORS. If the user's shell never exports it (cron
+# launches, minimal login environments, some macOS setups) the listing
+# comes back colorless. Seed it from `dircolors -b` when available.
+if (ENV['LS_COLORS'].nil? || ENV['LS_COLORS'].empty?) && !`which dircolors 2>/dev/null`.strip.empty?
+  dc = `dircolors -b 2>/dev/null`
+  if (m = dc.match(/LS_COLORS='([^']*)'/))
+    ENV['LS_COLORS'] = m[1]
+  end
+end
+
 # ENCODING {{{1
 # encoding: utf-8
 
@@ -341,6 +353,20 @@ CONFIG_FILE   = File.join(RTFM_HOME, 'conf')
   RUBY DEBUG MODE
     @       = Enter Ruby mode to execute any Ruby command (ENTER to execute, ESC to escape)
 
+  SCRIPT EVALUATOR
+    $       = Run any shell command (any language) with RTFM context as env vars.
+              Output is shown in the right pane.
+                RTFM_SELECTED  Full path of selected item
+                RTFM_DIR       Current working directory
+                RTFM_TAGGED    Newline-separated tagged paths
+                RTFM_INDEX     Selected index (0-based)
+                RTFM_COUNT     Number of files in listing
+                RTFM_CONTEXT   JSON object with all of the above
+              Scripts can control RTFM via stderr directives, one per line:
+                cd:/path       Change to /path
+                select:NAME    Place cursor on NAME in current directory
+                status:MSG     Show MSG in the bottom pane
+
   COPYRIGHT: Geir Isene, 2025+. No rights reserved. See http://isene.com for more.
 HELPTEXT
 
@@ -1166,7 +1192,10 @@ KEYMAP = { # {{{2
   'e'       => :show_file_properties,
 
   # RUBY MODE {{{3
-  '@'       => :ruby_debug
+  '@'       => :ruby_debug,
+
+  # SCRIPT EVALUATOR {{{3
+  '$'       => :script_eval
 }
 
 # USER KEYS (override or extend KEYMAP) {{{2
@@ -5562,6 +5591,98 @@ def ruby_debug # {{{3
   @pB.full_refresh
 end
 
+# SCRIPT EVALUATOR {{{2
+# Run a shell command (any language) with RTFM context exposed as env vars.
+# stdout shows in the right pane. stderr is scanned for control directives:
+#   cd:/path        change current directory
+#   select:NAME     move cursor onto NAME in the (new) cwd
+#   status:MSG      show MSG in the bottom pane
+# Any other stderr line is appended to the right-pane output in red.
+def script_eval # {{{3
+  cmd = @pCmd.ask('$ ', '').to_s.strip
+  if cmd.empty?
+    @pB.clear; @pB.update = true
+    return
+  end
+
+  require 'json'
+  selected = @selected.to_s
+  tagged_paths = @tagged.dup
+  context = {
+    selected:  selected,
+    directory: Dir.pwd,
+    tagged:    tagged_paths,
+    index:     @index,
+    count:     (@files || []).size
+  }
+
+  env = {
+    'RTFM_SELECTED' => selected,
+    'RTFM_DIR'      => Dir.pwd,
+    'RTFM_TAGGED'   => tagged_paths.join("\n"),
+    'RTFM_INDEX'    => @index.to_s,
+    'RTFM_COUNT'    => (@files || []).size.to_s,
+    'RTFM_CONTEXT'  => context.to_json
+  }
+
+  begin
+    out, err, _status = Open3.capture3(env, 'sh', '-c', cmd)
+  rescue StandardError => e
+    @pB.say("script: #{e.class}: #{e.message}".fg(196))
+    return
+  end
+
+  # Process stderr line-by-line: directives consumed, other lines kept.
+  leftover_err = []
+  directive_msgs = []
+  err.each_line do |line|
+    l = line.chomp
+    case l
+    when /\Acd:(.+)\z/
+      target = File.expand_path($1.strip)
+      if File.directory?(target)
+        @directory[Dir.pwd] = @index
+        mark_latest
+        Dir.chdir(target)
+        directive_msgs << "cd: #{target}"
+      else
+        leftover_err << "cd: no such directory: #{target}"
+      end
+    when /\Aselect:(.+)\z/
+      name = $1.strip
+      # Applied after the upcoming render populates @files (handles both
+      # same-dir selection and post-cd selection in the new dir).
+      @startup_select = name
+      directive_msgs << "select: #{name}"
+    when /\Astatus:(.+)\z/
+      msg = $1.strip
+      @pB.say(msg.fg(156))
+      directive_msgs << "status: #{msg}"
+    else
+      leftover_err << l unless l.empty?
+    end
+  end
+
+  body = out.dup
+  body << "\n" << leftover_err.join("\n").fg(196) unless leftover_err.empty?
+
+  # Show directive trace as a subtle footer so the user can see what fired
+  unless directive_msgs.empty?
+    body << "\n\n" unless body.empty?
+    body << '── directives applied ──'.fg(238) << "\n"
+    body << directive_msgs.map { |m| "  #{m}" }.join("\n").fg(244)
+  end
+
+  clear_image
+  @pR.clear  # wipe leftover preview lines so short output doesn't sit atop them
+  text = body.empty? ? ' (no output)'.fg(244) : body
+  @pR.text = text
+  @pR.ix = 0
+  @pR.full_refresh
+  @pR.update = false
+  @pB.update = true
+end
+
 # GENERIC FUNCTIONS {{{1
 def get_cached_dirlist(dir, ls_options, ls_options_with_long = nil) # {{{2
   # Use ls_options_with_long for display, or fall back to ls_options
@@ -6508,11 +6629,18 @@ def get_interactive_program(file_path) # HELPER FOR OPEN_SELECTED TO USE @intera
         if desktop_path
           content = File.read(desktop_path)
           exec_line = content[/^Exec=(.*)$/m, 1]
+          # Honor Terminal=true in the .desktop file: any app declaring
+          # itself a terminal program is treated as interactive even if
+          # the user hasn't manually added it to @interactive. Lets newly
+          # installed TUI tools "just work" without editing config.
+          terminal_true = content =~ /^Terminal\s*=\s*true\b/i
           if exec_line
-            # Extract the program name (first word, remove path)
             prog = exec_line.split.first
             prog = File.basename(prog) if prog
-            return prog if prog && inter_list.include?(prog)
+            if prog
+              return prog if inter_list.include?(prog)
+              return prog if terminal_true
+            end
           end
         end
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rtfm-filemanager
 version: !ruby/object:Gem::Version
-  version: 8.5.0
+  version: 8.7.2
 platform: ruby
 authors:
 - Geir Isene