dbmlite3 2.0.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d54afa78dc0b955258b1af242e139a7a782eadd8eed2158a7858977287f5c074
-  data.tar.gz: 31d89de7932fa529649b3826d4a70bb24ec2c32f13f00fde2d92fb25b11b5508
+  metadata.gz: da465808b55994e121ad5eda62124bf720c622b86037db1825cc40dd78159276
+  data.tar.gz: 2eb6f1175c0f8280c5909652a6d2ce18035f56e88441a150fa9f167f155c7c98
 SHA512:
-  metadata.gz: 5d889fd9d0ae8f09c7812e9e6d8444deabb6891679be8c33674eeceaaf8db00b3f9515d1d3c12e444126ab6c1b2079f77977ebe3d247c631d01a670b5e8826eb
-  data.tar.gz: a482cec8793ba096d9be6070b226d8b1a93c525e075a08af1590dd5f24ac2ae999b9067c028e59ec762291ef06fab95d4b89266aae49d92d385af576d6b158ed
+  metadata.gz: 0a0f9a06afe80bd78aff8280d2ccc8c068d62aff4665a6e2e1220012cfb3a0e518d87cac96da25c42cfbcc4e750735e38a1bdcdac94e4e9c3c8e56b6ec6ff49b
+  data.tar.gz: df24819b1512f79814578d3c0bf186eaa95bacdb26fba18831fab783c053d392071cfbd24732cf5bf454564f52c9644c8207c5f66bf92b3f03e8d3740e39a3ee

data/.yardopts

@@ -1,3 +1,3 @@
 --markup markdown
 --readme README.md
-lib/*.rb
+lib/*.rb lib/internal_lite3/*.rb

data/Rakefile

@@ -6,9 +6,7 @@ RSpec::Core::RakeTask.new(:test) do |t|
   t.pattern = Dir.glob('spec/*_spec.rb')
 end
 
-YARD::Rake::YardocTask.new(:docs_via_yard) do |t|
-  t.files = ['lib/*.rb', 'lib/internal_lite3/*.rb']
-end
+YARD::Rake::YardocTask.new(:docs_via_yard)
 
 task :gem => [:doc] do
   gem_prefix = "JRUBY_GEM=yes " if RUBY_PLATFORM == "java"

data/dbmlite3.gemspec

@@ -18,8 +18,8 @@ end
 
 Gem::Specification.new do |s|
   s.name        = "dbmlite3#{SUFFIX}"
-  s.version     = '2.0.0'
-  s.date        = '2022-02-21'
+  s.version     = '2.0.1'
+  s.date        = '2024-03-30'
   s.summary     = "A DBM-style key-value store using SQLite3#{SUMMARY_EXTRA}"
   s.description = <<-EOF + DESC_EXTRA
     Lite3::DBM is an object that behaves like a Ruby Hash but stores

data/doc/Lite3/DBM.html

@@ -150,7 +150,7 @@
 
   
     <span class="summary_desc"><div class='inline'>
-<p>Identical to <code>initialize</code> except that if a block is provided, it is evaluated with a new Lite3::DBM which is then closed afterward.</p>
+<p>Identical to <code>new</code> except that if a block is provided, it is evaluated with a new Lite3::DBM which is then closed afterward.</p>
 </div></span>
   
 </li>
@@ -982,7 +982,7 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>Identical to <code>initialize</code> except that if a block is provided, it is evaluated with a new Lite3::DBM which is then closed afterward. This is analagous to <code>File.open</code>.</p>
+<p>Identical to <code>new</code> except that if a block is provided, it is evaluated with a new Lite3::DBM which is then closed afterward. This is analagous to <code>File.open</code>. See <code>initialize</code> for an explanation of the arguments and caveats.</p>
 
 
   </div>
@@ -996,7 +996,6 @@
       <pre class="lines">
 
 
-93
 94
 95
 96
@@ -1005,10 +1004,11 @@
 99
 100
 101
-102</pre>
+102
+103</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 93</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 94</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_open'>open</span><span class='lparen'>(</span><span class='id identifier rubyid_filename'>filename</span><span class='comma'>,</span> <span class='id identifier rubyid_tablename'>tablename</span><span class='comma'>,</span> <span class='id identifier rubyid_serializer'>serializer</span> <span class='op'>=</span> <span class='symbol'>:yaml</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_instance'>instance</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_filename'>filename</span><span class='comma'>,</span> <span class='id identifier rubyid_tablename'>tablename</span><span class='comma'>,</span> <span class='id identifier rubyid_serializer'>serializer</span><span class='rparen'>)</span>
@@ -1057,12 +1057,12 @@
       <pre class="lines">
 
 
-262
 263
-264</pre>
+264
+265</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 262</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 263</span>
 
 <span class='kw'>def</span> <span class='op'>[]</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_fetch'>fetch</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='kw'>nil</span><span class='rparen'>)</span>
@@ -1106,17 +1106,17 @@
       <pre class="lines">
 
 
-250
 251
 252
 253
 254
 255
 256
-257</pre>
+257
+258</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 250</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 251</span>
 
 <span class='kw'>def</span> <span class='op'>[]=</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_key'>key</span> <span class='op'>=</span> <span class='id identifier rubyid_check_key'>check_key</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
@@ -1157,12 +1157,12 @@
       <pre class="lines">
 
 
-348
-349
-350</pre>
+354
+355
+356</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 348</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 354</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_clear'>clear</span>
   <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_clear_table'>clear_table</span><span class='lparen'>(</span><span class='id identifier rubyid_actual_tbl'>actual_tbl</span><span class='lparen'>(</span><span class='rparen'>)</span><span class='rparen'>)</span>
@@ -1200,13 +1200,13 @@
       <pre class="lines">
 
 
-185
 186
 187
-188</pre>
+188
+189</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 185</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 186</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_close'>close</span>
   <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_delref'>delref</span><span class='lparen'>(</span><span class='kw'>self</span><span class='rparen'>)</span>
@@ -1256,12 +1256,12 @@
       <pre class="lines">
 
 
-192
 193
-194</pre>
+194
+195</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 192</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 193</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_closed?'>closed?</span>
   <span class='kw'>return</span> <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span> <span class='const'>ClosedHandle</span>
@@ -1297,12 +1297,12 @@
       <pre class="lines">
 
 
-434
-435
-436</pre>
+440
+441
+442</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 434</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 440</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_delete'>delete</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
   <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_delete'>delete</span><span class='lparen'>(</span><span class='id identifier rubyid_actual_tbl'>actual_tbl</span><span class='lparen'>(</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
@@ -1360,14 +1360,14 @@
       <pre class="lines">
 
 
-442
-443
-444
-445
-446</pre>
+448
+449
+450
+451
+452</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 442</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 448</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_delete_if'>delete_if</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_transaction'>transaction</span> <span class='lbrace'>{</span>
@@ -1431,14 +1431,14 @@
       <pre class="lines">
 
 
-386
-387
-388
-389
-390</pre>
+392
+393
+394
+395
+396</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 386</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 392</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_each'>each</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_to_enum'>to_enum</span><span class='lparen'>(</span><span class='symbol'>:nt_each</span><span class='rparen'>)</span> <span class='kw'>unless</span> <span class='id identifier rubyid_block'>block</span>
@@ -1494,13 +1494,13 @@
       <pre class="lines">
 
 
-409
-410
-411
-412</pre>
+415
+416
+417
+418</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 409</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 415</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_each_key'>each_key</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='const'>Enumerator</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_y'>y</span><span class='op'>|</span> <span class='id identifier rubyid_nt_each'>nt_each</span><span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_k'>k</span><span class='comma'>,</span><span class='id identifier rubyid_v'>v</span><span class='op'>|</span> <span class='id identifier rubyid_y'>y</span> <span class='op'>&lt;&lt;</span> <span class='id identifier rubyid_k'>k</span>  <span class='rbrace'>}</span> <span class='rbrace'>}</span> <span class='kw'>unless</span> <span class='id identifier rubyid_block'>block</span>
@@ -1555,13 +1555,13 @@
       <pre class="lines">
 
 
-418
-419
-420
-421</pre>
+424
+425
+426
+427</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 418</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 424</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_each_value'>each_value</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='const'>Enumerator</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_y'>y</span><span class='op'>|</span> <span class='id identifier rubyid_nt_each'>nt_each</span><span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_k'>k</span><span class='comma'>,</span><span class='id identifier rubyid_v'>v</span><span class='op'>|</span> <span class='id identifier rubyid_y'>y</span> <span class='op'>&lt;&lt;</span> <span class='id identifier rubyid_v'>v</span>  <span class='rbrace'>}</span> <span class='rbrace'>}</span> <span class='kw'>unless</span> <span class='id identifier rubyid_block'>block</span>
@@ -1611,12 +1611,12 @@
       <pre class="lines">
 
 
-456
-457
-458</pre>
+462
+463
+464</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 456</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 462</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_empty?'>empty?</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_size'>size</span> <span class='op'>==</span> <span class='int'>0</span>
@@ -1674,16 +1674,16 @@
       <pre class="lines">
 
 
-365
-366
-367
-368
-369
-370
-371</pre>
+371
+372
+373
+374
+375
+376
+377</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 365</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 371</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_fast_each'>fast_each</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_transaction'>transaction</span> <span class='lbrace'>{</span>
@@ -1713,11 +1713,9 @@
 
 <p><code>key</code> <strong>must</strong> be a String or a Symbol; Symbols are transparently converted to Strings.</p>
 
-<p>If it is not present and a block is given, evaluate the block with the key as its argument and return that.</p>
-
-<p>If no block was given either but one extra parameter was given, that value is returned instead.</p>
+<p>If it is not present and a block is given, evaluate the block with the key as its argument and return that. If no block was given either but one extra parameter was given, that value is returned instead. Finally, if none of these was given, it throws an <code>IndexError</code> exception.</p>
 
-<p>Finally, if none of these was given, it throws an <code>IndexError</code> exception.</p>
+<p>All database accesses occur within a transaction, so it is safe to consider <code>fetch</code> atomic. This includes evaluating a block argument.</p>
 
 <p>It is an error if <code>fetch</code> is called with more than two arguments.</p>
 
@@ -1764,8 +1762,6 @@
       <pre class="lines">
 
 
-283
-284
 285
 286
 287
@@ -1789,10 +1785,16 @@
 305
 306
 307
-308</pre>
+308
+309
+310
+311
+312
+313
+314</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 283</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 285</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_fetch'>fetch</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_default_block'>default_block</span><span class='rparen'>)</span>
 
@@ -1805,17 +1807,21 @@
   <span class='comment'># Retrieve the value
 </span>  <span class='id identifier rubyid_key'>key</span> <span class='op'>=</span> <span class='id identifier rubyid_check_key'>check_key</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
 
-  <span class='comment'># Return the value if found.  (nil will always mean the entry
-</span>  <span class='comment'># isn&#39;t present because values are encoded in strings.)
-</span>  <span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_lookup'>lookup</span><span class='lparen'>(</span><span class='id identifier rubyid_actual_tbl'>actual_tbl</span><span class='lparen'>(</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
-  <span class='kw'>return</span> <span class='ivar'>@valdec</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='id identifier rubyid_value'>value</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_value'>value</span>
+  <span class='comment'># We do the lookup-and-maybe-replace in a transaction so that
+</span>  <span class='comment'># it&#39;s atomic.
+</span>  <span class='id identifier rubyid_transaction'>transaction</span> <span class='kw'>do</span>
+    <span class='comment'># Return the value if found.  (nil will always mean the entry
+</span>    <span class='comment'># isn&#39;t present because values are encoded in strings.)
+</span>    <span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_lookup'>lookup</span><span class='lparen'>(</span><span class='id identifier rubyid_actual_tbl'>actual_tbl</span><span class='lparen'>(</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
+    <span class='kw'>return</span> <span class='ivar'>@valdec</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='id identifier rubyid_value'>value</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_value'>value</span>
 
-  <span class='comment'># Not found.  If a block was given, evaluate it and return its
-</span>  <span class='comment'># result.
-</span>  <span class='kw'>return</span> <span class='id identifier rubyid_default_block'>default_block</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_default_block'>default_block</span>
+    <span class='comment'># Not found.  If a block was given, evaluate it and return its
+</span>    <span class='comment'># result.
+</span>    <span class='kw'>return</span> <span class='id identifier rubyid_default_block'>default_block</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_default_block'>default_block</span>
 
-  <span class='comment'># Next, see if we have a default value we can return
-</span>  <span class='kw'>return</span> <span class='id identifier rubyid_args'>args</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span> <span class='kw'>if</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_size'>size</span> <span class='op'>&gt;</span> <span class='int'>0</span>
+    <span class='comment'># Next, see if we have a default value we can return
+</span>    <span class='kw'>return</span> <span class='id identifier rubyid_args'>args</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span> <span class='kw'>if</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_size'>size</span> <span class='op'>&gt;</span> <span class='int'>0</span>
+  <span class='kw'>end</span>
 
   <span class='comment'># And if all else fails, raise an IndexError.
 </span>  <span class='id identifier rubyid_raise'>raise</span> <span class='const'>IndexError</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>key &#39;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_key'>key</span><span class='embexpr_end'>}</span><span class='tstring_content'>&#39; not found.</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
@@ -1868,14 +1874,14 @@
       <pre class="lines">
 
 
-338
-339
-340
-341
-342</pre>
+344
+345
+346
+347
+348</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 338</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 344</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_has_key?'>has_key?</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='kw'>false</span> <span class='kw'>unless</span> <span class='id identifier rubyid_key'>key</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='op'>==</span> <span class='const'>String</span> <span class='op'>||</span> <span class='id identifier rubyid_key'>key</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='op'>==</span> <span class='const'>Symbol</span>
@@ -1932,13 +1938,13 @@
       <pre class="lines">
 
 
-499
-500
-501
-502</pre>
+505
+506
+507
+508</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 499</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 505</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_has_value?'>has_value?</span><span class='lparen'>(</span><span class='id identifier rubyid_val'>val</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_fast_each'>fast_each</span><span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_k'>k</span><span class='comma'>,</span><span class='id identifier rubyid_v'>v</span><span class='op'>|</span> <span class='kw'>return</span> <span class='kw'>true</span> <span class='kw'>if</span> <span class='id identifier rubyid_v'>v</span> <span class='op'>==</span> <span class='id identifier rubyid_val'>val</span> <span class='rbrace'>}</span>
@@ -1977,14 +1983,14 @@
       <pre class="lines">
 
 
-511
-512
-513
-514
-515</pre>
+517
+518
+519
+520
+521</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 511</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 517</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_invert'>invert</span>
   <span class='id identifier rubyid_result'>result</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
@@ -2024,14 +2030,14 @@
       <pre class="lines">
 
 
-320
-321
-322
-323
-324</pre>
+326
+327
+328
+329
+330</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 320</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 326</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_keys'>keys</span>
   <span class='id identifier rubyid_keys'>keys</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
@@ -2069,19 +2075,19 @@
       <pre class="lines">
 
 
-520
-521
-522
-523
-524
-525
 526
 527
 528
-529</pre>
+529
+530
+531
+532
+533
+534
+535</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 520</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 526</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_shift'>shift</span>
   <span class='id identifier rubyid_transaction'>transaction</span> <span class='lbrace'>{</span>
@@ -2128,12 +2134,12 @@
       <pre class="lines">
 
 
-450
-451
-452</pre>
+456
+457
+458</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 450</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 456</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_size'>size</span>
   <span class='kw'>return</span> <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_get_size'>get_size</span><span class='lparen'>(</span><span class='id identifier rubyid_actual_tbl'>actual_tbl</span><span class='lparen'>(</span><span class='rparen'>)</span><span class='rparen'>)</span>
@@ -2171,14 +2177,14 @@
       <pre class="lines">
 
 
-484
-485
-486
-487
-488</pre>
+490
+491
+492
+493
+494</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 484</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 490</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_to_a'>to_a</span>
   <span class='id identifier rubyid_result'>result</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
@@ -2218,14 +2224,14 @@
       <pre class="lines">
 
 
-471
-472
-473
-474
-475</pre>
+477
+478
+479
+480
+481</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 471</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 477</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_to_hash'>to_hash</span>
   <span class='id identifier rubyid_result'>result</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
@@ -2256,14 +2262,14 @@
       <pre class="lines">
 
 
-170
 171
 172
 173
-174</pre>
+174
+175</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 170</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 171</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_to_s'>to_s</span>
   <span class='id identifier rubyid_openstr'>openstr</span> <span class='op'>=</span> <span class='id identifier rubyid_closed?'>closed?</span> <span class='op'>?</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>CLOSED</span><span class='tstring_end'>&#39;</span></span> <span class='op'>:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>OPEN</span><span class='tstring_end'>&#39;</span></span>
@@ -2343,12 +2349,12 @@
       <pre class="lines">
 
 
-228
 229
-230</pre>
+230
+231</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 228</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 229</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_transaction'>transaction</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_transaction'>transaction</span> <span class='lbrace'>{</span> <span class='id identifier rubyid_block'>block</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='kw'>self</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
@@ -2397,12 +2403,12 @@
       <pre class="lines">
 
 
-233
 234
-235</pre>
+235
+236</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 233</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 234</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_transaction_active?'>transaction_active?</span>
   <span class='kw'>return</span> <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_transaction_active?'>transaction_active?</span>
@@ -2438,14 +2444,14 @@
       <pre class="lines">
 
 
-426
-427
-428
-429
-430</pre>
+432
+433
+434
+435
+436</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 426</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 432</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_update'>update</span><span class='lparen'>(</span><span class='id identifier rubyid_hash'>hash</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_transaction'>transaction</span> <span class='lbrace'>{</span>
@@ -2485,14 +2491,14 @@
       <pre class="lines">
 
 
-330
-331
-332
-333
-334</pre>
+336
+337
+338
+339
+340</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 330</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 336</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_values'>values</span>
   <span class='id identifier rubyid_values'>values</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
@@ -2530,12 +2536,12 @@
       <pre class="lines">
 
 
-312
-313
-314</pre>
+318
+319
+320</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 312</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/dbm.rb', line 318</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_values_at'>values_at</span><span class='lparen'>(</span><span class='op'>*</span><span class='id identifier rubyid_keys'>keys</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_keys'>keys</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span><span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_k'>k</span><span class='op'>|</span> <span class='kw'>self</span><span class='lbracket'>[</span><span class='id identifier rubyid_k'>k</span><span class='rbracket'>]</span><span class='rbrace'>}</span>
@@ -2550,7 +2556,7 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Aug 19 13:22:02 2023 by
+  Generated on Sat Mar 30 16:15:43 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.34 (ruby-3.2.1).
 </div>

data/doc/Lite3/Error.html

@@ -129,7 +129,7 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Aug 19 13:22:02 2023 by
+  Generated on Sat Mar 30 16:15:43 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.34 (ruby-3.2.1).
 </div>

data/doc/Lite3/InternalError.html

@@ -133,7 +133,7 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Aug 19 13:22:02 2023 by
+  Generated on Sat Mar 30 16:15:43 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.34 (ruby-3.2.1).
 </div>

data/doc/Lite3/SQL.html

@@ -333,7 +333,7 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Aug 19 13:22:01 2023 by
+  Generated on Sat Mar 30 16:15:42 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.34 (ruby-3.2.1).
 </div>

data/doc/Lite3.html

@@ -109,7 +109,7 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Aug 19 13:22:01 2023 by
+  Generated on Sat Mar 30 16:15:42 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.34 (ruby-3.2.1).
 </div>

data/doc/_index.html

@@ -157,7 +157,7 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Aug 19 13:22:01 2023 by
+  Generated on Sat Mar 30 16:15:42 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.34 (ruby-3.2.1).
 </div>

data/doc/file.README.html

@@ -207,7 +207,7 @@ $ rake
 </div></div>
 
       <div id="footer">
-  Generated on Sat Aug 19 13:22:01 2023 by
+  Generated on Sat Mar 30 16:15:42 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.34 (ruby-3.2.1).
 </div>

data/doc/index.html

@@ -207,7 +207,7 @@ $ rake
 </div></div>
 
       <div id="footer">
-  Generated on Sat Aug 19 13:22:01 2023 by
+  Generated on Sat Mar 30 16:15:42 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.34 (ruby-3.2.1).
 </div>

data/doc/top-level-namespace.html

@@ -100,7 +100,7 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Aug 19 13:22:01 2023 by
+  Generated on Sat Mar 30 16:15:42 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.34 (ruby-3.2.1).
 </div>

data/lib/internal_lite3/dbm.rb

@@ -87,9 +87,10 @@ module Lite3
     end
 
 
-    # Identical to `initialize` except that if a block is provided, it
-    # is evaluated with a new Lite3::DBM which is then closed afterward.
-    # This is analagous to `File.open`.
+    # Identical to `new` except that if a block is provided, it is
+    # evaluated with a new Lite3::DBM which is then closed afterward.
+    # This is analagous to `File.open`.  See `initialize` for an
+    # explanation of the arguments and caveats.
     def self.open(filename, tablename, serializer = :yaml, &block)
       instance = self.new(filename, tablename, serializer)
       return instance unless block
@@ -269,13 +270,14 @@ module Lite3
     # transparently converted to Strings.
     #
     # If it is not present and a block is given, evaluate the block
-    # with the key as its argument and return that.
+    # with the key as its argument and return that.  If no block was
+    # given either but one extra parameter was given, that value is
+    # returned instead.  Finally, if none of these was given, it
+    # throws an `IndexError` exception.
     #
-    # If no block was given either but one extra parameter was given,
-    # that value is returned instead.
-    #
-    # Finally, if none of these was given, it throws an `IndexError`
-    # exception.
+    # All database accesses occur within a transaction, so it is safe
+    # to consider `fetch` atomic.  This includes evaluating a block
+    # argument.
     #
     # It is an error if `fetch` is called with more than two arguments.
     #
@@ -291,17 +293,21 @@ module Lite3
       # Retrieve the value
       key = check_key(key)
 
-      # Return the value if found.  (nil will always mean the entry
-      # isn't present because values are encoded in strings.)
-      value = @handle.lookup(actual_tbl(), key)
-      return @valdec.call(value) if value
+      # We do the lookup-and-maybe-replace in a transaction so that
+      # it's atomic.
+      transaction do
+        # Return the value if found.  (nil will always mean the entry
+        # isn't present because values are encoded in strings.)
+        value = @handle.lookup(actual_tbl(), key)
+        return @valdec.call(value) if value
 
-      # Not found.  If a block was given, evaluate it and return its
-      # result.
-      return default_block.call(key) if default_block
+        # Not found.  If a block was given, evaluate it and return its
+        # result.
+        return default_block.call(key) if default_block
 
-      # Next, see if we have a default value we can return
-      return args[0] if args.size > 0
+        # Next, see if we have a default value we can return
+        return args[0] if args.size > 0
+      end
 
       # And if all else fails, raise an IndexError.
       raise IndexError.new("key '#{key}' not found.")

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dbmlite3
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.0.1
 platform: ruby
 authors:
 - Chris Reuter
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-21 00:00:00.000000000 Z
+date: 2024-03-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sequel
@@ -143,7 +143,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - Sequel, sqlite3, Ruby MRI
-rubygems_version: 3.4.6
+rubygems_version: 3.5.4
 signing_key: 
 specification_version: 4
 summary: A DBM-style key-value store using SQLite3