Module: Spree::Preferences::PreferableClassMethods

Defined in:
lib/spree/core/preferences/preferable_class_methods.rb

Instance Method Summary collapse

Instance Method Details

#preference(name, type, *args) ⇒ Object



3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
# File 'lib/spree/core/preferences/preferable_class_methods.rb', line 3

def preference(name, type, *args)
  options = args.extract_options!
  options.assert_valid_keys(:default, :deprecated, :nullable, :parse_on_set)
  default = options[:default]
  default = -> { options[:default] } unless default.is_a?(Proc)
  deprecated = options[:deprecated]
  nullable = options[:nullable]
  parse_on_set = options[:parse_on_set]

  # cache_key will be nil for new objects, then if we check if there
  # is a pending preference before going to default
  define_method preference_getter_method(name) do
    preferences.fetch(name) do
      default.call
    end
  end

  define_method preference_setter_method(name) do |value|
    value = parse_on_set.call(value) if parse_on_set.is_a?(Proc)
    value = convert_preference_value(value, type, nullable: nullable)
    preferences[name] = value

    Spree::Deprecation.warn("`#{name}` is deprecated. #{deprecated}") if deprecated

    # If this is an activerecord object, we need to inform
    # ActiveRecord::Dirty that this value has changed, since this is an
    # in-place update to the preferences hash.
    preferences_will_change! if respond_to?(:preferences_will_change!)
  end

  define_method preference_default_getter_method(name), &default

  define_method preference_type_getter_method(name) do
    type
  end

  define_method preference_deprecated_getter_method(name) do
    deprecated
  end

  define_method prefers_query_method(name) do
    preferences.fetch(name).to_b
  end

  define_method preference_change_method(name) do
    preference_change(name, changes) if respond_to?(:changes)
  end

  define_method preference_was_method(name) do
    return unless respond_to?(:changes)

    preference_change(name, changes)&.first || get_preference(name)
  end

  define_method preference_changed_method(name) do
    respond_to?(:changes) && preference_change(name, changes).present?
  end

  define_method preference_previous_change_method(name) do
    preference_change(name, previous_changes) if respond_to?(:previous_changes)
  end

  define_method preference_previous_was_method(name) do
    return unless respond_to?(:previous_changes)

    preference_change(name, previous_changes)&.first
  end

  define_method preference_previous_changed_method(name) do
    respond_to?(:previous_changes) && preference_change(name, previous_changes).present?
  end
end

#preference_change_method(name) ⇒ Object



100
101
102
# File 'lib/spree/core/preferences/preferable_class_methods.rb', line 100

def preference_change_method(name)
  "preferred_#{name}_change".to_sym
end

#preference_changed_method(name) ⇒ Object



108
109
110
# File 'lib/spree/core/preferences/preferable_class_methods.rb', line 108

def preference_changed_method(name)
  "preferred_#{name}_changed?".to_sym
end

#preference_default_getter_method(name) ⇒ Object



84
85
86
# File 'lib/spree/core/preferences/preferable_class_methods.rb', line 84

def preference_default_getter_method(name)
  "preferred_#{name}_default".to_sym
end

#preference_deprecated_getter_method(name) ⇒ Object



88
89
90
# File 'lib/spree/core/preferences/preferable_class_methods.rb', line 88

def preference_deprecated_getter_method(name)
  "preferred_#{name}_deprecated".to_sym
end

#preference_getter_method(name) ⇒ Object



76
77
78
# File 'lib/spree/core/preferences/preferable_class_methods.rb', line 76

def preference_getter_method(name)
  "preferred_#{name}".to_sym
end

#preference_previous_change_method(name) ⇒ Object



112
113
114
# File 'lib/spree/core/preferences/preferable_class_methods.rb', line 112

def preference_previous_change_method(name)
  "preferred_#{name}_previous_change".to_sym
end

#preference_previous_changed_method(name) ⇒ Object



120
121
122
# File 'lib/spree/core/preferences/preferable_class_methods.rb', line 120

def preference_previous_changed_method(name)
  "preferred_#{name}_previously_changed?".to_sym
end

#preference_previous_was_method(name) ⇒ Object



116
117
118
# File 'lib/spree/core/preferences/preferable_class_methods.rb', line 116

def preference_previous_was_method(name)
  "preferred_#{name}_previously_was".to_sym
end

#preference_setter_method(name) ⇒ Object



80
81
82
# File 'lib/spree/core/preferences/preferable_class_methods.rb', line 80

def preference_setter_method(name)
  "preferred_#{name}=".to_sym
end

#preference_type_getter_method(name) ⇒ Object



92
93
94
# File 'lib/spree/core/preferences/preferable_class_methods.rb', line 92

def preference_type_getter_method(name)
  "preferred_#{name}_type".to_sym
end

#preference_was_method(name) ⇒ Object



104
105
106
# File 'lib/spree/core/preferences/preferable_class_methods.rb', line 104

def preference_was_method(name)
  "preferred_#{name}_was".to_sym
end

#prefers_query_method(name) ⇒ Object



96
97
98
# File 'lib/spree/core/preferences/preferable_class_methods.rb', line 96

def prefers_query_method(name)
  "prefers_#{name}?".to_sym
end