Class: Ransack::Context

Inherits:
Object
  • Object
show all
Defined in:
lib/ransack/context.rb,
lib/ransack/adapters/mongoid/ransack/context.rb,
lib/ransack/adapters/active_record/ransack/context.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(object, options = {}) ⇒ Context

<< self



29
30
31
 
# File 'lib/ransack/context.rb', line 29

def initialize(object, options = {})
  raise "not implemented"
end

Instance Attribute Details

#arel_visitor ⇒ Object (readonly)

Returns the value of attribute arel_visitor.



6
7
8
 
# File 'lib/ransack/context.rb', line 6

def arel_visitor
  @arel_visitor
end

#auth_object ⇒ Object

Returns the value of attribute auth_object.



7
8
9
 
# File 'lib/ransack/context.rb', line 7

def auth_object
  @auth_object
end

#base ⇒ Object (readonly)

Returns the value of attribute base.



6
7
8
 
# File 'lib/ransack/context.rb', line 6

def base
  @base
end

#engine ⇒ Object (readonly)

Returns the value of attribute engine.



6
7
8
 
# File 'lib/ransack/context.rb', line 6

def engine
  @engine
end

#klass ⇒ Object (readonly)

Returns the value of attribute klass.



6
7
8
 
# File 'lib/ransack/context.rb', line 6

def klass
  @klass
end

#object ⇒ Object (readonly)

Returns the value of attribute object.



6
7
8
 
# File 'lib/ransack/context.rb', line 6

def object
  @object
end

#search ⇒ Object (readonly)

Returns the value of attribute search.



6
7
8
 
# File 'lib/ransack/context.rb', line 6

def search
  @search
end

#search_key ⇒ Object

Returns the value of attribute search_key.



7
8
9
 
# File 'lib/ransack/context.rb', line 7

def search_key
  @search_key
end

Class Method Details

.for(object, options = {}) ⇒ Object 



19
20
21
22
23
24
25
 
# File 'lib/ransack/context.rb', line 19

def for(object, options = {})
  context = Class === object ?
    for_class(object, options) :
    for_object(object, options)
  context or raise ArgumentError,
    "Don't know what context to use for #{object}"
end

.for_class(klass, options = {}) ⇒ Object 



11
12
13
 
# File 'lib/ransack/context.rb', line 11

def for_class(klass, options = {})
  raise "not implemented"
end

.for_object(object, options = {}) ⇒ Object 



15
16
17
 
# File 'lib/ransack/context.rb', line 15

def for_object(object, options = {})
  raise "not implemented"
end

Instance Method Details

#association_path(str, base = @base) ⇒ Object 



89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
 
# File 'lib/ransack/context.rb', line 89

def association_path(str, base = @base)
  base = klassify(base)
  str ||= Constants::EMPTY
  path = []
  segments = str.split(/_/)
  association_parts = []
  if (segments = str.split(/_/)).size > 0
    while segments.size > 0 &&
    !base.columns_hash[segments.join(Constants::UNDERSCORE)] &&
    association_parts << segments.shift do
      assoc, klass = unpolymorphize_association(
        association_parts.join(Constants::UNDERSCORE)
        )
      if found_assoc = get_association(assoc, base)
        path += association_parts
        association_parts = []
        base = klassify(klass || found_assoc)
      end
    end
  end

  path.join(Constants::UNDERSCORE)
end

#bind(object, str) ⇒ Object 



57
58
59
 
# File 'lib/ransack/context.rb', line 57

def bind(object, str)
  object.parent, object.attr_name = @bind_pairs[str]
end

#chain_scope(scope, args) ⇒ Object 



44
45
46
47
48
49
50
51
 
# File 'lib/ransack/context.rb', line 44

def chain_scope(scope, args)
  return unless @klass.method(scope) && args != false
  @object = if scope_arity(scope) < 1 && args == true
              @object.public_send(scope)
            else
              @object.public_send(scope, *args)
            end
end

#contextualize(str) ⇒ Object

Convert a string representing a chain of associations and an attribute into the attribute itself



39
40
41
42
 
# File 'lib/ransack/context.rb', line 39

def contextualize(str)
  parent, attr_name = @bind_pairs[str]
  table_for(parent)[attr_name]
end

#klassify(obj) ⇒ Object 



33
34
35
 
# File 'lib/ransack/context.rb', line 33

def klassify(obj)
  raise "not implemented"
end

#ransackable_association?(str, klass) ⇒ Boolean

Returns:

  • (Boolean) 


126
127
128
 
# File 'lib/ransack/context.rb', line 126

def ransackable_association?(str, klass)
  klass.ransackable_associations(auth_object).include? str
end

#ransackable_attribute?(str, klass) ⇒ Boolean

Returns:

  • (Boolean) 


121
122
123
124
 
# File 'lib/ransack/context.rb', line 121

def ransackable_attribute?(str, klass)
  klass.ransackable_attributes(auth_object).include?(str) ||
  klass.ransortable_attributes(auth_object).include?(str)
end

#ransackable_scope?(str, klass) ⇒ Boolean

Returns:

  • (Boolean) 


130
131
132
 
# File 'lib/ransack/context.rb', line 130

def ransackable_scope?(str, klass)
  klass.ransackable_scopes(auth_object).any? { |s| s.to_s == str }
end

#scope_arity(scope) ⇒ Object 



53
54
55
 
# File 'lib/ransack/context.rb', line 53

def scope_arity(scope)
  @klass.method(scope).arity
end

#searchable_associations(str = Constants::EMPTY) ⇒ Object 



142
143
144
 
# File 'lib/ransack/context.rb', line 142

def searchable_associations(str = Constants::EMPTY)
  traverse(str).ransackable_associations(auth_object)
end

#searchable_attributes(str = Constants::EMPTY) ⇒ Object 



134
135
136
 
# File 'lib/ransack/context.rb', line 134

def searchable_attributes(str = Constants::EMPTY)
  traverse(str).ransackable_attributes(auth_object)
end

#sortable_attributes(str = Constants::EMPTY) ⇒ Object 



138
139
140
 
# File 'lib/ransack/context.rb', line 138

def sortable_attributes(str = Constants::EMPTY)
  traverse(str).ransortable_attributes(auth_object)
end

#traverse(str, base = @base) ⇒ Object 



61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
 
# File 'lib/ransack/context.rb', line 61

def traverse(str, base = @base)
  str ||= Constants::EMPTY

  if (segments = str.split(/_/)).size > 0
    remainder = []
    found_assoc = nil
    while !found_assoc && segments.size > 0 do
      # Strip the _of_Model_type text from the association name, but hold
      # onto it in klass, for use as the next base
      assoc, klass = unpolymorphize_association(
        segments.join(Constants::UNDERSCORE)
        )
      if found_assoc = get_association(assoc, base)
        base = traverse(
          remainder.join(
            Constants::UNDERSCORE), klass || found_assoc.klass
            )
      end

      remainder.unshift segments.pop
    end
    raise UntraversableAssociationError,
      "No association matches #{str}" unless found_assoc
  end

  klassify(base)
end

#unpolymorphize_association(str) ⇒ Object 



113
114
115
116
117
118
119
 
# File 'lib/ransack/context.rb', line 113

def unpolymorphize_association(str)
  if (match = str.match(/_of_([^_]+?)_type$/))
    [match.pre_match, Kernel.const_get(match.captures.first)]
  else
    [str, nil]
  end
end