ratatui_ruby 1.3.2 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 859d136b449ee3babaa09dd80f9bfa1507f08146a632564369c6ab2aa3b937c8
-  data.tar.gz: dd7e5cf58b04c81e2b5a0c2eb75e796dbfdcbcdc925d4ee6d6f5eda3fdb15df9
+  metadata.gz: 3e12c46f758cf25eb436da52bbdcbf46f5cd256b804cb3f67a2d6edeeb8d4062
+  data.tar.gz: c4aa2e4c6251a6a75b8ac57e3c7f6133c88066185ee5e9cd1633fbc459edf612
 SHA512:
-  metadata.gz: 75ccfaca2381095492f89c37abfc04530391e6ff31691253cdcd7feb93f12c81bb71bf011dbe00ef34f7cf9a580cf601d5939e592e22949390ebde29721bf05f
-  data.tar.gz: d498466df9bb6af3f4e2c76ce6db58c379a684a8670fa01df1912c621306dc35bdb30c4d1481196b6b493751546d0a03f88bf3be9ac1a888cd80c4c478ae8adc
+  metadata.gz: dca9adc8ecef9e432c163b5b7b9e2488d42f9f1db98212a5c140a70bf21dc6c19fa687a97fb30d52ef9cadf8c5dd34a3aecbe471562ba5d9bfdb8c1ff85b99bf
+  data.tar.gz: 5f1e347a863736fae0ea9854a37402bd3115c311a228c23b24848113c23a21beeb97b5a33a9177611cd83c7e9d61ed6b4c4c9cf85c110e89f358e805f456465c

data/ext/ratatui_ruby/Cargo.lock

@@ -1059,7 +1059,7 @@ dependencies = [
 
 [[package]]
 name = "ratatui_ruby"
-version = "1.3.2"
+version = "1.4.0"
 dependencies = [
  "bumpalo",
  "lazy_static",

data/ext/ratatui_ruby/Cargo.toml

@@ -3,7 +3,7 @@
 
 [package]
 name = "ratatui_ruby"
-version = "1.3.2"
+version = "1.4.0"
 edition = "2021"
 
 [lib]

data/lib/ratatui_ruby/test_helper/snapshot.rb

@@ -99,7 +99,62 @@ module RatatuiRuby
     #--
     # SPDX-SnippetEnd
     #++
+    #
+    # === Class-Wide Normalization
+    #
+    # When every test in a class faces the same dynamic content, override
+    # <tt>normalize_snapshots</tt> instead of repeating the block. Return a callable
+    # (or Array of callables) that transforms lines. The hook runs before any per-call
+    # block, so the two compose naturally. See <tt>normalize_snapshots</tt> for details.
     module Snapshot
+      # Override this method to normalize all snapshots in a test class.
+      #
+      # Snapshot assertions compare screen content against stored files. Dynamic content
+      # (timestamps, temp paths, random IDs) breaks those comparisons. Passing a normalization
+      # block to each assertion fixes one test but creates duplication when every test in a
+      # class faces the same dynamic content.
+      #
+      # Override <tt>normalize_snapshots</tt> in your test class to define class-wide
+      # normalization. Accept an Array of Strings (lines) and return the transformed Array.
+      #
+      # The hook runs before any per-call normalization block, so the two compose naturally:
+      # the hook handles class-wide concerns and the block handles one-off masking.
+      #
+      # Returns <tt>lines</tt> unchanged by default (no normalization).
+      #
+      # === Example
+      #
+      #--
+      # SPDX-SnippetBegin
+      # SPDX-FileCopyrightText: 2026 Kerrick Long
+      # SPDX-License-Identifier: MIT-0
+      #++
+      #   class TestFileExplorer < Minitest::Test
+      #     include RatatuiRuby::TestHelper
+      #
+      #     private def normalize_snapshots(lines)
+      #       lines.map { |l| l.gsub(Dir.pwd, "STABLE_PATH") }
+      #     end
+      #
+      #     def test_initial_render
+      #       # normalize_snapshots runs automatically — no block needed
+      #       assert_snapshots("initial_render")
+      #     end
+      #
+      #     def test_after_scroll
+      #       # Per-call block composes with the hook (hook runs first)
+      #       assert_snapshots("after_scroll") do |lines|
+      #         lines.map { |l| l.gsub(/\d{2}:\d{2}/, "XX:XX") }
+      #       end
+      #     end
+      #   end
+      #
+      #--
+      # SPDX-SnippetEnd
+      #++
+      private def normalize_snapshots(lines)
+        lines
+      end
       ##
       # Asserts that the current screen content matches a stored plain text snapshot.
       #
@@ -181,7 +236,7 @@ module RatatuiRuby
       # Ensure your render logic is deterministic by seeding random number generators and stubbing
       # time where necessary.
       def assert_screen_matches(expected, msg = nil)
-        actual_lines = buffer_content
+        actual_lines = normalize_snapshots(buffer_content)
 
         if block_given?
           actual_lines = yield(actual_lines)
@@ -203,9 +258,6 @@ module RatatuiRuby
 
               # Write with explicit mode to ensure clean write
               File.write(snapshot_path, content_to_write, mode: "w")
-
-              # Flush filesystem buffers to ensure durability
-              File.open(snapshot_path, "r", &:fsync) if File.exist?(snapshot_path)
             rescue => e
               warn "Failed to write snapshot #{snapshot_path}: #{e.message}"
               raise
@@ -269,12 +321,11 @@ module RatatuiRuby
 
         actual_content = _render_buffer_with_ansi
 
+        lines = normalize_snapshots(actual_content.split("\n"))
         if block_given?
-          lines = actual_content.split("\n")
-          # Yield lines to user block for modification (e.g. masking IDs/Times)
           lines = yield(lines)
-          actual_content = "#{lines.join("\n")}\n"
         end
+        actual_content = "#{lines.join("\n")}\n"
 
         update_snapshots = ENV["UPDATE_SNAPSHOTS"] == "1" || ENV["UPDATE_SNAPSHOTS"] == "true"
 
@@ -287,9 +338,6 @@ module RatatuiRuby
 
             # Write with explicit mode to ensure clean write
             File.write(snapshot_path, actual_content, mode: "w")
-
-            # Flush filesystem buffers to ensure durability
-            File.open(snapshot_path, "r", &:fsync) if File.exist?(snapshot_path)
           rescue => e
             warn "Failed to write rich snapshot #{snapshot_path}: #{e.message}"
             raise

data/lib/ratatui_ruby/test_helper/subprocess_timeout.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: LGPL-3.0-or-later
+#++
+
+require "timeout"
+
+module RatatuiRuby
+  module TestHelper
+    ##
+    # Portable subprocess timeout helper.
+    module SubprocessTimeout
+      private def popen_with_timeout(env, cmd, timeout: 2)
+        output = +""
+        IO.popen(env, cmd, err: [:child, :out]) do |io|
+          deadline = Process.clock_gettime(Process::CLOCK_MONOTONIC) + timeout
+          loop do
+            remaining = deadline - Process.clock_gettime(Process::CLOCK_MONOTONIC)
+            break if remaining <= 0
+            break unless io.wait_readable(remaining)
+
+            chunk = io.read_nonblock(4096, exception: false)
+            break if chunk.nil? || chunk == :wait_readable
+
+            output << chunk
+          end
+          Process.kill("KILL", io.pid) rescue nil # rubocop:disable Style/RescueModifier
+        end
+        output.strip
+      end
+    end
+  end
+end

data/lib/ratatui_ruby/test_helper.rb

@@ -12,6 +12,7 @@ require_relative "test_helper/event_injection"
 require_relative "test_helper/style_assertions"
 require_relative "test_helper/test_doubles"
 require_relative "test_helper/global_state"
+require_relative "test_helper/subprocess_timeout"
 
 module RatatuiRuby
   ##
@@ -109,5 +110,6 @@ module RatatuiRuby
     include StyleAssertions
     include TestDoubles
     include GlobalState
+    include SubprocessTimeout
   end
 end

data/lib/ratatui_ruby/version.rb

@@ -8,5 +8,5 @@
 module RatatuiRuby
   # The version of the ratatui_ruby gem.
   # See https://semver.org/spec/v2.0.0.html
-  VERSION = "1.3.2"
+  VERSION = "1.4.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ratatui_ruby
 version: !ruby/object:Gem::Version
-  version: 1.3.2
+  version: 1.4.0
 platform: ruby
 authors:
 - Kerrick Long
@@ -298,7 +298,7 @@ description: |2-
   RatatuiRuby renders. For complex applications, add a framework that manages
   state and composition.
 
-  ==== Rooibos[https://git.sr.ht/~kerrick/rooibos] (Framework)
+  ==== Rooibos[https://www.rooibos.run] (Framework)
 
   Model-View-Update architecture. Inspired by Elm, Bubble Tea, and React +
   Redux. Your UI is a pure function of state.
@@ -371,26 +371,26 @@ description: |2-
     {API Reference}[https://www.ratatui-ruby.dev/docs/v0.10/],
     {Guides}[https://www.ratatui-ruby.dev/docs/v0.10/doc/index_md.html]
   [Ecosystem]
-    Rooibos[https://git.sr.ht/~kerrick/rooibos],
+    Rooibos[https://www.rooibos.run],
     {Kit}[https://sr.ht/~kerrick/ratatui_ruby/#chapter-3-the-object-path--kit] (Planned),
     {Framework}[https://sr.ht/~kerrick/ratatui_ruby/#chapter-5-the-framework] (Planned),
     {UI Widgets}[https://sr.ht/~kerrick/ratatui_ruby/#chapter-6-licensing] (Planned)
   [Community]
-    {Discuss and Chat}[https://lists.sr.ht/~kerrick/ratatui_ruby-discuss],
-    {Announcements}[https://lists.sr.ht/~kerrick/ratatui_ruby-announce],
-    {Development}[https://lists.sr.ht/~kerrick/ratatui_ruby-devel],
-    {Bug Tracker}[https://todo.sr.ht/~kerrick/ratatui_ruby]
+    {Forum}[https://forum.setdef.com/c/ratatui-ruby/6],
+    {Announcements}[https://forum.setdef.com/tags/c/ratatui-ruby/6/announcement],
+    {Discussion}[https://forum.setdef.com/tags/c/ratatui-ruby/6/discussion],
+    {Bug Tracker}[https://forum.setdef.com/tags/c/ratatui-ruby/6/bug]
   [Contribute]
     {Contributing Guide}[https://man.sr.ht/~kerrick/ratatui_ruby/contributing.md],
     {Code of Conduct}[https://man.sr.ht/~kerrick/ratatui_ruby/code_of_conduct.md],
     {Project History}[https://man.sr.ht/~kerrick/ratatui_ruby/history/index.md],
-    {Pull Requests}[https://lists.sr.ht/~kerrick/ratatui_ruby-devel/patches]
+    {Pull Requests}[https://forum.setdef.com/tags/c/ratatui-ruby/6/patch]
 
 
   ---
 
   [Website] https://www.ratatui-ruby.dev
-  [Source] https://git.sr.ht/~kerrick/ratatui_ruby
+  [Source] https://github.com/setdef/RatatuiRuby
   [RubyGems] https://rubygems.org/gems/ratatui_ruby
   [Upstream] https://ratatui.rs
   [Build Status] https://builds.sr.ht/~kerrick/ratatui_ruby
@@ -535,6 +535,7 @@ files:
 - lib/ratatui_ruby/test_helper/snapshots/styled_dataset_name.ansi
 - lib/ratatui_ruby/test_helper/snapshots/styled_dataset_name.txt
 - lib/ratatui_ruby/test_helper/style_assertions.rb
+- lib/ratatui_ruby/test_helper/subprocess_timeout.rb
 - lib/ratatui_ruby/test_helper/terminal.rb
 - lib/ratatui_ruby/test_helper/test_doubles.rb
 - lib/ratatui_ruby/text.rb
@@ -692,17 +693,17 @@ files:
 - sig/ratatui_ruby/widgets/table.rbs
 - sig/ratatui_ruby/widgets/tabs.rbs
 - vendor/goodcop/base.yml
-homepage: https://sr.ht/~kerrick/ratatui_ruby/
+homepage: https://www.ratatui-ruby.dev
 licenses:
 - LGPL-3.0-or-later
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://sr.ht/~kerrick/ratatui_ruby/
-  bug_tracker_uri: https://todo.sr.ht/~kerrick/ratatui_ruby
-  changelog_uri: https://git.sr.ht/~kerrick/ratatui_ruby/tree/stable/item/CHANGELOG.md
-  mailing_list_uri: https://lists.sr.ht/~kerrick/ratatui_ruby-discuss
-  source_code_uri: https://git.sr.ht/~kerrick/ratatui_ruby
-  documentation_uri: https://git.sr.ht/~kerrick/ratatui_ruby/tree/HEAD/doc/index.md
+  homepage_uri: https://www.ratatui-ruby.dev
+  bug_tracker_uri: https://forum.setdef.com/tags/c/ratatui-ruby/6/bug
+  changelog_uri: https://github.com/setdef/RatatuiRuby/blob/stable/CHANGELOG.md
+  mailing_list_uri: https://forum.setdef.com/c/ratatui-ruby/6
+  source_code_uri: https://github.com/setdef/RatatuiRuby
+  documentation_uri: https://www.ratatui-ruby.dev/docs/
   wiki_uri: https://man.sr.ht/~kerrick/ratatui_ruby/
   funding_uri: https://opencollective.com/ratatui
 rdoc_options: []