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


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

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

Instance Attribute Details

#attributeObject (readonly)

Returns the value of attribute attribute


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

def attribute
  @attribute
end

#conditionsObject (readonly)

Returns the value of attribute conditions


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

def conditions
  @conditions
end

#documentationObject (readonly)

Returns the value of attribute documentation


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

def documentation
  @documentation
end

#for_mergeObject (readonly)

Returns the value of attribute for_merge


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

def for_merge
  @for_merge
end

#is_safeObject (readonly)

Returns the value of attribute is_safe


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

def is_safe
  @is_safe
end

Class Method Details

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


9
10
11
# File 'lib/grape_entity/exposure/base.rb', line 9

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

Instance Method Details

#==(other) ⇒ Object


33
34
35
36
37
38
# File 'lib/grape_entity/exposure/base.rb', line 33

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

#attr_path(entity, options) ⇒ Object


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

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)

88
89
90
# File 'lib/grape_entity/exposure/base.rb', line 88

def conditional?
  !@conditions.empty?
end

#conditions_met?(entity, options) ⇒ Boolean

Returns:

  • (Boolean)

92
93
94
# File 'lib/grape_entity/exposure/base.rb', line 92

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

#deep_complex_nesting?(entity) ⇒ Boolean

if we have any nesting exposures with the same name.

Returns:

  • (Boolean)

47
48
49
# File 'lib/grape_entity/exposure/base.rb', line 47

def deep_complex_nesting?(entity) # rubocop:disable Lint/UnusedMethodArgument
  false
end

#dup(&block) ⇒ Object


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

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

#dup_argsObject


29
30
31
# File 'lib/grape_entity/exposure/base.rb', line 29

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

#key(entity = nil) ⇒ Object


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

def key(entity = nil)
  @key.respond_to?(:call) ? entity.exec_with_object(@options, &@key) : @key
end

#nesting?Boolean

Returns:

  • (Boolean)

42
43
44
# File 'lib/grape_entity/exposure/base.rb', line 42

def nesting?
  false
end

#serializable_value(entity, options) ⇒ Object


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

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

#setupObject


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

def setup; end

#should_expose?(entity, options) ⇒ Boolean

Returns:

  • (Boolean)

96
97
98
# File 'lib/grape_entity/exposure/base.rb', line 96

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

#should_return_key?(options) ⇒ Boolean

Returns:

  • (Boolean)

84
85
86
# File 'lib/grape_entity/exposure/base.rb', line 84

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

#valid?(entity) ⇒ Boolean

Returns:

  • (Boolean)

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

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


80
81
82
# File 'lib/grape_entity/exposure/base.rb', line 80

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

#value(_entity, _options) ⇒ Object

Raises:

  • (NotImplementedError)

60
61
62
# File 'lib/grape_entity/exposure/base.rb', line 60

def value(_entity, _options)
  raise NotImplementedError
end

#with_attr_path(entity, options) ⇒ Object


112
113
114
115
116
117
# File 'lib/grape_entity/exposure/base.rb', line 112

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