rtfm-filemanager 7.0.11 → 7.0.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e78200976a8e712b82378dae1bff8f113943a1cca12d74646300f1f11ee2fb6f
-  data.tar.gz: 0a99799ebac8608030e957b77e90a5863aef00a7c09b735f9c4d48635fb7defc
+  metadata.gz: 21434141f1b12b20834d27fc396872713be1d4539633c94a5013b037cef98103
+  data.tar.gz: 5178581ecd9e29b53fea3d6fb0d21038902d26f187964a8ce743e4ecf93e749a
 SHA512:
-  metadata.gz: 8515ae1d820ac5bf2c010a890e01ffc8175abc7e0836c8ebc5cb138ca9b2f5970e4f9f383df490175cdb7a76e6c119e4da8cdbe2c6177683aa26a4ccdde9b473
-  data.tar.gz: 78b78c1716929a3b8f7fc0050a17034b7b9a1046f425d3916a847df82e8f16f13b1470a5d6bbd93bc92e112851a557d8f1292500beae124ee8625fea33bcfbd5
+  metadata.gz: d624adeb145e7b8f0e4e14806bf5c27e633384d7d61bee2982598421dec576613a6c7d900e2a19012139575b91c39df181ce83497253eb49acd9863257c5b5e1
+  data.tar.gz: 433791a3f9ac5d71961dd65071a3e1f38b18251a06a4f0857783c90ee8a37a47995a5bf7c9b81f3c38c2e798733a0a98926d0f8d50105f2b4ab096689e896f82

data/README.md

@@ -574,6 +574,29 @@ def git_update
   @pB.full_refresh
 end
 ```
+If you're launching external terminal programs (like editors or TUI applications) from your custom keys, 
+make sure to set `@external_program_running = true` before launching and `false` after it returns. 
+This prevents RTFM from redrawing over your program when switching terminals:
+```ruby
+def custom_handler
+  if @selected&.end_with?('.ext')
+    @external_program_running = true  # Prevent SIGWINCH interference
+    system('stty sane < /dev/tty')
+    system('clear < /dev/tty > /dev/tty')
+    Cursor.show
+    system("my_program #{Shellwords.escape(@selected)}")
+    @external_program_running = false  # Re-enable SIGWINCH handling
+    # Restore terminal for RTFM
+    system('stty raw -echo isig < /dev/tty')
+    $stdin.raw!
+    $stdin.echo = false
+    Cursor.hide
+    Rcurses.clear_screen
+    refresh
+    render
+  end
+end
+```
 ***With this, you can mold RTFM to fit your needs better.***
 
 When writing plugins, there are a few variables you should know:
@@ -589,6 +612,7 @@ Variable  | Description
 @pAI      | Pane for interacting with (Open)AI
 @pRuby    | Ruby debug/command pane
 @selected | The selected item in the Left pane
+@external_program_running | Set to true when launching terminal programs to prevent SIGWINCH from redrawing RTFM
 
 Here are three importan hook-ins to use with your plugins:
 

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    = '7.0.11' # Fixed ESC behavior and GIF preview dimensions
+@version    = '7.0.12' # Fixed escape code residue in bottom pane during rapid key presses
 
 # SAVE & STORE TERMINAL {{{1
 ORIG_STTY = `stty -g`.chomp
@@ -494,6 +494,9 @@ end
 @last_focus_check = Time.now
 @focus_check_interval = 0.5  # Check focus every 500ms
 
+# Track when external programs are running to prevent SIGWINCH interference
+@external_program_running = false
+
 @bat = cmd?('bat') ? 'bat' : 'batcat'
 
 ## Set encoding for $stdin to utf-8 {{{2
@@ -2604,6 +2607,8 @@ def open_remote_shell # {{{3
     ssh_cmd = "ssh #{ssh_opts} #{ssh_target} -t 'cd #{Shellwords.escape(@remote_path)} 2>/dev/null || cd ~; exec bash -l'"
     
     # Use RTFM's interactive program pattern
+    # Set flag to prevent SIGWINCH from refreshing during SSH session
+    @external_program_running = true
     system("stty #{ORIG_STTY} < /dev/tty")
     system('clear < /dev/tty > /dev/tty')
     Cursor.show
@@ -2625,6 +2630,9 @@ def open_remote_shell # {{{3
     rescue Interrupt
       Process.kill('TERM', pid) rescue nil
       retry
+    ensure
+      # Clear flag when SSH session exits
+      @external_program_running = false
     end
     
     # Restore RTFM's terminal state
@@ -4177,6 +4185,8 @@ def command_mode # {{{3
     end
   end
   if force || whitelist || magic # Decide interactive vs non-interactive
+    # Set flag to prevent SIGWINCH from refreshing during interactive command
+    @external_program_running = true
     # Restore shell tty so Ctrl-C/D work
     system("stty #{ORIG_STTY} < /dev/tty")
     # Clear to top-left
@@ -4192,6 +4202,9 @@ def command_mode # {{{3
     rescue Interrupt
       Process.kill('TERM', pid2) rescue nil
       retry
+    ensure
+      # Clear flag when command exits
+      @external_program_running = false
     end
     # Restore raw/no-echo for RTFM
     system('stty raw -echo isig < /dev/tty')
@@ -4758,7 +4771,11 @@ def render # RENDER ALL PANES {{{2
     info = " Showing only file types '#{@lsfiles}'".fg(129).u if @lsfiles =~ /,/
     info += " and only files matching '#{@lsmatch}'".fg(129).u if @lsfiles != '' && @lsmatch != ''
     @pB.text = info
-    @pB.refresh unless @pB.text == bottomtext
+    # Ensure screen output is complete before continuing
+    if @pB.text != bottomtext
+      @pB.refresh
+      STDOUT.flush
+    end
   end
 end
 
@@ -5089,6 +5106,8 @@ def open_selected(html = nil) # OPEN SELECTED FILE {{{2
   if !html && (prog = get_interactive_program(@selected))
     cmd = "#{prog} #{Shellwords.escape(@selected)}"
     # Use exactly the same logic as command_mode with § prefix (force interactive)
+    # Set flag to prevent SIGWINCH from refreshing during external program
+    @external_program_running = true
     # Restore shell tty so Ctrl-C/D work
     system("stty #{ORIG_STTY} < /dev/tty")
     # Reset terminal to sane/cooked mode for interactive programs
@@ -5106,6 +5125,9 @@ def open_selected(html = nil) # OPEN SELECTED FILE {{{2
     rescue Interrupt
       Process.kill('TERM', pid) rescue nil
       retry
+    ensure
+      # Clear flag when program exits
+      @external_program_running = false
     end
     # Restore raw/no-echo for RTFM
     system('stty raw -echo isig < /dev/tty')
@@ -5134,6 +5156,8 @@ def open_selected(html = nil) # OPEN SELECTED FILE {{{2
   end
   # Don't try to read large files or PDFs as text for validation
   if !@selected&.match(@pdffile) && File.size(@selected) < 1_000_000 && File.read(@selected).force_encoding('UTF-8').valid_encoding? # Pure text
+    # Set flag to prevent SIGWINCH from refreshing during editor
+    @external_program_running = true
     # Save terminal state before launching editor
     system("stty -g < /dev/tty > /tmp/rtfm_stty_$$")
     # Reset terminal to sane/cooked mode for editor
@@ -5144,6 +5168,8 @@ def open_selected(html = nil) # OPEN SELECTED FILE {{{2
     # Launch editor
     editor = ENV.fetch('EDITOR', 'vi')
     system("#{editor} #{Shellwords.escape(@selected)}")
+    # Clear flag when editor exits
+    @external_program_running = false
     # Restore terminal state
     system("stty $(cat /tmp/rtfm_stty_$$) < /dev/tty")
     system("rm -f /tmp/rtfm_stty_$$")
@@ -5643,10 +5669,15 @@ setborder
 
 ## Catch change in terminal resize, redraw {{{2
 Signal.trap('WINCH') do 
-  @h, @w = IO.console.winsize
-  @pT.update = @pL.update = @pR.update = @pB.update = true
-  refresh
-  render
+  # Don't refresh/render if an external interactive program is running
+  # This prevents RTFM from painting over programs like HyperList when
+  # switching terminals in window managers like i3-wm
+  unless @external_program_running
+    @h, @w = IO.console.winsize
+    @pT.update = @pL.update = @pR.update = @pB.update = true
+    refresh
+    render
+  end
 end
 
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rtfm-filemanager
 version: !ruby/object:Gem::Version
-  version: 7.0.11
+  version: 7.0.13
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-26 00:00:00.000000000 Z
+date: 2025-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rcurses
@@ -53,7 +53,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '7.4'
 description: |-
-  RTFM v7.0.11: Fixed ESC key behavior to properly restore bottom pane after cancelling actions. Fixed animated GIF preview dimensions issue.
+  RTFM v7.0.13: Added @external_program_running flag for custom keys/plugins to prevent SIGWINCH interference when launching terminal programs.
    A full featured terminal browser with syntax highlighted files, images shown in the terminal, videos thumbnailed, etc. Features include remote SSH/SFTP browsing, interactive SSH shell, comprehensive undo system, bookmarks, and much more. You can bookmark and jump around easily, delete, rename, copy, symlink and move files. RTFM is one of the most feature-packed terminal file managers.
 email: g@isene.com
 executables: