Initial LLDB support.

Author: samuel-williams-shopify

.github/workflows/test.yaml

@@ -34,7 +34,7 @@ jobs:
       with:
         ruby-version: ${{matrix.ruby}}
         bundler-cache: true
-        apt-get: gdb
+        apt-get: gdb lldb
 
     - name: Run tests
       timeout-minutes: 10

bake/toolbox/gdb.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2025, by Samuel Williams.
+
+require "toolbox/gdb"
+require "fileutils"
+
+# Install GDB extensions by adding source line to ~/.gdbinit
+# @parameter gdbinit [String] Optional path to .gdbinit (defaults to ~/.gdbinit)
+def install(gdbinit: nil)
+	gdbinit_path = gdbinit || File.join(Dir.home, ".gdbinit")
+	init_py_path = Toolbox::GDB.init_script_path
+	source_line = "source #{init_py_path}"
+	marker_comment = "# Ruby Toolbox GDB Extensions"
+	
+	puts "Installing Ruby Toolbox GDB extensions..."
+	puts "  Extensions: #{File.dirname(init_py_path)}"
+	puts "  Config: #{gdbinit_path}"
+	
+	# Read existing .gdbinit or create empty array
+	lines = File.exist?(gdbinit_path) ? File.readlines(gdbinit_path) : []
+	
+	# Check if already installed (look for marker comment)
+	marker_index = lines.index{|line| line.strip == marker_comment}
+	
+	if marker_index
+		# Already installed - update the source line in case path changed
+		source_index = marker_index + 1
+		if source_index < lines.size && lines[source_index].strip.start_with?("source")
+			old_source = lines[source_index].strip
+			if old_source == source_line
+				puts "\n✓ Already installed in #{gdbinit_path}"
+				puts "  #{source_line}"
+				return
+			else
+				# Path changed - update it
+				lines[source_index] = "#{source_line}\n"
+				File.write(gdbinit_path, lines.join)
+				puts "\n✓ Updated installation in #{gdbinit_path}"
+				puts "  Old: #{old_source}"
+				puts "  New: #{source_line}"
+				return
+			end
+		end
+	end
+	
+	# Not installed - add it
+	File.open(gdbinit_path, "a") do |f|
+		f.puts unless lines.last&.strip&.empty?
+		f.puts marker_comment
+		f.puts source_line
+	end
+	
+	puts "\n✓ Installation complete!"
+	puts "\nAdded to #{gdbinit_path}:"
+	puts "  #{source_line}"
+	puts "\nExtensions will load automatically when you start GDB."
+end
+
+# Uninstall GDB extensions by removing source line from ~/.gdbinit
+# @parameter gdbinit [String] Optional path to .gdbinit (defaults to ~/.gdbinit)
+def uninstall(gdbinit: nil)
+	gdbinit_path = gdbinit || File.join(Dir.home, ".gdbinit")
+	marker_comment = "# Ruby Toolbox GDB Extensions"
+	
+	puts "Uninstalling Ruby Toolbox GDB extensions..."
+	
+	unless File.exist?(gdbinit_path)
+		puts "No ~/.gdbinit file found - nothing to uninstall."
+		return
+	end
+	
+	lines = File.readlines(gdbinit_path)
+	marker_index = lines.index{|line| line.strip == marker_comment}
+	
+	unless marker_index
+		puts "Extensions were not found in #{gdbinit_path}"
+		return
+	end
+	
+	# Remove the marker comment and the source line after it
+	lines.delete_at(marker_index)  # Remove comment
+	if marker_index < lines.size && lines[marker_index].strip.start_with?("source")
+		removed_line = lines.delete_at(marker_index).strip  # Remove source line
+		puts "  Removed: #{removed_line}"
+	end
+	
+	# Clean up empty line before marker if it exists
+	if marker_index > 0 && lines[marker_index - 1].strip.empty?
+		lines.delete_at(marker_index - 1)
+	end
+	
+	File.write(gdbinit_path, lines.join)
+	puts "✓ Removed Ruby Toolbox GDB extensions from #{gdbinit_path}"
+end
+
+# Show installation information
+# @parameter gdbinit [String] Optional path to .gdbinit (defaults to ~/.gdbinit)
+def info(gdbinit: nil)
+	gdbinit_path = gdbinit || File.join(Dir.home, ".gdbinit")
+	init_py_path = Toolbox::GDB.init_script_path
+	marker_comment = "# Ruby Toolbox GDB Extensions"
+	
+	puts "Ruby Toolbox GDB Extensions v#{Toolbox::VERSION}"
+	puts "\nToolbox directory: #{Toolbox::GDB.data_path}"
+	puts "Init script: #{init_py_path}"
+	puts "Note: Same init.py works for both GDB and LLDB"
+	
+	# Check installation status by looking for marker comment
+	installed = false
+	current_source = nil
+	
+	if File.exist?(gdbinit_path)
+		lines = File.readlines(gdbinit_path)
+		marker_index = lines.index{|line| line.strip == marker_comment}
+		if marker_index
+			installed = true
+			source_index = marker_index + 1
+			if source_index < lines.size
+				current_source = lines[source_index].strip
+			end
+		end
+	end
+	
+	puts "\nGDB config: #{gdbinit_path}"
+	if installed
+		puts "Status: ✓ Installed"
+		if current_source
+			puts "  #{current_source}"
+		end
+	else
+		puts "Status: ✗ Not installed"
+		puts "\nRun: bake toolbox:gdb:install"
+	end
+end
+

bake/toolbox/lldb.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2025, by Samuel Williams.
+
+require "toolbox/lldb"
+require "fileutils"
+
+# Install LLDB extensions by adding command to ~/.lldbinit
+# @parameter lldbinit [String] Optional path to .lldbinit (defaults to ~/.lldbinit)
+def install(lldbinit: nil)
+	lldbinit_path = lldbinit || File.join(Dir.home, ".lldbinit")
+	init_py_path = Toolbox::LLDB.init_script_path
+	command_line = "command script import #{init_py_path}"
+	marker_comment = "# Ruby Toolbox LLDB Extensions"
+	
+	puts "Installing Ruby Toolbox LLDB extensions..."
+	puts "  Extensions: #{File.dirname(init_py_path)}"
+	puts "  Config: #{lldbinit_path}"
+	
+	# Read existing .lldbinit or create empty array
+	lines = File.exist?(lldbinit_path) ? File.readlines(lldbinit_path) : []
+	
+	# Check if already installed (look for marker comment)
+	marker_index = lines.index{|line| line.strip == marker_comment}
+	
+	if marker_index
+		# Already installed - update the command line in case path changed
+		command_index = marker_index + 1
+		if command_index < lines.size && lines[command_index].strip.start_with?("command script import")
+			old_command = lines[command_index].strip
+			if old_command == command_line
+				puts "\n✓ Already installed in #{lldbinit_path}"
+				puts "  #{command_line}"
+				return
+			else
+				# Path changed - update it
+				lines[command_index] = "#{command_line}\n"
+				File.write(lldbinit_path, lines.join)
+				puts "\n✓ Updated installation in #{lldbinit_path}"
+				puts "  Old: #{old_command}"
+				puts "  New: #{command_line}"
+				return
+			end
+		end
+	end
+	
+	# Not installed - add it
+	File.open(lldbinit_path, "a") do |f|
+		f.puts unless lines.last&.strip&.empty?
+		f.puts marker_comment
+		f.puts command_line
+	end
+	
+	puts "\n✓ Installation complete!"
+	puts "\nAdded to #{lldbinit_path}:"
+	puts "  #{command_line}"
+	puts "\nExtensions will load automatically when you start LLDB."
+end
+
+# Uninstall LLDB extensions by removing command from ~/.lldbinit
+# @parameter lldbinit [String] Optional path to .lldbinit (defaults to ~/.lldbinit)
+def uninstall(lldbinit: nil)
+	lldbinit_path = lldbinit || File.join(Dir.home, ".lldbinit")
+	marker_comment = "# Ruby Toolbox LLDB Extensions"
+	
+	puts "Uninstalling Ruby Toolbox LLDB extensions..."
+	
+	unless File.exist?(lldbinit_path)
+		puts "No ~/.lldbinit file found - nothing to uninstall."
+		return
+	end
+	
+	lines = File.readlines(lldbinit_path)
+	marker_index = lines.index{|line| line.strip == marker_comment}
+	
+	unless marker_index
+		puts "Extensions were not found in #{lldbinit_path}"
+		return
+	end
+	
+	# Remove the marker comment and the command line after it
+	lines.delete_at(marker_index)  # Remove comment
+	if marker_index < lines.size && lines[marker_index].strip.start_with?("command script import")
+		removed_line = lines.delete_at(marker_index).strip  # Remove command line
+		puts "  Removed: #{removed_line}"
+	end
+	
+	# Clean up empty line before marker if it exists
+	if marker_index > 0 && lines[marker_index - 1].strip.empty?
+		lines.delete_at(marker_index - 1)
+	end
+	
+	File.write(lldbinit_path, lines.join)
+	puts "✓ Removed Ruby Toolbox LLDB extensions from #{lldbinit_path}"
+end
+
+# Show installation information
+# @parameter lldbinit [String] Optional path to .lldbinit (defaults to ~/.lldbinit)
+def info(lldbinit: nil)
+	lldbinit_path = lldbinit || File.join(Dir.home, ".lldbinit")
+	init_py_path = Toolbox::LLDB.init_script_path
+	marker_comment = "# Ruby Toolbox LLDB Extensions"
+	
+	puts "Ruby Toolbox LLDB Extensions v#{Toolbox::VERSION}"
+	puts "\nToolbox directory: #{Toolbox::LLDB.data_path}"
+	puts "Init script: #{init_py_path}"
+	puts "Note: Same init.py works for both GDB and LLDB"
+	
+	# Check installation status by looking for marker comment
+	installed = false
+	current_command = nil
+	
+	if File.exist?(lldbinit_path)
+		lines = File.readlines(lldbinit_path)
+		marker_index = lines.index{|line| line.strip == marker_comment}
+		if marker_index
+			installed = true
+			command_index = marker_index + 1
+			if command_index < lines.size
+				current_command = lines[command_index].strip
+			end
+		end
+	end
+	
+	puts "\nLLDB config: #{lldbinit_path}"
+	if installed
+		puts "Status: ✓ Installed"
+		if current_command
+			puts "  #{current_command}"
+		end
+	else
+		puts "Status: ✗ Not installed"
+		puts "\nRun: bake toolbox:lldb:install"
+	end
+end
+