¿Qué es mattr_accessor en un módulo Rails?

Realmente no pude encontrar esto en la documentación de Rails, pero parece que 'mattr_accessor' es el corolario del módulo para 'attr_accessor' (getter & setter) en una clase Ruby normal .

P.ej. en una clase

class User
  attr_accessor :name

  def set_fullname
    @name = "#{self.first_name} #{self.last_name}"
  end
end

P.ej. en un módulo

module Authentication
  mattr_accessor :current_user

  def login
    @current_user = session[:user_id] || nil
  end
end

Este método auxiliar lo proporciona ActiveSupport .

Rails extiende Ruby tanto con mattr_accessor(Módulo de acceso) como cattr_accessor(así como con _ reader/ _writerversiones). Como Ruby attr_accessorgenera métodos getter / setter para instancias , cattr/mattr_accessorproporcione métodos getter / setter a nivel de clase o módulo . Así:

module Config
  mattr_accessor :hostname
  mattr_accessor :admin_email
end

es la abreviatura de:

module Config
  def self.hostname
    @hostname
  end
  def self.hostname=(hostname)
    @hostname = hostname
  end
  def self.admin_email
    @admin_email
  end
  def self.admin_email=(admin_email)
    @admin_email = admin_email
  end
end

Ambas versiones le permiten acceder a las variables de nivel de módulo de esta manera:

>> Config.hostname = "example.com"
>> Config.admin_email = "admin@example.com"
>> Config.hostname # => "example.com"
>> Config.admin_email # => "admin@example.com"

Aquí está la fuente de cattr_accessor

Y

Aquí está la fuente de mattr_accessor

Como puede ver, son prácticamente idénticos.

¿Por qué hay dos versiones diferentes? A veces, desea escribir cattr_accessoren un módulo, por lo que puede usarlo para información de configuración como menciona Avdi .
Sin embargo, cattr_accessorno funciona en un módulo, por lo que más o menos copiaron el código para que funcione también con los módulos.

Además, a veces es posible que desee escribir un método de clase en un módulo, de modo que siempre que una clase incluya el módulo, obtenga ese método de clase, así como todos los métodos de instancia. mattr_accessortambién te permite hacer esto.

Sin embargo, en el segundo escenario, su comportamiento es bastante extraño. Observe el siguiente código, particularmente tenga en cuenta los @@mattr_in_modulebits

module MyModule
  mattr_accessor :mattr_in_module
end

class MyClass
  include MyModule
  def self.get_mattr; @@mattr_in_module; end # directly access the class variable
end

MyModule.mattr_in_module = 'foo' # set it on the module
=> "foo"

MyClass.get_mattr # get it out of the class
=> "foo"

class SecondClass
  include MyModule
  def self.get_mattr; @@mattr_in_module; end # again directly access the class variable in a different class
end

SecondClass.get_mattr # get it out of the OTHER class
=> "foo"