Class: Module

Inherits:
Object show all
Defined in:
lib/cassandra_mapper/core_ext/object/duplicable.rb,
lib/cassandra_mapper/core_ext/module/aliasing.rb,
lib/cassandra_mapper/core_ext/module/attribute_accessors.rb

Overview

:nodoc:

Instance Method Summary collapse

Instance Method Details

#alias_attribute(new_name, old_name) ⇒ Object

Allows you to make aliases for attributes, which includes getter, setter, and query methods.

Example:

class Content < ActiveRecord::Base
  # has a title attribute
end

class Email < Content
  alias_attribute :subject, :title
end

e = Email.find(1)
e.title    # => "Superstars"
e.subject  # => "Superstars"
e.subject? # => true
e.subject = "Megastars"
e.title    # => "Megastars"



63
64
65
66
67
68
69
 
# File 'lib/cassandra_mapper/core_ext/module/aliasing.rb', line 63

def alias_attribute(new_name, old_name)
  module_eval "    def \#{new_name}; self.\#{old_name}; end          # def subject; self.title; end\n    def \#{new_name}?; self.\#{old_name}?; end        # def subject?; self.title?; end\n    def \#{new_name}=(v); self.\#{old_name} = v; end  # def subject=(v); self.title = v; end\n  STR\nend\n", __FILE__, __LINE__ + 1

#alias_method_chain(target, feature) {|aliased_target, punctuation| ... } ⇒ Object

Encapsulates the common pattern of:

alias_method :foo_without_feature, :foo
alias_method :foo, :foo_with_feature

With this, you simply do:

alias_method_chain :foo, :feature

And both aliases are set up for you.

Query and bang methods (foo?, foo!) keep the same punctuation:

alias_method_chain :foo?, :feature

is equivalent to

alias_method :foo_without_feature?, :foo?
alias_method :foo?, :foo_with_feature?

so you can safely chain foo, foo?, and foo! with the same feature.

Yields:

  • (aliased_target, punctuation) 


23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
 
# File 'lib/cassandra_mapper/core_ext/module/aliasing.rb', line 23

def alias_method_chain(target, feature)
  # Strip out punctuation on predicates or bang methods since
  # e.g. target?_without_feature is not a valid method name.
  aliased_target, punctuation = target.to_s.sub(/([?!=])$/, ''), $1
  yield(aliased_target, punctuation) if block_given?

  with_method, without_method = "#{aliased_target}_with_#{feature}#{punctuation}", "#{aliased_target}_without_#{feature}#{punctuation}"

  alias_method without_method, target
  alias_method target, with_method

  case
    when public_method_defined?(without_method)
      public target
    when protected_method_defined?(without_method)
      protected target
    when private_method_defined?(without_method)
      private target
  end
end

#duplicable? ⇒ Boolean 



62
63
64
 
# File 'lib/cassandra_mapper/core_ext/object/duplicable.rb', line 62

def duplicable?
  false
end

#mattr_accessor(*syms) ⇒ Object

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!"



62
63
64
65
 
# File 'lib/cassandra_mapper/core_ext/module/attribute_accessors.rb', line 62

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

#mattr_reader(*syms) ⇒ Object 



4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
 
# File 'lib/cassandra_mapper/core_ext/module/attribute_accessors.rb', line 4

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

#mattr_writer(*syms) ⇒ Object 



27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
 
# File 'lib/cassandra_mapper/core_ext/module/attribute_accessors.rb', line 27

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    EOS\n\n    unless options[:instance_writer] == false\n      class_eval(<<-EOS, __FILE__, __LINE__ + 1)\n        def \#{sym}=(obj)\n          @@\#{sym} = obj\n        end\n      EOS\n    end\n  end\nend\n", __FILE__, __LINE__ + 1)