curses-extension 1.1.3 → 1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ffbe7dfbe4c788a68bd7e66157e2a5fb2b74d9588c5cb5f07d038edd556ec381
-  data.tar.gz: 4d142698ed3853386841608e48d6e49dbd666d744d256d9e940fe9d72db61793
+  metadata.gz: a7498f40bb4872284aeb236f6a5d585e57ec07f221c932170b33a07c4dd356ae
+  data.tar.gz: b9cd6a36554a25fd3b8c2c7de39a48f74496b04700d017e90cfdc0c9833095d4
 SHA512:
-  metadata.gz: 54164528ffe50d738853d3f8e0d484a2ada715772ab8f48b0c439b71dcb8f828c6f4af8de8342d01e40cd0fcdf3ea52fb7d5eff7f5f1b1ec68cac89be40def19
-  data.tar.gz: d13c3062272b764ba9959cf8a8dbd0969e30741195524c1b6c6d3b75d506667e9af6a1a6ceed9996359fde1ba8eefbd5df8266f6e0a518b0bdf3890355740d65
+  metadata.gz: 5e6222c8fe2dd03a9746693722cafa3a3faf875c76cf1acdaaad62d7d4d7d4601e60d8c6dc134bdfbdcb52e06d074923b3243c614306b2e258aecdbd7f183221
+  data.tar.gz: 8afba7364535e4f10b1a670908c45c5d94ae1b6ee025aa3b1ebc0c8947e23ce34343745378f7d3136b828d70b886ea87f747623e918770598a41f37447810b55

data/lib/README.md

@@ -0,0 +1,31 @@
+# Ruby-Curses-Class-Extension
+Extending the Ruby Curses module with some obvious functionality
+
+## Attributes
+Attribute           | Description
+--------------------|--------------------------------------------------------
+color               | Set the window's color to an already initiated color pair (with `init_pair(index, forground, backround`)
+fg                  | Foreground color for window (0-255)
+bg                  | Background color for window (0-255)
+attr                | Attributes for window (such as Curses::A_BOLD) - string with "\|" (such as Curses::A_BOLD \| Curses::A_UNDERLINE)
+update				| Whether to update the window on the next refresh
+
+## Functions
+Function							| Description
+------------------------------------|--------------------------------------------------------
+clr									| Clears window without flicker (win.clear flickers)
+clr_to_cur_pos						| Clears the window up to the current line
+clr_from_cur_pos					| Clears the rest of the window after the current line
+fill								| Fill window with color as set by :color ( or :bg if not :color is set)
+fill_to_cur_pos						| Fill the window up to the current line
+fill_from_cur_pos					| Fill the rest of the window after the current line
+p(text)								| Write text to window with color or fg/bg and attributes (will handle the exceptions if no colors are set)
+pclr(text)							| As `p(text)` but also clears the rest of the window
+pa(fg, bg, attr, text)				| Write text to window with specified fg, bg and attribute(s)
+paclr(text)							| As `pa(text)` but also clears the rest of the window
+print(text, fg=255, bg=0, attr=0)	| Print text (from current position) with optional attributes
+puts(text, fg=255, bg=0, attr=0)	| Clears window and puts text with optional attributes
+format_text(text)					| Format text so that it linebreaks neatly inside window
+
+## Curses template
+The `curses_template.rb` includes the class extension and serves as the basis for my curses applications.

data/lib/curses-extension.rb

@@ -88,4 +88,18 @@ class Curses::Window # CLASS EXTENSION
     self.attron(color_pair(self.fg) | self.attr) { self << text }
     self.refresh
   end
+  def puts(text, fg=255, bg=0, attr=0) # Clears window and puts text with optional attributes
+    self.clr
+    self.refresh
+    self.setpos(0, 0)
+    self.print(text, fg, bg, attr)
+  end
+  def print(text, fg=255, bg=0, attr=0) # Print text (from current position) with optional attributes
+    init_pair(fg, fg, bg)
+    self.attron(color_pair(fg) | attr) { self << text }
+    self.refresh
+  end
+  def format_text(text) # Format text so that it linebreaks neatly inside window
+    return "\n" + text.gsub(/(.{1,#{self.maxx}})( +|$\n?)|(.{1,#{self.maxx}})/, "\\1\\3\n")
+  end
 end

data/lib/curses-template.rb

@@ -117,6 +117,20 @@ class Curses::Window # CLASS EXTENSION
     self.attron(color_pair(self.fg) | self.attr) { self << text }
     self.refresh
   end
+  def puts(text, fg=255, bg=0, attr=0) # Clears window and puts text with optional attributes
+    self.clr
+    self.refresh
+    self.setpos(0, 0)
+    self.print(text, fg, bg, attr)
+  end
+  def print(text, fg=255, bg=0, attr=0) # Print text (from current position) with optional attributes
+    init_pair(fg, fg, bg)
+    self.attron(color_pair(fg) | attr) { self << text }
+    self.refresh
+  end
+  def format_text(text) # Format text so that it linebreaks neatly inside window
+    return "\n" + text.gsub(/(.{1,#{self.maxx}})( +|$\n?)|(.{1,#{self.maxx}})/, "\\1\\3\n")
+  end
 end
 
 def getchr # PROCESS KEY PRESSES
@@ -131,12 +145,19 @@ def getchr # PROCESS KEY PRESSES
       when 'C' then chr = "RIGHT"
       when 'D' then chr = "LEFT"
       when 'Z' then chr = "S-TAB"
-      when '2' then chr = "INS"    ; STDIN.getc
-      when '3' then chr = "DEL"    ; STDIN.getc
-      when '5' then chr = "PgUP"   ; STDIN.getc
-      when '6' then chr = "PgDOWN" ; STDIN.getc
-      when '7' then chr = "HOME"   ; STDIN.getc
-      when '8' then chr = "END"    ; STDIN.getc
+      when '2' then chr = "INS"    ; chr = "C-INS"    if STDIN.getc == "^"
+      when '3' then chr = "DEL"    ; chr = "C-DEL"    if STDIN.getc == "^"
+      when '5' then chr = "PgUP"   ; chr = "C-PgUP"   if STDIN.getc == "^"
+      when '6' then chr = "PgDOWN" ; chr = "C-PgDOWN" if STDIN.getc == "^"
+      when '7' then chr = "HOME"   ; chr = "C-HOME"   if STDIN.getc == "^"
+      when '8' then chr = "END"    ; chr = "C-END"    if STDIN.getc == "^"
+      end
+    when 'O'
+      case $stdin.getc
+      when 'a' then chr = "C-UP"
+      when 'b' then chr = "C-DOWN"
+      when 'c' then chr = "C-RIGHT"
+      when 'd' then chr = "C-LEFT"
       end
     end
   when "", "" then chr = "BACK"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: curses-extension
 version: !ruby/object:Gem::Version
-  version: 1.1.3
+  version: '1.2'
 platform: ruby
 authors:
 - Geir Isene
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-19 00:00:00.000000000 Z
+date: 2023-01-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: curses
@@ -35,12 +35,14 @@ description: 'The Ruby curses library is sorely lacking some important features.
   terminal curses applications in Ruby. See the Github page for information on what
   properties and functions are included: https://github.com/isene/Ruby-Curses-Class-Extension.
   The curses_template.rb is also installed in the lib directory and serves as the
-  basis for my own curses applications. New in 1.1.3: Less resources needed for template.'
+  basis for my own curses applications. New in 1.2: Added functions `print`, `puts`and
+  `format`.'
 email: g@isene.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- lib/README.md
 - lib/curses-extension.rb
 - lib/curses-template.rb
 homepage: https://isene.com/
@@ -63,7 +65,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.3.5
 signing_key: 
 specification_version: 4
 summary: Extending the Ruby Curses module with some obvious functionality