Module: Liquid::Utils

Defined in:
lib/liquid/utils.rb

Class Method Summary collapse

Class Method Details

.array_inspect(arr, seen = {}) ⇒ Object


129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
# File 'lib/liquid/utils.rb', line 129

def self.array_inspect(arr, seen = {})
  if seen[arr.object_id]
    return "[...]"
  end

  seen[arr.object_id] = true
  str = +"["
  cursor = 0
  len = arr.length

  while cursor < len
    if cursor > 0
      str << ", "
    end

    item_str = inspect(arr[cursor], seen)
    str << item_str
    cursor += 1
  end

  str << "]"
  str
ensure
  seen.delete(arr.object_id)
end

.hash_inspect(hash, seen = {}) ⇒ Object


155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
# File 'lib/liquid/utils.rb', line 155

def self.hash_inspect(hash, seen = {})
  if seen[hash.object_id]
    return "{...}"
  end
  seen[hash.object_id] = true

  str = +"{"
  first = true
  hash.each do |key, value|
    if first
      first = false
    else
      str << ", "
    end

    key_str = inspect(key, seen)
    str << key_str
    str << "=>"

    value_str = inspect(value, seen)
    str << value_str
  end
  str << "}"
  str
ensure
  seen.delete(hash.object_id)
end

.inspect(obj, seen = {}) ⇒ Object


111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
# File 'lib/liquid/utils.rb', line 111

def self.inspect(obj, seen = {})
  case obj
  when Hash
    # If the custom hash implementation overrides `#inspect`, use their
    # custom implementation. Otherwise we use Liquid's default
    # implementation.
    if obj.class.instance_method(:inspect) == HASH_INSPECT_METHOD
      hash_inspect(obj, seen)
    else
      obj.inspect
    end
  when Array
    array_inspect(obj, seen)
  else
    obj.inspect
  end
end

.slice_collection(collection, from, to) ⇒ Object


5
6
7
8
9
10
11
# File 'lib/liquid/utils.rb', line 5

def self.slice_collection(collection, from, to)
  if (from != 0 || !to.nil?) && collection.respond_to?(:load_slice)
    collection.load_slice(from, to)
  else
    slice_collection_using_each(collection, from, to)
  end
end

.slice_collection_using_each(collection, from, to) ⇒ Object


13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
# File 'lib/liquid/utils.rb', line 13

def self.slice_collection_using_each(collection, from, to)
  segments = []
  index    = 0

  # Maintains Ruby 1.8.7 String#each behaviour on 1.9
  if collection.is_a?(String)
    return collection.empty? ? [] : [collection]
  end
  return [] unless collection.respond_to?(:each)

  collection.each do |item|
    if to && to <= index
      break
    end

    if from <= index
      segments << item
    end

    index += 1
  end

  segments
end

.to_date(obj) ⇒ Object


65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
# File 'lib/liquid/utils.rb', line 65

def self.to_date(obj)
  return obj if obj.respond_to?(:strftime)

  if obj.is_a?(String)
    return nil if obj.empty?
    obj = obj.downcase
  end

  case obj
  when 'now', 'today'
    Time.now
  when /\A\d+\z/, Integer
    Time.at(obj.to_i)
  when String
    Time.parse(obj)
  end
rescue ::ArgumentError
  nil
end

.to_integer(num) ⇒ Object


38
39
40
41
42
43
44
45
46
# File 'lib/liquid/utils.rb', line 38

def self.to_integer(num)
  return num if num.is_a?(Integer)
  num = num.to_s
  begin
    Integer(num)
  rescue ::ArgumentError
    raise Liquid::ArgumentError, "invalid integer"
  end
end

.to_liquid_value(obj) ⇒ Object


85
86
87
88
89
90
91
# File 'lib/liquid/utils.rb', line 85

def self.to_liquid_value(obj)
  # Enable "obj" to represent itself as a primitive value like integer, string, or boolean
  return obj.to_liquid_value if obj.respond_to?(:to_liquid_value)

  # Otherwise return the object itself
  obj
end

.to_number(obj) ⇒ Object


48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
# File 'lib/liquid/utils.rb', line 48

def self.to_number(obj)
  case obj
  when Float
    BigDecimal(obj.to_s)
  when Numeric
    obj
  when String
    /\A-?\d+\.\d+\z/.match?(obj.strip) ? BigDecimal(obj) : obj.to_i
  else
    if obj.respond_to?(:to_number)
      obj.to_number
    else
      0
    end
  end
end

.to_s(obj, seen = {}) ⇒ Object


93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
# File 'lib/liquid/utils.rb', line 93

def self.to_s(obj, seen = {})
  case obj
  when Hash
    # If the custom hash implementation overrides `#to_s`, use their
    # custom implementation. Otherwise we use Liquid's default
    # implementation.
    if obj.class.instance_method(:to_s) == HASH_TO_S_METHOD
      hash_inspect(obj, seen)
    else
      obj.to_s
    end
  when Array
    array_inspect(obj, seen)
  else
    obj.to_s
  end
end