hyperlist 1.1.5 → 1.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35f413c3d4847c79d6284a15ebb366df9bf40371f6b9df3a5be2c34b6cb7a17b
-  data.tar.gz: 7c528e553d89eacdbd1b0ee1e87d847f9394cf43cd8a690dcd2dd241cb679624
+  metadata.gz: 7963687b87c7d271d9e45e5574e7af4edb900e49cc60a567774e4be54a386f51
+  data.tar.gz: '055148f7bc87ab9af632b5ad52eae9a367bdc8b4c84c8bbff28ed5686502e30a'
 SHA512:
-  metadata.gz: fc7607ecec08008dcc69d9a070a71d1b68edb564b8a9ecacd2cc4c67012188b350c5ff09b3f1a8015c9798a000c5eaffa09b4a637ac33bbfe7a96d943f0b1c40
-  data.tar.gz: 42ddb51750d0cecc9cf6afc8797bb3b89eb283ebcee2b085ab1ec2f401aefb73ed8f5f777d9c9cabfd6f6dda85619da317ae0b6db0fa0801868aad53ad26c589
+  metadata.gz: 17a562ee3ccdbcd2434c7a6fc5b08f3bccb696fb0a0100e735ea7e5f5e267021de31c0b9c8007dd4990818e236d9d0f7a87cebeed4384b69161202e0f1f6f8c9
+  data.tar.gz: 27a237a412326e4f45fa17cd7b622bfa5073f39a4b2f87ce1bc6af264eb0506d2f663b39338cd66738b54f95e7ccd48d85838c58eb6bad7c15ec84e007bd68dc

data/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 All notable changes to the HyperList Ruby TUI will be documented in this file.
 
+## [1.1.7] - 2025-08-15
+
+### Fixed
+- **Updated rcurses dependency to 5.1.6**
+  - Fixes Ruby 3.4.5 hanging issue during terminal initialization
+  - rcurses now handles stdin.raw! blocking with timeout and stty fallback
+  - Fully backward compatible
+
+## [1.1.6] - 2025-08-14
+
+### Fixed
+- **Ruby 3.4+ Compatibility**
+  - Added explicit rcurses initialization for Ruby 3.4.0 and later
+  - Improved error handling during terminal initialization
+  - Added proper cleanup on exit for newer Ruby versions
+  - Fixed silent crashes on Arch Linux with Ruby 3.4.5
+
 ## [1.1.0] - 2025-08-13
 
 ### Added

data/diagnose_ruby34.rb

@@ -0,0 +1,145 @@
+#!/usr/bin/env ruby
+# Diagnostic script for Ruby 3.4.5 compatibility issues
+
+puts "Ruby Compatibility Diagnostic for HyperList"
+puts "=" * 50
+puts "Ruby version: #{RUBY_VERSION}"
+puts "Ruby platform: #{RUBY_PLATFORM}"
+puts
+
+# Test 1: Basic rcurses functionality
+puts "Test 1: Basic rcurses require and init..."
+begin
+  require 'rcurses'
+  puts "  ✓ rcurses loaded successfully"
+  puts "  Rcurses version: #{Rcurses::VERSION}" if defined?(Rcurses::VERSION)
+rescue LoadError => e
+  puts "  ✗ Failed to load rcurses: #{e.message}"
+  exit 1
+end
+
+# Test 2: Rcurses initialization with error capture
+puts "\nTest 2: Rcurses initialization..."
+begin
+  # Capture any output during init
+  original_stdout = $stdout
+  original_stderr = $stderr
+  
+  # Create StringIO to capture output
+  require 'stringio'
+  captured_out = StringIO.new
+  captured_err = StringIO.new
+  
+  $stdout = captured_out
+  $stderr = captured_err
+  
+  # Try to initialize
+  Rcurses.init!
+  
+  # Restore output
+  $stdout = original_stdout
+  $stderr = original_stderr
+  
+  # Check if anything was captured
+  out_content = captured_out.string
+  err_content = captured_err.string
+  
+  if !out_content.empty?
+    puts "  Captured stdout during init: #{out_content.inspect}"
+  end
+  if !err_content.empty?
+    puts "  Captured stderr during init: #{err_content.inspect}"
+  end
+  
+  puts "  ✓ Rcurses initialized"
+  
+  # Test basic functionality
+  puts "  Testing basic screen operations..."
+  print "\e[2J\e[H"  # Clear screen
+  print "Test"
+  sleep 0.1
+  print "\e[2J\e[H"  # Clear again
+  
+  puts "  ✓ Basic operations work"
+  
+rescue => e
+  puts "  ✗ Failed during initialization: #{e.message}"
+  puts "  Backtrace:"
+  e.backtrace.first(5).each { |line| puts "    #{line}" }
+ensure
+  # Try to restore terminal
+  begin
+    Rcurses.done! if defined?(Rcurses.done!)
+  rescue
+    # Fallback terminal restore
+    print "\e[?25h"  # Show cursor
+    system("stty sane 2>/dev/null")
+  end
+end
+
+# Test 3: Check for method availability issues in Ruby 3.4
+puts "\nTest 3: Ruby 3.4 specific checks..."
+
+# Check IO methods that might have changed
+if IO.respond_to?(:console)
+  puts "  ✓ IO.console available"
+else
+  puts "  ✗ IO.console not available"
+end
+
+begin
+  require 'io/console'
+  $stdin.raw { }
+  puts "  ✓ IO#raw method works"
+rescue => e
+  puts "  ✗ IO#raw failed: #{e.message}"
+end
+
+# Test 4: Check encoding
+puts "\nTest 4: Encoding checks..."
+puts "  Default external: #{Encoding.default_external}"
+puts "  Default internal: #{Encoding.default_internal}"
+puts "  Console encoding: #{$stdout.external_encoding}" if $stdout.respond_to?(:external_encoding)
+
+# Test 5: Simple hyperlist initialization test
+puts "\nTest 5: HyperList class initialization..."
+begin
+  # Load just the class definition part
+  hyperlist_code = File.read(File.join(File.dirname(__FILE__), 'hyperlist'))
+  
+  # Extract just the class without running main
+  class_only = hyperlist_code.split(/^if __FILE__ == \$0/)[0]
+  
+  # Try to evaluate it
+  eval(class_only)
+  
+  puts "  ✓ HyperList class loaded"
+  
+  # Try to create instance (without running)
+  app = HyperListApp.new
+  puts "  ✓ HyperListApp instance created"
+  
+rescue => e
+  puts "  ✗ Failed to load HyperList: #{e.message}"
+  puts "  Error at: #{e.backtrace.first}"
+end
+
+# Test 6: Terminal capability check
+puts "\nTest 6: Terminal capabilities..."
+puts "  TERM: #{ENV['TERM']}"
+puts "  Columns: #{`tput cols`.strip}" rescue nil
+puts "  Lines: #{`tput lines`.strip}" rescue nil
+
+# Test 7: Check for signal handling changes
+puts "\nTest 7: Signal handling..."
+begin
+  old_handler = Signal.trap("WINCH") { }
+  Signal.trap("WINCH", old_handler)
+  puts "  ✓ SIGWINCH trap works"
+rescue => e
+  puts "  ✗ SIGWINCH trap failed: #{e.message}"
+end
+
+puts "\n" + "=" * 50
+puts "Diagnostic complete!"
+puts "\nPlease share this output to help identify the Ruby 3.4.5 compatibility issue."

data/diagnose_ruby34_detailed.rb

@@ -0,0 +1,156 @@
+#!/usr/bin/env ruby
+# Detailed diagnostic script for Ruby 3.4.5 compatibility issues
+
+puts "Ruby Compatibility Diagnostic for HyperList (Detailed)"
+puts "=" * 50
+puts "Ruby version: #{RUBY_VERSION}"
+puts "Ruby platform: #{RUBY_PLATFORM}"
+puts
+
+# Test 0: Environment check
+puts "Test 0: Environment check..."
+puts "  TERM: #{ENV['TERM']}"
+puts "  SHELL: #{ENV['SHELL']}"
+puts "  HOME: #{ENV['HOME']}"
+puts "  PATH includes gem bin: #{ENV['PATH'].include?('.gem')}"
+puts
+
+# Test 1: Basic rcurses load
+puts "Test 1: Loading rcurses gem..."
+STDOUT.flush
+begin
+  require 'rcurses'
+  puts "  ✓ rcurses loaded"
+  puts "  Rcurses constants defined: #{Rcurses.constants.sort.join(', ')}" if defined?(Rcurses)
+  STDOUT.flush
+rescue LoadError => e
+  puts "  ✗ Failed to load rcurses: #{e.message}"
+  exit 1
+end
+
+# Test 2: Check rcurses version and methods
+puts "\nTest 2: Checking rcurses methods..."
+STDOUT.flush
+if defined?(Rcurses)
+  puts "  Methods available: #{Rcurses.methods(false).sort.join(', ')}"
+  puts "  Responds to init!: #{Rcurses.respond_to?(:init!)}"
+  puts "  Responds to done!: #{Rcurses.respond_to?(:done!)}"
+  STDOUT.flush
+end
+
+# Test 3: Try initialization with timeout
+puts "\nTest 3: Attempting rcurses initialization (with 2 second timeout)..."
+STDOUT.flush
+
+require 'timeout'
+begin
+  Timeout::timeout(2) do
+    puts "  Calling Rcurses.init!..."
+    STDOUT.flush
+    
+    # Try to capture any initialization issues
+    old_stdout = $stdout
+    old_stderr = $stderr
+    
+    begin
+      Rcurses.init!
+      puts "  ✓ Rcurses.init! returned successfully"
+    rescue => e
+      puts "  ✗ Rcurses.init! raised: #{e.class} - #{e.message}"
+      puts "    Backtrace: #{e.backtrace.first(3).join("\n    ")}"
+    ensure
+      $stdout = old_stdout
+      $stderr = old_stderr
+    end
+    
+    STDOUT.flush
+  end
+rescue Timeout::Error
+  puts "  ✗ Rcurses.init! timed out after 2 seconds"
+  puts "  This suggests init! is hanging"
+  STDOUT.flush
+end
+
+# Test 4: Check terminal control without rcurses
+puts "\nTest 4: Direct terminal control test..."
+STDOUT.flush
+begin
+  # Save terminal state
+  system("stty -g > /tmp/terminal_state.txt 2>/dev/null")
+  
+  # Try basic terminal operations
+  print "\e[?25l"  # Hide cursor
+  print "\e[2J"     # Clear screen
+  print "\e[H"      # Home
+  print "Terminal control test"
+  sleep 0.5
+  print "\e[2J\e[H" # Clear again
+  print "\e[?25h"   # Show cursor
+  
+  puts "  ✓ Direct terminal control works"
+  STDOUT.flush
+rescue => e
+  puts "  ✗ Terminal control failed: #{e.message}"
+  STDOUT.flush
+ensure
+  # Restore terminal
+  system("stty $(cat /tmp/terminal_state.txt) 2>/dev/null")
+  print "\e[?25h"  # Ensure cursor is visible
+end
+
+# Test 5: Check IO/console
+puts "\nTest 5: IO/console functionality..."
+STDOUT.flush
+begin
+  require 'io/console'
+  
+  # Check if stdin is a tty
+  puts "  STDIN.tty?: #{STDIN.tty?}"
+  puts "  STDOUT.tty?: #{STDOUT.tty?}"
+  
+  # Test raw mode
+  begin
+    STDIN.raw { }
+    puts "  ✓ STDIN.raw works"
+  rescue => e
+    puts "  ✗ STDIN.raw failed: #{e.message}"
+  end
+  
+  # Test noecho
+  begin
+    STDIN.noecho { }
+    puts "  ✓ STDIN.noecho works"
+  rescue => e
+    puts "  ✗ STDIN.noecho failed: #{e.message}"
+  end
+  
+  STDOUT.flush
+rescue => e
+  puts "  ✗ Failed: #{e.message}"
+  STDOUT.flush
+end
+
+# Test 6: Check if rcurses is trying to use methods that don't exist
+puts "\nTest 6: Checking potential Ruby 3.4 incompatibilities..."
+STDOUT.flush
+
+# Check Thread methods
+puts "  Thread.respond_to?(:handle_interrupt): #{Thread.respond_to?(:handle_interrupt)}"
+puts "  Signal.list includes WINCH: #{Signal.list.include?('WINCH')}"
+
+# Check IO methods that might be different
+if defined?(IO.console)
+  console = IO.console
+  puts "  IO.console class: #{console.class}"
+  puts "  IO.console methods include raw: #{console.respond_to?(:raw)}"
+  puts "  IO.console methods include getch: #{console.respond_to?(:getch)}"
+end
+
+puts "\n" + "=" * 50
+puts "Diagnostic complete!"
+puts "\nIf the script hangs at 'Calling Rcurses.init!', it means rcurses"
+puts "is incompatible with Ruby 3.4.5 and needs to be updated."
+STDOUT.flush
+
+# Clean exit
+exit 0

data/hyperlist

@@ -7,7 +7,7 @@
 # Check for help/version BEFORE loading any libraries
 if ARGV[0] == '-h' || ARGV[0] == '--help'
   puts <<~HELP
-    HyperList v1.1.5 - Terminal User Interface for HyperList files
+    HyperList v1.1.7 - Terminal User Interface for HyperList files
     
     USAGE
       hyperlist [OPTIONS] [FILE]
@@ -52,7 +52,7 @@ if ARGV[0] == '-h' || ARGV[0] == '--help'
   HELP
   exit 0
 elsif ARGV[0] == '-v' || ARGV[0] == '--version'
-  puts "HyperList v1.1.5"
+  puts "HyperList v1.1.7"
   exit 0
 end
 
@@ -70,7 +70,7 @@ class HyperListApp
   include Rcurses::Input
   include Rcurses::Cursor
   
-  VERSION = "1.1.5"
+  VERSION = "1.1.7"
   
   def initialize(filename = nil)
     @filename = filename ? File.expand_path(filename) : nil

data/hyperlist.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |spec|
   spec.name          = "hyperlist"
-  spec.version       = "1.1.5"
+  spec.version       = "1.1.7"
   spec.authors       = ["Geir Isene"]
   spec.email         = ["g@isene.com"]
 
@@ -28,7 +28,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["."]
 
   # Runtime dependencies
-  spec.add_runtime_dependency "rcurses", "~> 5.1", ">= 5.1.5"
+  spec.add_runtime_dependency "rcurses", "~> 5.1", ">= 5.1.6"
   
   # Development dependencies
   spec.add_development_dependency "minitest", "~> 5.0"

data/hyperlist_ruby34_wrapper.rb

@@ -0,0 +1,57 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+# Wrapper for Ruby 3.4+ compatibility
+# This ensures proper initialization of rcurses
+
+# Handle help/version before loading libraries
+if ARGV[0] == '-h' || ARGV[0] == '--help' || ARGV[0] == '-v' || ARGV[0] == '--version'
+  # Pass through to main hyperlist
+  load File.join(File.dirname(__FILE__), 'hyperlist')
+  exit 0
+end
+
+# Explicitly initialize rcurses before loading the main app
+require 'rcurses'
+
+begin
+  # Initialize rcurses with proper error handling
+  Rcurses.init!
+  
+  # Now load and run the main hyperlist app
+  # We need to prevent the main file from running automatically
+  $hyperlist_wrapper_mode = true
+  
+  # Load the hyperlist file
+  load File.join(File.dirname(__FILE__), 'hyperlist')
+  
+  # Create and run the app
+  app = HyperListApp.new(ARGV[0])
+  app.run
+  
+rescue Interrupt
+  # Handle Ctrl+C gracefully
+  Rcurses.done! if defined?(Rcurses.done!)
+  puts "\nInterrupted"
+  exit 0
+rescue => e
+  # Ensure terminal is restored on error
+  Rcurses.done! if defined?(Rcurses.done!)
+  
+  # Fallback terminal restoration
+  print "\e[?25h"  # Show cursor
+  system("stty sane 2>/dev/null")
+  
+  puts "Error: #{e.message}"
+  puts "Backtrace:" if ENV['DEBUG']
+  e.backtrace.first(10).each { |line| puts "  #{line}" } if ENV['DEBUG']
+  exit 1
+ensure
+  # Always try to restore terminal
+  begin
+    Rcurses.done! if defined?(Rcurses.done!)
+  rescue
+    print "\e[?25h"
+    system("stty sane 2>/dev/null")
+  end
+end

data/rcurses_ruby34_patch.rb

@@ -0,0 +1,149 @@
+#!/usr/bin/env ruby
+# Patch for rcurses to work with Ruby 3.4.5
+# This shows the minimal changes needed to fix the initialization hang
+
+module Rcurses
+  class << self
+    # Override init! with Ruby 3.4+ compatibility
+    def init_with_ruby34_fix!
+      return if @initialized
+      return unless $stdin.tty?
+
+      # Ruby 3.4.5 compatibility: Use Timeout to prevent hangs
+      # and try different approaches
+      begin
+        if RUBY_VERSION >= "3.4.0"
+          # For Ruby 3.4+, try using the block form first
+          # which properly handles terminal state
+          begin
+            require 'timeout'
+            
+            # Try to set raw mode with timeout
+            Timeout::timeout(0.5) do
+              # In Ruby 3.4+, raw! might need explicit flush
+              $stdout.flush
+              $stderr.flush
+              
+              # Try setting raw mode
+              $stdin.raw!
+            end
+            
+            # Set echo separately with timeout
+            Timeout::timeout(0.5) do
+              $stdin.echo = false
+            end
+          rescue Timeout::Error
+            # If raw! hangs, try alternative approach
+            # Use stty command as fallback
+            system("stty raw -echo 2>/dev/null")
+            @using_stty = true
+          end
+        else
+          # Original code for older Ruby versions
+          $stdin.raw!
+          $stdin.echo = false
+        end
+      rescue Errno::ENOTTY, Errno::ENODEV
+        # Not a terminal, can't initialize
+        return
+      rescue => e
+        # Log error but don't fail
+        $stderr.puts "rcurses init warning: #{e.message}" if ENV['DEBUG']
+        return
+      end
+
+      # ensure cleanup on normal exit
+      at_exit do
+        if $! && !$!.is_a?(SystemExit) && !$!.is_a?(Interrupt)
+          @error_to_display = $!
+        end
+        cleanup_with_ruby34_fix!
+      end
+
+      # ensure cleanup on signals
+      %w[INT TERM].each do |sig|
+        trap(sig) { cleanup_with_ruby34_fix!; exit }
+      end
+
+      @initialized = true
+    end
+    
+    def cleanup_with_ruby34_fix!
+      return if @cleaned_up
+
+      begin
+        if @using_stty
+          # If we used stty for initialization, use it for cleanup too
+          system("stty sane 2>/dev/null")
+        elsif RUBY_VERSION >= "3.4.0"
+          # Ruby 3.4+ cleanup with timeout
+          begin
+            Timeout::timeout(0.5) do
+              $stdin.cooked!
+              $stdin.echo = true
+            end
+          rescue Timeout::Error
+            # Fallback to stty
+            system("stty sane 2>/dev/null")
+          end
+        else
+          # Original cleanup
+          $stdin.cooked!
+          $stdin.echo = true
+        end
+      rescue => e
+        # Last resort cleanup
+        system("stty sane 2>/dev/null")
+      end
+      
+      # Rest of cleanup remains the same
+      if @error_to_display.nil?
+        Rcurses.clear_screen
+      else
+        print "\e[999;1H"
+        print "\e[K"
+      end
+      
+      Cursor.show
+      @cleaned_up = true
+      
+      if @error_to_display
+        display_error(@error_to_display)
+      end
+    end
+  end
+end
+
+# Test the patch
+if __FILE__ == $0
+  puts "Testing rcurses Ruby 3.4.5 patch..."
+  puts "Ruby version: #{RUBY_VERSION}"
+  
+  # Load rcurses
+  require 'rcurses'
+  
+  # Apply the patch
+  class << Rcurses
+    alias_method :init_original!, :init!
+    alias_method :init!, :init_with_ruby34_fix!
+    alias_method :cleanup!, :cleanup_with_ruby34_fix!
+  end
+  
+  # Test initialization
+  begin
+    puts "Calling Rcurses.init! with patch..."
+    Rcurses.init!
+    puts "✓ Initialization successful!"
+    
+    # Do a simple test
+    print "\e[2J\e[H"
+    print "Patch works! Press any key..."
+    $stdin.getch if $stdin.respond_to?(:getch)
+    
+  rescue => e
+    puts "✗ Error: #{e.message}"
+  ensure
+    Rcurses.cleanup!
+    puts "✓ Cleanup successful!"
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hyperlist
 version: !ruby/object:Gem::Version
-  version: 1.1.5
+  version: 1.1.7
 platform: ruby
 authors:
 - Geir Isene
@@ -19,7 +19,7 @@ dependencies:
         version: '5.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 5.1.5
+        version: 5.1.6
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '5.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 5.1.5
+        version: 5.1.6
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -75,11 +75,15 @@ files:
 - README.md
 - debug_instructions.md
 - diagnose.rb
+- diagnose_ruby34.rb
+- diagnose_ruby34_detailed.rb
 - diagnose_safe.rb
 - fix_terminal.sh
 - hyperlist
 - hyperlist.gemspec
 - hyperlist_logo.svg
+- hyperlist_ruby34_wrapper.rb
+- rcurses_ruby34_patch.rb
 - sample.hl
 - screenshot_help.png
 - screenshot_sample.png