lldb 0.1.0

data/lib/lldb/breakpoint_location.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+# rbs_inline: enabled
+
+module LLDB
+  class BreakpointLocation
+    # @rbs return: Breakpoint
+    attr_reader :breakpoint
+
+    # @rbs ptr: FFI::Pointer
+    # @rbs breakpoint: Breakpoint
+    # @rbs return: void
+    def initialize(ptr, breakpoint:)
+      @ptr = ptr # : FFI::Pointer
+      @breakpoint = breakpoint
+      ObjectSpace.define_finalizer(self, self.class.release(@ptr))
+    end
+
+    # @rbs ptr: FFI::Pointer
+    # @rbs return: ^(Integer) -> void
+    def self.release(ptr)
+      ->(_id) { FFIBindings.lldb_breakpoint_location_destroy(ptr) unless ptr.null? }
+    end
+
+    # @rbs return: bool
+    def valid?
+      !@ptr.null? && FFIBindings.lldb_breakpoint_location_is_valid(@ptr) != 0
+    end
+
+    # @rbs return: Integer
+    def id
+      return -1 unless valid?
+
+      FFIBindings.lldb_breakpoint_location_get_id(@ptr)
+    end
+
+    # @rbs return: Integer
+    def load_address
+      return 0 unless valid?
+
+      FFIBindings.lldb_breakpoint_location_get_load_address(@ptr)
+    end
+
+    # @rbs return: bool
+    def enabled?
+      return false unless valid?
+
+      FFIBindings.lldb_breakpoint_location_is_enabled(@ptr) != 0
+    end
+
+    # @rbs value: bool
+    # @rbs return: void
+    def enabled=(value)
+      raise InvalidObjectError, 'BreakpointLocation is not valid' unless valid?
+
+      FFIBindings.lldb_breakpoint_location_set_enabled(@ptr, value ? 1 : 0)
+    end
+
+    # @rbs return: void
+    def enable
+      self.enabled = true
+    end
+
+    # @rbs return: void
+    def disable
+      self.enabled = false
+    end
+
+    # @rbs return: Integer
+    def hit_count
+      return 0 unless valid?
+
+      FFIBindings.lldb_breakpoint_location_get_hit_count(@ptr)
+    end
+
+    # @rbs return: Integer
+    def ignore_count
+      return 0 unless valid?
+
+      FFIBindings.lldb_breakpoint_location_get_ignore_count(@ptr)
+    end
+
+    # @rbs count: Integer
+    # @rbs return: void
+    def ignore_count=(count)
+      raise InvalidObjectError, 'BreakpointLocation is not valid' unless valid?
+
+      FFIBindings.lldb_breakpoint_location_set_ignore_count(@ptr, count)
+    end
+
+    # @rbs return: String?
+    def condition
+      return nil unless valid?
+
+      cond = FFIBindings.lldb_breakpoint_location_get_condition(@ptr)
+      cond.nil? || cond.empty? ? nil : cond
+    end
+
+    # @rbs expr: String?
+    # @rbs return: void
+    def condition=(expr)
+      raise InvalidObjectError, 'BreakpointLocation is not valid' unless valid?
+
+      FFIBindings.lldb_breakpoint_location_set_condition(@ptr, expr)
+    end
+
+    # @rbs return: String
+    def to_s
+      "BreakpointLocation #{id}: address=0x#{load_address.to_s(16)}, enabled=#{enabled?}"
+    end
+
+    # @rbs return: FFI::Pointer
+    def to_ptr
+      @ptr
+    end
+  end
+end

data/lib/lldb/command_interpreter.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+# rbs_inline: enabled
+
+module LLDB
+  class CommandInterpreter
+    # @rbs return: Debugger
+    attr_reader :debugger
+
+    # @rbs ptr: FFI::Pointer
+    # @rbs debugger: Debugger
+    # @rbs return: void
+    def initialize(ptr, debugger:)
+      @ptr = ptr # : FFI::Pointer
+      @debugger = debugger
+      ObjectSpace.define_finalizer(self, self.class.release(@ptr))
+    end
+
+    # @rbs ptr: FFI::Pointer
+    # @rbs return: ^(Integer) -> void
+    def self.release(ptr)
+      ->(_id) { FFIBindings.lldb_command_interpreter_destroy(ptr) unless ptr.null? }
+    end
+
+    # @rbs return: bool
+    def valid?
+      !@ptr.null? && FFIBindings.lldb_command_interpreter_is_valid(@ptr) != 0
+    end
+
+    # @rbs command: String
+    # @rbs add_to_history: bool
+    # @rbs return: CommandReturnObject
+    def handle_command(command, add_to_history: true)
+      raise InvalidObjectError, 'CommandInterpreter is not valid' unless valid?
+
+      result = CommandReturnObject.create
+      FFIBindings.lldb_command_interpreter_handle_command(@ptr, command, result.to_ptr, add_to_history ? 1 : 0)
+      result
+    end
+
+    # @rbs command: String
+    # @rbs return: bool
+    def command_exists?(command)
+      return false unless valid?
+
+      FFIBindings.lldb_command_interpreter_command_exists(@ptr, command) != 0
+    end
+
+    # @rbs alias_name: String
+    # @rbs return: bool
+    def alias_exists?(alias_name)
+      return false unless valid?
+
+      FFIBindings.lldb_command_interpreter_alias_exists(@ptr, alias_name) != 0
+    end
+
+    # @rbs return: FFI::Pointer
+    def to_ptr
+      @ptr
+    end
+  end
+end

data/lib/lldb/command_return_object.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# rbs_inline: enabled
+
+module LLDB
+  class CommandReturnObject
+    # @rbs return: CommandReturnObject
+    def self.create
+      ptr = FFIBindings.lldb_command_return_object_create
+      raise LLDBError, 'Failed to create command return object' if ptr.nil? || ptr.null?
+
+      new(ptr)
+    end
+
+    # @rbs ptr: FFI::Pointer
+    # @rbs return: void
+    def initialize(ptr)
+      @ptr = ptr # : FFI::Pointer
+      ObjectSpace.define_finalizer(self, self.class.release(@ptr))
+    end
+
+    # @rbs ptr: FFI::Pointer
+    # @rbs return: ^(Integer) -> void
+    def self.release(ptr)
+      ->(_id) { FFIBindings.lldb_command_return_object_destroy(ptr) unless ptr.null? }
+    end
+
+    # @rbs return: bool
+    def valid?
+      !@ptr.null? && FFIBindings.lldb_command_return_object_is_valid(@ptr) != 0
+    end
+
+    # @rbs return: String?
+    def output
+      return nil unless valid?
+
+      FFIBindings.lldb_command_return_object_get_output(@ptr)
+    end
+
+    # @rbs return: String?
+    def error
+      return nil unless valid?
+
+      FFIBindings.lldb_command_return_object_get_error(@ptr)
+    end
+
+    # @rbs return: bool
+    def succeeded?
+      return false unless valid?
+
+      FFIBindings.lldb_command_return_object_succeeded(@ptr) != 0
+    end
+
+    # @rbs return: void
+    def clear
+      raise InvalidObjectError, 'CommandReturnObject is not valid' unless valid?
+
+      FFIBindings.lldb_command_return_object_clear(@ptr)
+    end
+
+    # @rbs return: String
+    def to_s
+      succeeded? ? (output || '') : (error || '')
+    end
+
+    # @rbs return: FFI::Pointer
+    def to_ptr
+      @ptr
+    end
+  end
+end

data/lib/lldb/debugger.rb

@@ -0,0 +1,179 @@
+# frozen_string_literal: true
+
+# rbs_inline: enabled
+
+module LLDB
+  class Debugger
+    # @rbs return: Debugger
+    def self.create
+      LLDB.ensure_initialized!
+      ptr = FFIBindings.lldb_debugger_create
+      raise LLDBError, 'Failed to create debugger' if ptr.null?
+
+      new(ptr)
+    end
+
+    # @rbs ptr: FFI::Pointer
+    # @rbs return: void
+    def initialize(ptr)
+      @ptr = ptr # : FFI::Pointer
+      @targets = [] # : Array[Target]
+      ObjectSpace.define_finalizer(self, self.class.release(@ptr))
+    end
+
+    # @rbs ptr: FFI::Pointer
+    # @rbs return: ^(Integer) -> void
+    def self.release(ptr)
+      ->(_id) { FFIBindings.lldb_debugger_destroy(ptr) unless ptr.null? }
+    end
+
+    # @rbs return: bool
+    def valid?
+      !@ptr.null? && FFIBindings.lldb_debugger_is_valid(@ptr) != 0
+    end
+
+    # @rbs filename: String
+    # @rbs arch: String?
+    # @rbs platform: String?
+    # @rbs add_dependent_modules: bool
+    # @rbs return: Target
+    def create_target(filename, arch: nil, platform: nil, add_dependent_modules: true)
+      raise InvalidObjectError, 'Debugger is not valid' unless valid?
+
+      error = Error.new
+      target_ptr = FFIBindings.lldb_debugger_create_target(
+        @ptr,
+        filename.to_s,
+        arch&.to_s,
+        platform&.to_s,
+        add_dependent_modules ? 1 : 0,
+        error.to_ptr
+      )
+
+      error.raise_if_error!
+      raise LLDBError, "Failed to create target for '#{filename}'" if target_ptr.nil? || target_ptr.null?
+
+      target = Target.new(target_ptr, debugger: self)
+      @targets << target
+      target
+    end
+
+    # @rbs filename: String
+    # @rbs return: Target
+    def create_target_simple(filename)
+      raise InvalidObjectError, 'Debugger is not valid' unless valid?
+
+      target_ptr = FFIBindings.lldb_debugger_create_target_simple(@ptr, filename.to_s)
+      raise LLDBError, "Failed to create target for '#{filename}'" if target_ptr.nil? || target_ptr.null?
+
+      target = Target.new(target_ptr, debugger: self)
+      @targets << target
+      target
+    end
+
+    # @rbs return: Integer
+    def num_targets
+      return 0 unless valid?
+
+      FFIBindings.lldb_debugger_get_num_targets(@ptr)
+    end
+
+    # @rbs index: Integer
+    # @rbs return: Target?
+    def target_at_index(index)
+      raise InvalidObjectError, 'Debugger is not valid' unless valid?
+
+      target_ptr = FFIBindings.lldb_debugger_get_target_at_index(@ptr, index)
+      return nil if target_ptr.nil? || target_ptr.null?
+
+      Target.new(target_ptr, debugger: self)
+    end
+
+    # @rbs return: Target?
+    def selected_target
+      raise InvalidObjectError, 'Debugger is not valid' unless valid?
+
+      target_ptr = FFIBindings.lldb_debugger_get_selected_target(@ptr)
+      return nil if target_ptr.nil? || target_ptr.null?
+
+      Target.new(target_ptr, debugger: self)
+    end
+
+    # @rbs return: Array[Target]
+    def targets
+      (0...num_targets).map { |i| target_at_index(i) }.compact
+    end
+
+    # @rbs return: bool
+    def async?
+      return false unless valid?
+
+      FFIBindings.lldb_debugger_get_async(@ptr) != 0
+    end
+
+    # @rbs value: bool
+    # @rbs return: void
+    def async=(value)
+      raise InvalidObjectError, 'Debugger is not valid' unless valid?
+
+      FFIBindings.lldb_debugger_set_async(@ptr, value ? 1 : 0)
+    end
+
+    # @rbs target: Target
+    # @rbs return: void
+    def selected_target=(target)
+      raise InvalidObjectError, 'Debugger is not valid' unless valid?
+
+      FFIBindings.lldb_debugger_set_selected_target(@ptr, target.to_ptr)
+    end
+
+    # @rbs target: Target
+    # @rbs return: bool
+    def delete_target(target)
+      raise InvalidObjectError, 'Debugger is not valid' unless valid?
+
+      result = FFIBindings.lldb_debugger_delete_target(@ptr, target.to_ptr) != 0
+      @targets.delete(target) if result
+      result
+    end
+
+    # @rbs pid: Integer
+    # @rbs return: Target?
+    def find_target_with_process_id(pid)
+      raise InvalidObjectError, 'Debugger is not valid' unless valid?
+
+      target_ptr = FFIBindings.lldb_debugger_find_target_with_process_id(@ptr, pid)
+      return nil if target_ptr.nil? || target_ptr.null?
+
+      Target.new(target_ptr, debugger: self)
+    end
+
+    # @rbs return: String?
+    def self.version_string
+      FFIBindings.lldb_debugger_get_version_string
+    end
+
+    # @rbs return: CommandInterpreter
+    def command_interpreter
+      raise InvalidObjectError, 'Debugger is not valid' unless valid?
+
+      ci_ptr = FFIBindings.lldb_debugger_get_command_interpreter(@ptr)
+      raise LLDBError, 'Failed to get command interpreter' if ci_ptr.nil? || ci_ptr.null?
+
+      CommandInterpreter.new(ci_ptr, debugger: self)
+    end
+
+    # @rbs command: String
+    # @rbs return: void
+    def handle_command(command)
+      raise InvalidObjectError, 'Debugger is not valid' unless valid?
+
+      FFIBindings.lldb_debugger_handle_command(@ptr, command)
+    end
+
+    # @rbs return: FFI::Pointer
+    def to_ptr
+      @ptr
+    end
+  end
+end

data/lib/lldb/error.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+# rbs_inline: enabled
+
+module LLDB
+  class LLDBError < StandardError; end
+  class InvalidObjectError < LLDBError; end
+  class LaunchError < LLDBError; end
+  class AttachError < LLDBError; end
+  class BreakpointError < LLDBError; end
+  class EvaluationError < LLDBError; end
+
+  class Error
+    # @rbs ptr: FFI::Pointer?
+    # @rbs return: void
+    def initialize(ptr = nil)
+      @ptr = ptr || FFIBindings.lldb_error_create
+      ObjectSpace.define_finalizer(self, self.class.release(@ptr))
+    end
+
+    # @rbs ptr: FFI::Pointer
+    # @rbs return: ^(Integer) -> void
+    def self.release(ptr)
+      ->(_id) { FFIBindings.lldb_error_destroy(ptr) unless ptr.null? }
+    end
+
+    # @rbs return: bool
+    def success?
+      FFIBindings.lldb_error_success(@ptr) != 0
+    end
+
+    # @rbs return: bool
+    def fail?
+      FFIBindings.lldb_error_fail(@ptr) != 0
+    end
+
+    # @rbs return: String
+    def message
+      FFIBindings.lldb_error_get_cstring(@ptr) || ''
+    end
+
+    alias to_s message
+
+    # @rbs return: Integer
+    def error_code
+      FFIBindings.lldb_error_get_error(@ptr)
+    end
+
+    # @rbs return: void
+    def clear
+      FFIBindings.lldb_error_clear(@ptr)
+    end
+
+    # @rbs message: String
+    # @rbs return: void
+    def set_error(message)
+      FFIBindings.lldb_error_set_error_string(@ptr, message)
+    end
+
+    # @rbs return: FFI::Pointer
+    def to_ptr
+      @ptr
+    end
+
+    # @rbs return: void
+    def raise_if_error!
+      raise LLDBError, message if fail?
+    end
+  end
+end