module Rooibos::Message::Predicates

Fallback predicate mixin.

Update functions receive many message types. Checking unknown predicates crashes with NoMethodError. Verifying every predicate clutters the code.

This mixin returns false for unknown predicates. It also adds symbol comparison via to_sym and ==.

Include in custom message types for safe predicate calls and symbol matching.

Public Instance Methods

== (other)

Source

# File lib/rooibos/message.rb, line 64
def ==(other)
  case other
  when Symbol then to_sym == other
  else super
  end
end

Compares the message with another object.

Symbols compare against to_sym. Other objects use default equality.

Example

if message == :message_timer
  handle_tick(message)
end

Calls superclass method

deconstruct_keys (keys)

Source

# File lib/rooibos/message.rb, line 98
def deconstruct_keys(keys)
  class_name = self.class.name&.split("::")&.last
  type_name = if class_name
    class_name.gsub(/([a-z])([A-Z])/, '\1_\2').downcase.to_sym
  else
    :custom
  end

  # Filter out :type before calling super — Data returns {} if any
  # requested key is unknown, which breaks pattern matching
  filtered_keys = keys&.reject { |k| k == :type }

  # Preserve parent's fields (e.g., Data.define members) and add :type
  parent_keys = begin
    super(filtered_keys)
  rescue NoMethodError
    {} #: Hash[Symbol, untyped]
  end
  parent_keys.merge(type: type_name)
end

Fallback pattern matching for classes without explicit deconstruct_keys.

Derives :type from the class name in snake_case. Anonymous classes default to :custom.

Example

class MyCustomMessage
  include Rooibos::Message::Predicates
end

msg = MyCustomMessage.new
msg.deconstruct_keys(nil) # => { type: :my_custom_message }
msg.to_sym                # => :message_my_custom_message

Calls superclass method

method_missing (name, *args, **kwargs, &block)

Source

# File lib/rooibos/message.rb, line 74
def method_missing(name, *args, **kwargs, &block)
  if name.to_s.end_with?("?") && args.empty? && kwargs.empty?
    predicate = name.to_s.chomp("?").to_sym
    keys = deconstruct_keys(nil)
    keys[:type] == predicate || keys[:envelope] == predicate
  else
    super
  end
end

Returns true if predicate matches :type or :envelope from deconstruct_keys. Returns false for unknown predicate methods.

Calls superclass method

respond_to_missing? (name, *)

Source

# File lib/rooibos/message.rb, line 120
def respond_to_missing?(name, *)
  name.to_s.end_with?("?")
end

Responds to all predicate methods.

to_sym ()

Source

# File lib/rooibos/message.rb, line 51
def to_sym
  :"message_#{deconstruct_keys(nil)[:type]}"
end

Converts the message to a Symbol.

Returns the :type value from deconstruct_keys prefixed with message_. The prefix avoids collision with RatatuiRuby event symbols like :resize or :mouse.

Example

timer = Message::Timer.new(envelope: :tick, elapsed: 0.016)
timer.to_sym # => :message_timer