Class: Module

Inherits:
Object show all
Includes:
ActiveSupport::CoreExtensions::Module
Defined in:
lib/active_support/vendor/builder-2.1.2/blankslate.rb,
lib/active_support/core_ext/module.rb,
lib/active_support/core_ext/module/attribute_accessors.rb,
lib/active_support/core_ext/module/attr_accessor_with_default.rb

Overview

Extends the module object with module and instance accessors for class attributes, just like the native attr* accessors for instance attributes.

module AppConfiguration
  mattr_accessor :google_api_key
  self.google_api_key = "123456789"

  mattr_accessor :paypal_url
  self.paypal_url = "www.sandbox.paypal.com"
end

AppConfiguration.google_api_key = "overriding the api key!"

Instance Method Summary collapse

Methods included from ActiveSupport::CoreExtensions::Module

#alias_attribute, #alias_method_chain

Instance Method Details

#append_features(mod) ⇒ Object 



105
106
107
108
109
110
111
112
 
# File 'lib/active_support/vendor/builder-2.1.2/blankslate.rb', line 105

def append_features(mod)
  result = blankslate_original_append_features(mod)
  return result if mod != Object
  instance_methods.each do |name|
    BlankSlate.hide(name)
  end
  result
end

#attr_accessor_with_default(sym, default = nil, &block) ⇒ Object

Declare an attribute accessor with an initial default return value.

To give attribute :age the initial value 25:

class Person
  attr_accessor_with_default :age, 25
end

some_person.age
=> 25
some_person.age = 26
some_person.age
=> 26

To give attribute :element_name a dynamic default value, evaluated in scope of self:

attr_accessor_with_default(:element_name) { name.underscore }



21
22
23
24
25
26
27
28
29
30
 
# File 'lib/active_support/core_ext/module/attr_accessor_with_default.rb', line 21

def attr_accessor_with_default(sym, default = nil, &block)
  raise 'Default value or block required' unless !default.nil? || block
  define_method(sym, block_given? ? block : Proc.new { default })
  module_eval("    def \#{sym}=(value)\n      class << self; attr_reader :\#{sym} end\n      @\#{sym} = value\n    end\n  EVAL\nend\n", __FILE__, __LINE__)

#blankslate_original_append_features ⇒ Object 



104
 
# File 'lib/active_support/vendor/builder-2.1.2/blankslate.rb', line 104

alias blankslate_original_append_features append_features

#mattr_accessor(*syms) ⇒ Object 



54
55
56
57
 
# File 'lib/active_support/core_ext/module/attribute_accessors.rb', line 54

def mattr_accessor(*syms)
  mattr_reader(*syms)
  mattr_writer(*syms)
end

#mattr_reader(*syms) ⇒ Object 



14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
 
# File 'lib/active_support/core_ext/module/attribute_accessors.rb', line 14

def mattr_reader(*syms)
  syms.each do |sym|
    next if sym.is_a?(Hash)
    class_eval("      unless defined? @@\#{sym}\n        @@\#{sym} = nil\n      end\n      \n      def self.\#{sym}\n        @@\#{sym}\n      end\n\n      def \#{sym}\n        @@\#{sym}\n      end\n    EOS\n  end\nend\n", __FILE__, __LINE__)

#mattr_writer(*syms) ⇒ Object 



33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
 
# File 'lib/active_support/core_ext/module/attribute_accessors.rb', line 33

def mattr_writer(*syms)
  options = syms.extract_options!
  syms.each do |sym|
    class_eval("      unless defined? @@\#{sym}\n        @@\#{sym} = nil\n      end\n      \n      def self.\#{sym}=(obj)\n        @@\#{sym} = obj\n      end\n      \n      \#{\"\n      def \#{sym}=(obj)\n        @@\#{sym} = obj\n      end\n      \" unless options[:instance_writer] == false }\n    EOS\n  end\nend\n", __FILE__, __LINE__)