tui-td 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8ebaa8989019a8cd573f682a538ca76a21a17daee810f29a1f178f8f35f0008
-  data.tar.gz: 52fecfc7d59143648f450e71612ac7b7b6839e1b697d03056cb80e0a0dd067ac
+  metadata.gz: b74325984554c843a191d5affcf77472229000da6f14551c26ca2e6f1b0425cd
+  data.tar.gz: 2ddeb1aaedfc23ca62e3e791bb254950ef4432a32f0031e0a144f7567e2a3785
 SHA512:
-  metadata.gz: 9563af163f07bbaae4ea0427120785cc814c444289f7a6bc75b527d9a2e2a5a29785b99f40fa7c31c807c10708693f7f1a5cb5d9c39fea40b82a31e8d8c56964
-  data.tar.gz: 6912a0399394405e8678e33b13b1c95a7575ce5ef7f7731c23a514d2f55c720724c1f4d17bcb73be654a58461bade34d03adfcfd7e615509d1244c53ac8a8673
+  metadata.gz: b02944c10ed90a607ccfadd80fe80237a1bd5d50bba8e92320875c3cc71181f04057d2cad78648f5ddefee7a149b179c215c12b0ed61a19af7363b658090e36a
+  data.tar.gz: fe0f2b747cc15fe39da0195c83371ef44c457194f1648aa5e4e03f525ac856a60f3561a482012009054158350d354ea7cf28a04ab75eb9d660c1712203364373

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # CHANGELOG
 
+## 0.2.2
+
+- `wait_for_exit` and `assert_exit` test steps — test process exit codes
+
+## 0.2.1
+
+- `Driver#refresh` — explicit state re-parse for MCP server clients
+
 ## 0.2.0
 
 - Live debug modes for `tui-td test`: `-v` (verbose), `-l` (live screen-refresh), `-s` (step-by-step pause)

data/README.md

@@ -142,6 +142,16 @@ Global options:
 `tui-td --help` serves as the full CLI reference. `tui-td help test` shows all JSON test
 step types and `tui-td help rspec` shows all RSpec matchers — no need to consult the docs.
 
+## Demo
+
+Step-by-step live view of a vim test — type "Hello World", copy the line, replace "World" with "Sun":
+
+![vim test demo](examples/vim_demo.gif)
+
+```bash
+tui-td -vls test examples/vim_hello_world.json
+```
+
 ## Ruby API
 
 ### Driver — Start, send, capture

data/lib/tui_td/cli.rb

@@ -367,8 +367,14 @@ module TUITD
           {"html": "<path>"}
               Save an HTML render. Path defaults to /tmp/tui_td_<ts>.html.
 
+          {"wait_for_exit": true}
+              Wait until the process exits naturally.
+
+          {"assert_exit": <N>}
+              Assert the process exit status equals N.
+
           {"close": true}
-              Close the driver session.
+              Close the driver session (force-kill if needed).
 
         Example test file: examples/echo_test.json
       HELP

data/lib/tui_td/driver.rb

@@ -117,12 +117,28 @@ module TUITD
       @wait_thr&.value
     end
 
+    # Get the process exit status (nil if still running)
+    def exitstatus
+      return nil unless @wait_thr
+      status = @wait_thr.value
+      status&.exitstatus
+    rescue NoMethodError
+      nil
+    end
+
     # Get the terminal output (raw ANSI + text)
     def raw_output
       read_available!
       @output_mutex.synchronize { @output_buffer.dup }
     end
 
+    # Refresh the terminal state by re-parsing the output buffer.
+    # Call this if the terminal content has changed and you need an up-to-date state.
+    def refresh
+      refresh_state!
+      @state
+    end
+
     # Get structured terminal state as a Hash
     def state_data
       refresh_state! if @state.nil?

data/lib/tui_td/test_runner.rb

@@ -136,6 +136,22 @@ module TUITD
                 HtmlRenderer.new(driver.state_data).render(path)
                 Result.new(step: action, passed: true, message: "Saved: #{path}")
 
+              when "wait_for_exit"
+                ensure_driver!(driver)
+                driver.wait_for_exit
+                status = driver.exitstatus
+                Result.new(step: action, passed: true, message: "Exited with status #{status}")
+
+              when "assert_exit"
+                ensure_driver!(driver)
+                expected = value.to_s.to_i
+                actual = driver.exitstatus
+                if actual == expected
+                  Result.new(step: action, passed: true, message: "Exit status #{expected} matches")
+                else
+                  Result.new(step: action, passed: false, message: "Exit status #{actual}, expected #{expected}")
+                end
+
               when "close"
                 driver&.close
                 driver = nil

data/lib/tui_td/version.rb

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

metadata

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