tui-td 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: be8d93991312317febcad6a713d4dd58e6e670e620211bae0adc0db0bdd21da1
-  data.tar.gz: 5618bc612addd9be3c634ebd4009800ddd6f7da9396ad5d950c8f831727398f8
+  metadata.gz: b8ebaa8989019a8cd573f682a538ca76a21a17daee810f29a1f178f8f35f0008
+  data.tar.gz: 52fecfc7d59143648f450e71612ac7b7b6839e1b697d03056cb80e0a0dd067ac
 SHA512:
-  metadata.gz: ea0199d84e4f2a038141178e6b0adc539c1547184d99b13ee270e971e7076e37d079f315b6d6fde4b880231a032f8463677ebc359e93ad5084974ca0bc6ad30d
-  data.tar.gz: 99e5a3c8d7bdf39ec903a7b44fb9a7d2e9c792cc405ec25b409ed8eca6f504b830b75cdf24a29271612931b79b4719f547580f61ab6f5f67aa829e74ab95bd10
+  metadata.gz: 9563af163f07bbaae4ea0427120785cc814c444289f7a6bc75b527d9a2e2a5a29785b99f40fa7c31c807c10708693f7f1a5cb5d9c39fea40b82a31e8d8c56964
+  data.tar.gz: 6912a0399394405e8678e33b13b1c95a7575ce5ef7f7731c23a514d2f55c720724c1f4d17bcb73be654a58461bade34d03adfcfd7e615509d1244c53ac8a8673

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # CHANGELOG
 
+## 0.2.0
+
+- Live debug modes for `tui-td test`: `-v` (verbose), `-l` (live screen-refresh), `-s` (step-by-step pause)
+- Fix: skip DEC private mode sequences (`\e[?1049h` alternate screen, `\e[?25h` cursor visibility, etc.)
+- TestRunner `on_step` callback API for programmatic step-by-step observation
+- Vim interaction test example: type, yank, paste, substitute
+- Removed aruba dev dependency from Gemfile
+
 ## 0.1.3
 
 - UTF-8 multi-byte character support in ANSI parser (`_utf8_char_at`)

data/README.md

@@ -98,22 +98,45 @@ Usage: tui-td <command> [options]
 
 Commands:
   serve              Start MCP server (JSON-RPC over stdio)
-  test <file>        Run JSON test file
-  run <command>      Run a TUI app and show live output
-  drive <command>    Drive a TUI with structured state output
   capture <command>  Run once, capture and display state
+  drive <command>    Drive a TUI interactively
+  run <command>      Run a TUI app and show live output
+  test <file.json>   Run JSON test file
+  help [topic]       Show this help, or help test / help rspec
+
+Examples:
+  tui-td capture "ls -la"
+  tui-td --screenshot out.png capture "htop" --timeout 5
+  tui-td --html out.html capture "glow README.md"
+  tui-td -C /my/project capture "make test"
+  tui-td drive "vim file.txt" --rows 24 --cols 80
+  tui-td test examples/echo_test.json
+  tui-td -vl test examples/vim_hello_world.json
+  tui-td serve
+
+Interactive commands (drive mode):
+  state              Show terminal state as pretty JSON
+  raw                Show raw ANSI output
+  key <name>         Send keystroke (enter, tab, escape, up, down, left, right,
+                     backspace, ctrl_c, ctrl_d)
+  <text>             Send text to the TUI
+  exit               Quit drive mode
 
 Global options:
   -r, --rows N          Terminal rows (default: 40)
   -c, --cols N          Terminal cols (default: 120)
-  -C, --chdir PATH      Working directory for the command
   -t, --timeout N       Timeout in seconds (default: 30)
+  -C, --chdir PATH      Working directory for the command
   --screenshot PATH     Save PNG screenshot
   --html PATH           Save HTML render for browser viewing
   --json                Output state as compact JSON (includes raw ANSI)
   --pretty              Output state as pretty JSON
-  --text                Output state as plain text table (default)
-  -h, --help            Show complete reference (commands, options, examples, interactive commands)
+  --text                Output state as plain text table
+  -v, --verbose         Show each test step as it runs
+  -l, --live            Show terminal state after each test step (screen-refresh)
+  -s, --step            Pause after each test step for confirmation
+  --version             Show version
+  -h, --help            Show complete reference
 ```
 
 `tui-td --help` serves as the full CLI reference. `tui-td help test` shows all JSON test

data/lib/tui_td/ansi_parser.rb

@@ -103,7 +103,7 @@ module TUITD
         if processed[i] == "\e" && processed[i + 1] == "["
           # Find end of CSI sequence
           j = i + 2
-          j += 1 while j < processed.length && !processed[j].match?(/[A-HJ-KP-SX@`fmnR]/)
+          j += 1 while j < processed.length && !processed[j].match?(/[A-HJ-KP-SX@`fhlmnR]/)
           seq = processed[i..j]
 
           dsr = _apply_csi(seq, cursor, attrs, grid, rows, cols)
@@ -214,7 +214,7 @@ module TUITD
     def self._apply_csi(seq, cursor, attrs, grid, rows, cols)
       # Strip leading escape char if present
       cleaned = seq.sub(/^\e/, "")
-      match = cleaned.match(/^\[([\d;]*)([A-HJ-KP-SX@`fhmnR])$/)
+      match = cleaned.match(/^\[([\d;]*)([A-HJ-KP-SX@`fhlmnR])$/)
       return unless match
 
       params = match[1].split(";").map(&:to_i)
@@ -270,6 +270,8 @@ module TUITD
           next unless cursor[:row] < rows && cursor[:col] + i < cols
           grid[cursor[:row]][cursor[:col] + i][:char] = " "
         end
+      when "h", "l" # DEC private mode set/reset — skip (alternate screen, cursor show/hide, etc.)
+        nil
       when "n" # DSR — Device Status Report request
         # \e[6n = request cursor position → caller must respond with \e[row;colR
         return params[0] == 6

data/lib/tui_td/cli.rb

@@ -32,6 +32,7 @@ module TUITD
         opts.separator "  tui-td -C /my/project capture \"make test\""
         opts.separator "  tui-td drive \"vim file.txt\" --rows 24 --cols 80"
         opts.separator "  tui-td test examples/echo_test.json"
+        opts.separator "  tui-td -vl test examples/vim_hello_world.json"
         opts.separator "  tui-td serve"
         opts.separator ""
         opts.separator "Interactive commands (drive mode):"
@@ -71,6 +72,15 @@ module TUITD
         opts.on("--text", "Output state as plain text table") do |_|
           global_opts[:format] = :text
         end
+        opts.on("-v", "--verbose", "Show each test step as it runs") do |_|
+          global_opts[:verbose] = true
+        end
+        opts.on("-l", "--live", "Show terminal state after each step (screen-refresh)") do |_|
+          global_opts[:live] = true
+        end
+        opts.on("-s", "--step", "Pause after each test step for confirmation") do |_|
+          global_opts[:step_mode] = true
+        end
         opts.on("--version", "Show version") do
           puts "tui-td #{TUITD::VERSION}"
           exit 0
@@ -228,9 +238,35 @@ module TUITD
       path = args.first
       abort "File not found: #{path}" unless File.exist?(path)
 
+      verbose = globals[:verbose]
+      live = globals[:live]
+      step_mode = globals[:step_mode]
+
+      on_step = if verbose || live || step_mode
+                  lambda do |info|
+                    if live && info[:driver]
+                      info[:driver].wait_for_stable(stable_ms: 200)
+                    end
+                    if verbose
+                      status = info[:result].passed ? "PASS" : "FAIL"
+                      puts "[#{info[:index] + 1}/#{info[:total]}] #{info[:action]}: #{info[:result].message}"
+                      puts "      → #{status}"
+                    end
+                    if live && info[:driver]
+                      print "\e[2J\e[H"  # clear screen, home cursor
+                      _render_text(info[:driver].state_data)
+                    end
+                    if step_mode
+                      print "\n[Enter=weiter, q=abbruch] "
+                      input = $stdin.gets
+                      exit 1 if input&.chomp == "q"
+                    end
+                  end
+                end
+
       require "json"
       plan = JSON.parse(File.read(path), symbolize_names: true)
-      runner = TestRunner.new(plan)
+      runner = TestRunner.new(plan, on_step: on_step)
       result = runner.run
 
       puts
@@ -277,6 +313,10 @@ module TUITD
         Run from CLI:
 
           tui-td test examples/echo_test.json
+          tui-td -v test examples/echo_test.json   (verbose: show each step)
+          tui-td -vl test examples/echo_test.json  (verbose + live terminal view)
+          tui-td -vs test examples/echo_test.json  (verbose + pause after each step)
+          tui-td -vls test examples/vim_hello_world.json  (all three: watch vim edit live)
 
         Or from Ruby code:
 

data/lib/tui_td/test_runner.rb

@@ -26,10 +26,11 @@ module TUITD
   class TestRunner
     Result = Struct.new(:step, :passed, :message, keyword_init: true)
 
-    def initialize(source)
+    def initialize(source, on_step: nil)
       raw = source.is_a?(String) ? JSON.parse(source) : source
       @plan = raw.transform_keys(&:to_sym)
       @plan[:steps] = @plan[:steps].map { |s| s.transform_keys(&:to_sym) }
+      @on_step = on_step
     end
 
     def run
@@ -150,6 +151,24 @@ module TUITD
 
         results << r
         all_passed &&= r.passed
+
+        if @on_step
+          state_data = nil
+          begin
+            state_data = driver.state_data if driver
+          rescue StandardError
+            # ignore — state retrieval is best-effort
+          end
+          @on_step.call(
+            index: results.size - 1,
+            total: @plan[:steps].size,
+            action: action,
+            value: value,
+            result: r,
+            driver: driver,
+            state_data: state_data
+          )
+        end
       end
 
       driver&.close

data/lib/tui_td/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TUITD
-  VERSION = "0.1.3"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tui-td
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - Haluk Durmus