File: store.rb

package info (click to toggle)
ruby-moneta 1.6.0-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 1,776 kB
  • sloc: ruby: 13,201; sh: 178; makefile: 7
file content (265 lines) | stat: -rw-r--r-- 8,611 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
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
154
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
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
shared_examples :store do
  it 'writes values to keys that like a Hash' do
    moneta_property_of(keys: 1, values: 1).check do |m|
      store[m.keys[0]] = m.values[0]
      store[m.keys[0]].should == m.values[0]
      store.load(m.keys[0]).should == m.values[0]
    end
  end

  it 'returns true from #key? if a key is available' do
    moneta_property_of(keys: 1, values: 1).check do |m|
      store[m.keys[0]] = m.values[0]
      store.key?(m.keys[0]).should be true
    end
  end

  it 'stores values with #store' do
    moneta_property_of(keys: 1, values: 1).check do |m|
      value = m.values[0]
      store.store(m.keys[0], value).should equal(value)
      store[m.keys[0]].should == m.values[0]
      store.load(m.keys[0]).should == m.values[0]
    end
  end

  it 'stores values after clear' do
    moneta_property_of(keys: 2, values: 2).check do |m|
      store[m.keys[0]] = m.values[0]
      store[m.keys[1]] = m.values[1]
      store.clear.should equal(store)
      store[m.keys[0]] = m.values[0]
      store[m.keys[0]].should == m.values[0]
      store[m.keys[1]].should be_nil
    end
  end

  it 'removes and returns a value from the backing store via delete if it exists' do
    moneta_property_of(keys: 1, values: 1).check do |m|
      store[m.keys[0]] = m.values[0]
      store.delete(m.keys[0]).should == m.values[0]
      store.key?(m.keys[0]).should be false
    end
  end

  it 'overwrites existing values' do
    moneta_property_of(keys: 1, values: 2).check do |m|
      store[m.keys[0]] = m.values[0]
      store[m.keys[0]].should == m.values[0]
      store[m.keys[0]] = m.values[1]
      store[m.keys[0]].should == m.values[1]
    end
  end

  it 'stores frozen values' do
    moneta_property_of(keys: 1, values: 1).check do |m|
      value = m.values[0].freeze
      (store[m.keys[0]] = value).should equal(value)
      store[m.keys[0]].should == m.values[0]
    end
  end

  it 'stores frozen keys' do
    moneta_property_of(keys: 1, values: 1).check do |m|
      key = m.keys[0].freeze
      store[key] = m.values[0]
      store[m.keys[0]].should == m.values[0]
    end
  end

  it 'fetches a key with a default value with fetch, if the key is available' do
    moneta_property_of(keys: 1, values: 2).check do |m|
      next if m.values[0].nil?
      store[m.keys[0]] = m.values[0]
      store.fetch(m.keys[0], m.values[1]).should == m.values[0]
    end
  end

  it 'does not run the block in fetch if the key is available' do
    moneta_property_of(keys: 1, values: 1).check do |m|
      next if m.values[0].nil?
      store[m.keys[0]] = m.values[0]
      unaltered = 'unaltered'
      store.fetch(m.keys[0]) { unaltered = 'altered' }
      unaltered.should == 'unaltered'
    end
  end

  shared_examples :values_at do |name|
    it 'retrieves stored values' do
      moneta_property_of(keys: 3, values: 3).check do |m|
        store[m.keys[0]] = m.values[0]
        store[m.keys[1]] = m.values[1]
        store[m.keys[2]] = m.values[2]
        expect(store.public_send(name, m.keys[1], m.keys[2], m.keys[0])).to eq [m.values[1], m.values[2], m.values[0]]
        store.clear
      end
    end

    it 'returns nil in place of missing values' do
      moneta_property_of(keys: 3, values: 2).check do |m|
        store[m.keys[0]] = m.values[0]
        store[m.keys[1]] = m.values[1]
        expect(store.public_send(name, m.keys[1], m.keys[2], m.keys[0])).to eq [m.values[1], nil, m.values[0]]
        store.clear
      end
    end
  end

  describe '#values_at' do
    include_examples :values_at, :values_at
  end

  describe '#fetch_values' do
    include_examples :values_at, :fetch_values

    it 'yields to the block, if given, for keys that are not in the store' do
      moneta_property_of(keys: 4, values: 3).check do |m|
        store[m.keys[0]] = m.values[0]
        store[m.keys[1]] = m.values[1]
        store[m.keys[2]] = m.values[2]

        expect do |b|
          store.fetch_values(m.keys[0], m.keys[1], m.keys[2], m.keys[3], &b)
        end.to yield_with_args(m.keys[3])

        store.clear
      end
    end

    it 'uses the value of the block, if given, for keys that are not in the store' do
      moneta_property_of(keys: 4, values: 4).check do |m|
        store[m.keys[0]] = m.values[0]
        store[m.keys[1]] = m.values[1]
        store[m.keys[2]] = m.values[2]

        expect(store.fetch_values(m.keys[0], m.keys[1], m.keys[2], m.keys[3]) do |key|
          expect(key).to eq m.keys[3]
          m.values[3]
        end).to eq [m.values[0], m.values[1], m.values[2], m.values[3]]

        store.clear
      end
    end

    it 'raises any error raised in the block' do
      expect { store.fetch_values('key') { raise 'yarg' } }.to raise_error 'yarg'
    end
  end

  describe '#slice' do
    it 'returns pairs of stored keys and values' do
      moneta_property_of(keys: 3, values: 3).check do |m|
        store[m.keys[0]] = m.values[0]
        store[m.keys[1]] = m.values[1]
        store[m.keys[2]] = m.values[2]

        expect(store.slice(*[m.keys[0], m.keys[1], m.keys[2]].shuffle).to_a).to \
          contain_exactly([m.keys[0], m.values[0]], [m.keys[1], m.values[1]], [m.keys[2], m.values[2]])

        store.clear
      end
    end

    it 'does not return pairs for any keys absent from the store' do
      moneta_property_of(keys: 4, values: 3).check do |m|
        store[m.keys[0]] = m.values[0]
        store[m.keys[1]] = m.values[1]
        store[m.keys[2]] = m.values[2]

        expect(store.slice(*[m.keys[0], m.keys[1], m.keys[2], m.keys[3]].shuffle).to_a).to \
          contain_exactly([m.keys[0], m.values[0]], [m.keys[1], m.values[1]], [m.keys[2], m.values[2]])

        store.clear
      end
    end
  end

  shared_examples :merge! do
    it 'can be called with an empty object' do
      expect { store.public_send(method, pairs.call({})) }.not_to raise_error
    end

    it 'stores values' do
      moneta_property_of(keys: 3, values: 3).check do |m|
        expect(store.public_send(method, pairs.call({ m.keys[0] => m.values[0], m.keys[1] => m.values[1], m.keys[2] => m.values[2] }))).to be store
        expect(store.key?(m.keys[0])).to be true
        expect(store[m.keys[0]]).to eq m.values[0]
        expect(store.key?(m.keys[1])).to be true
        expect(store[m.keys[1]]).to eq m.values[1]
        expect(store.key?(m.keys[2])).to be true
        expect(store[m.keys[2]]).to eq m.values[2]
        store.clear
      end
    end

    it 'overwrites existing values' do
      moneta_property_of(keys: 2, values: 3).check do |m|
        expect(store[m.keys[0]] = m.values[0]).to eq m.values[0]
        expect(store.public_send(method, pairs.call({ m.keys[0] => m.values[1], m.keys[1] => m.values[2] }))).to be store
        expect(store.key?(m.keys[0])).to be true
        expect(store[m.keys[0]]).to eq m.values[1]
        expect(store.key?(m.keys[1])).to be true
        expect(store[m.keys[1]]).to eq m.values[2]
        store.clear
      end
    end

    it 'stores the return value of the block, if given, for keys that will be overwritten' do
      moneta_property_of(keys: 2, values: 4).check do |m|
        expect(store[m.keys[0]] = m.values[0]).to eq m.values[0]
        expect(store.public_send(method, pairs.call({ m.keys[0] => m.values[1], m.keys[1] => m.values[2] })) do |key, old_val, new_val|
          expect(key).to eq m.keys[0]
          expect(old_val).to eq m.values[0]
          expect(new_val).to eq m.values[1]
          m.values[3]
        end).to be store

        expect(store.key?(m.keys[0])).to be true
        expect(store[m.keys[0]]).to eq m.values[3]
        expect(store.key?(m.keys[1])).to be true
        expect(store[m.keys[1]]).to eq m.values[2]
        store.clear
      end
    end

    it 'raises any error raised in the block' do
      store['x'] = 'y'
      expect { store.public_send(method, 'x' => 'v') { raise 'yarg' } }.to raise_error 'yarg'
    end
  end

  shared_examples :merge_or_update do
    context 'when passed a hash' do
      let(:pairs) { :itself.to_proc }
      include_examples :merge!
    end

    context 'when passed an array' do
      let(:pairs) { :to_a.to_proc }
      include_examples :merge!
    end

    context 'when passed a lazy enumerator' do
      let :pairs do
        lambda do |hash|
          Enumerator.new do |y|
            hash.each(&y.method(:<<))
          end.lazy
        end
      end

      include_examples :merge!
    end
  end

  describe '#merge!' do
    let(:method) { :merge! }
    include_examples :merge_or_update
  end

  describe '#update' do
    let(:method) { :update }
    include_examples :merge_or_update
  end
end