extralite 1.8.2 → 1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd26d2937628e408ba8ee2f69e2e170755a43d5e1ffcdcbb82ca184cd5734576
-  data.tar.gz: c762b88c6e1671de5daab90f6f6fb574bb4dfb43fb0a866e8154fb8ac02f755f
+  metadata.gz: 874f2ebc573b23e4336b69409252b2cbb8c71c1275b1ca34d1d1924999d8ed31
+  data.tar.gz: 5b304d82a818c3e0da2dd72bca6fa590ff8be84241c6dc54fdb9f3bee49e498a
 SHA512:
-  metadata.gz: 9ea096a28f15e8415b8e450a45035ffbe0c2186ebc7bba2ddd76c34e2328baaff307cee3c5079dda235992011497ef72b924bf3916628842e100ba8953ee7454
-  data.tar.gz: 0efd84d3a7fa1fd1157df43f65bd4fa6999a0943efc8c0b36030a8550bbb2bc1c3a96509d4bf6c7a8a2bb9c4bd071dc0a650cb45e54e75c7ec722ee29c8bb72e
+  metadata.gz: dd039c09306a04eb1e1cd42eb968c58cbf7693fd09c31587e9b7853a061c2a607af9d594859510f6cabc2ef5f166426a5a0ae4459b40168b10ea3fc4c6e3063f
+  data.tar.gz: 2b65161b0ec69a8072e8e2f343386d8178194d1dae3bfc2ac16e414f5682d2ca1da501057f1da38cf875238e0314aa35032dcdbbf3d610affe14fb572713435a

data/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: ciconia

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 1.9 2021-12-15
+
+- Add support for reading BLOBs
+
 ## 1.8.2 2021-12-15
 
 - Add documentation

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    extralite (1.8.2)
+    extralite (1.9)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -1,4 +1,4 @@
-# Extralite - a Ruby gem for working with SQLite3 databases
+# Extralite - a fast Ruby gem for working with SQLite3 databases
 
 [![Gem Version](https://badge.fury.io/rb/extralite.svg)](http://rubygems.org/gems/extralite)
 [![Modulation Test](https://github.com/digital-fabric/extralite/workflows/Tests/badge.svg)](https://github.com/digital-fabric/extralite/actions?query=workflow%3ATests)
@@ -6,9 +6,9 @@
 
 ## What is Extralite?
 
-Extralite is an extra-lightweight (less than 430 lines of C-code) SQLite3
-wrapper for Ruby. It provides a single class with a minimal set of methods to
-interact with an SQLite3 database.
+Extralite is a fast, extra-lightweight (less than 460 lines of C-code) SQLite3
+wrapper for Ruby. It provides a single class with a minimal set of methods for
+interacting with an SQLite3 database.
 
 ## Features
 
@@ -127,7 +127,7 @@ Here's a table summarizing the differences between the two gems:
 |custom collations|yes|no|
 |custom aggregate functions|yes|no|
 |Multithread friendly|no|[yes](#what-about-concurrency)|
-|Code size|~2650LoC|~500LoC|
+|Code size|~2650LoC|~530LoC|
 |Performance|1x|1.5x to 12.5x (see [below](#performance))|
 
 ## What about concurrency?
@@ -140,23 +140,33 @@ performance:
 
 ## Performance
 
-A benchmark script is
-[included](https://github.com/digital-fabric/extralite/blob/main/test/perf.rb),
-creating a table of various row counts, then fetching the entire table using
-either `sqlite3` or `extralite`. This benchmark shows Extralite to be up to 12.5
-times faster than `sqlite3` when fetching a large number of rows. Here are the
-results (using the `sqlite3` gem performance as baseline):
+A benchmark script is included, creating a table of various row counts, then
+fetching the entire table using either `sqlite3` or `extralite`. This benchmark
+shows Extralite to be up to 12.5 times faster than `sqlite3` when fetching a
+large number of rows. Here are the [results for fetching rows as hashes](https://github.com/digital-fabric/extralite/blob/main/test/perf_hash.rb):
 
-|Row count|sqlite3-ruby (baseline)|Extralite (relative - rounded)|
-|-:|-:|-:|
-|10|1x|1.5x|
-|1K|1x|7x|
-|100K|1x|12.5x|
+|Row count|sqlite3-ruby|Extralite|Advantage|
+|-:|-:|-:|-:|
+|10|57620 rows/s|95340 rows/s|__1.65x__|
+|1K|286.8K rows/s|2106.4 rows/s|__7.35x__|
+|100K|181K rows/s|2275.3K rows/s|__12.53x__|
+
+When [fetching rows as arrays](https://github.com/digital-fabric/extralite/blob/main/test/perf_ary.rb) Extralite also significantly outperforms sqlite3-ruby:
+
+|Row count|sqlite3-ruby|Extralite|Advantage|
+|-:|-:|-:|-:|
+|10|64365 rows/s|94031 rows/s|__1.46x__|
+|1K|498.9K rows/s|2478.2K rows/s|__4.97x__|
+|100K|441.1K rows/s|3023.4K rows/s|__6.85x__|
 
 (If you're interested in checking this yourself, just run the script and let me
-know if your results are different.)
+know if your results are better/worse.)
+
+As those benchmarks show, Extralite is capabale of reading more than 3M
+rows/second (when fetching rows as arrays), and more than 2.2M rows/second (when
+fetching rows as hashes.)
 
 ## Contributing
 
 Contributions in the form of issues, PRs or comments will be greatly
-appreciated!
+appreciated!

data/ext/extralite/extralite.c

@@ -116,7 +116,7 @@ inline VALUE get_column_value(sqlite3_stmt *stmt, int col, int type) {
     case SQLITE_TEXT:
       return rb_str_new_cstr((char *)sqlite3_column_text(stmt, col));
     case SQLITE_BLOB:
-      rb_raise(cError, "BLOB reading not yet implemented");
+      return rb_str_new((const char *)sqlite3_column_blob(stmt, col), (long)sqlite3_column_bytes(stmt, col));
     default:
       rb_raise(cError, "Unknown column type: %d", type);
   }

data/lib/extralite/version.rb

@@ -1,3 +1,3 @@
 module Extralite
-  VERSION = '1.8.2'
+  VERSION = '1.9'
 end

data/test/perf_ary.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'bundler/inline'
+
+gemfile do
+  source 'https://rubygems.org'
+  gem 'sqlite3'
+  gem 'extralite', path: '..'
+  gem 'benchmark-ips'
+end
+
+require 'benchmark/ips'
+require 'fileutils'
+
+DB_PATH = '/tmp/extralite_sqlite3_perf.db'
+
+def prepare_database(count)
+  FileUtils.rm(DB_PATH) rescue nil
+  db = Extralite::Database.new(DB_PATH)
+  db.query('create table foo ( a integer primary key, b text )')
+  db.query('begin')
+  count.times { db.query('insert into foo (b) values (?)', "hello#{rand(1000)}" )}
+  db.query('commit')
+end
+
+def sqlite3_run(count)
+  db = SQLite3::Database.new(DB_PATH)
+  results = db.execute('select * from foo')
+  raise unless results.size == count
+end
+
+def extralite_run(count)
+  db = Extralite::Database.new(DB_PATH)
+  results = db.query_ary('select * from foo')
+  raise unless results.size == count
+end
+
+[10, 1000, 100000].each do |c|
+  puts; puts; puts "Record count: #{c}"
+
+  prepare_database(c)
+
+  Benchmark.ips do |x|
+    x.config(:time => 3, :warmup => 1)
+
+    x.report("sqlite3") { sqlite3_run(c) }
+    x.report("extralite") { extralite_run(c) }
+
+    x.compare!
+  end
+end

data/test/test_database.rb

@@ -138,6 +138,23 @@ end
     r = @db.query('select x, y, z from t where z = :bazzz', ':bazzz' => 6)
     assert_equal [{ x: 4, y: 5, z: 6 }], r
   end
+
+  def test_value_casting
+    r = @db.query_single_value("select 'abc'")
+    assert_equal 'abc', r
+
+    r = @db.query_single_value('select 123')
+    assert_equal 123, r
+
+    r = @db.query_single_value('select 12.34')
+    assert_equal 12.34, r
+
+    r = @db.query_single_value('select zeroblob(4)')
+    assert_equal "\x00\x00\x00\x00", r
+
+    r = @db.query_single_value('select null')
+    assert_nil r
+  end
 end
 
 class ScenarioTest < MiniTest::Test

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: extralite
 version: !ruby/object:Gem::Version
-  version: 1.8.2
+  version: '1.9'
 platform: ruby
 authors:
 - Sharon Rosner
@@ -88,6 +88,7 @@ extensions:
 extra_rdoc_files:
 - README.md
 files:
+- ".github/FUNDING.yml"
 - ".github/workflows/test.yml"
 - ".gitignore"
 - CHANGELOG.md
@@ -105,7 +106,8 @@ files:
 - lib/extralite/version.rb
 - lib/sequel/adapters/extralite.rb
 - test/helper.rb
-- test/perf.rb
+- test/perf_ary.rb
+- test/perf_hash.rb
 - test/run.rb
 - test/test_database.rb
 - test/test_sequel.rb