rcurses 2.4 → 2.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c6b5f0fbbc0c9c981c1e4d23197008f4a5ea00cff36492938328fe30c52804af
-  data.tar.gz: d4ee9ba0743c045168d0528534f5cc3f5571b3e968948d8553afdb768aebb1c3
+  metadata.gz: '0242225387152024f958dd6d49e9671626e07589c514910258f8bb092c73eb90'
+  data.tar.gz: b745692855fcdd6fae65b1fd82126e006737d2923eaf1d4b4cdcea8c19f98734
 SHA512:
-  metadata.gz: 53b164b30ccb430b541a6880c51d298c8ddaa38b7d5b97b1714c53ca0c5e100caa1883c1caec210816f03704ff3d1b59715c317bd015c480c83e49227a91e7ed
-  data.tar.gz: 89ecd3c6021dcfd70bf390723de8a7d75210a85b5e73077dfb7f0167f3faad9c68e422b25ef4ed564fa4fd3341d32ac6c90e70132910e025e278f82ec3b892ec
+  metadata.gz: 9bf0a7aac4eeaf767aea8d3f3ec3f529cf633184cb9b771b124dcb9236fcbf9ec6cb458db301e870539c79c3bfba80cd4bb9d5eb8f343265d858d0896ed73c5a
+  data.tar.gz: 4f792ed8261eea7b65cc17b95333ccc940843cdb77734f840fdbda3b45e8e671ab221c87e38dd6e38c83bcf6cb9d34674815f13843d998a340f5e100cb7acad4

data/README.md

@@ -114,14 +114,15 @@ restore           | Restore cursor position
 pos               | Query cursor current position (example: `row,col = mycursor.pos`)
 colget            | Query cursor current cursor col/x position (example: `row = mycursor.rowget`)
 rowget            | Query cursor current cursor row/y position (example: `row = mycursor.rowget`)         
+set(c = 1, r = 1) | Set the position of the cursor to row/y,col/x (example: `mycursor.set(row,col)`) (default = top row, first column)
+col(c = 1)        | Cursor moves to the nth position horizontally in the current line (default = first column)
+row(r = 1)        | Cursor moves to the nth position vertically in the current column (default = first/top row)
 up(n = 1)         | Move cursor up by n (default is 1 character up)
 down(n = 1)       | Move cursor down by n (default is 1 character down)
 left(n = 1)       | Move cursor backward by n (default is one character)
 right(n = 1)      | Move cursor forward by n (default is one character)
-col(n = 1)        | Cursor moves to the nth position horizontally in the current line (default = first column)
-row(n = 1)        | Cursor moves to the nth position vertically in the current column (default = first/top row)
-next_line)        | Move cursor down to beginning of next line
-prev_line)        | Move cursor up to beginning of previous line
+next_line         | Move cursor down to beginning of next line
+prev_line         | Move cursor up to beginning of previous line
 clear_char(n = 1) | Erase n characters from the current cursor position (default is one character)
 clear_line        | Erase the entire current line and return to beginning of the line
 clear_line_before | Erase from the beginning of the line up to and including the current cursor position
@@ -201,6 +202,8 @@ while $stdin.ready?
   chr += $stdin.getc
 end
 ```
+You can also pass two parameters to `getchr` with `getchr(min, time)` where `min` instructs getchr to wait for the minimum number of characters to return (not very useful) - and `time` is the timeout for waiting (can be very useful). You can happily call `getchr` without these parameters.
+
 
 # Example
 

data/lib/rcurses/cursor.rb

@@ -26,22 +26,23 @@ module Rcurses
       _row, col = pos
       col
     end
-    def up(n = 1);         print(CSI + "#{(n)}A");         end # Move cursor up by n
-    def down(n = 1);       print(CSI + "#{(n)}B");         end # Move the cursor down by n
-    def left(n = 1);       print(CSI + "#{n}D");           end # Move the cursor backward by n
-    def right(n = 1);      print(CSI + "#{n}C");           end # Move the cursor forward by n
-    def col(n = 1);        print(CSI + "#{n}G");           end # Cursor moves to nth position horizontally in the current line
-    def row(n = 1);        print(CSI + "#{n}d");           end # Cursor moves to the nth position vertically in the current column
-    def next_line;         print(CSI + 'E' + CSI + "1G");  end # Move cursor down to beginning of next line
-    def prev_line;         print(CSI + 'A' + CSI + "1G");  end # Move cursor up to beginning of previous line
-    def clear_char(n = 1); print(CSI + "#{n}X");           end # Erase n characters from the current cursor position
-    def clear_line;        print(CSI + '2K' + CSI + "1G"); end # Erase the entire current line and return to beginning of the line
-    def clear_line_before; print(CSI + '1K');              end # Erase from the beginning of the line up to and including the current cursor position.
-    def clear_line_after;  print(CSI + '0K');              end # Erase from the current position (inclusive) to the end of the line
-    def clear_screen_down; print(CSI + 'J');               end # Clear screen down from current row
-    def scroll_up;         print(ESC + 'M');               end # Scroll display up one line
-    def scroll_down;       print(ESC + 'D');               end # Scroll display down one line
-    def hide;              print(CSI + '?25l');            end # Scroll display down one line
-    def show;              print(CSI + '?25h');            end # Scroll display down one line
+    def set(r = 1, c = 1); print(CSI + "#{r}d"); print(CSI + "#{c}G");  end # Set cursor position to Row, Col (y,x)
+    def up(n = 1);         print(CSI + "#{(n)}A");                      end # Move cursor up by n
+    def down(n = 1);       print(CSI + "#{(n)}B");                      end # Move the cursor down by n
+    def left(n = 1);       print(CSI + "#{n}D");                        end # Move the cursor backward by n
+    def right(n = 1);      print(CSI + "#{n}C");                        end # Move the cursor forward by n
+    def col(c = 1);        print(CSI + "#{c}G");                        end # Cursor moves to nth position horizontally in the current line
+    def row(r = 1);        print(CSI + "#{r}d");                        end # Cursor moves to the nth position vertically in the current column
+    def next_line;         print(CSI + 'E' + CSI + "1G");               end # Move cursor down to beginning of next line
+    def prev_line;         print(CSI + 'A' + CSI + "1G");               end # Move cursor up to beginning of previous line
+    def clear_char(n = 1); print(CSI + "#{n}X");                        end # Erase n characters from the current cursor position
+    def clear_line;        print(CSI + '2K' + CSI + "1G");              end # Erase the entire current line and return to beginning of the line
+    def clear_line_before; print(CSI + '1K');                           end # Erase from the beginning of the line up to and including the current cursor position.
+    def clear_line_after;  print(CSI + '0K');                           end # Erase from the current position (inclusive) to the end of the line
+    def clear_screen_down; print(CSI + 'J');                            end # Clear screen down from current row
+    def scroll_up;         print(ESC + 'M');                            end # Scroll display up one line
+    def scroll_down;       print(ESC + 'D');                            end # Scroll display down one line
+    def hide;              print(CSI + '?25l');                         end # Scroll display down one line
+    def show;              print(CSI + '?25h');                         end # Scroll display down one line
   end
 end

data/lib/rcurses/input.rb

@@ -1,8 +1,8 @@
 module Rcurses
   module Input
-    def getchr
+    def getchr(m = nil, t = nil)
       # Function to process key presses
-      c = $stdin.getch
+      c = $stdin.getch(min: m, time: t)
       case c
       when "\e"    # ANSI escape sequences
         return "ESC" if !$stdin.ready?
@@ -58,6 +58,8 @@ module Rcurses
       when "\u0005" then chr = "C-E"
       when "\u0006" then chr = "C-F"
       when "\u0007" then chr = "C-G"
+      when "\u0008" then chr = "C-H"
+      when "\u000A" then chr = "C-J"
       when "\u000B" then chr = "C-K"
       when "\u000C" then chr = "C-L"
       when "\u000D" then chr = "C-M"
@@ -66,6 +68,7 @@ module Rcurses
       when "\u0010" then chr = "C-P"
       when "\u0011" then chr = "C-Q"
       when "\u0012" then chr = "C-R"
+      when "\u0013" then chr = "C-S"
       when "\u0014" then chr = "C-T"
       when "\u0015" then chr = "C-U"
       when "\u0016" then chr = "C-V"
@@ -73,7 +76,6 @@ module Rcurses
       when "\u0019" then chr = "C-Y"
       when "\u001A" then chr = "C-Z"
       when "\u0017" then chr = "WBACK"
-      when "\u0013" then chr = "C-S"
       when /[[:print:]]/ then chr = c
       else chr = ""
       end

data/lib/rcurses/pane.rb

@@ -201,6 +201,11 @@ module Rcurses
       @txt
     end
 
+    def puts(txt)
+      @text = txt
+      refresh
+    end
+    
     def textformat(cont)
       # Split the content by '\n'
       lines = cont.split("\n")

data/lib/rcurses.rb

@@ -5,7 +5,7 @@
 # Web_site:   http://isene.com/
 # Github:     https://github.com/isene/rcurses
 # License:    Public domain
-# Version:    2.4: Show cursor on edit. Changed hide_cursor and show_cursor to hide and show.
+# Version:    2.4.2: Added parameters 'min' and 'time' to getchr
 
 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.4'
+  version: 2.4.2
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-07 00:00:00.000000000 Z
+date: 2025-03-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: clipboard
@@ -29,8 +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.4: Show cursor on edit.
-  Changed hide_cursor and show_cursor to hide and show.'
+  in panes. Cursor movement around the terminal. New in 2.4.2: Added parameters ''min''
+  and ''time'' to getchr'
 email: g@isene.com
 executables: []
 extensions: []