dbmlite3 2.0.0.pre.alpha.6 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab0be7881425078c239893c85abbc7d90c90080d22199ba32b90374881c7da74
-  data.tar.gz: 07ac1be8a7477203df27b774421845cee2860a0193e10b5984592e891038a007
+  metadata.gz: d54afa78dc0b955258b1af242e139a7a782eadd8eed2158a7858977287f5c074
+  data.tar.gz: 31d89de7932fa529649b3826d4a70bb24ec2c32f13f00fde2d92fb25b11b5508
 SHA512:
-  metadata.gz: 6ebf5bf6deefa36c6a9e350beb6bc6f89ac838f6bba30a6325c7173503a7e5934665a4f2cf008960656639fbcf956836e6e2c7c613b2e66c9945e08e6c12dfaa
-  data.tar.gz: 6220cf63ff404034f1ec1a81e470ca0af5508e412af46ace4b6209b091237c476d4708383639f2b9ba3d1d6f9ef639185a44a563066c07457d9fcfeb2fbbd32a
+  metadata.gz: 5d889fd9d0ae8f09c7812e9e6d8444deabb6891679be8c33674eeceaaf8db00b3f9515d1d3c12e444126ab6c1b2079f77977ebe3d247c631d01a670b5e8826eb
+  data.tar.gz: a482cec8793ba096d9be6070b226d8b1a93c525e075a08af1590dd5f24ac2ae999b9067c028e59ec762291ef06fab95d4b89266aae49d92d385af576d6b158ed

data/LICENSE.txt

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022 Chris Reuter
+Copyright (c) 2022,2023 Chris Reuter
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/Rakefile

@@ -11,8 +11,8 @@ YARD::Rake::YardocTask.new(:docs_via_yard) do |t|
 end
 
 task :gem => [:doc] do
-  sh "gem build dbmlite3"
-  sh "JRUBY_GEM=yes gem build dbmlite3"
+  gem_prefix = "JRUBY_GEM=yes " if RUBY_PLATFORM == "java"
+  sh "#{gem_prefix}gem build dbmlite3"
 end
 
 task :clean do

data/dbmlite3.gemspec

@@ -18,7 +18,7 @@ end
 
 Gem::Specification.new do |s|
   s.name        = "dbmlite3#{SUFFIX}"
-  s.version     = '2.0.0-alpha.6'
+  s.version     = '2.0.0'
   s.date        = '2022-02-21'
   s.summary     = "A DBM-style key-value store using SQLite3#{SUMMARY_EXTRA}"
   s.description = <<-EOF + DESC_EXTRA
@@ -32,7 +32,7 @@ Gem::Specification.new do |s|
     and safety.
 EOF
   s.authors     = ["Chris Reuter"]
-  s.email       = 'chris@isplitonyourgrave.com'
+  s.email       = 'chris@remove-this-part.blit.ca'
 
   # I'm just going to add everything so that if you've got the gem,
   # you've also got the source distribution.  Yay! Open source!
@@ -40,23 +40,23 @@ EOF
     Dir.glob('doc/**/*') +
     `git ls-files`.split.reject {|f| f =~ /\.org$/}
 
-  
+
   s.required_ruby_version = '>= 2.7.0'
   s.requirements << (JRUBY_GEM                          ?
                      "Sequel, jdbc-sqlite3, JRuby"  :
                      "Sequel, sqlite3, Ruby MRI")
-  
-  s.add_runtime_dependency "sequel", '~> 5.65.0'
+
+  s.add_runtime_dependency "sequel", '~> 5.71.0'
 
   if JRUBY_GEM
-    s.add_runtime_dependency "jdbc-sqlite3", "~> 3.32.3.3"
+    s.add_runtime_dependency "jdbc-sqlite3", "~> 3.42.0.0"
   else
     s.add_runtime_dependency "sqlite3", "~> 1.6.1"
   end
-  
+
   s.add_development_dependency "rspec", '~> 3.10', '>= 3.10.0'
   s.add_development_dependency "yard", '~> 0.9.25', '>= 0.9.25'
-  
+
   s.homepage    = 'https://codeberg.org/suetanvil/dbmlite3'
   s.license     = 'MIT'
 end

data/doc/Lite3/DBM.html

@@ -6,7 +6,7 @@
 <title>
   Class: Lite3::DBM
   
-    &mdash; Documentation by YARD 0.9.26
+    &mdash; Documentation by YARD 0.9.34
   
 </title>
 
@@ -453,7 +453,7 @@
 
   
     <span class="summary_desc"><div class='inline'>
-<p>Behaves like &#39;each&#39; with a block–that is, call it for each key/value pair–but (probably) executes faster.</p>
+<p>Behaves like ‘each’ with a block–that is, call it for each key/value pair–but (probably) executes faster.</p>
 </div></span>
   
 </li>
@@ -579,7 +579,7 @@
 
   
     <span class="summary_desc"><div class='inline'>
-<p>Return a <code>Hash</code> whose keys are the table&#39;s values and whose values are the table&#39;s keys.</p>
+<p>Return a <code>Hash</code> whose keys are the table’s values and whose values are the table’s keys.</p>
 </div></span>
   
 </li>
@@ -1638,11 +1638,11 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>Behaves like &#39;each&#39; with a block–that is, call it for each key/value pair–but (probably) executes faster.</p>
+<p>Behaves like ‘each’ with a block–that is, call it for each key/value pair–but (probably) executes faster.</p>
 
 <p>The downside is that there is no guarantee of reentrance or safety. The block <em>MUST NOT</em> access the database in any way. In addition, no guarantee is made about element order.</p>
 
-<p>(You might be able to infer some ways to safely bend the rules by seeing what the underlying database libraries allow, but your code won&#39;t be future-proof if you do that.)</p>
+<p>(You might be able to infer some ways to safely bend the rules by seeing what the underlying database libraries allow, but your code won’t be future-proof if you do that.)</p>
 
 
   </div>
@@ -1961,7 +1961,7 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>Return a <code>Hash</code> whose keys are the table&#39;s values and whose values are the table&#39;s keys.</p>
+<p>Return a <code>Hash</code> whose keys are the table’s values and whose values are the table’s keys.</p>
 
 <p><strong>WARNING:</strong> it is possible for tables to be significantly larger than available RAM; in that case, this will likely crash your program.</p>
 
@@ -2055,7 +2055,7 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>Remove the first key/value pair from <code>self</code> and return it. “First” is defined by <code>self</code>&#39;s row order, which is the order of insertion as determined by SQLite3.</p>
+<p>Remove the first key/value pair from <code>self</code> and return it. “First” is defined by <code>self</code>‘s row order, which is the order of insertion as determined by SQLite3.</p>
 
 
   </div>
@@ -2287,11 +2287,11 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>Begins a transaction, evaluates the given block and then ends the transaction. If no error occurred (i.e. an exception was thrown), the transaction is committed; otherwise, it is rolled back. Returns the block&#39;s result.</p>
+<p>Begins a transaction, evaluates the given block and then ends the transaction. If no error occurred (i.e. an exception was thrown), the transaction is committed; otherwise, it is rolled back. Returns the block’s result.</p>
 
-<p>It is safe to call <code>DBM.transaction</code> within another <code>DBM.transaction</code> block&#39;s call chain because <code>DBM</code> will not start a new transaction on a database handle that already has one in progress. (It may be possible to trick <code>DBM</code> into trying via fibers or other flow control trickery; don&#39;t do that.)</p>
+<p>It is safe to call <code>DBM.transaction</code> within another <code>DBM.transaction</code> block’s call chain because <code>DBM</code> will not start a new transaction on a database handle that already has one in progress. (It may be possible to trick <code>DBM</code> into trying via fibers or other flow control trickery; don’t do that.)</p>
 
-<p>Note that it&#39;s probably not a good idea to assume too much about the precise semantics; I can&#39;t guarantee that the underlying library(es) won&#39;t change or be replaced outright.</p>
+<p>Note that it’s probably not a good idea to assume too much about the precise semantics; I can’t guarantee that the underlying library(es) won’t change or be replaced outright.</p>
 
 <p>That being said, at present, this is simply a wrapper around <code>Sequel::Database.transaction</code> with the default options and so is subject to the quirks therein. In version 1.0.0, transactions were always executed in <code>:deferred</code> mode via the <code>sqlite3</code> gem.</p>
 
@@ -2330,7 +2330,7 @@
       
         &mdash;
         <div class='inline'>
-<p>Returns the block&#39;s result.</p>
+<p>Returns the block’s result.</p>
 </div>
       
     </li>
@@ -2550,9 +2550,9 @@
 </div>
 
       <div id="footer">
-  Generated on Wed Mar  8 13:02:55 2023 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.26 (ruby-3.0.1).
+  Generated on Sat Aug 19 13:22:02 2023 by
+  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.34 (ruby-3.2.1).
 </div>
 
     </div>

data/doc/Lite3/Error.html

@@ -6,7 +6,7 @@
 <title>
   Exception: Lite3::Error
   
-    &mdash; Documentation by YARD 0.9.26
+    &mdash; Documentation by YARD 0.9.34
   
 </title>
 
@@ -129,9 +129,9 @@
 </div>
 
       <div id="footer">
-  Generated on Wed Mar  8 13:02:55 2023 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.26 (ruby-3.0.1).
+  Generated on Sat Aug 19 13:22:02 2023 by
+  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.34 (ruby-3.2.1).
 </div>
 
     </div>

data/doc/Lite3/InternalError.html

@@ -6,7 +6,7 @@
 <title>
   Exception: Lite3::InternalError
   
-    &mdash; Documentation by YARD 0.9.26
+    &mdash; Documentation by YARD 0.9.34
   
 </title>
 
@@ -133,9 +133,9 @@
 </div>
 
       <div id="footer">
-  Generated on Wed Mar  8 13:02:55 2023 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.26 (ruby-3.0.1).
+  Generated on Sat Aug 19 13:22:02 2023 by
+  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.34 (ruby-3.2.1).
 </div>
 
     </div>

data/doc/Lite3/SQL.html

@@ -6,7 +6,7 @@
 <title>
   Module: Lite3::SQL
   
-    &mdash; Documentation by YARD 0.9.26
+    &mdash; Documentation by YARD 0.9.34
   
 </title>
 
@@ -220,10 +220,10 @@
       <pre class="lines">
 
 
-84</pre>
+87</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/sql.rb', line 84</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/sql.rb', line 87</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_close_all'>close_all</span><span class='lparen'>(</span><span class='rparen'>)</span>    <span class='kw'>return</span> <span class='const'>HandlePool</span><span class='period'>.</span><span class='id identifier rubyid_close_all'>close_all</span>     <span class='kw'>end</span></pre>
     </td>
@@ -245,9 +245,9 @@
     
 <p>Disconnect and delete all database handles and associated metadata that are no longer needed (i.e. because their corresponding <code>DBM</code>s have been closed or reclaimed).</p>
 
-<p>Returns a hash mapping the path to each open database file to the number of live DBM objects referencing it.</p>
+<p>Returns a hash mapping the path to each open database file to the number of live DBM objects referencing it. (Note that DBM objects that have gone out of scope but are not yet finalized count as “live”; as a result, this will differ across Ruby implementations due to differing garbage collector semantics.)</p>
 
-<p>You normally won&#39;t need to explicitly call this, but it&#39;s useful for testing and debugging.</p>
+<p>You normally won’t need to explicitly call this, but it’s useful for testing and debugging.</p>
 
 
   </div>
@@ -261,10 +261,10 @@
       <pre class="lines">
 
 
-71</pre>
+74</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/internal_lite3/sql.rb', line 71</span>
+      <pre class="code"><span class="info file"># File 'lib/internal_lite3/sql.rb', line 74</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_gc'>gc</span><span class='lparen'>(</span><span class='rparen'>)</span>           <span class='kw'>return</span> <span class='const'>HandlePool</span><span class='period'>.</span><span class='id identifier rubyid_gc'>gc</span><span class='semicolon'>;</span>           <span class='kw'>end</span></pre>
     </td>
@@ -333,9 +333,9 @@
 </div>
 
       <div id="footer">
-  Generated on Wed Mar  8 13:02:55 2023 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.26 (ruby-3.0.1).
+  Generated on Sat Aug 19 13:22:01 2023 by
+  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.34 (ruby-3.2.1).
 </div>
 
     </div>

data/doc/Lite3.html

@@ -6,7 +6,7 @@
 <title>
   Module: Lite3
   
-    &mdash; Documentation by YARD 0.9.26
+    &mdash; Documentation by YARD 0.9.34
   
 </title>
 
@@ -109,9 +109,9 @@
 </div>
 
       <div id="footer">
-  Generated on Wed Mar  8 13:02:54 2023 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.26 (ruby-3.0.1).
+  Generated on Sat Aug 19 13:22:01 2023 by
+  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.34 (ruby-3.2.1).
 </div>
 
     </div>

data/doc/_index.html

@@ -4,7 +4,7 @@
     <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>
-  Documentation by YARD 0.9.26
+  Documentation by YARD 0.9.34
   
 </title>
 
@@ -52,7 +52,7 @@
         <div class="clear"></div>
       </div>
 
-      <div id="content"><h1 class="noborder title">Documentation by YARD 0.9.26</h1>
+      <div id="content"><h1 class="noborder title">Documentation by YARD 0.9.34</h1>
 <div id="listing">
   <h1 class="alphaindex">Alphabetic Index</h1>
   
@@ -157,9 +157,9 @@
 </div>
 
       <div id="footer">
-  Generated on Wed Mar  8 13:02:54 2023 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.26 (ruby-3.0.1).
+  Generated on Sat Aug 19 13:22:01 2023 by
+  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.34 (ruby-3.2.1).
 </div>
 
     </div>

data/doc/file.README.html

@@ -6,7 +6,7 @@
 <title>
   File: README
   
-    &mdash; Documentation by YARD 0.9.26
+    &mdash; Documentation by YARD 0.9.34
   
 </title>
 
@@ -139,7 +139,7 @@ $ rake
 <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_db'>db</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>foo</span><span class='tstring_end'>&#39;</span></span><span class='rbracket'>]</span> <span class='op'>+=</span> <span class='int'>1</span>
 </code></pre>
 
-<p>contains a race condition. If (e.g.) two copies of this script are running at the same time, it is possible for both to perform the read before one of them writes, losing the others&#39; result.</p>
+<p>contains a race condition. If (e.g.) two copies of this script are running at the same time, it is possible for both to perform the read before one of them writes, losing the others’ result.</p>
 
 <p>There are two ways to deal with this. You can wrap the read-modify-write cycle in a transaction:</p>
 
@@ -190,26 +190,26 @@ $ rake
 
 <p>While it is generally safe to treat <code>Lite3::DBM</code> as a wrapper around a file handle (i.e. <code>open</code> and <code>close</code> work as expected), you should be aware that this is not precisely the way things actually work. Instead, the gem maintains a pool of database handles, one per file, and associates them with <code>Lite3::DBM</code> instances as needed. This is necessary for transactions to work correctly.</p>
 
-<p>Mostly, you don&#39;t need to care about this. However, it affects you in the following ways:</p>
+<p>Mostly, you don’t need to care about this. However, it affects you in the following ways:</p>
 <ol><li>
 <p>Transactions are done at the file level and not the table level.  This means that you can access separate tables in the same  transaction, which is a Very Good Thing.</p>
 </li><li>
-<p>You can safely fork the current process and keep using existing  <code>DBM</code> objects in both processes, provided you&#39;ve invoked  <code>Lite3::SQL.close_all</code> before the fork. This will have closed the  actual database handles (which can&#39;t tolerate being carried across  a fork) and opens new ones the next time they&#39;re needed.</p>
+<p>You can safely fork the current process and keep using existing  <code>DBM</code> objects in both processes, provided you've invoked  <code>Lite3::SQL.close_all</code> before the fork. This will have closed the  actual database handles (which can't tolerate being carried across  a fork) and opens new ones the next time they're needed.</p>
 </li></ol>
 
-<p><code>DBM</code> objects that go out of scope without first being closed <strong>will</strong> eventually have their underlying resources cleaned up. However, given that <em>when</em> when that happens depends on the vagaries of the garbage collector and various library internals, it&#39;s almost always a bad idea to not explicitly call <code>close</code> first.</p>
+<p><code>DBM</code> objects that go out of scope without first being closed <strong>will</strong> eventually have their underlying resources cleaned up. However, given that <em>when</em> when that happens depends on the vagaries of the garbage collector and various library internals, it’s almost always a bad idea to not explicitly call <code>close</code> first.</p>
 
 <h3 id="label-Under+the+hood">Under the hood</h3>
 
 <p>Currently, <code>Lite3::DBM</code> uses <a href="https://sequel.jeremyevans.net">Sequel</a> to access the <code>sqlite3</code> library. On JRuby, it goes through the <code>jdbc</code> interface. The previous version (1.0.0) used <a href="https://github.com/sparklemotion/sqlite3-ruby">sqlite3</a> and only worked on MRI. However, you should make no assumptions about the underlying database libraries this gem uses. It may change in a future release.</p>
 
-<p>All tables created by <code>Lite3::DBM</code> will have names beginning with <code>dbmlite3_</code> and you should not modify them directly. It <strong>might</strong> be safe to put other tables in the same database file (e.g. via <code>Sequel</code>) provided that you don&#39;t make global changes or mix transactions across interfaces. However, I make no guarantees.</p>
+<p>All tables created by <code>Lite3::DBM</code> will have names beginning with <code>dbmlite3_</code> and you should not modify them directly. It <strong>might</strong> be safe to put other tables in the same database file (e.g. via <code>Sequel</code>) provided that you don’t make global changes or mix transactions across interfaces. However, I make no guarantees.</p>
 </div></div>
 
       <div id="footer">
-  Generated on Wed Mar  8 13:02:54 2023 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.26 (ruby-3.0.1).
+  Generated on Sat Aug 19 13:22:01 2023 by
+  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.34 (ruby-3.2.1).
 </div>
 
     </div>

data/doc/frames.html

@@ -2,7 +2,7 @@
 <html>
 <head>
   <meta charset="utf-8">
-	<title>Documentation by YARD 0.9.26</title>
+	<title>Documentation by YARD 0.9.34</title>
 </head>
 <script type="text/javascript">
   var match = unescape(window.location.hash).match(/^#!(.+)/);

data/doc/index.html

@@ -6,7 +6,7 @@
 <title>
   File: README
   
-    &mdash; Documentation by YARD 0.9.26
+    &mdash; Documentation by YARD 0.9.34
   
 </title>
 
@@ -139,7 +139,7 @@ $ rake
 <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_db'>db</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>foo</span><span class='tstring_end'>&#39;</span></span><span class='rbracket'>]</span> <span class='op'>+=</span> <span class='int'>1</span>
 </code></pre>
 
-<p>contains a race condition. If (e.g.) two copies of this script are running at the same time, it is possible for both to perform the read before one of them writes, losing the others&#39; result.</p>
+<p>contains a race condition. If (e.g.) two copies of this script are running at the same time, it is possible for both to perform the read before one of them writes, losing the others’ result.</p>
 
 <p>There are two ways to deal with this. You can wrap the read-modify-write cycle in a transaction:</p>
 
@@ -190,26 +190,26 @@ $ rake
 
 <p>While it is generally safe to treat <code>Lite3::DBM</code> as a wrapper around a file handle (i.e. <code>open</code> and <code>close</code> work as expected), you should be aware that this is not precisely the way things actually work. Instead, the gem maintains a pool of database handles, one per file, and associates them with <code>Lite3::DBM</code> instances as needed. This is necessary for transactions to work correctly.</p>
 
-<p>Mostly, you don&#39;t need to care about this. However, it affects you in the following ways:</p>
+<p>Mostly, you don’t need to care about this. However, it affects you in the following ways:</p>
 <ol><li>
 <p>Transactions are done at the file level and not the table level.  This means that you can access separate tables in the same  transaction, which is a Very Good Thing.</p>
 </li><li>
-<p>You can safely fork the current process and keep using existing  <code>DBM</code> objects in both processes, provided you&#39;ve invoked  <code>Lite3::SQL.close_all</code> before the fork. This will have closed the  actual database handles (which can&#39;t tolerate being carried across  a fork) and opens new ones the next time they&#39;re needed.</p>
+<p>You can safely fork the current process and keep using existing  <code>DBM</code> objects in both processes, provided you've invoked  <code>Lite3::SQL.close_all</code> before the fork. This will have closed the  actual database handles (which can't tolerate being carried across  a fork) and opens new ones the next time they're needed.</p>
 </li></ol>
 
-<p><code>DBM</code> objects that go out of scope without first being closed <strong>will</strong> eventually have their underlying resources cleaned up. However, given that <em>when</em> when that happens depends on the vagaries of the garbage collector and various library internals, it&#39;s almost always a bad idea to not explicitly call <code>close</code> first.</p>
+<p><code>DBM</code> objects that go out of scope without first being closed <strong>will</strong> eventually have their underlying resources cleaned up. However, given that <em>when</em> when that happens depends on the vagaries of the garbage collector and various library internals, it’s almost always a bad idea to not explicitly call <code>close</code> first.</p>
 
 <h3 id="label-Under+the+hood">Under the hood</h3>
 
 <p>Currently, <code>Lite3::DBM</code> uses <a href="https://sequel.jeremyevans.net">Sequel</a> to access the <code>sqlite3</code> library. On JRuby, it goes through the <code>jdbc</code> interface. The previous version (1.0.0) used <a href="https://github.com/sparklemotion/sqlite3-ruby">sqlite3</a> and only worked on MRI. However, you should make no assumptions about the underlying database libraries this gem uses. It may change in a future release.</p>
 
-<p>All tables created by <code>Lite3::DBM</code> will have names beginning with <code>dbmlite3_</code> and you should not modify them directly. It <strong>might</strong> be safe to put other tables in the same database file (e.g. via <code>Sequel</code>) provided that you don&#39;t make global changes or mix transactions across interfaces. However, I make no guarantees.</p>
+<p>All tables created by <code>Lite3::DBM</code> will have names beginning with <code>dbmlite3_</code> and you should not modify them directly. It <strong>might</strong> be safe to put other tables in the same database file (e.g. via <code>Sequel</code>) provided that you don’t make global changes or mix transactions across interfaces. However, I make no guarantees.</p>
 </div></div>
 
       <div id="footer">
-  Generated on Wed Mar  8 13:02:54 2023 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.26 (ruby-3.0.1).
+  Generated on Sat Aug 19 13:22:01 2023 by
+  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.34 (ruby-3.2.1).
 </div>
 
     </div>

data/doc/top-level-namespace.html

@@ -6,7 +6,7 @@
 <title>
   Top Level Namespace
   
-    &mdash; Documentation by YARD 0.9.26
+    &mdash; Documentation by YARD 0.9.34
   
 </title>
 
@@ -100,9 +100,9 @@
 </div>
 
       <div id="footer">
-  Generated on Wed Mar  8 13:02:54 2023 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.26 (ruby-3.0.1).
+  Generated on Sat Aug 19 13:22:01 2023 by
+  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.34 (ruby-3.2.1).
 </div>
 
     </div>

data/lib/internal_lite3/dbm.rb

@@ -1,6 +1,6 @@
 
 module Lite3
-  
+
   # Lite3::DBM encapsulates a single table in a single SQLite3
   # database file and lets you access it as easily as a Hash.
   # Multiple instances may be opened on different tables in the same
@@ -267,7 +267,7 @@ module Lite3
     #
     # `key` **must** be a String or a Symbol; Symbols are
     # 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.
     #
@@ -370,7 +370,7 @@ module Lite3
       }
     end
 
-    
+
     # Calls the given block with each key-value pair in the usual
     # order, then return self.  The entire call takes place in its own
     # transaction.

data/lib/internal_lite3/error.rb

@@ -10,18 +10,14 @@ module Lite3
 
   private
 
-  
   module ErrUtil
-
     # Error check: if block evaluates to false, raise a Lite3::DBM::Error
     # with the given message.
     def check(message, &block)
       return if block && block.call
       raise InternalError.new(message)
     end
-    
   end
 
-
   private_constant :ErrUtil
 end

data/lib/internal_lite3/handle.rb

@@ -41,7 +41,7 @@ module Lite3
     end
     alias inspect to_s
 
-    
+
     #
     # References to the DBM object(s) using this handle.
     #
@@ -85,7 +85,7 @@ module Lite3
     #
     # Transactions
     #
-    
+
     # Perform &block in a transaction.  See DBM.transaction.
     def transaction(&block)
       result = nil

data/lib/internal_lite3/sql.rb

@@ -64,7 +64,10 @@ module Lite3
     # corresponding `DBM`s have been closed or reclaimed).
     #
     # Returns a hash mapping the path to each open database file to
-    # the number of live DBM objects referencing it.
+    # the number of live DBM objects referencing it.  (Note that DBM
+    # objects that have gone out of scope but are not yet finalized
+    # count as "live"; as a result, this will differ across Ruby
+    # implementations due to differing garbage collector semantics.)
     #
     # You normally won't need to explicitly call this, but it's
     # useful for testing and debugging.

data/spec/dbmlite3_spec.rb

@@ -5,6 +5,10 @@ require_relative '../lib/dbmlite3.rb'
 require 'fileutils'
 require 'set'
 
+def jruby?
+  return RUBY_PLATFORM == "java"
+end
+
 module Tmp
   @root = File.join( File.dirname(__FILE__), "tmpdata")
   @count = 0
@@ -884,7 +888,8 @@ describe Lite3::SQL do
   }
 
   it "lets you close the actual handle without impeding database use" do
-    expect( Lite3::SQL.gc.size ) .to eq 0
+    jruby? or   # JRuby GC semantics throw this off
+      expect( Lite3::SQL.gc.size ) .to eq 0
 
     file = Tmp.file
     db1 = newbasic.call(file, "first")
@@ -892,14 +897,17 @@ describe Lite3::SQL do
 
     # The above should be using the same handle, which is currently
     # open.
-
-    stats = Lite3::SQL.gc
-    expect( stats.keys.size ) .to eq 1
-
-    # Referencing DBM objects should be db1 and db2
-    path, refs = stats.to_a[0]
-    expect( path ) .to eq file
-    expect( refs ) .to eq 2
+    #
+    # (Depends on GC wierdness so we skip this part for JRuby.)
+    unless jruby?
+      stats = Lite3::SQL.gc
+      expect( stats.keys.size ) .to eq 1
+
+      # Referencing DBM objects should be db1 and db2
+      path, refs = stats.to_a[0]
+      expect( path ) .to eq file
+      expect( refs ) .to eq 2
+    end
 
     # We can no longer test if the underlying file handles are still
     # open, so we don't.
@@ -915,7 +923,8 @@ describe Lite3::SQL do
     db1.close
     db2.close
 
-    expect( Lite3::SQL.gc.keys.size ) .to eq 0
+    jruby? or
+      expect( Lite3::SQL.gc.keys.size ) .to eq 0
   end
 
   it "allows multiple table accesses in the same transaction" do
@@ -978,6 +987,7 @@ describe Lite3::SQL do
     #
     # (Dropping into the debugger after GC.start seems to help.)
 
+    skip "JRuby GC is capricious" if jruby?
 
     file = Tmp.file
     db1 = newbasic.call(file, "first")
@@ -1017,6 +1027,7 @@ end
 
 describe self do
   it "(this test) closes all handles when done with them" do
+    skip "JRuby GC is capricious"if jruby?
     expect( Lite3::SQL.gc.size ) .to eq 0
   end
 end

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: dbmlite3
 version: !ruby/object:Gem::Version
-  version: 2.0.0.pre.alpha.6
+  version: 2.0.0
 platform: ruby
 authors:
 - Chris Reuter
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
 date: 2022-02-21 00:00:00.000000000 Z
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.65.0
+        version: 5.71.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.65.0
+        version: 5.71.0
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
@@ -87,7 +87,7 @@ description: |2
       (almost) any Ruby type to be stored.  In addition, there is
       rudimentary support for transactions with emphasis on simplicity
       and safety.
-email: chris@isplitonyourgrave.com
+email: chris@remove-this-part.blit.ca
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -116,7 +116,6 @@ files:
 - doc/js/jquery.js
 - doc/method_list.html
 - doc/top-level-namespace.html
-- extras/benchmark.rb
 - lib/dbmlite3.rb
 - lib/internal_lite3/dbm.rb
 - lib/internal_lite3/error.rb
@@ -128,7 +127,7 @@ homepage: https://codeberg.org/suetanvil/dbmlite3
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -139,13 +138,13 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements:
 - Sequel, sqlite3, Ruby MRI
-rubygems_version: 3.2.15
-signing_key:
+rubygems_version: 3.4.6
+signing_key: 
 specification_version: 4
 summary: A DBM-style key-value store using SQLite3
 test_files: []

data/extras/benchmark.rb

@@ -1,172 +0,0 @@
-#!/usr/bin/env ruby
-
-# Low-effort benchmark comparing Lite3::DBM in various modes against
-# other equivalent Hash-like Ruby storage mechanisms.
-
-require 'dbmlite3'
-require 'yaml/dbm' unless RUBY_PLATFORM == "java"
-require 'fileutils'
-require 'optparse'
-
-COUNT = 10000
-
-Opts = proc do
-  opt_defaults = {
-    count: COUNT,
-    transaction_only: true,
-  }
-
-  opts = Struct.new(*opt_defaults.keys).new(*opt_defaults.values)
-
-  OptionParser.new do |opo|
-    opo.banner = "Usage: bench_1.rb [options]"
-
-    opo.on("-t", "--multi-transaction",
-           "Don't batch Lite3 accesses in one big transaction.") {
-      opts.transaction_only = false
-    }
-
-    opo.on("-c", "--count N", Integer, "Set test count.") { |c|
-      opts.count = c
-    }
-  end.parse!
-
-  next opts
-end.call
-
-
-module Tmp
-  @root = File.join( File.dirname(__FILE__), "tmpdata")
-  @count = 0
-
-  def self.file
-    FileUtils.mkdir(@root) unless File.directory?(@root)
-
-    file = "testfile_#{@count}_#{$$}.sqlite3"
-    @count += 1
-
-    return File.join(@root, file)
-  end
-
-  def self.cleanup
-    return unless File.directory?(@root)
-    FileUtils.rm_rf(@root)
-  end
-end
-
-
-
-def insert(count, db, offset)
-  for n in 0 .. count
-    db["k_#{n}"] = "#{n + offset}"
-  end
-end
-
-
-def lookup(count, db)
-  rnd = Random.new(69_420)
-  sz = db.size
-
-  for _ in 0 .. count * 3
-    idx = rnd.rand(sz)
-    v = db["k_#{idx}"]
-    raise "Invalid value: #{v}" unless v.to_s == "#{idx + 1}"
-  end
-end
-
-
-Times = {}
-
-def time_it(type, task, db, use_tr, &block)
-  print "#{type} #{task} - "
-  STDOUT.flush
-
-  start = Time.now
-
-  if use_tr && db.respond_to?(:transaction)
-    db.transaction { block.call }
-  else
-    block.call
-  end
-
-  finish = Time.now
-
-  elapsed = (finish - start).to_f
-  Times[type] = Times.fetch(type, 0) + elapsed
-
-  puts "#{elapsed.round(4)}"
-end
-
-def bench(count, desc, db, use_tr)
-  time_it(desc, "insert", db, use_tr) {
-    insert(count, db, 0)
-  }
-  time_it(desc, "upsert", db, use_tr) {
-    insert(count, db, 1)
-  }
-  time_it(desc, "lookup", db, use_tr) {
-    lookup(count, db)
-  }
-  time_it(desc, "delete_if", db, use_tr) {
-    rnd = Random.new(69_420)
-    db.delete_if{|k,v| rnd.rand(2) == 0}
-  }
-  puts
-end
-
-
-
-def main
-  puts "Count = #{Opts.count}\n"
-
-  Tmp.cleanup
-
-  bench(Opts.count, "hash", {}, false)
-
-  if RUBY_PLATFORM != "java"
-    DBM.open(Tmp.file) {|dbm|
-      bench(Opts.count, "DBM", dbm, false)
-    }
-  
-    YAML::DBM.open(Tmp.file) {|dbm|
-      bench(Opts.count, "YAML::DBM", dbm, false)
-    }
-  end
-
-  Lite3::DBM.open(Tmp.file, "benchmark", :yaml) { |dbm|
-    bench(Opts.count, "Lite3::DBM(yaml)", dbm, true)
-  }
-
-  Lite3::DBM.open(Tmp.file, "benchmark", :marshal) { |dbm|
-    bench(Opts.count, "Lite3::DBM(marshal)", dbm, true)
-  }
-
-  Lite3::DBM.open(Tmp.file, "benchmark", :string) { |dbm|
-    bench(Opts.count, "Lite3::DBM(string)", dbm, true)
-  }
-
-  if !Opts.transaction_only
-    Lite3::DBM.open(Tmp.file, "benchmark", :yaml) { |dbm|
-      bench(Opts.count, "Lite3::DBM(yaml, single-trans)", dbm, false)
-    }
-
-    Lite3::DBM.open(Tmp.file, "benchmark", :marshal) { |dbm|
-      bench(Opts.count, "Lite3::DBM(marshal, single-trans)", dbm, false)
-    }
-
-    Lite3::DBM.open(Tmp.file, "benchmark", :string) { |dbm|
-      bench(Opts.count, "Lite3::DBM(string, single-trans)", dbm, false)
-    }
-  end
-
-
-  puts
-  puts "Totals:"
-  Times.each{|k,v|
-    puts "    #{k} - #{v.round(4)}"
-  }
-
-  Tmp.cleanup
-end
-
-main