Class: Object

Inherits:
BasicObject
Defined in:
lib/lite/ruby/object.rb,
lib/lite/ruby/safe/object.rb

Constant Summary collapse

FALSE_VALUES = 
%w[
  0 f false n no off
].freeze
TRUE_VALUES = 
%w[
  1 t true y yes on
].freeze

Instance Method Summary collapse

Instance Method Details

#array? ⇒ Boolean

Returns:

  • (Boolean) 


17
18
19
 
# File 'lib/lite/ruby/object.rb', line 17

def array?
  is_a?(Array)
end

#blank? ⇒ Boolean

Returns:

  • (Boolean) 


5
6
7
8
9
10
11
 
# File 'lib/lite/ruby/safe/object.rb', line 5

def blank?
  object = self
  object = object.strip if respond_to?(:strip)
  return object.empty? if respond_to?(:empty?)

  !object
end

#bool? ⇒ Boolean

Returns:

  • (Boolean) 


22
23
24
 
# File 'lib/lite/ruby/object.rb', line 22

def bool?
  true? || false?
end

#boolean? ⇒ Boolean

Returns:

  • (Boolean) 


26
27
28
29
 
# File 'lib/lite/ruby/object.rb', line 26

def boolean?
  val = to_s.downcase
  TRUE_VALUES.include?(val) || FALSE_VALUES.include?(val)
end

#date? ⇒ Boolean

Returns:

  • (Boolean) 


31
32
33
 
# File 'lib/lite/ruby/object.rb', line 31

def date?
  is_a?(Date)
end

#deep_dup ⇒ Object 



13
14
15
 
# File 'lib/lite/ruby/safe/object.rb', line 13

def deep_dup
  duplicable? ? dup : self
end

#duplicable? ⇒ Boolean

Returns:

  • (Boolean) 


17
18
19
 
# File 'lib/lite/ruby/safe/object.rb', line 17

def duplicable?
  true
end

#false? ⇒ Boolean

rubocop:disable Style/YodaCondition

Returns:

  • (Boolean) 


36
37
38
 
# File 'lib/lite/ruby/object.rb', line 36

def false?
  false == self
end

#falsey? ⇒ Boolean

rubocop:enable Style/YodaCondition

Returns:

  • (Boolean) 


41
42
43
 
# File 'lib/lite/ruby/object.rb', line 41

def falsey?
  nil? || FALSE_VALUES.include?(to_s.downcase)
end

#float? ⇒ Boolean

Returns:

  • (Boolean) 


45
46
47
 
# File 'lib/lite/ruby/object.rb', line 45

def float?
  is_a?(Float)
end

#hash? ⇒ Boolean

Returns:

  • (Boolean) 


49
50
51
 
# File 'lib/lite/ruby/object.rb', line 49

def hash?
  is_a?(Hash)
end

#integer? ⇒ Boolean

Returns:

  • (Boolean) 


53
54
55
 
# File 'lib/lite/ruby/object.rb', line 53

def integer?
  is_a?(Integer)
end

#is_any?(*objs) ⇒ Boolean

rubocop:disable Naming/PredicateName

Returns:

  • (Boolean) 


58
59
60
 
# File 'lib/lite/ruby/object.rb', line 58

def is_any?(*objs)
  objs.any? { |obj| is_a?(obj) }
end

#numeral? ⇒ Boolean

rubocop:enable Naming/PredicateName

Returns:

  • (Boolean) 


63
64
65
 
# File 'lib/lite/ruby/object.rb', line 63

def numeral?
  !to_s.match(/\A[+-]?\d+?(\.\d+)?\Z/).nil?
end

#numeric? ⇒ Boolean

Returns:

  • (Boolean) 


67
68
69
 
# File 'lib/lite/ruby/object.rb', line 67

def numeric?
  is_a?(Numeric)
end

#open_struct? ⇒ Boolean

Returns:

  • (Boolean) 


71
72
73
 
# File 'lib/lite/ruby/object.rb', line 71

def open_struct?
  is_a?(OpenStruct)
end

#palindrome? ⇒ Boolean

Returns:

  • (Boolean) 


75
76
77
 
# File 'lib/lite/ruby/object.rb', line 75

def palindrome?
  to_s == to_s.reverse
end

#presence ⇒ Object 



25
26
27
 
# File 'lib/lite/ruby/safe/object.rb', line 25

def presence
  self if present?
end

#present? ⇒ Boolean

Returns:

  • (Boolean) 


21
22
23
 
# File 'lib/lite/ruby/safe/object.rb', line 21

def present?
  !blank?
end

#range? ⇒ Boolean

Returns:

  • (Boolean) 


79
80
81
 
# File 'lib/lite/ruby/object.rb', line 79

def range?
  is_a?(Range)
end

#safe_call(*keys) ⇒ Object 



83
84
85
 
# File 'lib/lite/ruby/object.rb', line 83

def safe_call(*keys)
  try_call(*keys) || self
end

#safe_send(*keys) ⇒ Object 



87
88
89
 
# File 'lib/lite/ruby/object.rb', line 87

def safe_send(*keys)
  try_send(*keys) || self
end

#safe_try(*obj, &block) ⇒ Object 



91
92
93
 
# File 'lib/lite/ruby/object.rb', line 91

def safe_try(*obj, &block)
  try(*obj, &block) || self
end

#salvage(placeholder = '---') ⇒ Object 



95
96
97
 
# File 'lib/lite/ruby/object.rb', line 95

def salvage(placeholder = '---')
  blank? ? placeholder : self
end

#salvage_try(*obj, placeholder: '---', &block) ⇒ Object 



99
100
101
 
# File 'lib/lite/ruby/object.rb', line 99

def salvage_try(*obj, placeholder: '---', &block)
  try(*obj, &block).salvage(placeholder)
end

#send_chain(*keys) ⇒ Object 



103
104
105
 
# File 'lib/lite/ruby/object.rb', line 103

def send_chain(*keys)
  Array(keys).inject(self) { |obj, key| obj.send(*key) }
end

#send_chain_if(*keys) ⇒ Object 



107
108
109
 
# File 'lib/lite/ruby/object.rb', line 107

def send_chain_if(*keys)
  Array(keys).inject(self) { |obj, key| obj.send_if(*key) }
end

#send_if(key, *args) ⇒ Object 



111
112
113
114
115
 
# File 'lib/lite/ruby/object.rb', line 111

def send_if(key, *args)
  return self unless respond_to?(key)

  send(key, *args)
end

#set? ⇒ Boolean

Returns:

  • (Boolean) 


117
118
119
 
# File 'lib/lite/ruby/object.rb', line 117

def set?
  is_a?(Set)
end

#string? ⇒ Boolean

Returns:

  • (Boolean) 


121
122
123
 
# File 'lib/lite/ruby/object.rb', line 121

def string?
  is_a?(String)
end

#struct? ⇒ Boolean

Returns:

  • (Boolean) 


125
126
127
 
# File 'lib/lite/ruby/object.rb', line 125

def struct?
  is_a?(Struct)
end

#symbol? ⇒ Boolean

Returns:

  • (Boolean) 


129
130
131
 
# File 'lib/lite/ruby/object.rb', line 129

def symbol?
  is_a?(Symbol)
end

#time? ⇒ Boolean

Returns:

  • (Boolean) 


133
134
135
 
# File 'lib/lite/ruby/object.rb', line 133

def time?
  is_a?(Time)
end

#to_bool ⇒ Object Also known as: to_b 



137
138
139
140
141
142
 
# File 'lib/lite/ruby/object.rb', line 137

def to_bool
  return true if truthy?
  return false if falsey?

  nil
end

#true? ⇒ Boolean

rubocop:disable Style/YodaCondition

Returns:

  • (Boolean) 


145
146
147
 
# File 'lib/lite/ruby/object.rb', line 145

def true?
  true == self
end

#truthy? ⇒ Boolean

rubocop:enable Style/YodaCondition

Returns:

  • (Boolean) 


150
151
152
 
# File 'lib/lite/ruby/object.rb', line 150

def truthy?
  TRUE_VALUES.include?(to_s.downcase)
end

#try(*obj, &block) ⇒ Object 



29
30
31
 
# File 'lib/lite/ruby/safe/object.rb', line 29

def try(*obj, &block)
  try!(*obj, &block) if obj.empty? || respond_to?(obj.first)
end

#try!(*obj, &block) ⇒ Object 



33
34
35
36
37
38
39
 
# File 'lib/lite/ruby/safe/object.rb', line 33

def try!(*obj, &block)
  if obj.empty? && defined?(yield)
    block.arity.zero? ? instance_eval(&block) : yield(self)
  else
    public_send(*obj, &block)
  end
end

#try_call(*keys) ⇒ Object 



154
155
156
157
158
 
# File 'lib/lite/ruby/object.rb', line 154

def try_call(*keys)
  return unless respond_to?(:call)

  keys.blank? ? call : call(*keys)
end

#try_send(*keys) ⇒ Object 



160
161
162
163
164
 
# File 'lib/lite/ruby/object.rb', line 160

def try_send(*keys)
  send(*keys)
rescue StandardError
  nil
end