libsql2 0.1.3-x86_64-darwin

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d81d65215eb52ef44c5c2024fb70f1b8e26c7199f0f6788ae31cd1a21b032cd8
+  data.tar.gz: d2702e8d3741ddc8ed684baff753b35e8d71da70709de6b2161734b8bbeb1e02
+SHA512:
+  metadata.gz: 1e81c70f905e13fd8e3e53a566ebcf74146c02ef1d6ee0ac32fe285121629a6ca1ae71fae66467616f1fa29c8a5de8dc5a208233ac9fea00bf0ddbac02e0503f
+  data.tar.gz: 9b0612d82ac1ebada8134c074e854d46694ab08e9329df4f36c1cf224adbee7d47970c068bbde5585c522d52156b800c208ac5482b4dfca6f7516344023e9327

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 speria-jp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,161 @@
+# libsql2
+
+An alternative to [turso_libsql](https://github.com/tursodatabase/libsql-ruby) with a native Rust extension.
+
+## Features
+
+- **Native Rust extension** — no FFI overhead
+- **Full libSQL support** — local files, in-memory, remote (Turso Cloud), and Embedded Replicas
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "libsql2"
+```
+
+Then run:
+
+```bash
+bundle install
+```
+
+## Usage
+
+### Opening a Database
+
+```ruby
+require "libsql2"
+
+# Local file
+db = Libsql::Database.open("/path/to/file.db")
+
+# In-memory
+db = Libsql::Database.open(":memory:")
+
+# Remote (Turso Cloud)
+db = Libsql::Database.open("libsql://xxx.turso.io", auth_token: "xxx")
+
+# Embedded Replica
+db = Libsql::Database.open("libsql://xxx.turso.io",
+  auth_token: "xxx",
+  local_path: "/path/to/replica.db",
+  sync_interval: 60,
+  read_your_writes: true
+)
+
+# Block form (auto-close)
+Libsql::Database.open(":memory:") do |db|
+  # ...
+end
+```
+
+### Querying
+
+```ruby
+db.connect do |conn|
+  conn.execute("CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT, age INTEGER)")
+  conn.execute("INSERT INTO users (name, age) VALUES (?, ?)", ["Alice", 30])
+
+  rows = conn.query("SELECT * FROM users WHERE age > ?", [20])
+  rows.columns  #=> ["id", "name", "age"]
+  rows.types    #=> ["INTEGER", "TEXT", "INTEGER"]
+  rows.each { |row| puts row["name"] }
+end
+```
+
+### Execute (no result set)
+
+```ruby
+conn.execute("INSERT INTO users (name) VALUES (?)", ["Alice"])
+conn.changes            #=> 1
+conn.last_insert_rowid  #=> 42
+```
+
+### Batch Execution
+
+```ruby
+conn.execute_batch(<<~SQL)
+  CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT);
+  CREATE TABLE posts (id INTEGER PRIMARY KEY, user_id INTEGER, title TEXT);
+SQL
+```
+
+### Prepared Statements
+
+```ruby
+stmt = conn.prepare("SELECT * FROM users WHERE name = ?")
+stmt.bind(["Alice"])
+rows = stmt.query
+stmt.close
+```
+
+### Transactions
+
+```ruby
+conn.transaction do |tx|
+  tx.execute("UPDATE accounts SET balance = balance - 100 WHERE id = ?", [1])
+  tx.execute("UPDATE accounts SET balance = balance + 100 WHERE id = ?", [2])
+  # Commits on normal exit, rolls back on exception
+end
+
+# With behavior
+conn.transaction(:immediate) do |tx|
+  tx.execute("INSERT INTO orders (item) VALUES (?)", ["widget"])
+end
+
+# Nested transactions (SAVEPOINT)
+conn.transaction do |tx|
+  tx.execute("INSERT INTO users (name) VALUES (?)", ["Alice"])
+  tx.transaction do |tx2|
+    tx2.execute("INSERT INTO users (name) VALUES (?)", ["Bob"])
+  end
+end
+```
+
+### Embedded Replica Sync
+
+```ruby
+db.sync  # Manual sync
+```
+
+### Fork Safety (Puma / Unicorn)
+
+```ruby
+# puma.rb
+on_worker_boot do
+  $db.discard! if $db
+  $db = Libsql::Database.open(...)
+end
+```
+
+## Type Mapping
+
+| libSQL Type | Ruby Type | Notes |
+|---|---|---|
+| INTEGER | `Integer` | Signed 64-bit |
+| REAL | `Float` | Double precision |
+| TEXT | `String` | UTF-8 encoded |
+| BLOB | `Libsql::Blob` | `String` subclass with `ASCII-8BIT` encoding |
+| NULL | `nil` | |
+
+## Development
+
+Requirements: Ruby >= 3.4, Rust >= 1.74, and a C compiler.
+
+```bash
+bundle install       # Install Ruby dependencies
+rake compile         # Compile the Rust extension
+rake spec            # Run tests
+rake lint            # Run all linters (RuboCop + Clippy)
+rake fmt             # Auto-format all code
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/speria-jp/libsql-ruby2.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/libsql/blob.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Libsql
+  class Blob < String
+    def initialize(data = "")
+      super
+      force_encoding(Encoding::ASCII_8BIT)
+    end
+  end
+end

data/lib/libsql/connection.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Libsql
+  class Connection
+    def transaction
+      execute("BEGIN")
+      result = yield self
+      execute("COMMIT")
+      result
+    rescue Exception # rubocop:disable Lint/RescueException
+      execute("ROLLBACK")
+      raise
+    end
+  end
+end

data/lib/libsql/database.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Libsql
+  class Database
+    class << self
+      alias _open open
+
+      def open(path, **opts)
+        db = opts.empty? ? _open(path) : _open(path, opts)
+        if block_given?
+          begin
+            yield db
+          ensure
+            db.close
+          end
+        else
+          db
+        end
+      end
+    end
+
+    alias _connect connect
+
+    def connect
+      conn = _connect
+      if block_given?
+        begin
+          yield conn
+        ensure
+          conn.close
+        end
+      else
+        conn
+      end
+    end
+  end
+end

data/lib/libsql/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Libsql
+  VERSION = "0.1.3"
+end

data/lib/libsql2.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require_relative "libsql/version"
+require_relative "libsql/blob"
+require_relative "libsql/libsql2"
+require_relative "libsql/connection"
+require_relative "libsql/database"

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification
+name: libsql2
+version: !ruby/object:Gem::Version
+  version: 0.1.3
+platform: x86_64-darwin
+authors:
+- speria-jp
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-03-17 00:00:00.000000000 Z
+dependencies: []
+description: Native Ruby bindings for libSQL database, built with Rust (magnus + libsql
+  crate)
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/libsql/3.4/libsql2.bundle
+- lib/libsql/4.0/libsql2.bundle
+- lib/libsql/blob.rb
+- lib/libsql/connection.rb
+- lib/libsql/database.rb
+- lib/libsql/version.rb
+- lib/libsql2.rb
+homepage: https://github.com/speria-jp/libsql-ruby2
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.4'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 4.1.dev
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.23
+signing_key: 
+specification_version: 4
+summary: Ruby bindings for libSQL
+test_files: []