method
mattr_reader
![Moderate documentation Importance_2](https://d2vfyqvduarcvs.cloudfront.net/images/importance_2.png?1349367920)
mattr_reader(*syms)
public
Defines a class attribute and creates a class and instance reader methods. The underlying class variable is set to nil, if it is not previously defined.
module HairColors mattr_reader :hair_colors end HairColors.hair_colors # => nil HairColors.class_variable_set("@@hair_colors", [:brown, :black]) HairColors.hair_colors # => [:brown, :black]
The attribute name must be a valid method name in Ruby.
module Foo mattr_reader :"1_Badname" end # => NameError: invalid attribute name: 1_Badname
If you want to opt out the creation on the instance reader method, pass instance_reader: false or instance_accessor: false.
module HairColors mattr_reader :hair_colors, instance_reader: false end class Person include HairColors end Person.new.hair_colors # => NoMethodError
Also, you can pass a block to set up the attribute with a default value.
module HairColors mattr_reader :hair_colors do [:brown, :black, :blonde, :red] end end class Person include HairColors end Person.new.hair_colors # => [:brown, :black, :blonde, :red]