libsql-sequel 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37c836e635f6104c6972774e8cb3dba6397cfbf5b6c958c19f15eaaca4fc1367
-  data.tar.gz: adce3fe4850eab4d30b4b303f404520f969390060dded1b89def96675d2f7249
+  metadata.gz: 0b85ae761e49c7fc3ed4146cdf94f244d1cae27a1642b57fe7ebc9e00265211e
+  data.tar.gz: e7a634b05315f2795010cfbb8719ae8edbf70c4fd942950a33b56c77a5d59adf
 SHA512:
-  metadata.gz: d02c3ee895aa85b2e4bae54743d0fc8b8b0028a8170b9b87212caeab594798b080c52dba582b2fd882a19e23a3aea5989ba5f0b53dc33ba68f7c924cb544b606
-  data.tar.gz: 8c777ebc4996b0d96a5e4fd437337347568820f5a8a3adc2569ce69ad603f6b133acb386e6f8c2e59a641789b62f7c8aef780e66234908ba05e28e394276df37
+  metadata.gz: ca3aa0de34530d183c699699380c984a1bf84c52e2f509ac90c433da17abb334db72083fd1d820932b8adef32be47d4a9a3d80f7765a722368d9da417454e2eb
+  data.tar.gz: 34d675b2abcaf4435812d98b38ccf3a0c6931ca52e4652bf49a1d77df38538f14b2f5bb1c78ab1a2fc4ca7663d3882ee3d18be7d9e096aa7b0da3774e1e44496

data/README.md

@@ -30,13 +30,13 @@ Install from [RubyGems](https://rubygems.org/gems/libsql-sequel):
 
 ```ruby
 # Gemfile
-gem 'libsql-sequel', '~> 0.3.0'
+gem 'libsql-sequel', '~> 0.3.1'
 ```
 
 Then run `bundle install`. To install without Bundler:
 
 ```sh
-gem install libsql-sequel -v 0.3.0
+gem install libsql-sequel -v 0.3.1
 ```
 
 Ruby 3.3+ and Sequel 5.80–5.x are required. The native dependency is **pinned to `turso_libsql` 0.2.0**: 0.2.1 contains native debug output of connection credentials and SQL. Do not widen that dependency without reviewing the replacement library. The adapter uses the bundled native library with scoped corrections for the driver's Ruby wrapper; it does not patch global `Libsql` classes or require `sqlite3` at runtime.
@@ -135,6 +135,7 @@ bundle exec rake lint          # syntax and method visibility only
 bundle exec rake test          # real native local/file databases
 bundle exec rake upstream      # upstream SQLite + integration specs
 bundle exec rake remote_local  # real native HTTP client, local Hrana server
+bundle exec rake performance   # local end-to-end timing and allocation benchmarks
 ```
 
 `upstream` and `remote_local` need the ignored reference checkouts; setup instructions are in [development.md](docs/development.md). `rake` defaults to `check`. Checks follow Sequel's own syntax/warnings/visibility approach; Sequel does not configure RuboCop or a complexity analyzer. See [the spec and code-quality review](docs/testing-review.md).
@@ -142,3 +143,8 @@ bundle exec rake remote_local  # real native HTTP client, local Hrana server
 For an explicit test against a **disposable** hosted database, set `LIBSQL_TEST_URL` and `LIBSQL_TEST_AUTH_TOKEN` in your environment, then run `bundle exec rake remote`. It creates randomly named test tables and drops those tables afterward. Hosted authentication and HTTPS remote operations have been validated with a `turso://` URL; embedded replication remains unverified. See [compatibility and verification](docs/compatibility.md) for the tested scope.
 
 See [architecture](docs/architecture.md), [compatibility](docs/compatibility.md), and [the local example](examples/local.rb).
+
+The [performance suite](test/performance/README.md) covers queries/chaining, bound
+and prepared operations, result decoding, CRUD, models, transactions, bulk writes,
+schema operations, and file-backed connection concurrency. It includes correctness
+checks, JSON before/after comparisons, and a Sequel SQLite reference mode.

data/docs/architecture.md

@@ -34,6 +34,15 @@ Sequel's cached placeholder literalizer optimization is disabled because it repl
 
 Numeric timestamps follow Sequel's SQLite convention: Integer means Unix seconds and Float means Julian day. Numeric TIME values preserve microseconds. BLOB columns containing integer/real/text storage values convert through their string representation, and nonnumeric text in a decimal column remains text, matching Sequel's SQLite adapter.
 
+Result decoding resolves column types once per result, then uses an indexed loop
+to assemble row hashes, following Sequel's SQLite adapter. The native column count
+is also resolved once per iteration over a result. Signed-integer bounds are
+constants rather than repeated Bignum arithmetic per cell/bind. Native text input
+can reuse a frozen UTF-8 string; mutable strings are still copied before calls
+that release the GVL. These optimizations preserve per-row cleanup and schema
+invalidation; they introduce no statement or result-type cache. The local
+[performance suite](../test/performance/README.md) records timing and allocations.
+
 Sequel invalidates its own schema cache for schema DSL changes. External schema changes and arbitrary DDL via `run` follow Sequel's usual cache rules; reload the affected schema or reconnect the Database object when needed. No extra unbounded type cache is introduced.
 
 ## Driver boundary

data/docs/development.md

@@ -51,11 +51,21 @@ The fixture needs a free localhost port 8080. It creates a temporary SQLite file
 
 For a disposable hosted database, export `LIBSQL_TEST_URL` and `LIBSQL_TEST_AUTH_TOKEN`, then run `bundle exec rake remote`. Tests create randomly named tables and drop only those tables. Do not point destructive integration fixtures from another project at a production database.
 
+## Performance benchmarks
+
+See [`test/performance/README.md`](../test/performance/README.md) for the standalone
+local native benchmark suite and [`results.md`](../test/performance/results.md)
+for measured optimization results. `bundle exec rake performance:smoke` checks all
+workloads with small fixtures on libSQL memory/file databases and a SQLite file
+database. `bundle exec rake performance` runs the measured memory suite; use the
+runner directly for file mode, filtering, longer samples, and JSON output.
+Benchmarks are opt-in and do not impose noisy wall-clock thresholds on `rake check`.
+
 ## Packaging
 
 ```sh
 mkdir -p pkg
-gem build libsql-sequel.gemspec --output pkg/libsql-sequel-0.3.0.gem
+gem build libsql-sequel.gemspec --output pkg/libsql-sequel-0.3.1.gem
 ```
 
 The explicit gem file list includes Ruby library files, public docs, examples, README, and LICENSE. It excludes private notes, cloned repositories, credentials, tests, and temporary databases. Nothing is automatically published.

data/lib/sequel/libsql/connection.rb

@@ -132,12 +132,13 @@ module Sequel
 
       def each
         check_open
+        column_count = columns.length
         loop do
           check_open
           row = Native.check(Native.rows_next(@rows))
           break if row[:inner].null?
           begin
-            values = Array.new(columns.length) do |index|
+            values = Array.new(column_count) do |index|
               Native.value(Native.check(CLibsql.libsql_row_value(row, index))[:ok])
             end
             yield values

data/lib/sequel/libsql/dataset.rb

@@ -27,13 +27,18 @@ module Sequel
         execute(sql) do |result|
           columns = result.columns.map{|column| output_identifier(column)}
           types = ResultTypes.new(self).for_columns(columns)
+          column_types = columns.map{|name| types[name]}
+          column_count = columns.length
           converter = TypeConverter.new(db)
           self.columns = columns
           result.each do |values|
             row = {}
-            columns.each_with_index do |name, index|
+            index = 0
+            while index < column_count
               value = values[index]
-              row[name] = converter.call(value, types[name])
+              type = column_types[index]
+              row[columns[index]] = type ? converter.call(value, type) : value
+              index += 1
             end
             yield row
           end

data/lib/sequel/libsql/native.rb

@@ -11,6 +11,11 @@ module Sequel
     module Native
       class Error < StandardError; end
 
+      # Hoist Bignum arithmetic out of the per-cell decode and bind paths.
+      INTEGER_MIN = -(1 << 63)
+      INTEGER_LIMIT = 1 << 63
+      INTEGER_MODULUS = 1 << 64
+
       extend FFI::Library
       ffi_lib(*CLibsql.ffi_libraries.map(&:name))
 
@@ -47,7 +52,9 @@ module Sequel
       end
 
       def self.string(value)
-        value = value.to_s.encode(Encoding::UTF_8)
+        value = value.to_s
+        # Keep a stable copy of mutable input while native calls release the GVL.
+        value = value.encode(Encoding::UTF_8) unless value.frozen? && value.encoding == Encoding::UTF_8
         raise Sequel::Error, 'libSQL text cannot contain NUL bytes; use Sequel.blob for binary data' if value.include?("\0")
         raise Sequel::Error, 'libSQL text must be valid UTF-8' unless value.valid_encoding?
         value
@@ -69,17 +76,17 @@ module Sequel
       end
 
       def self.value(value)
-        case value[:type]
+        case type = value[:type]
         when :null
           nil
         when :integer
           # The Ruby driver declares uint64, while the C API returns int64.
           integer = value[:value][:integer]
-          integer >= (1 << 63) ? integer - (1 << 64) : integer
+          integer >= INTEGER_LIMIT ? integer - INTEGER_MODULUS : integer
         when :real
           value[:value][:real]
         when :text, :blob
-          read_slice(value[:value][value[:type]], value[:type] == :text)
+          read_slice(value[:value][type], type == :text)
         else
           raise Error, 'unknown libSQL value type'
         end
@@ -91,7 +98,7 @@ module Sequel
         when nil
           yield CLibsql.libsql_null
         when Integer
-          unless (-(1 << 63)...(1 << 63)).cover?(value)
+          unless value >= INTEGER_MIN && value < INTEGER_LIMIT
             raise Sequel::Error, 'libSQL integers must fit in signed 64 bits'
           end
           yield CLibsql.libsql_integer(value)

data/lib/sequel/libsql/version.rb

@@ -2,6 +2,6 @@
 
 module Sequel
   module LibSQL
-    VERSION = '0.3.0'
+    VERSION = '0.3.1'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: libsql-sequel
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Francesco Canessa