rcurses 2.9 → 3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66ea9b80bc6e110518ce62e95aa6f021fdbde64a8ca639c7bb43b33856496372
-  data.tar.gz: 59a2371b4bad8b29ce338385d7d506426c1d02b4d84f56b4421d1ee4b56dc32d
+  metadata.gz: 706550c12ee9965c33b958c6ce4ec5cb0aa12fb37196b4dd623cea43b982528f
+  data.tar.gz: 17e20e12a50a34f2d36069041b3f1dfbedbf27ab7dddf8f3681fd8b289e6fe00
 SHA512:
-  metadata.gz: b04179f02c444db27c64ff66f090eda1a2d0176177a32f85c94e867903e1148af47972b50601d6e70e56d2830c5ba8470fc97ce3385963fd685c5c07fa00b155
-  data.tar.gz: 144a1941e04608a19def0450bc93e334d1577388eb798de4423e9720bf3435834786cce1045f3f25969490d5aec6b43010f8da1dca4c69aa1341ec32c827141f
+  metadata.gz: 68fe3d1c80b12fae7ad09b49efdec40a889bf36f6d269e68ab09971bf9f057874ac122cff4d1c08c9b0673e13e65857c98e9e888977138a1c51a385544520901
+  data.tar.gz: aa6d784ef29afbb0b5e09ada56b2caadf2b474e0bf909eaa92dc161f88d6d1e6c33424d3c1ed2c407148d9ce502bd5563bf1eb1118e3b2a7a15444df18494a89

data/README.md

@@ -69,6 +69,8 @@ text           | The text/content of the Pane
 ix             | "Index" - the line number at the top of the Pane, starts at 0, the first line of text in the Pane
 align          | Text alignment in the Pane: "l" = lefts aligned, "c" = center, "r" = right, with the default "l"
 prompt         | The prompt to print at the beginning of a one-liner Pane used as an input box
+moreup         | Set to true when there is more text above what is shown (top scroll bar i showing)
+moredown       | Set to true when there is more text below what is shown (bottom scroll bar i showing)
 
 The methods for Pane:
 
@@ -150,12 +152,16 @@ Key pressed     | string returned
 ----------------|----------------------------------------------------------
 `esc`           | "ESC"
 `up`            | "UP"
+`shift-up`      | "S-UP"
 `ctrl-up`       | "C-UP"
 `down`          | "DOWN"
+`shift-down`    | "S-DOWN"
 `ctrl-down`     | "C-DOWN"
 `right`         | "RIGHT"
+`shift-right`   | "S-RIGHT"
 `ctrl-right`    | "C-RIGHT"
 `left`          | "LEFT"
+`shifth-left`   | "S-LEFT"
 `ctrl-left`     | "C-LEFT"
 `shift-tab`     | "S-TAB"
 `insert`        | "INS"   

data/lib/rcurses/input.rb

@@ -21,9 +21,13 @@ module Rcurses
           third_char = $stdin.getc
           case third_char
           when 'A' then chr = "UP"
+          when 'a' then chr = "S-UP"
           when 'B' then chr = "DOWN"
+          when 'b' then chr = "S-DOWN"
           when 'C' then chr = "RIGHT"
+          when 'c' then chr = "S-RIGHT"
           when 'D' then chr = "LEFT"
+          when 'd' then chr = "S-LEFT"
           when 'Z' then chr = "S-TAB"
           when '1'
             fourth_char = $stdin.getc

data/lib/rcurses/pane.rb

@@ -5,6 +5,7 @@ module Rcurses
     include Input
     attr_accessor :x, :y, :w, :h, :fg, :bg
     attr_accessor :border, :scroll, :text, :ix, :align, :prompt
+    attr_accessor :moreup, :moredown
 
     def initialize(x = 1, y = 1, w = 1, h = 1, fg = nil, bg = nil)
       @x       = x
@@ -14,9 +15,9 @@ module Rcurses
       @fg, @bg = fg, bg
       @text    = ""              # Initialize text variable
       @align   = "l"             # Default alignment
-      @scroll  = true            # Initialize scroll indicators to true
-      @prompt  = ""              # Initialize prompt for editline
-      @ix      = 0               # Text index (starting text line in pane)
+      @scroll  = true            # Enable scroll indicators
+      @prompt  = ""              # Prompt for editline
+      @ix      = 0               # Starting text line index
       @max_h, @max_w = IO.console.winsize
     end
 
@@ -73,108 +74,12 @@ module Rcurses
       refresh
     end
 
+    # Optimized refresh using double buffering to minimize flicker.
     def refresh(cont = @text)
       @max_h, @max_w = IO.console.winsize
 
-      # Define the core of the ANSI escape sequence handling
-      def split_line_with_ansi(line, w)
-        # Define opening and closing sequences
-        open_sequences = {
-          "\e[1m" => "\e[22m",
-          "\e[3m" => "\e[23m",
-          "\e[4m" => "\e[24m",
-          "\e[5m" => "\e[25m",
-          "\e[7m" => "\e[27m" }
-        # All known closing sequences
-        close_sequences = open_sequences.values + ["\e[0m"]
-        # Regex to match ANSI escape sequences
-        ansi_regex = /\e\[[0-9;]*m/
-        result = []
-        # Tokenize the line into ANSI sequences and plain text
-        tokens = line.scan(/(\e\[[0-9;]*m|[^\e]+)/).flatten.compact
-        current_line = ''
-        current_line_length = 0
-        active_sequences = []
-        tokens.each do |token|
-          if token.match?(ansi_regex)
-            # It's an ANSI sequence
-            current_line << token
-            if close_sequences.include?(token)
-              # It's a closing sequence
-              if token == "\e[0m"
-                # Reset all sequences
-                active_sequences.clear
-              else
-                # Remove the corresponding opening sequence
-                corresponding_open = open_sequences.key(token)
-                active_sequences.delete(corresponding_open)
-              end
-            else
-              # It's an opening sequence (or any other ANSI sequence)
-              active_sequences << token
-            end
-          else
-            # It's plain text, split into words and spaces
-            words = token.scan(/\S+\s*/)
-            words.each do |word|
-              word_length = word.gsub(ansi_regex, '').length
-              if current_line_length + word_length <= w
-                # Append word to current line
-                current_line << word
-                current_line_length += word_length
-              else
-                # Word doesn't fit in the current line
-                if current_line_length > 0
-                  # Finish the current line and start a new one
-                  result << current_line
-                  # Start new line with active ANSI sequences
-                  current_line = active_sequences.join
-                  current_line_length = 0
-                end
-                # Handle long words that might need splitting
-                while word_length > w
-                  # Split the word
-                  part = word[0, w]
-                  current_line << part
-                  result << current_line
-                  # Update word and lengths
-                  word = word[w..-1]
-                  word_length = word.gsub(ansi_regex, '').length
-                  # Start new line
-                  current_line = active_sequences.join
-                  current_line_length = 0
-                end
-                # Append any remaining part of the word
-                if word_length > 0
-                  current_line << word
-                  current_line_length += word_length
-                end
-              end
-            end
-          end
-        end
-        # Append any remaining text in the current line
-        result << current_line unless current_line.empty?
-        result
-      end
-
-      # Define the main textformat function
-      def textformat(cont)
-        # Split the content by '\n'
-        lines = cont.split("\n")
-        result = []
-        lines.each do |line|
-          split_lines = split_line_with_ansi(line, @w)
-          result.concat(split_lines)
-        end
-        result
-      end
-
-      # Start the actual refresh
-      o_row, o_col = pos
-
-      # Adjust pane dimensions and positions
-      if @border # Keep panes inside screen
+      # Adjust pane dimensions (unchanged logic)
+      if @border
         @w = @max_w - 2 if @w > @max_w - 2
         @h = @max_h - 2 if @h > @max_h - 2
         @x = 2 if @x < 2; @x = @max_w - @w if @x + @w > @max_w
@@ -186,69 +91,81 @@ module Rcurses
         @y = 1 if @y < 1; @y = @max_h - @h + 1 if @y + @h > @max_h + 1
       end
 
-      col(@x); row(@y) # Cursor to start of pane
-      fmt = [@fg, @bg].compact.join(',') # Format for printing in pane (fg,bg)
-      @txt = cont.split("\n") # Split content into array
-      @txt = textformat(cont) if @txt.any? { |line| line.pure.length >= @w } # Reformat lines if necessary
-      @ix = @txt.length - 1 if @ix > @txt.length - 1; @ix = 0 if @ix < 0 # Ensure no out-of-bounds
+      # Save current cursor position.
+      o_row, o_col = pos
+
+      # Hide cursor and switch to alternate screen buffer (if desired). Hide it any case and use Curses.show to bring it back.
+      # Note: The alternate screen buffer means your program’s output won’t mix with the normal terminal content.
+      STDOUT.print "\e[?25l"  # hide cursor
+      # Uncomment the next line to use the alternate screen buffer.
+      #STDOUT.print "\e[?1049h"
+
+      buf = ""
+      buf << "\e[#{@y};#{@x}H"  # Move cursor to start of pane.
+      fmt = [@fg, @bg].compact.join(',')
+      @txt = cont.split("\n")
+      @txt = textformat(cont) if @txt.any? { |line| line.pure.length >= @w }
+      @ix = @txt.length - 1 if @ix > @txt.length - 1
+      @ix = 0 if @ix < 0
 
-      @h.times do |i| # Print pane content
-        l = @ix + i # The current line to be printed
-        if @txt[l].to_s != "" # Print the text line
-          # Get padding width and half width
+      @h.times do |i|
+        l = @ix + i
+        if @txt[l].to_s != ""
           pl = @w - @txt[l].pure.length
           pl = 0 if pl < 0
           hl = pl / 2
           case @align
           when "l"
-            print @txt[l].c(fmt) + " ".c(fmt) * pl
+            buf << @txt[l].c(fmt) << " ".c(fmt) * pl
           when "r"
-            print " ".c(fmt) * pl + @txt[l].c(fmt)
+            buf << " ".c(fmt) * pl << @txt[l].c(fmt)
           when "c"
-            print " ".c(fmt) * hl + @txt[l].c(fmt) + " ".c(fmt) * (pl - hl)
+            buf << " ".c(fmt) * hl << @txt[l].c(fmt) << " ".c(fmt) * (pl - hl)
           end
         else
-          print " ".c(fmt) * @w
+          buf << " ".c(fmt) * @w
         end
-        col(@x) # Cursor to start of pane
-        row(@y + i + 1)
+        buf << "\e[#{@y + i + 1};#{@x}H"  # Next line.
       end
 
-      if @ix > 0 and @scroll # Print "more" marker at top
-        col(@x + @w - 1); row(@y)
-        print "▲".c(fmt)
+      # Draw scroll markers.
+      if @ix > 0 and @scroll
+        buf << "\e[#{@y};#{@x + @w - 1}H" << "∆".c(fmt)
+        @moreup = true
+      else
+        @moreup = false
       end
 
-      if @txt.length - @ix > @h and @scroll # Print bottom "more" marker
-        col(@x + @w - 1); row(@y + @h - 1)
-        print "▼".c(fmt)
+      if @txt.length - @ix > @h and @scroll
+        buf << "\e[#{@y + @h - 1};#{@x + @w - 1}H" << "∇".c(fmt)
+        @moredown = true
+      else
+        @moredown = false
       end
 
-      if @border # Print border if @border is set to true
-        row(@y - 1); col(@x - 1)
-        print ("┌" + "─" * @w + "┐").c(fmt)
+      # Draw border if enabled.
+      if @border
+        buf << "\e[#{@y - 1};#{@x - 1}H" << ("┌" + "─" * @w + "┐").c(fmt)
         @h.times do |i|
-          row(@y + i); col(@x - 1)
-          print "│".c(fmt)
-          col(@x + @w)
-          print "│".c(fmt)
+          buf << "\e[#{@y + i};#{@x - 1}H" << "│".c(fmt)
+          buf << "\e[#{@y + i};#{@x + @w}H" << "│".c(fmt)
         end
-        row(@y + @h); col(@x - 1)
-        print ("└" + "─" * @w + "┘").c(fmt)
+        buf << "\e[#{@y + @h};#{@x - 1}H" << ("└" + "─" * @w + "┘").c(fmt)
       end
 
-      row(o_row)
-      col(o_col)
+      # Restore original cursor position.
+      buf << "\e[#{o_row};#{o_col}H"
+
+      # Print the whole buffer at once.
+      print buf
+
+      # Uncomment the next line to switched to the alternate screen buffer.
+      #STDOUT.print "\e[?1049l"
+
       @txt
     end
 
-    def puts(txt)
-      @text = txt
-      refresh
-    end
-    
     def textformat(cont)
-      # Split the content by '\n'
       lines = cont.split("\n")
       result = []
       lines.each do |line|
@@ -258,6 +175,11 @@ module Rcurses
       result
     end
 
+    def puts(txt)
+      @text = txt
+      refresh
+    end
+
     def right
       if @pos < @txt[@ix + @line].length
         @pos += 1
@@ -279,6 +201,7 @@ module Rcurses
         end
       end
     end
+
     def left
       if @pos == 0
         if @line == 0
@@ -294,6 +217,7 @@ module Rcurses
         @pos -= 1
       end
     end
+
     def up
       if @line == 0
         @ix -= 1 unless @ix == 0
@@ -305,6 +229,7 @@ module Rcurses
       rescue
       end
     end
+
     def down
       if @line == @h - 1
         @ix += 1 unless @ix + @line >= @txt.length - 1
@@ -318,10 +243,10 @@ module Rcurses
     end
 
     def parse(cont)
-      cont.gsub!(/\*(.+?)\*/,           '\1'.b)
-      cont.gsub!(/\/(.+?)\//,           '\1'.i)
-      cont.gsub!(/_(.+?)_/,             '\1'.u)
-      cont.gsub!(/#(.+?)#/,             '\1'.r)
+      cont.gsub!(/\*(.+?)\*/, '\1'.b)
+      cont.gsub!(/\/(.+?)\//, '\1'.i)
+      cont.gsub!(/_(.+?)_/, '\1'.u)
+      cont.gsub!(/#(.+?)#/, '\1'.r)
       cont.gsub!(/<([^|]+)\|([^>]+)>/) do
         text = $2; codes = $1
         text.c(codes)
@@ -331,92 +256,85 @@ module Rcurses
 
     def edit
       begin
-        # Switch to raw mode without echoing input
         STDIN.raw!
         Rcurses::Cursor.show
-        # Prepare content for editing, replacing newlines with a placeholder
         content = @text.pure.gsub("\n", "¬\n")
-        # Initialize cursor position and indices
-        @ix        = 0   # Starting index of text lines displayed in the pane
-        @line      = 0   # Current line number relative to the pane's visible area
-        @pos       = 0   # Position within the current line (character index)
-        @txt       = refresh(content)
+        @ix    = 0
+        @line  = 0
+        @pos   = 0
+        @txt   = refresh(content)
         input_char = ''
 
-        while input_char != 'ESC'  # Continue until ESC is pressed
-          row(@y + @line)          # Move cursor to the correct row
-          col(@x + @pos)           # Move cursor to the correct column
-
-          input_char = getchr      # Read user input
+        while input_char != 'ESC'
+          row(@y + @line)
+          col(@x + @pos)
+          input_char = getchr
           case input_char
-          when 'C-L'    # Left justify
+          when 'C-L'
             @align = 'l'
-          when 'C-R'    # Right justify
+          when 'C-R'
             @align = 'r'
-          when 'C-C'    # Center justify
+          when 'C-C'
             @align = 'c'
-          when 'C-Y'    # Copy pane content to clipboard
+          when 'C-Y'
             Clipboard.copy(@text.pure)
-          when 'C-S'    # Save edited text back to @text and exit
+          when 'C-S'
             content = content.gsub('¬', "\n")
             content = parse(content)
             @text = content
             input_char = 'ESC'
-          when 'DEL'    # Delete character at current position
+          when 'DEL'
             posx = calculate_posx
             content.slice!(posx)
-          when 'BACK'   # Backspace (delete character before current position)
+          when 'BACK'
             if @pos > 0
               left
               posx = calculate_posx
               content.slice!(posx)
             end
-          when 'WBACK'  # Word backspace
+          when 'WBACK'
             while @pos > 0 && content[calculate_posx - 1] != ' '
               left
               posx = calculate_posx
               content.slice!(posx)
             end
-          when 'C-K'    # Kill line (delete from cursor to end of line)
+          when 'C-K'
             line_start_pos = calculate_line_start_pos
             line_length = @txt[@ix + @line]&.length || 0
             content.slice!(line_start_pos + @pos, line_length - @pos)
-          when 'UP'     # Move cursor up one line
+          when 'UP'
             up
-          when 'DOWN'   # Move cursor down one line
+          when 'DOWN'
             down
-          when 'RIGHT'  # Move cursor right one character
+          when 'RIGHT'
             right
-          when 'LEFT'   # Move cursor left one character
+          when 'LEFT'
             left
-          when 'HOME'   # Move to start of line
+          when 'HOME'
             @pos = 0
-          when 'END'    # Move to end of line
+          when 'END'
             current_line_length = @txt[@ix + @line]&.length || 0
             @pos = current_line_length
-          when 'C-HOME' # Move to start of pane
+          when 'C-HOME'
             @ix = 0
             @line = 0
             @pos = 0
-          when 'C-END'  # Move to end of pane
+          when 'C-END'
             total_lines = @txt.length
             @ix = [total_lines - @h, 0].max
             @line = [@h - 1, total_lines - @ix - 1].min
             current_line_length = @txt[@ix + @line]&.length || 0
             @pos = current_line_length
-          when 'ENTER'  # Insert newline at current position
+          when 'ENTER'
             posx = calculate_posx
             content.insert(posx, "¬\n")
             right
-          when /^.$/    # Insert character at current position
+          when /^.$/
             posx = calculate_posx
             content.insert(posx, input_char)
             right
-          else
-            # Handle unrecognized input if necessary
           end
 
-          # Handle pasted input (additional characters in the buffer)
           while IO.select([$stdin], nil, nil, 0)
             input_char = $stdin.read_nonblock(1) rescue nil
             break unless input_char
@@ -425,10 +343,9 @@ module Rcurses
             right
           end
 
-          @txt = refresh(content)  # Refresh the pane with the current content
+          @txt = refresh(content)
         end
       ensure
-        # Restore terminal mode
         STDIN.cooked!
       end
       Rcurses::Cursor.hide
@@ -436,36 +353,28 @@ module Rcurses
 
     def editline
       begin
-        # Switch to raw mode without echo
         STDIN.raw!
         Rcurses::Cursor.show
-
-        # Initialize position and dimensions
-        # Ensure pane is within screen bounds
         @x = [[@x, 1].max, @max_w - @w + 1].min
         @y = [[@y, 1].max, @max_h - @h + 1].min
-
         @scroll = false
-        @ix     = 0
+        @ix = 0
         row(@y)
-
         fmt = [@fg, @bg].compact.join(',')
         col(@x)
-        print @prompt.c(fmt)  # Print prompt at the pane's starting position
-
+        print @prompt.c(fmt)
         prompt_len = @prompt.pure.length
         content_len = @w - prompt_len
         cont = @text.pure.slice(0, content_len)
-        @pos = cont.length  # Set initial cursor position at the end of content
+        @pos = cont.length
         chr = ''
 
-        while chr != 'ESC'  # Continue until ESC is pressed
-          col(@x + prompt_len)  # Set cursor at start of content
-          cont = cont.slice(0, content_len)  # Trim content to max length
-          print cont.ljust(content_len).c(fmt)  # Print content, left-justified
-          col(@x + prompt_len + @pos)  # Set cursor to current position
-
-          chr = getchr  # Read user input
+        while chr != 'ESC'
+          col(@x + prompt_len)
+          cont = cont.slice(0, content_len)
+          print cont.ljust(content_len).c(fmt)
+          col(@x + prompt_len + @pos)
+          chr = getchr
           case chr
           when 'LEFT'
             @pos -= 1 if @pos > 0
@@ -500,7 +409,6 @@ module Rcurses
             end
           end
 
-          # Handle pasted input
           while IO.select([$stdin], nil, nil, 0)
             chr = $stdin.read_nonblock(1) rescue nil
             break unless chr
@@ -511,7 +419,6 @@ module Rcurses
           end
         end
       ensure
-        # Restore terminal mode
         STDIN.cooked!
       end
       Rcurses::Cursor.hide
@@ -519,23 +426,94 @@ module Rcurses
 
     private
 
-    # Calculates the position in the content string corresponding to the current cursor position
+    def flush_stdin
+      while IO.select([$stdin], nil, nil, 0.005)
+        begin
+          $stdin.read_nonblock(1024)
+        rescue IO::WaitReadable, EOFError
+          break
+        end
+      end
+    end
+
     def calculate_posx
       total_length = 0
       (@ix + @line).times do |i|
-        total_length += @txt[i].pure.length + 1  # +1 for the newline character
+        total_length += @txt[i].pure.length + 1  # +1 for the newline
       end
       total_length += @pos
       total_length
     end
-    # Calculates the starting position of the current line in the content string
+
     def calculate_line_start_pos
       total_length = 0
       (@ix + @line).times do |i|
-        total_length += @txt[i].pure.length + 1  # +1 for the newline character
+        total_length += @txt[i].pure.length + 1
       end
       total_length
     end
+
+    def split_line_with_ansi(line, w)
+      open_sequences = {
+        "\e[1m" => "\e[22m",
+        "\e[3m" => "\e[23m",
+        "\e[4m" => "\e[24m",
+        "\e[5m" => "\e[25m",
+        "\e[7m" => "\e[27m"
+      }
+      close_sequences = open_sequences.values + ["\e[0m"]
+      ansi_regex = /\e\[[0-9;]*m/
+      result = []
+      tokens = line.scan(/(\e\[[0-9;]*m|[^\e]+)/).flatten.compact
+      current_line = ''
+      current_line_length = 0
+      active_sequences = []
+      tokens.each do |token|
+        if token.match?(ansi_regex)
+          current_line << token
+          if close_sequences.include?(token)
+            if token == "\e[0m"
+              active_sequences.clear
+            else
+              corresponding_open = open_sequences.key(token)
+              active_sequences.delete(corresponding_open)
+            end
+          else
+            active_sequences << token
+          end
+        else
+          words = token.scan(/\s+|\S+/)
+          words.each do |word|
+            word_length = word.gsub(ansi_regex, '').length
+            if current_line_length + word_length <= w
+              current_line << word
+              current_line_length += word_length
+            else
+              if current_line_length > 0
+                result << current_line
+                current_line = active_sequences.join
+                current_line_length = 0
+              end
+              while word_length > w
+                part = word[0, w]
+                current_line << part
+                result << current_line
+                word = word[w..-1]
+                word_length = word.gsub(ansi_regex, '').length
+                current_line = active_sequences.join
+                current_line_length = 0
+              end
+              if word_length > 0
+                current_line << word
+                current_line_length += word_length
+              end
+            end
+          end
+        end
+      end
+      result << current_line unless current_line.empty?
+      result
+    end
   end
 end
 

data/lib/rcurses.rb

@@ -5,7 +5,7 @@
 # Web_site:   http://isene.com/
 # Github:     https://github.com/isene/rcurses
 # License:    Public domain
-# Version:    2.9: Added Rcurses.clear_screen
+# Version:    3.0: Flicker reduction by double screen buffer
 
 require 'io/console' # Basic gem for rcurses
 require 'io/wait'    # stdin handling

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rcurses
 version: !ruby/object:Gem::Version
-  version: '2.9'
+  version: '3.0'
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-28 00:00:00.000000000 Z
+date: 2025-04-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: clipboard
@@ -29,7 +29,8 @@ description: 'Create curses applications for the terminal easier than ever. Crea
   up text (in panes or anywhere in the terminal) in bold, italic, underline, reverse
   color, blink and in any 256 terminal colors for foreground and background. Use a
   simple editor to let users edit text in panes. Left, right or center align text
-  in panes. Cursor movement around the terminal. New in 2.9: Added Rcurses.clear_screen.'
+  in panes. Cursor movement around the terminal. New in 3.0: Flicker reduction by
+  double screen buffer.'
 email: g@isene.com
 executables: []
 extensions: []