dbmlite3 1.0.a3 → 1.0.a4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 17eae0eb8bfbfa0da5aee38d17a957d9555faaa07de11b7959853cc51a92e55a
-  data.tar.gz: 7122901693d010af7fd6bfa78f473345c7fe7a74ec09c036959bc3f24fb31b8a
+  metadata.gz: fac72547c8bd87ca5fcc089e5570ee80b4a7beeb539e76df1888c8b1b97b163b
+  data.tar.gz: d689bf111e159c2c46568f921c945fdbdbed53f57e7a6fd68f24bc52baa5cf34
 SHA512:
-  metadata.gz: a83e7f6f4540d45171e2e2e21d034e2a98aa2040d4e7baecafc819f829f20984cca123a890111c190db4bcebfd4421d97401b0b0776034322a22faef7507e6e1
-  data.tar.gz: c3a98e630431c99018b01f68e597cb2beea6ea92a6089af7f29c237f604f1eef4c599696e7ce30153ddd243fe381b92f5b58d78d579ab6b576bbee448a5e81e0
+  metadata.gz: a8706449a100a494853f57f5ee5f7d2c79a67794d835efb3ab5453a56898909129811b4acf72a9770ed61a55b4919105adedc1cdbf005b87475801c7effcb84a
+  data.tar.gz: ef3fc4ad6f06c4b270584cc86d60a0b9526f9e51f1456077edd8076d676bdf1b69f124fe45fca50eabfa88067214c669f7563bd1a29ac23921630614c82b7b35

data/DBMLite3.gemspec

@@ -3,7 +3,7 @@
 
 Gem::Specification.new do |s|
   s.name        = 'dbmlite3'
-  s.version     = '1.0.a3'
+  s.version     = '1.0.a4'
   s.date        = '2022-02-21'
   s.summary     = "A DBM-style key-value store using SQLite3"
   s.description = <<-EOF

data/doc/Lite3/DBM.html

@@ -1086,12 +1086,12 @@ nil if it is not present.</p>
       <pre class="lines">
 
 
-615
-616
-617</pre>
+644
+645
+646</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 615</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 644</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>
@@ -1148,7 +1148,36 @@ serialization method you have chosen.</p>
 607
 608
 609
-610</pre>
+610
+611
+612
+613
+614
+615
+616
+617
+618
+619
+620
+621
+622
+623
+624
+625
+626
+627
+628
+629
+630
+631
+632
+633
+634
+635
+636
+637
+638
+639</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 597</span>
@@ -1157,12 +1186,41 @@ serialization method you have chosen.</p>
   <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='id identifier rubyid_valstr'>valstr</span> <span class='op'>=</span> <span class='const'>SQLite3</span><span class='op'>::</span><span class='const'>Blob</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='ivar'>@valenc</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='rparen'>)</span>
 
-  <span class='id identifier rubyid_insert'>insert</span> <span class='op'>=</span> <span class='heredoc_beg'>&lt;&lt;~SQL</span>
-<span class='tstring_content'>    insert into </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_actual_tbl'>actual_tbl</span><span class='embexpr_end'>}</span><span class='tstring_content'> (key, value) values (?,?)
-</span><span class='tstring_content'>        on conflict(key) do update set value = ?;
-</span><span class='heredoc_end'>    SQL
+  <span class='comment'># At one point, this operation was done with SQLite3&#39;s UPSERT:
+</span>  <span class='comment'>#
+</span>  <span class='comment'>#     insert into #{actual_tbl} (key, value) values (?,?)
+</span>  <span class='comment'>#         on conflict(key) do update set value = ?;
+</span>  <span class='comment'>#
+</span>  <span class='comment'># Unfortunately, this capability was only added to SQLite3 in
+</span>  <span class='comment'># 2018, which means that at the time of this writing (2022)
+</span>  <span class='comment'># there are still a lot of systems out there that have older
+</span>  <span class='comment'># versions of SQLite3 and so can&#39;t do this.
+</span>  <span class='comment'>#
+</span>  <span class='comment'># The venerable `insert or replace` feature **almost** does what
+</span>  <span class='comment'># I want:
+</span>  <span class='comment'>#
+</span>  <span class='comment'>#   insert or replace into #{actual_tbl} (key, value) values (?, ?);
+</span>  <span class='comment'>#
+</span>  <span class='comment'># The one problem is that it changes the order of the rows,
+</span>  <span class='comment'># which we need to preserve in order to remain consistent with
+</span>  <span class='comment'># `Hash` semantics (and because it&#39;s useful).
+</span>  <span class='comment'>#
+</span>  <span class='comment'># So we kick it old school and do a `select` followed by an
+</span>  <span class='comment'># `insert` or `update` wrapped in a transaction.
 </span>  <span class='id identifier rubyid_transaction'>transaction</span> <span class='lbrace'>{</span>
-    <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_sql'>sql</span><span class='lparen'>(</span><span class='id identifier rubyid_insert'>insert</span><span class='comma'>,</span> <span class='lbracket'>[</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_valstr'>valstr</span><span class='comma'>,</span> <span class='id identifier rubyid_valstr'>valstr</span><span class='rbracket'>]</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_rowid'>rowid</span> <span class='op'>=</span> <span class='kw'>nil</span>
+    <span class='id identifier rubyid_select'>select</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>select rowid, key, value from </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_actual_tbl'>actual_tbl</span><span class='embexpr_end'>}</span><span class='tstring_content'> where key = ?;</span><span class='tstring_end'>&quot;</span></span>
+    <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_sql'>sql</span><span class='lparen'>(</span><span class='id identifier rubyid_select'>select</span><span class='comma'>,</span> <span class='lbracket'>[</span><span class='id identifier rubyid_key'>key</span><span class='rbracket'>]</span><span class='rparen'>)</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_row'>row</span><span class='op'>|</span>
+      <span class='id identifier rubyid_rowid'>rowid</span> <span class='op'>=</span> <span class='id identifier rubyid_row'>row</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span>
+    <span class='rbrace'>}</span>
+
+    <span class='kw'>if</span> <span class='id identifier rubyid_rowid'>rowid</span>
+      <span class='id identifier rubyid_update'>update</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>update </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_actual_tbl'>actual_tbl</span><span class='embexpr_end'>}</span><span class='tstring_content'> set value = ? where rowid = ?;</span><span class='tstring_end'>&quot;</span></span>
+      <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_sql'>sql</span><span class='lparen'>(</span><span class='id identifier rubyid_update'>update</span><span class='comma'>,</span> <span class='lbracket'>[</span><span class='id identifier rubyid_valstr'>valstr</span><span class='comma'>,</span> <span class='id identifier rubyid_rowid'>rowid</span><span class='rbracket'>]</span><span class='rparen'>)</span>
+    <span class='kw'>else</span>
+      <span class='id identifier rubyid_insert'>insert</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>insert into </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_actual_tbl'>actual_tbl</span><span class='embexpr_end'>}</span><span class='tstring_content'> (key, value) values (?,?);</span><span class='tstring_end'>&quot;</span></span>
+      <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_sql'>sql</span><span class='lparen'>(</span><span class='id identifier rubyid_insert'>insert</span><span class='comma'>,</span> <span class='lbracket'>[</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_valstr'>valstr</span><span class='rbracket'>]</span><span class='rparen'>)</span>
+    <span class='kw'>end</span>
   <span class='rbrace'>}</span>
 
   <span class='kw'>return</span> <span class='id identifier rubyid_value'>value</span>
@@ -1197,12 +1255,12 @@ serialization method you have chosen.</p>
       <pre class="lines">
 
 
-699
-700
-701</pre>
+728
+729
+730</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 699</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 728</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_clear'>clear</span>
   <span class='id identifier rubyid_transaction'>transaction</span> <span class='lbrace'>{</span> <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_sql'>sql</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>delete from </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_actual_tbl'>actual_tbl</span><span class='embexpr_end'>}</span><span class='tstring_content'>;</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='lbracket'>[</span><span class='rbracket'>]</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
@@ -1339,14 +1397,14 @@ not present, does nothing.</p>
       <pre class="lines">
 
 
-788
-789
-790
-791
-792</pre>
+817
+818
+819
+820
+821</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 788</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 817</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='id identifier rubyid_transaction'>transaction</span> <span class='lbrace'>{</span>
@@ -1405,14 +1463,14 @@ each entry for which the block returns true.</p>
       <pre class="lines">
 
 
-798
-799
-800
-801
-802</pre>
+827
+828
+829
+830
+831</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 798</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 827</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>
@@ -1477,14 +1535,14 @@ own transaction.</p>
       <pre class="lines">
 
 
-713
-714
-715
-716
-717</pre>
+742
+743
+744
+745
+746</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 713</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 742</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>
@@ -1539,13 +1597,13 @@ own transaction.</p>
       <pre class="lines">
 
 
-763
-764
-765
-766</pre>
+792
+793
+794
+795</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 763</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 792</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>
@@ -1599,13 +1657,13 @@ own transaction.</p>
       <pre class="lines">
 
 
-772
-773
-774
-775</pre>
+801
+802
+803
+804</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 772</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 801</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>
@@ -1654,12 +1712,12 @@ own transaction.</p>
       <pre class="lines">
 
 
-815
-816
-817</pre>
+844
+845
+846</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 815</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 844</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>
@@ -1735,36 +1793,36 @@ exception.</p>
       <pre class="lines">
 
 
-633
-634
-635
-636
-637
-638
-639
-640
-641
-642
-643
-644
-645
-646
-647
-648
-649
-650
-651
-652
-653
-654
-655
-656
-657
-658
-659</pre>
+662
+663
+664
+665
+666
+667
+668
+669
+670
+671
+672
+673
+674
+675
+676
+677
+678
+679
+680
+681
+682
+683
+684
+685
+686
+687
+688</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 633</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 662</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>
 
@@ -1898,14 +1956,14 @@ to help with unit tests.</p>
       <pre class="lines">
 
 
-689
-690
-691
-692
-693</pre>
+718
+719
+720
+721
+722</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 689</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 718</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>
@@ -1961,13 +2019,13 @@ to help with unit tests.</p>
       <pre class="lines">
 
 
-858
-859
-860
-861</pre>
+887
+888
+889
+890</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 858</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 887</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='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_each'>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>
@@ -2008,14 +2066,14 @@ program.</p>
       <pre class="lines">
 
 
-870
-871
-872
-873
-874</pre>
+899
+900
+901
+902
+903</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 870</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 899</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>
@@ -2055,14 +2113,14 @@ that the result could exceed available memory.</p>
       <pre class="lines">
 
 
-671
-672
-673
-674
-675</pre>
+700
+701
+702
+703
+704</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 671</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 700</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>
@@ -2101,19 +2159,19 @@ as determined by SQLite3.</p>
       <pre class="lines">
 
 
-879
-880
-881
-882
-883
-884
-885
-886
-887
-888</pre>
+908
+909
+910
+911
+912
+913
+914
+915
+916
+917</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 879</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 908</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>
@@ -2159,15 +2217,15 @@ as determined by SQLite3.</p>
       <pre class="lines">
 
 
-806
-807
-808
-809
-810
-811</pre>
+835
+836
+837
+838
+839
+840</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 806</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 835</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_size'>size</span>
   <span class='ivar'>@handle</span><span class='period'>.</span><span class='id identifier rubyid_sql'>sql</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>select count(*) from </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_actual_tbl'>actual_tbl</span><span class='embexpr_end'>}</span><span class='tstring_content'>;</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='lbracket'>[</span><span class='rbracket'>]</span><span class='rparen'>)</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_row'>row</span><span class='op'>|</span>
@@ -2210,14 +2268,14 @@ program.</p>
       <pre class="lines">
 
 
-843
-844
-845
-846
-847</pre>
+872
+873
+874
+875
+876</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 843</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 872</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>
@@ -2258,14 +2316,14 @@ program.</p>
       <pre class="lines">
 
 
-830
-831
-832
-833
-834</pre>
+859
+860
+861
+862
+863</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 830</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 859</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>
@@ -2466,14 +2524,14 @@ including <code>Hash</code> and <code>DBM</code> objects.</p>
       <pre class="lines">
 
 
-780
-781
-782
-783
-784</pre>
+809
+810
+811
+812
+813</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 780</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 809</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>
@@ -2513,14 +2571,14 @@ that the result could exceed available memory.</p>
       <pre class="lines">
 
 
-681
-682
-683
-684
-685</pre>
+710
+711
+712
+713
+714</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 681</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 710</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>
@@ -2558,12 +2616,12 @@ given keys.</p>
       <pre class="lines">
 
 
-663
-664
-665</pre>
+692
+693
+694</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 663</span>
+      <pre class="code"><span class="info file"># File 'lib/dbmlite3.rb', line 692</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>
@@ -2578,7 +2636,7 @@ given keys.</p>
 </div>
 
       <div id="footer">
-  Generated on Fri Feb 25 20:47:04 2022 by
+  Generated on Sat Feb 26 11:46:07 2022 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.25 (ruby-2.7.0).
 </div>

data/doc/Lite3/Error.html

@@ -125,7 +125,7 @@
 </div>
 
       <div id="footer">
-  Generated on Fri Feb 25 20:47:04 2022 by
+  Generated on Sat Feb 26 11:46:07 2022 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.25 (ruby-2.7.0).
 </div>

data/doc/Lite3/SQL.html

@@ -380,7 +380,7 @@ thread safe.  Just a wrapper around <code>SQLite3.threadsafe?</code></p>
 </div>
 
       <div id="footer">
-  Generated on Fri Feb 25 20:47:04 2022 by
+  Generated on Sat Feb 26 11:46:07 2022 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.25 (ruby-2.7.0).
 </div>

data/doc/Lite3.html

@@ -107,7 +107,7 @@
 </div>
 
       <div id="footer">
-  Generated on Fri Feb 25 20:47:04 2022 by
+  Generated on Sat Feb 26 11:46:07 2022 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.25 (ruby-2.7.0).
 </div>

data/doc/_index.html

@@ -142,7 +142,7 @@
 </div>
 
       <div id="footer">
-  Generated on Fri Feb 25 20:47:04 2022 by
+  Generated on Sat Feb 26 11:46:07 2022 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.25 (ruby-2.7.0).
 </div>

data/doc/file.README.html

@@ -193,7 +193,7 @@ make sense of them.</p>
 </div></div>
 
       <div id="footer">
-  Generated on Fri Feb 25 20:47:04 2022 by
+  Generated on Sat Feb 26 11:46:07 2022 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.25 (ruby-2.7.0).
 </div>

data/doc/index.html

@@ -193,7 +193,7 @@ make sense of them.</p>
 </div></div>
 
       <div id="footer">
-  Generated on Fri Feb 25 20:47:04 2022 by
+  Generated on Sat Feb 26 11:46:07 2022 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.25 (ruby-2.7.0).
 </div>

data/doc/top-level-namespace.html

@@ -100,7 +100,7 @@
 </div>
 
       <div id="footer">
-  Generated on Fri Feb 25 20:47:04 2022 by
+  Generated on Sat Feb 26 11:46:07 2022 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.25 (ruby-2.7.0).
 </div>

data/lib/dbmlite3.rb

@@ -340,7 +340,7 @@ module Lite3
   # string.  you will need to do this instead:
   #
   #     db.keys.include?('foo') or raise AbjectFailure.new
-  #     
+  #
   # Unlike DBM, values may (optionally) be any serializable Ruby type.
   #
   # You can select the serialization method with an optional third
@@ -598,12 +598,41 @@ SQL
       key = check_key(key)
       valstr = SQLite3::Blob.new( @valenc.call(value) )
 
-      insert = <<~SQL
-        insert into #{actual_tbl} (key, value) values (?,?)
-            on conflict(key) do update set value = ?;
-        SQL
+      # At one point, this operation was done with SQLite3's UPSERT:
+      #
+      #     insert into #{actual_tbl} (key, value) values (?,?)
+      #         on conflict(key) do update set value = ?;
+      #
+      # Unfortunately, this capability was only added to SQLite3 in
+      # 2018, which means that at the time of this writing (2022)
+      # there are still a lot of systems out there that have older
+      # versions of SQLite3 and so can't do this.
+      #
+      # The venerable `insert or replace` feature **almost** does what
+      # I want:
+      #
+      #   insert or replace into #{actual_tbl} (key, value) values (?, ?);
+      #
+      # The one problem is that it changes the order of the rows,
+      # which we need to preserve in order to remain consistent with
+      # `Hash` semantics (and because it's useful).
+      #
+      # So we kick it old school and do a `select` followed by an
+      # `insert` or `update` wrapped in a transaction.
       transaction {
-        @handle.sql(insert, [key, valstr, valstr])
+        rowid = nil
+        select = "select rowid, key, value from #{actual_tbl} where key = ?;"
+        @handle.sql(select, [key]) { |row|
+          rowid = row[0]
+        }
+
+        if rowid
+          update = "update #{actual_tbl} set value = ? where rowid = ?;"
+          @handle.sql(update, [valstr, rowid])
+        else
+          insert = "insert into #{actual_tbl} (key, value) values (?,?);"
+          @handle.sql(insert, [key, valstr])
+        end
       }
 
       return value

data/spec/dbmlite3_spec.rb

@@ -120,6 +120,25 @@ Serializations = Set.new
       db.close
     end
 
+    it "preserves order after modification" do
+      path = Tmp.file
+      db = newdb.call(path, "floop")
+
+      expect( db.keys ) .to eq []
+      expect( db.values ) .to eq []
+
+      db["foo"] = 42
+      db["bar"] = 99
+      db["quux"] = 123
+
+      db["foo"] = 88
+
+      expect( db.keys ) .to eq %w{foo bar quux}
+      expect( db.values ) .to eq [88, 99, 123]
+
+      db.close
+    end
+
     it "implements has_key?" do
       path = Tmp.file
       db = newdb.call(path, "floop")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dbmlite3
 version: !ruby/object:Gem::Version
-  version: 1.0.a3
+  version: 1.0.a4
 platform: ruby
 authors:
 - Chris Reuter