termcontroller 0.3 → 0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 137ab6e058cbc71d9ac66d57479fcb01a9ab87fb403c795c553c880498c21410
-  data.tar.gz: b51e7f7353b269fc8e0375d858e9c0ee8605ea0e340b1c4f000ec4557e6ac281
+  metadata.gz: 04632d599e81a07a9dcda4090091356de0fe257b01342d31719937fd366ccf8f
+  data.tar.gz: 8f411109feb2e00122c80bb7be2978a19e4e1af94f131b66ff6a25476fd1eb99
 SHA512:
-  metadata.gz: 4a1d7893783340263e8d92ed7503ef239b77407e4466305f2fbbb1700b73108bb34d23eb34f8fcb3f8680bf5ac40f191cce9eba7ff8d3188d4213c0885c04d16
-  data.tar.gz: a6270a9cb7c27ee6744540013e6abc599851f846cc5b8b1a76bc08f34a4bc1784cf60ef89e999e588d653afa38f3e407f3d12c9ae4bfddf61e01529e8d5638ce
+  metadata.gz: 8b693ada8e7fab935972a7ad40944eac7da728f5292f81b7217c94839dd0ff06896f909ca13ed0dddc630258020d7fa0ed3c9e4eba36efe430b679a962526b68
+  data.tar.gz: 5b189f18f46ed86916cef9fedbc7b70766c3fe3d4d229c22c4f704c1b37e05610b2ed8396b324218ed865ba0f8a23ddb34b178a2eba1f80aa61728f06ac7a27f

data/Gemfile

@@ -3,6 +3,6 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in termcontroller.gemspec
 gemspec
 
-gem "keyboard_map" #, path: "../keyboard_map"
+gem "keyboard_map"
 gem "rake", "~> 12.0"
 gem "rspec", "~> 3.0"

data/examples/draw.rb

@@ -0,0 +1,57 @@
+
+$: << File.expand_path(File.dirname(__FILE__)+"/../lib/")
+
+require 'termcontroller'
+
+class Target
+
+  def initialize
+    keymap = { :ctrl_c => :quit }
+    @ctrl = Termcontroller::Controller.new(self, keymap)
+    @c = " "
+    @col = 1
+  end
+
+  # If a method exists in the target class passed to Controller.new
+  # that matches the keymap, then it is called directly.
+  #
+  # In this case `quit` is defined in the map above,
+  # while `char` is a default.
+  #
+  # If nothing is mapped, then `handle_input` will return the
+  # symbol instead, as shown for `mouse_down`.
+  #
+  def quit    = (@running = false)
+  def char(c) = (@c = c)
+
+  def call
+    @running = true
+    col = 1
+    while @running
+      cmd = @ctrl.handle_input
+      case cmd.first
+      when :mouse_down
+        print "\e[5;1H#{cmd.inspect}"
+        print "\e[#{cmd[3]};#{cmd[2]}H"
+        if cmd[1] & 3 == 0
+          # left
+          print "\e[4#{col}m#{@c}\e[49m"
+          print "\e[1;1H[DRAWING] "
+        elsif cmd[1] & 3 == 2
+          # right
+          print " "
+          print "\e[1;1H[ERASING] "
+        end
+      end
+    end
+  end
+end
+
+
+print "\e[2J"   # Clear screen
+print "\e[4;1HHold left button and move mouse to draw; Hold right button and move to clear"
+print "\e[3;1HPress any letter to set a character to fill with on draw."
+print "\e[2;1HCtrl+c to quit"
+Target.new.call
+print "\e[2J"   # Clear screen
+print "\e[1;1H" # Move top left

data/lib/termcontroller/controller.rb

@@ -93,11 +93,11 @@ module Termcontroller
           IO.console.cooked!
           cleanup
           r = yield
-          setup
           r
         rescue Interrupt
         ensure
           @mode = old
+          setup
         end
       end
     end
@@ -123,6 +123,16 @@ module Termcontroller
       return Array(c)
     end
 
+    # USE WITH CAUTION. This will pause processing,
+    # yield to the provided block if any, and then send
+    # SIGSTOP to the process.
+    #
+    # This is meant to allow for handling ctrl-z to
+    # suspend in processes that need to be able to
+    # reset the terminal to a better state before stopping.
+    #
+    # FIXME: It seems like it does not work as expected.
+    #
     def suspend
       pause do
         yield if block_given?
@@ -136,6 +146,14 @@ module Termcontroller
       @commands << [:resume]
     end
 
+    def hide_cursor
+      STDOUT.print "\e[?25l"   # Hide cursor
+    end
+
+    def show_cursor
+      STDOUT.print "\e[?25h"   # Show cursor
+    end
+
     private # # ########################################################
 
     def setup
@@ -143,7 +161,7 @@ module Termcontroller
       STDOUT.print "\e[?1000h" # Enable mouse reporting
       STDOUT.print "\e[?1002h" # Enable mouse *move when clicked* reporting
       STDOUT.print "\e[?1006h" # Enable extended reporting
-      STDOUT.print "\e[?25l"   # Hide cursor
+      hide_cursor
       @con.raw!
     end
 
@@ -156,7 +174,7 @@ module Termcontroller
       @con.cooked!
       STDOUT.print "\e[?2004l" #Disable bracketed paste
       STDOUT.print "\e[?1000l" #Disable mouse reporting
-      STDOUT.print "\e[?25h"   # Show cursor
+      show_cursor
     end
 
     def quit

data/lib/termcontroller/version.rb

@@ -1,3 +1,3 @@
 module Termcontroller
-  VERSION = "0.3"
+  VERSION = "0.5"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: termcontroller
 version: !ruby/object:Gem::Version
-  version: '0.3'
+  version: '0.5'
 platform: ruby
 authors:
 - Vidar Hokstad
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-08-02 00:00:00.000000000 Z
+date: 2025-06-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: keyboard_map
@@ -40,6 +40,7 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- examples/draw.rb
 - lib/termcontroller.rb
 - lib/termcontroller/controller.rb
 - lib/termcontroller/version.rb
@@ -64,7 +65,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.4.10
 signing_key: 
 specification_version: 4
 summary: Controller/input processing for terminal applications