lldb 0.2.0 → 0.3.0

data/lib/lldb/address.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+# rbs_inline: enabled
+
+module LLDB
+  class Address
+    prepend NativeLifecycle
+
+    # @rbs target: Target?
+    # @rbs context: Context?
+    # @rbs pointer: FFI::Pointer?
+    # @rbs return: void
+    def initialize(target: nil, context: nil, pointer: nil, load_address: nil)
+      if load_address
+        raise ArgumentError, 'target is required for a load address' unless target.is_a?(Target)
+
+        ptr = FFIBindings.lldb_address_create_from_load_address(load_address, target.to_ptr)
+      else
+        ptr = pointer || FFIBindings.lldb_address_create
+      end
+      @target = target
+      initialize_native_object(
+        ptr,
+        release: ->(released) { FFIBindings.lldb_address_destroy(released) },
+        context: context || target&.context
+      )
+    end
+
+    # @rbs ptr: FFI::Pointer
+    # @rbs target: Target?
+    # @rbs context: Context?
+    # @rbs return: Address
+    def self.from_ptr(ptr, target: nil, context: nil)
+      new(pointer: ptr, target: target, context: context)
+    end
+
+    # @rbs return: bool
+    def valid?
+      !@ptr.null? && FFIBindings.lldb_address_is_valid(@ptr) != 0
+    end
+
+    # @rbs return: Integer
+    def file_address
+      return INVALID_ADDRESS unless valid?
+
+      FFIBindings.lldb_address_get_file_address(@ptr)
+    end
+
+    # @rbs target: Target?
+    # @rbs return: Integer
+    def load_address(target: @target)
+      return INVALID_ADDRESS unless valid?
+      raise ArgumentError, 'target must be a Target' if target && !target.is_a?(Target)
+
+      target_ptr = target ? target.to_ptr : NativeHandle::NULL_POINTER
+      FFIBindings.lldb_address_get_load_address(@ptr, target_ptr)
+    end
+
+    # @rbs return: Integer
+    def offset
+      return 0 unless valid?
+
+      FFIBindings.lldb_address_get_offset(@ptr)
+    end
+
+    # @rbs return: LineEntry?
+    def line_entry
+      return nil unless valid?
+
+      ptr = FFIBindings.lldb_address_get_line_entry(@ptr)
+      return nil if ptr.nil? || ptr.null?
+
+      LineEntry.new(ptr, target: @target, context: context)
+    end
+
+    # @rbs return: FFI::Pointer
+    def to_ptr
+      @ptr
+    end
+  end
+end

data/lib/lldb/api_support.rb

@@ -6,7 +6,8 @@ module LLDB
   # Module for checking API availability across different LLDB versions
   # and lldb-ruby binding implementations.
   module APISupport
-    # Feature to FFI method mapping
+    # Legacy method-backed feature mappings are kept for compatibility. Optional
+    # LLDB APIs must be listed in CAPABILITIES instead of inferred from FFI symbols.
     FEATURES = {
       breakpoint_by_address: :lldb_target_breakpoint_create_by_address,
       breakpoint_by_regex: :lldb_target_breakpoint_create_by_regex,
@@ -23,10 +24,14 @@ module LLDB
       evaluate_expression: :lldb_frame_evaluate_expression
     }.freeze
 
+    CAPABILITIES = {
+      watchpoint_access_kind: :watchpoint_access_kind
+    }.freeze
+
     class << self
       # Check if a specific FFI method is available
       #
-      # @rbs method_name: Symbol
+    # @rbs method_name: ::Symbol
       # @rbs return: bool
       def method_available?(method_name)
         FFIBindings.respond_to?(method_name)
@@ -34,7 +39,7 @@ module LLDB
 
       # Raise UnsupportedAPIError if the required method is not available
       #
-      # @rbs method_name: Symbol
+    # @rbs method_name: ::Symbol
       # @rbs feature_name: String?
       # @rbs return: void
       def require_method!(method_name, feature_name = nil)
@@ -45,11 +50,23 @@ module LLDB
               "API '#{feature}' is not supported in this LLDB version or binding"
       end
 
+    # @rbs feature: ::Symbol
+      # @rbs return: void
+      def require_feature!(feature)
+        return if feature_supported?(feature)
+
+        raise UnsupportedAPIError,
+              "Feature '#{feature}' is not supported by the loaded LLDB wrapper"
+      end
+
       # Check if a feature is supported
       #
-      # @rbs feature: Symbol
+    # @rbs feature: ::Symbol
       # @rbs return: bool
       def feature_supported?(feature)
+        capability = CAPABILITIES[feature]
+        return FFIBindings.capability_supported?(capability) if capability
+
         method_name = FEATURES[feature]
         return false unless method_name
 
@@ -58,14 +75,14 @@ module LLDB
 
       # Get list of all supported features
       #
-      # @rbs return: Array[Symbol]
+    # @rbs return: Array[::Symbol]
       def supported_features
         FEATURES.keys.select { |f| feature_supported?(f) }
       end
 
       # Get list of all unsupported features
       #
-      # @rbs return: Array[Symbol]
+    # @rbs return: Array[::Symbol]
       def unsupported_features
         FEATURES.keys.reject { |f| feature_supported?(f) }
       end

data/lib/lldb/attach_info.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+# rbs_inline: enabled
+
+module LLDB
+  class AttachInfo
+    prepend NativeLifecycle
+
+    # @rbs pid: Integer?
+    # @rbs context: Context?
+    # @rbs return: void
+    def initialize(pid = nil, context: nil)
+      ptr = FFIBindings.lldb_attach_info_create(pid || 0)
+      initialize_native_object(
+        ptr,
+        release: ->(released) { FFIBindings.lldb_attach_info_destroy(released) },
+        context: context
+      )
+    end
+
+    # @rbs return: bool
+    def valid?
+      !@ptr.null?
+    end
+
+    # @rbs return: Integer
+    def process_id
+      FFIBindings.lldb_attach_info_get_process_id(@ptr)
+    end
+
+    alias pid process_id
+
+    # @rbs value: Integer
+    # @rbs return: void
+    def process_id=(value)
+      FFIBindings.lldb_attach_info_set_process_id(@ptr, value)
+    end
+
+    alias pid= process_id=
+
+    # @rbs path: String
+    # @rbs return: void
+    def executable=(path)
+      NativeStringArray.validate!(path)
+      FFIBindings.lldb_attach_info_set_executable(@ptr, path)
+    end
+
+    # @rbs file: FileSpec
+    # @rbs return: void
+    def executable_file=(file)
+      raise ArgumentError, 'file must be a FileSpec' unless file.is_a?(FileSpec)
+
+      FFIBindings.lldb_attach_info_set_executable_file(@ptr, file.to_ptr)
+    end
+
+    # @rbs return: bool
+    def wait_for_launch?
+      FFIBindings.lldb_attach_info_get_wait_for_launch(@ptr) != 0
+    end
+
+    # @rbs value: bool
+    # @rbs return: void
+    def wait_for_launch=(value)
+      FFIBindings.lldb_attach_info_set_wait_for_launch(@ptr, value ? 1 : 0)
+    end
+
+    # @rbs return: bool
+    def ignore_existing?
+      FFIBindings.lldb_attach_info_get_ignore_existing(@ptr) != 0
+    end
+
+    # @rbs value: bool
+    # @rbs return: void
+    def ignore_existing=(value)
+      FFIBindings.lldb_attach_info_set_ignore_existing(@ptr, value ? 1 : 0)
+    end
+
+    # @rbs return: Integer
+    def resume_count
+      FFIBindings.lldb_attach_info_get_resume_count(@ptr)
+    end
+
+    # @rbs value: Integer
+    # @rbs return: void
+    def resume_count=(value)
+      FFIBindings.lldb_attach_info_set_resume_count(@ptr, value)
+    end
+
+    # @rbs return: String?
+    def process_plugin_name
+      FFIBindings.lldb_attach_info_get_process_plugin_name(@ptr)
+    end
+
+    # @rbs value: String
+    # @rbs return: void
+    def process_plugin_name=(value)
+      NativeStringArray.validate!(value)
+      FFIBindings.lldb_attach_info_set_process_plugin_name(@ptr, value)
+    end
+
+    # @rbs return: Listener?
+    def listener
+      listener_ptr = FFIBindings.lldb_attach_info_get_listener(@ptr)
+      return nil if listener_ptr.nil? || listener_ptr.null?
+
+      Listener.from_ptr(listener_ptr, context: context)
+    end
+
+    # @rbs value: Listener
+    # @rbs return: void
+    def listener=(value)
+      raise ArgumentError, 'listener must be a Listener' unless value.is_a?(Listener)
+
+      FFIBindings.lldb_attach_info_set_listener(@ptr, value.to_ptr)
+    end
+
+    # @rbs return: FFI::Pointer
+    def to_ptr
+      @ptr
+    end
+  end
+end

data/lib/lldb/block.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+# rbs_inline: enabled
+
+module LLDB
+  class Block
+    prepend NativeLifecycle
+
+    # @rbs target: Target?
+    # @rbs context: Context?
+    # @rbs return: void
+    def initialize(ptr, target: nil, context: nil)
+      @target = target
+      initialize_native_object(
+        ptr,
+        release: ->(released) { FFIBindings.lldb_block_destroy(released) },
+        context: context || target&.context
+      )
+    end
+
+    # @rbs return: bool
+    def valid?
+      !@ptr.null? && FFIBindings.lldb_block_is_valid(@ptr) != 0
+    end
+
+    # @rbs return: String?
+    def inlined_name
+      return nil unless valid?
+
+      FFIBindings.lldb_block_get_inlined_name(@ptr)
+    end
+
+    # @rbs return: FileSpec?
+    def inlined_call_site_file
+      return nil unless valid?
+
+      ptr = FFIBindings.lldb_block_get_inlined_call_site_file(@ptr)
+      return nil if ptr.nil? || ptr.null?
+
+      FileSpec.from_ptr(ptr, context: context)
+    end
+
+    # @rbs return: Integer
+    def inlined_call_site_line
+      return INVALID_LINE_NUMBER unless valid?
+
+      FFIBindings.lldb_block_get_inlined_call_site_line(@ptr)
+    end
+
+    # @rbs return: Integer
+    def inlined_call_site_column
+      return 0 unless valid?
+
+      FFIBindings.lldb_block_get_inlined_call_site_column(@ptr)
+    end
+
+    # @rbs return: Block?
+    def parent
+      child_block(:lldb_block_get_parent)
+    end
+
+    # @rbs return: Block?
+    def sibling
+      child_block(:lldb_block_get_sibling)
+    end
+
+    # @rbs return: Block?
+    def first_child
+      child_block(:lldb_block_get_first_child)
+    end
+
+    # @rbs return: Integer
+    def num_ranges
+      return 0 unless valid?
+
+      FFIBindings.lldb_block_get_num_ranges(@ptr)
+    end
+
+    # @rbs index: Integer
+    # @rbs return: Address?
+    def range_start_address(index)
+      range_address(:lldb_block_get_range_start_address, index)
+    end
+
+    # @rbs index: Integer
+    # @rbs return: Address?
+    def range_end_address(index)
+      range_address(:lldb_block_get_range_end_address, index)
+    end
+
+    # @rbs return: FFI::Pointer
+    def to_ptr
+      @ptr
+    end
+
+    private
+
+    # @rbs method_name: ::Symbol
+    # @rbs return: Block?
+    def child_block(method_name)
+      return nil unless valid?
+
+      ptr = FFIBindings.public_send(method_name, @ptr)
+      return nil if ptr.nil? || ptr.null?
+
+      Block.new(ptr, target: @target, context: context)
+    end
+
+    # @rbs method_name: ::Symbol
+    # @rbs index: Integer
+    # @rbs return: Address?
+    def range_address(method_name, index)
+      return nil unless valid?
+
+      ptr = FFIBindings.public_send(method_name, @ptr, index)
+      return nil if ptr.nil? || ptr.null?
+
+      Address.from_ptr(ptr, target: @target, context: context)
+    end
+  end
+end

data/lib/lldb/breakpoint.rb

@@ -4,16 +4,21 @@
 
 module LLDB
   class Breakpoint
+    prepend NativeLifecycle
+
     # @rbs return: Target
     attr_reader :target
 
     # @rbs ptr: FFI::Pointer
     # @rbs target: Target
     # @rbs return: void
-    def initialize(ptr, target:)
-      @ptr = ptr # : FFI::Pointer
+    def initialize(ptr, target:, context: target.context)
       @target = target
-      ObjectSpace.define_finalizer(self, self.class.release(@ptr))
+      initialize_native_object(
+        ptr,
+        release: ->(released) { FFIBindings.lldb_breakpoint_destroy(released) },
+        context: context
+      )
     end
 
     # @rbs ptr: FFI::Pointer
@@ -29,7 +34,7 @@ module LLDB
 
     # @rbs return: Integer
     def id
-      return -1 unless valid?
+      return INVALID_BREAK_ID unless valid?
 
       FFIBindings.lldb_breakpoint_get_id(@ptr)
     end
@@ -139,7 +144,7 @@ module LLDB
       loc_ptr = FFIBindings.lldb_breakpoint_get_location_at_index(@ptr, index)
       return nil if loc_ptr.nil? || loc_ptr.null?
 
-      BreakpointLocation.new(loc_ptr, breakpoint: self)
+      BreakpointLocation.new(loc_ptr, breakpoint: self, context: context)
     end
 
     # @rbs location_id: Integer
@@ -150,7 +155,7 @@ module LLDB
       loc_ptr = FFIBindings.lldb_breakpoint_find_location_by_id(@ptr, location_id)
       return nil if loc_ptr.nil? || loc_ptr.null?
 
-      BreakpointLocation.new(loc_ptr, breakpoint: self)
+      BreakpointLocation.new(loc_ptr, breakpoint: self, context: context)
     end
 
     # @rbs return: Array[BreakpointLocation]

data/lib/lldb/breakpoint_location.rb

@@ -4,16 +4,21 @@
 
 module LLDB
   class BreakpointLocation
+    prepend NativeLifecycle
+
     # @rbs return: Breakpoint
     attr_reader :breakpoint
 
     # @rbs ptr: FFI::Pointer
     # @rbs breakpoint: Breakpoint
     # @rbs return: void
-    def initialize(ptr, breakpoint:)
-      @ptr = ptr # : FFI::Pointer
+    def initialize(ptr, breakpoint:, context: breakpoint.context)
       @breakpoint = breakpoint
-      ObjectSpace.define_finalizer(self, self.class.release(@ptr))
+      initialize_native_object(
+        ptr,
+        release: ->(released) { FFIBindings.lldb_breakpoint_location_destroy(released) },
+        context: context
+      )
     end
 
     # @rbs ptr: FFI::Pointer
@@ -29,18 +34,28 @@ module LLDB
 
     # @rbs return: Integer
     def id
-      return -1 unless valid?
+      return INVALID_BREAK_ID unless valid?
 
       FFIBindings.lldb_breakpoint_location_get_id(@ptr)
     end
 
     # @rbs return: Integer
     def load_address
-      return 0 unless valid?
+      return INVALID_ADDRESS unless valid?
 
       FFIBindings.lldb_breakpoint_location_get_load_address(@ptr)
     end
 
+    # @rbs return: Address?
+    def address
+      return nil unless valid?
+
+      address_ptr = FFIBindings.lldb_breakpoint_location_get_address(@ptr)
+      return nil if address_ptr.nil? || address_ptr.null?
+
+      Address.from_ptr(address_ptr, target: @breakpoint.target, context: context)
+    end
+
     # @rbs return: bool
     def enabled?
       return false unless valid?

data/lib/lldb/broadcaster.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+# rbs_inline: enabled
+
+module LLDB
+  class Broadcaster
+    prepend NativeLifecycle
+
+    # @rbs name: String?
+    # @rbs context: Context?
+    # @rbs pointer: FFI::Pointer?
+    # @rbs return: void
+    def initialize(name = nil, context: nil, pointer: nil)
+      ptr = pointer || FFIBindings.lldb_broadcaster_create(name)
+      initialize_native_object(
+        ptr,
+        release: ->(released) { FFIBindings.lldb_broadcaster_destroy(released) },
+        context: context
+      )
+    end
+
+    # @rbs ptr: FFI::Pointer
+    # @rbs context: Context?
+    # @rbs return: Broadcaster
+    def self.from_ptr(ptr, context: nil)
+      new(context: context, pointer: ptr)
+    end
+
+    # @rbs return: bool
+    def valid?
+      !@ptr.null? && FFIBindings.lldb_broadcaster_is_valid(@ptr) != 0
+    end
+
+    # @rbs return: String?
+    def name
+      return nil unless valid?
+
+      FFIBindings.lldb_broadcaster_get_name(@ptr)
+    end
+
+    # @rbs listener: Listener
+    # @rbs event_mask: Integer
+    # @rbs return: Integer
+    def add_listener(listener, event_mask)
+      ensure_open!
+      FFIBindings.lldb_broadcaster_add_listener(@ptr, listener.to_ptr, event_mask)
+    end
+
+    # @rbs listener: Listener
+    # @rbs event_mask: Integer
+    # @rbs return: bool
+    def remove_listener(listener, event_mask = (1 << 32) - 1)
+      ensure_open!
+      FFIBindings.lldb_broadcaster_remove_listener(@ptr, listener.to_ptr, event_mask) != 0
+    end
+
+    # @rbs event_type: Integer
+    # @rbs return: bool
+    def event_type_has_listeners?(event_type)
+      return false unless valid?
+
+      FFIBindings.lldb_broadcaster_event_type_has_listeners(@ptr, event_type) != 0
+    end
+
+    # @rbs event_type: Integer
+    # @rbs unique: bool
+    # @rbs return: void
+    def broadcast_event_by_type(event_type, unique: false)
+      ensure_open!
+      FFIBindings.lldb_broadcaster_broadcast_event_by_type(@ptr, event_type, unique ? 1 : 0)
+      nil
+    end
+
+    # @rbs return: FFI::Pointer
+    def to_ptr
+      @ptr
+    end
+  end
+end

data/lib/lldb/command_interpreter.rb

@@ -4,16 +4,21 @@
 
 module LLDB
   class CommandInterpreter
+    prepend NativeLifecycle
+
     # @rbs return: Debugger
     attr_reader :debugger
 
     # @rbs ptr: FFI::Pointer
     # @rbs debugger: Debugger
     # @rbs return: void
-    def initialize(ptr, debugger:)
-      @ptr = ptr # : FFI::Pointer
+    def initialize(ptr, debugger:, context: debugger.context)
       @debugger = debugger
-      ObjectSpace.define_finalizer(self, self.class.release(@ptr))
+      initialize_native_object(
+        ptr,
+        release: ->(released) { FFIBindings.lldb_command_interpreter_destroy(released) },
+        context: context
+      )
     end
 
     # @rbs ptr: FFI::Pointer
@@ -33,7 +38,7 @@ module LLDB
     def handle_command(command, add_to_history: true)
       raise InvalidObjectError, 'CommandInterpreter is not valid' unless valid?
 
-      result = CommandReturnObject.create
+      result = CommandReturnObject.create(context: context)
       FFIBindings.lldb_command_interpreter_handle_command(@ptr, command, result.to_ptr, add_to_history ? 1 : 0)
       result
     end

data/lib/lldb/command_return_object.rb

@@ -4,19 +4,23 @@
 
 module LLDB
   class CommandReturnObject
+    prepend NativeLifecycle
     # @rbs return: CommandReturnObject
-    def self.create
+    def self.create(context: nil)
       ptr = FFIBindings.lldb_command_return_object_create
       raise LLDBError, 'Failed to create command return object' if ptr.nil? || ptr.null?
 
-      new(ptr)
+      new(ptr, context: context)
     end
 
     # @rbs ptr: FFI::Pointer
     # @rbs return: void
-    def initialize(ptr)
-      @ptr = ptr # : FFI::Pointer
-      ObjectSpace.define_finalizer(self, self.class.release(@ptr))
+    def initialize(ptr, context: nil)
+      initialize_native_object(
+        ptr,
+        release: ->(released) { FFIBindings.lldb_command_return_object_destroy(released) },
+        context: context
+      )
     end
 
     # @rbs ptr: FFI::Pointer
@@ -44,6 +48,14 @@ module LLDB
       FFIBindings.lldb_command_return_object_get_error(@ptr)
     end
 
+    # @rbs return: Integer
+    # @rbs return: Integer
+    def status
+      return ReturnStatus::INVALID unless valid?
+
+      FFIBindings.lldb_command_return_object_get_status(@ptr)
+    end
+
     # @rbs return: bool
     def succeeded?
       return false unless valid?
@@ -51,6 +63,13 @@ module LLDB
       FFIBindings.lldb_command_return_object_succeeded(@ptr) != 0
     end
 
+    # @rbs return: bool
+    def has_result?
+      return false unless valid?
+
+      FFIBindings.lldb_command_return_object_has_result(@ptr) != 0
+    end
+
     # @rbs return: void
     def clear
       raise InvalidObjectError, 'CommandReturnObject is not valid' unless valid?