beagle-turso 0.1.0-aarch64-linux

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c7ee363f8f6907c44c13643ca8343a1d5f978df82c854bf709e5f62a922373cd
+  data.tar.gz: 3de062e24354c15d6d1c59c5015c8171a6457774ee90bfa6e85612212b30ad30
+SHA512:
+  metadata.gz: 4012318992c20173ddb5907f7854f565bfcb994fc2585aa0fc47fc9a0a1bb9f01cd2a0405a84d007d5561355d210693ae09b02801765cd94de7e8ffc4480d3b2
+  data.tar.gz: 86688686bb548e1ff248ed7edee4ed0ce5864084ae845263a61ce7313db740cb2693cc1631870287a72abe6681931c0b387a33881ab0252fe654e6ea4e48ff2e

data/README.md

@@ -0,0 +1,89 @@
+# beagle-turso
+
+A Ruby driver for [Turso](https://turso.tech)'s database engine, backed by a
+native Rust extension (`beagle_turso_core`, via [Magnus](https://github.com/matsadler/magnus)/[rb_sys](https://github.com/oxidize-rb/rb-sys)).
+
+A `Database` can be opened two ways:
+
+- **Local-only** — in-memory or an on-disk file, no network involved.
+- **Synced** — a local file kept in sync with a remote Turso database via
+  `push`/`pull`.
+
+## Install
+
+Add to your `Gemfile`:
+
+```ruby
+gem "beagle-turso"
+```
+
+or install directly:
+
+```sh
+gem install beagle-turso
+```
+
+Installing builds the native extension via `rb_sys`/`rake-compiler`, so a
+Rust toolchain is required unless a precompiled binary gem is available for
+your platform.
+
+## Local example
+
+```ruby
+require "beagle/turso"
+
+db = Beagle::Turso::Database.open_local(":memory:")
+conn = db.connect
+
+conn.execute("CREATE TABLE users (id INTEGER, name TEXT)", [])
+conn.execute("INSERT INTO users (id, name) VALUES (?, ?)", [1, "Ada"])
+
+rows = conn.query("SELECT id, name FROM users", [])
+# => [[1, "Ada"]]
+```
+
+`execute` returns the number of affected rows (an `Integer`); `query`
+returns an `Array` of row `Array`s. Bind parameters may be `nil`, `Integer`,
+`Float`, `String` (bound as `TEXT`), or a binary `String` — one with
+`ASCII-8BIT`/`BINARY` encoding — bound as `BLOB`.
+
+## Synced example
+
+```ruby
+require "beagle/turso"
+
+db = Beagle::Turso::Database.open(
+  local_path: "/path/to/local.db",
+  remote_url: ENV.fetch("TURSO_DATABASE_URL"),
+  auth_token: ENV.fetch("TURSO_AUTH_TOKEN")
+)
+
+conn = db.connect
+conn.execute("INSERT INTO users (id, name) VALUES (?, ?)", [2, "Grace"])
+
+db.push # propagate local writes to the remote
+db.pull # pull remote changes down to the local file (returns true/false)
+```
+
+`Database.open` also accepts `bootstrap_if_empty:` (defaults to `true`),
+which pulls all remote data down on first open if the local file is new/empty.
+Calling `push`/`pull` on a database opened via `open_local` (or via `open`
+without both `remote_url:` and `auth_token:`) raises `RuntimeError`.
+
+### Durability note: writes commit on-sync, not synchronously
+
+Writes to a synced database commit to the **local** file immediately, as
+part of `execute` — they do not wait on the network. They are only
+propagated to the remote **on sync**, i.e. whenever `push` is explicitly
+called; `push` is not called automatically after every write. Until a
+`push` succeeds, a write that's durable locally is not yet visible to other
+replicas of the same remote database.
+
+## Credential safety
+
+`auth_token` is never included in `inspect` output or in error messages —
+confirmed by this gem's `no_secret_logging_spec.rb`.
+
+## License
+
+[MIT](https://opensource.org/licenses/MIT).

data/lib/beagle/turso/version.rb

@@ -0,0 +1,5 @@
+module Beagle
+  module Turso
+    VERSION = "0.1.0"
+  end
+end

data/lib/beagle/turso.rb

@@ -0,0 +1,18 @@
+require_relative "turso/version"
+require "beagle_turso/beagle_turso" # native extension
+
+module Beagle
+  module Turso
+    class Database
+      # Opens a local-only database, or one synced with a remote Turso
+      # database when both `remote_url` and `auth_token` are given (see
+      # `#push`/`#pull`). Delegates to the native `_open` primitive, which
+      # takes its arguments positionally.
+      def self.open(local_path:, remote_url: nil, auth_token: nil, bootstrap_if_empty: true)
+        _open(local_path, remote_url, auth_token, bootstrap_if_empty)
+      end
+
+      private_class_method :_open
+    end
+  end
+end

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification
+name: beagle-turso
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: aarch64-linux
+authors:
+- BeagleSoftwareUK
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-08-08 00:00:00.000000000 Z
+dependencies: []
+description: |
+  A Ruby driver for Turso's database engine, backed by a native Rust
+  extension (beagle_turso_core, via Magnus/rb-sys). Opens a local-only
+  database (in-memory or on-disk) or one kept in sync with a remote Turso
+  database via explicit push/pull. Writes are durable to the local file
+  immediately as they happen; push is what propagates them to the remote
+  on sync, not synchronously with every write.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/beagle/turso.rb
+- lib/beagle/turso/version.rb
+- lib/beagle_turso/3.3/beagle_turso.so
+- lib/beagle_turso/3.4/beagle_turso.so
+homepage: https://github.com/BeagleSoftwareUK/beagle-turso
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/BeagleSoftwareUK/beagle-turso
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 3.5.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 driver for Turso's new engine, backed by beagle_turso_core (Rust).
+test_files: []