hyperlist 1.1.7 → 1.2.2

data/debug_instructions.md

@@ -1,112 +0,0 @@
-# Debugging HyperList Issues
-
-## For the user experiencing startup crashes:
-
-### 1. First, verify you have the latest versions:
-
-```bash
-gem list hyperlist
-# Should show: hyperlist (1.1.3)
-
-gem list rcurses  
-# Should show: rcurses (5.1.4) or higher
-```
-
-### 2. If not, update to the latest:
-
-```bash
-gem update hyperlist
-gem update rcurses
-```
-
-### 3. Run with debug mode to see errors:
-
-```bash
-# Set debug environment variable
-export RCURSES_DEBUG=1
-export DEBUG=1
-
-# Then run hyperlist
-hyperlist
-
-# Or run in one line:
-DEBUG=1 RCURSES_DEBUG=1 hyperlist
-```
-
-### 4. Alternative: Run with Ruby directly to see errors:
-
-```bash
-# Find where hyperlist is installed
-which hyperlist
-
-# Run it directly with Ruby to see any errors
-ruby $(which hyperlist)
-```
-
-### 5. Check Ruby version compatibility:
-
-```bash
-ruby --version
-# HyperList requires Ruby 3.0.0 or higher
-```
-
-### 6. Try running with verbose Ruby output:
-
-```bash
-ruby -w $(which hyperlist)
-```
-
-### 7. Check for missing dependencies:
-
-```bash
-# This will show if rcurses is properly installed
-ruby -e "require 'rcurses'; puts 'rcurses loaded successfully'"
-```
-
-### 8. Create a simple test file to isolate the issue:
-
-Create a file called `test_hyperlist.rb`:
-
-```ruby
-#!/usr/bin/env ruby
-
-puts "Ruby version: #{RUBY_VERSION}"
-puts "Testing rcurses..."
-
-begin
-  require 'rcurses'
-  puts "✓ rcurses loaded successfully (version from gem)"
-rescue LoadError => e
-  puts "✗ Failed to load rcurses: #{e.message}"
-  exit 1
-end
-
-puts "\nTesting basic rcurses functionality..."
-begin
-  include Rcurses
-  puts "✓ Rcurses module included"
-  puts "✓ All basic checks passed!"
-rescue => e
-  puts "✗ Error: #{e.message}"
-  exit 1
-end
-```
-
-Run it with:
-```bash
-ruby test_hyperlist.rb
-```
-
-### 9. If all else fails, capture output:
-
-```bash
-# Run with script to capture all output
-script -c "hyperlist" hyperlist_output.txt
-
-# Then send us the hyperlist_output.txt file
-```
-
-## Notes:
-- GDB won't work with Ruby scripts (it's for compiled binaries)
-- The new error handling in rcurses 5.1.4+ should show errors after terminal cleanup
-- Setting DEBUG=1 or RCURSES_DEBUG=1 will show full stack traces

data/diagnose.rb

@@ -1,115 +0,0 @@
-#!/usr/bin/env ruby
-# HyperList Diagnostic Script
-# Run this to help diagnose installation/startup issues
-
-puts "=" * 60
-puts "HyperList Diagnostic Report"
-puts "=" * 60
-
-# Check Ruby version
-puts "\n1. Ruby Version:"
-puts "   #{RUBY_VERSION} (#{RUBY_PLATFORM})"
-if RUBY_VERSION < "3.0.0"
-  puts "   ⚠️  WARNING: HyperList requires Ruby 3.0.0 or higher"
-else
-  puts "   ✓ Ruby version OK"
-end
-
-# Check gem versions
-puts "\n2. Gem Versions:"
-begin
-  hyperlist_version = `gem list hyperlist --local`.match(/hyperlist \(([\d.]+)\)/)[1] rescue "not found"
-  rcurses_version = `gem list rcurses --local`.match(/rcurses \(([\d.]+(?:,\s*[\d.]+)*)\)/)[1] rescue "not found"
-  
-  puts "   hyperlist: #{hyperlist_version}"
-  if hyperlist_version >= "1.1.3"
-    puts "   ✓ HyperList version OK"
-  else
-    puts "   ⚠️  Please update: gem update hyperlist"
-  end
-  
-  puts "   rcurses: #{rcurses_version}"
-  if rcurses_version.include?("5.1.4") || rcurses_version >= "5.1.4"
-    puts "   ✓ rcurses version OK"
-  else
-    puts "   ⚠️  Please update: gem update rcurses"
-  end
-rescue => e
-  puts "   Error checking gems: #{e.message}"
-end
-
-# Test loading rcurses
-puts "\n3. Testing rcurses load:"
-begin
-  require 'rcurses'
-  puts "   ✓ rcurses loaded successfully"
-  
-  # Check if we can access rcurses modules
-  include Rcurses
-  puts "   ✓ Rcurses modules accessible"
-rescue LoadError => e
-  puts "   ✗ Failed to load rcurses: #{e.message}"
-  puts "   Try: gem install rcurses"
-rescue => e
-  puts "   ✗ Error with rcurses: #{e.message}"
-end
-
-# Test terminal capabilities
-puts "\n4. Terminal Check:"
-puts "   TERM: #{ENV['TERM'] || 'not set'}"
-puts "   TTY: #{$stdin.tty? ? 'Yes' : 'No'}"
-puts "   Encoding: #{Encoding.default_external}"
-
-# Check for HyperList executable
-puts "\n5. HyperList Installation:"
-hyperlist_path = `which hyperlist`.strip
-if hyperlist_path.empty?
-  puts "   ✗ hyperlist command not found in PATH"
-  puts "   Try: gem install hyperlist"
-else
-  puts "   ✓ Found at: #{hyperlist_path}"
-  
-  # Check if it's executable
-  if File.executable?(hyperlist_path)
-    puts "   ✓ File is executable"
-  else
-    puts "   ⚠️  File is not executable"
-    puts "   Try: chmod +x #{hyperlist_path}"
-  end
-end
-
-# Try to load core dependencies
-puts "\n6. Core Dependencies:"
-deps = ['io/console', 'date', 'cgi', 'openssl', 'digest', 'base64']
-deps.each do |dep|
-  begin
-    require dep
-    puts "   ✓ #{dep}"
-  rescue LoadError => e
-    puts "   ✗ #{dep}: #{e.message}"
-  end
-end
-
-# Test creating a basic rcurses pane (without initializing terminal)
-puts "\n7. Testing Rcurses Pane Creation (simulation):"
-begin
-  # Don't actually initialize the terminal, just test the class exists
-  if defined?(Rcurses::Pane)
-    puts "   ✓ Rcurses::Pane class exists"
-  else
-    puts "   ✗ Rcurses::Pane class not found"
-  end
-rescue => e
-  puts "   ✗ Error: #{e.message}"
-end
-
-puts "\n" + "=" * 60
-puts "Diagnostic complete!"
-puts "=" * 60
-
-puts "\nIf everything shows ✓ but hyperlist still crashes:"
-puts "1. Run with debug mode: DEBUG=1 RCURSES_DEBUG=1 hyperlist"
-puts "2. Check for error log: cat ~/.hyperlist_error.log"
-puts "3. Try running directly: ruby #{hyperlist_path}"
-
-puts "\nPlease share this diagnostic output when reporting issues."

data/diagnose_ruby34.rb

@@ -1,145 +0,0 @@
-#!/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

@@ -1,156 +0,0 @@
-#!/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