Ruby: include, extend, prepend и refine — кто ты из модулей?

Ruby предлагает мощные инструменты для расширения функциональности через модули — от классических include и extend до гибкого prepend и локальных патчей с refine. В этой статье разберёмся, как правильно использовать эти механизмы в Rails-приложениях, избегая типичных ошибок и подводных камней при работе с цепочкой наследования.

🧩 include: добавляем методы как instance-методы

module Speak
  def hello
    "Привет!"
  end
end

class Human
  include Speak
end

puts Human.new.hello # => Привет!

include подключает методы как экземплярные. То есть Speak#hello станет доступен у Human.new.

🧠 extend: добавляем методы как методы самого объекта

module Meta
  def version
    "1.0"
  end
end

class App
  extend Meta
end

puts App.version # => 1.0

extend подключает методы как методы самого объекта. В данном случае — класса App.

🔄 prepend: магическое include слева

module Loud
  def hello
    "ЭТО ПЕРЕПРЕД!"
  end
end

class Robot
  prepend Loud
  def hello
    "Привет от робота"
  end
end

puts Robot.new.hello # => ЭТО ПЕРЕПРЕД!

prepend вставляет модуль перед классом в цепочке ancestors.

puts Robot.ancestors
# => [Loud, Robot, Object, Kernel, BasicObject]

🗺️ Где include, где extend?

🤯 using и refine — локальные патчи

Иногда хочется переопределить методы существующих классов, но не глобально. Вот тогда — refine.

module Shout
  refine String do
    def shout
      upcase + "!!!"
    end
  end
end

using Shout

puts "ruby".shout # => RUBY!!!

За пределами области using метода shout не существует.

🔥 Пример подвоха на собеседовании

module M
  def greet
    "hello from M"
  end
end

class A
  include M
end

class B
  extend M
end

puts A.new.greet    # => ?
puts B.greet        # => ?

Ответ:

• A.new.greet — работает (instance method)
• B.greet — работает (class method)
• A.greet — 💥 NoMethodError
• B.new.greet — 💥 NoMethodError

❗ Совет на прод

Если ты пишешь модуль:

• include — для поведения экземпляров
• extend self — для модульных функций
• prepend — когда нужен hook или override
• refine — когда нельзя ломать глобально, но очень хочется

🔚 Вывод: Ruby даёт много способов добавить поведение, но всё зависит от того, куда ты вставляешь модуль, и для кого: объекта, экземпляра или всего класса.