Class: Grape::Entity::Exposure::Base

Inherits:
Object
  • Object
show all
Defined in:
lib/grape_entity/exposure/base.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(attribute, options, conditions) ⇒ Base

Returns a new instance of Base.



11
12
13
14
15
16
17
18
19
20
 
# File 'lib/grape_entity/exposure/base.rb', line 11

def initialize(attribute, options, conditions)
  @attribute = attribute.try(:to_sym)
  @options = options
  @key = (options[:as] || attribute).try(:to_sym)
  @is_safe = options[:safe]
  @for_merge = options[:merge]
  @attr_path_proc = options[:attr_path]
  @documentation = options[:documentation]
  @conditions = conditions
end

Instance Attribute Details

#attribute ⇒ Object (readonly)

Returns the value of attribute attribute.



5
6
7
 
# File 'lib/grape_entity/exposure/base.rb', line 5

def attribute
  @attribute
end

#conditions ⇒ Object (readonly)

Returns the value of attribute conditions.



5
6
7
 
# File 'lib/grape_entity/exposure/base.rb', line 5

def conditions
  @conditions
end

#documentation ⇒ Object (readonly)

Returns the value of attribute documentation.



5
6
7
 
# File 'lib/grape_entity/exposure/base.rb', line 5

def documentation
  @documentation
end

#for_merge ⇒ Object (readonly)

Returns the value of attribute for_merge.



5
6
7
 
# File 'lib/grape_entity/exposure/base.rb', line 5

def for_merge
  @for_merge
end

#is_safe ⇒ Object (readonly)

Returns the value of attribute is_safe.



5
6
7
 
# File 'lib/grape_entity/exposure/base.rb', line 5

def is_safe
  @is_safe
end

#key ⇒ Object (readonly)

Returns the value of attribute key.



5
6
7
 
# File 'lib/grape_entity/exposure/base.rb', line 5

def key
  @key
end

Class Method Details

.new(attribute, options, conditions, *args, &block) ⇒ Object 



7
8
9
 
# File 'lib/grape_entity/exposure/base.rb', line 7

def self.new(attribute, options, conditions, *args, &block)
  super(attribute, options, conditions).tap { |e| e.setup(*args, &block) }
end

Instance Method Details

#==(other) ⇒ Object 



30
31
32
33
34
35
 
# File 'lib/grape_entity/exposure/base.rb', line 30

def ==(other)
  self.class == other.class &&
    @attribute == other.attribute &&
    @options == other.options &&
    @conditions == other.conditions
end

#attr_path(entity, options) ⇒ Object 



98
99
100
101
102
103
104
 
# File 'lib/grape_entity/exposure/base.rb', line 98

def attr_path(entity, options)
  if @attr_path_proc
    entity.exec_with_object(options, &@attr_path_proc)
  else
    @key
  end
end

#conditional? ⇒ Boolean

Returns:

  • (Boolean) 


86
87
88
 
# File 'lib/grape_entity/exposure/base.rb', line 86

def conditional?
  !@conditions.empty?
end

#conditions_met?(entity, options) ⇒ Boolean

Returns:

  • (Boolean) 


90
91
92
 
# File 'lib/grape_entity/exposure/base.rb', line 90

def conditions_met?(entity, options)
  @conditions.all? { |condition| condition.met? entity, options }
end

#deep_complex_nesting? ⇒ Boolean

if we have any nesting exposures with the same name.

Returns:

  • (Boolean) 


45
46
47
 
# File 'lib/grape_entity/exposure/base.rb', line 45

def deep_complex_nesting?
  false
end

#dup(&block) ⇒ Object 



22
23
24
 
# File 'lib/grape_entity/exposure/base.rb', line 22

def dup(&block)
  self.class.new(*dup_args, &block)
end

#dup_args ⇒ Object 



26
27
28
 
# File 'lib/grape_entity/exposure/base.rb', line 26

def dup_args
  [@attribute, @options, @conditions.map(&:dup)]
end

#nesting? ⇒ Boolean

Returns:

  • (Boolean) 


40
41
42
 
# File 'lib/grape_entity/exposure/base.rb', line 40

def nesting?
  false
end

#serializable_value(entity, options) ⇒ Object 



62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
 
# File 'lib/grape_entity/exposure/base.rb', line 62

def serializable_value(entity, options)
  partial_output = valid_value(entity, options)

  if partial_output.respond_to?(:serializable_hash)
    partial_output.serializable_hash
  elsif partial_output.is_a?(Array) && partial_output.all? { |o| o.respond_to?(:serializable_hash) }
    partial_output.map(&:serializable_hash)
  elsif partial_output.is_a?(Hash)
    partial_output.each do |key, value|
      partial_output[key] = value.serializable_hash if value.respond_to?(:serializable_hash)
    end
  else
    partial_output
  end
end

#setup ⇒ Object 



37
38
 
# File 'lib/grape_entity/exposure/base.rb', line 37

def setup
end

#should_expose?(entity, options) ⇒ Boolean

Returns:

  • (Boolean) 


94
95
96
 
# File 'lib/grape_entity/exposure/base.rb', line 94

def should_expose?(entity, options)
  should_return_key?(options) && conditions_met?(entity, options)
end

#should_return_key?(options) ⇒ Boolean

Returns:

  • (Boolean) 


82
83
84
 
# File 'lib/grape_entity/exposure/base.rb', line 82

def should_return_key?(options)
  options.should_return_key?(@key)
end

#valid?(entity) ⇒ Boolean

Returns:

  • (Boolean) 


49
50
51
52
53
54
55
56
 
# File 'lib/grape_entity/exposure/base.rb', line 49

def valid?(entity)
  is_delegatable = entity.delegator.delegatable?(@attribute) || entity.respond_to?(@attribute, true)
  if @is_safe
    is_delegatable
  else
    is_delegatable || raise(NoMethodError, "#{entity.class.name} missing attribute `#{@attribute}' on #{entity.object}")
  end
end

#valid_value(entity, options) ⇒ Object 



78
79
80
 
# File 'lib/grape_entity/exposure/base.rb', line 78

def valid_value(entity, options)
  value(entity, options) if valid?(entity)
end

#value(_entity, _options) ⇒ Object

Raises:

  • (NotImplementedError) 


58
59
60
 
# File 'lib/grape_entity/exposure/base.rb', line 58

def value(_entity, _options)
  raise NotImplementedError
end

#with_attr_path(entity, options) ⇒ Object 



106
107
108
109
110
111
 
# File 'lib/grape_entity/exposure/base.rb', line 106

def with_attr_path(entity, options)
  path_part = attr_path(entity, options)
  options.with_attr_path(path_part) do
    yield
  end
end