activerecord-turso 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8e00bcf26be0b39f02a05bd0f4850db41d277f7d72bdb15013c218f032d93eb
-  data.tar.gz: 9e9ccad1e346648fef21eb2d0a3aceafa7afada0bc67348a0ed912b723e6cca5
+  metadata.gz: cfdd23462f8313c9a19d64bab33314e3d5a4b7532249695f01811ebcf3fcccbd
+  data.tar.gz: 74e33f479629655b50621e300dc7a1d38b2d94d95edd2da9b57b3d18c5799dbe
 SHA512:
-  metadata.gz: c16dce07f7dbcf2bd60d07e58b10d6960c7d4a2945f88deda0082c532b0e1e42cc58213582acd2548c0c19d72a13ef30e5688503ba8ab9a00b7fa99f882048e8
-  data.tar.gz: 22f295b0eda449f11b5f31c63b16718e5f609452904b0c9c5b534117fe4145324460d3ed56f7ac7365f38345ac165eb8969a3e01bb5c21d59c2e9f3bef2f4f4d
+  metadata.gz: 9dee234b1fa1abd37883de7c10b876cad339858a41643000eee969348ae0ad1da8458a8b546145aa1c7e38648e5e7da3734d35fa484b08c0d87260dc170f3fe5
+  data.tar.gz: 314bda7c65ccc415af50204690e098859517419f8f7ba035852a6230c0654c40f94a82ba3bd22ba54a829920cfb7f9159fbf1acc0de8e04816641669b6789938

data/README.md

@@ -4,7 +4,7 @@ ActiveRecord adapter for [Turso](https://turso.tech) (SQLite compatible db).
 
 ## Status
 
-Production ready for ActiveRecord 8.1 applications. The underlying `turso` gem releases the GVL during blocking operations, supports fiber-aware connection ownership, and uses native batch execution.
+Production ready for **embedded/local** ActiveRecord 8.1 applications using the Turso SQLite-compatible database engine. This adapter does **not** support remote `libsql://` URLs or Turso cloud authentication. The underlying `turso` gem releases the GVL during blocking operations, supports fiber-aware connection ownership, and uses native batch execution.
 
 ## Requirements
 
@@ -114,6 +114,7 @@ development:
 - `transaction(concurrent: true)` requires the same database connection to be held for the entire retry loop. Rails' connection pool may reap the connection between retries, which can silently break MVCC semantics. Use this only when you understand the pooling behavior of your app.
 - `lock!`, `with_lock`, and `lock_version` are not meaningful under MVCC. Do not use them inside concurrent transactions.
 - If the retry limit is exhausted, the conflict is raised as `ActiveRecord::StatementInvalid`. You must handle it in application code.
+- Normal ActiveRecord model persistence (`create!`, `save!`, `update!`, `touch`) is **not supported** inside a concurrent transaction because ActiveRecord opens its own internal transaction for each model change. Use raw SQL (`execute`, `exec_query`) or bulk operations (`insert_all`, `update_all`, `update_columns`) instead.
 
 ### Full-text search (Tantivy)
 

data/lib/active_record/connection_adapters/turso_adapter/connection_management.rb

@@ -65,7 +65,8 @@ module ActiveRecord
           timeout = @config[:busy_timeout] || @config[:timeout] || 5000
           @raw_connection.busy_timeout = timeout
 
-
+          query_timeout = @config[:query_timeout] || 30_000
+          @raw_connection.query_timeout = query_timeout
         end
       end
     end

data/lib/active_record/connection_adapters/turso_adapter/error_translation.rb

@@ -5,7 +5,7 @@ module ActiveRecord
     class TursoAdapter < SQLite3Adapter
       module ErrorTranslation
         def translate_exception(exception, message:, sql:, binds:)
-          cause = exception.cause
+          cause = exception.cause || exception
           case cause
           when ::Turso::ConstraintException
             translate_constraint_error(message, sql, binds)

data/lib/active_record/tasks/turso_database_tasks.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+require "active_record/tasks/database_tasks"
+
+module ActiveRecord
+  module Tasks
+    class TursoDatabaseTasks < SQLiteDatabaseTasks
+      def initialize(db_config, root = nil)
+        @configuration = db_config
+      end
+
+      def create
+        path = configuration.database
+        return if path == ":memory:"
+
+        FileUtils.mkdir_p(File.dirname(path))
+        establish_connection(configuration)
+        connection.execute("SELECT 1")
+      end
+
+      def drop
+        path = configuration.database
+        return if path == ":memory:"
+
+        disconnect!
+        FileUtils.rm_f(path)
+        FileUtils.rm_f("#{path}-wal")
+        FileUtils.rm_f("#{path}-shm")
+      end
+
+      def purge
+        drop
+        create
+      end
+
+      def charset
+        "UTF-8"
+      end
+
+      def charset_collation
+        nil
+      end
+
+      def structure_dump(filename, extra_flags)
+        establish_connection(configuration)
+        io = File.open(filename, "w")
+        io.puts("PRAGMA foreign_keys = OFF;")
+
+        tables = connection.query_values(<<~SQL, "SCHEMA")
+          SELECT name FROM sqlite_master
+          WHERE type = 'table'
+            AND name NOT LIKE 'sqlite_%'
+            AND name NOT LIKE '__turso_internal_%'
+          ORDER BY name
+        SQL
+
+        tables.each do |table|
+          sql = connection.query_value(<<~SQL, "SCHEMA")
+            SELECT sql FROM sqlite_master WHERE name = #{connection.quote(table)}
+          SQL
+          io.puts("#{sql};") if sql
+        end
+
+        indexes = connection.query_values(<<~SQL, "SCHEMA")
+          SELECT name FROM sqlite_master
+          WHERE type = 'index'
+            AND name NOT LIKE 'sqlite_%'
+            AND sql IS NOT NULL
+          ORDER BY name
+        SQL
+
+        indexes.each do |index|
+          sql = connection.query_value(<<~SQL, "SCHEMA")
+            SELECT sql FROM sqlite_master WHERE name = #{connection.quote(index)}
+          SQL
+          io.puts("#{sql};") if sql
+        end
+
+        views = connection.query_values(<<~SQL, "SCHEMA")
+          SELECT name FROM sqlite_master
+          WHERE type = 'view'
+            AND name NOT LIKE 'sqlite_%'
+          ORDER BY name
+        SQL
+
+        views.each do |view|
+          sql = connection.query_value(<<~SQL, "SCHEMA")
+            SELECT sql FROM sqlite_master WHERE name = #{connection.quote(view)}
+          SQL
+          io.puts("#{sql};") if sql
+        end
+
+        io.puts("PRAGMA foreign_keys = ON;")
+        io.close
+      end
+
+      def structure_load(filename, extra_flags)
+        establish_connection(configuration)
+        sql = File.read(filename)
+        ActiveRecord::Base.connection.raw_connection.execute_batch(sql)
+      end
+
+      private
+
+      def configuration
+        @configuration
+      end
+
+      def connection
+        ActiveRecord::Base.connection
+      end
+
+      def establish_connection(config)
+        @configuration = config
+        ActiveRecord::Base.establish_connection(config)
+        ActiveRecord::Base.connection.connect!
+      end
+
+      def disconnect!
+        ActiveRecord::Base.connection_pool.disconnect!
+      end
+    end
+  end
+end

data/lib/activerecord-turso/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActiveRecordTurso
-  VERSION = "0.2.2"
+  VERSION = "0.3.0"
 end

data/lib/activerecord-turso.rb

@@ -12,3 +12,8 @@ ActiveRecord::ConnectionAdapters.register(
   "ActiveRecord::ConnectionAdapters::TursoAdapter",
   "active_record/connection_adapters/turso_adapter"
 )
+
+require "active_record/tasks/database_tasks"
+require_relative "active_record/tasks/turso_database_tasks"
+
+ActiveRecord::Tasks::DatabaseTasks.register_task(/turso/, "ActiveRecord::Tasks::TursoDatabaseTasks")

data/lib/turso/ar/connection.rb

@@ -8,7 +8,8 @@ module Turso
       extend Forwardable
 
       def_delegators :@db, :close, :closed?, :changes, :total_changes,
-                     :last_insert_rowid, :prepare, :interrupt, :busy_timeout=
+                     :last_insert_rowid, :prepare, :interrupt, :busy_timeout=,
+                     :query_timeout, :query_timeout=
 
       DEFAULT_BUSY_TIMEOUT_MS = 5000
       DEFAULT_QUERY_TIMEOUT_MS = 30_000
@@ -19,7 +20,10 @@ module Turso
           busy_timeout: config[:busy_timeout] || config[:timeout] || DEFAULT_BUSY_TIMEOUT_MS,
           query_timeout: config[:query_timeout] || DEFAULT_QUERY_TIMEOUT_MS
         }
-        db_opts[:experimental_features] = config[:experimental_features] if config[:experimental_features]
+        if config[:experimental_features]
+          features = Array(config[:experimental_features]).map(&:to_s).reject(&:empty?)
+          db_opts[:experimental_features] = features.join(",") unless features.empty?
+        end
         database = ::Turso::Database.new(config[:database].to_s, **db_opts)
         @db = database.connection
         @db.busy_timeout = db_opts[:busy_timeout]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: activerecord-turso
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Ben D'Angelo
@@ -63,6 +63,7 @@ files:
 - lib/active_record/connection_adapters/turso_adapter/schema_statements.rb
 - lib/active_record/connection_adapters/turso_adapter/statement_pool.rb
 - lib/active_record/connection_adapters/turso_adapter/transaction_management.rb
+- lib/active_record/tasks/turso_database_tasks.rb
 - lib/activerecord-turso.rb
 - lib/activerecord-turso/error.rb
 - lib/activerecord-turso/version.rb
@@ -86,5 +87,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.15
 specification_version: 4
-summary: ActiveRecord adapter for Turso
+summary: Embedded ActiveRecord adapter for Turso (SQLite-compatible)
 test_files: []