rubydb 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b474095677d024d7aae488865411803476f0c5040d75fba89b063f0e9679a3d9
-  data.tar.gz: 18a4bbf0d5744c8e980a50ee4b6ee6a75133f299a96eabd458ca1bf40554bb78
+  metadata.gz: 5005f9218456b8961e7cb6c61ea685d10cc327765f9509a49a766b3389634132
+  data.tar.gz: 878e67e40ece7e731e9aae8f412f3e0733f43e56202e83d77212d44c032ef191
 SHA512:
-  metadata.gz: a719c2d1f1de9e98ac56a45ab3956ce5b216dd1987e510688af3d71cfe131f98463cbab9525ca96ef2cc34a4457d3475b65016f8595a9f4f3c9b5f621a503247
-  data.tar.gz: b0f0d139f3da9c4eb8bea8805cbefeff6c11dae8dcf47853b8a157b402e4c10103bbf8b94a84a8ef1d80c7fe07a63e2effa042bff21d6ac3591b7340ff6c1b55
+  metadata.gz: c81b88aa18802979d5320534cf7ee7270e84a6c48b2a9528b8bec135439f5c84c3a0b45a7e3012d6a3fbdbdb6b226f4ed29dc9a3edbe86333b2e0eb633214b5c
+  data.tar.gz: 1fe32bd686090053c717631b97a6e996094c5284c77c452ede991d18aefc248616d905c44f12a2dae725bb19aa7f603e235ba8c9fe6a97ca121cef38f24d3237

data/CHANGELOG.md

@@ -3,7 +3,7 @@
 All notable changes to RubyDB are documented here. Versions follow
 [Semantic Versioning](https://semver.org/).
 
-## Unreleased
+## Unreleased
 
 - Added full developer, troubleshooting, debugging, production operations,
   Rails compatibility, and SQL compatibility guides with repository maps,
@@ -21,9 +21,16 @@ All notable changes to RubyDB are documented here. Versions follow
 - Added a full CLI guide and cheat sheet covering lifecycle, server operation,
   shell, migrations, backup/restore, snapshots, branches, inspection, doctor,
   vacuum, maintenance, and release workflows.
-- Clarified the tested common SQLite-style profile and production limits.
-
-## 0.1.0 - 2026-09-07
+- Clarified the tested common SQLite-style profile and production limits.
+
+## 0.1.1 - 2026-09-09
+
+- Published the Rails connection configuration fixes for embedded database
+  paths and `rubydb://`/`rubydbs://` connection URLs.
+- Kept the patch release compatible with the RubyDB 0.1.x adapter dependency
+  range.
+
+## 0.1.0 - 2026-09-07
 
 - Initial public release candidate.
 - Includes the embedded engine, ActiveRecord adapter, backup/recovery, WAL,

data/adapters/activerecord/README.md

@@ -1,9 +1,133 @@
-# RubyDB ActiveRecord adapter
-
-The `rubydb-activerecord` gem connects Rails applications to RubyDB through
-ActiveRecord. It supports embedded RubyDB engines and network connections.
-
-For an executable Rails 7.2 example, see
-[`examples/rails_app`](../../examples/rails_app). The example includes a
-database configuration, migration, model/controller, browser form, and a
-smoke test that exercises the adapter against a real RubyDB engine.
+# rubydb-activerecord
+
+`rubydb-activerecord` is the ActiveRecord adapter for [RubyDB](https://github.com/aldanedev-create/rubydb). It lets Rails applications use RubyDB through the normal model, relation, transaction, migration, schema, and connection-pool APIs.
+
+This gem is an adapter to RubyDB's SQL engine. It is not a PostgreSQL, MySQL, or SQLite wire-protocol compatibility layer, and it does not make arbitrary dialect-specific SQL portable. Validate your application's queries and migrations against the exact Ruby, Rails, RubyDB, operating-system, and deployment versions you will run.
+
+## Requirements
+
+- Ruby 3.3 or newer
+- RubyDB 0.1.x
+- ActiveRecord 7.1, 7.2, or 8.0 (the dependency range is `>= 7.1`, `< 8.1`)
+
+## Install
+
+Add both gems to the Rails application's `Gemfile`:
+
+```ruby
+gem "rubydb"
+gem "rubydb-activerecord"
+```
+
+Then run:
+
+```sh
+bundle install
+```
+
+The adapter registers itself under the `rubydb` adapter name when it is
+required by Bundler. For a manually loaded application, require it explicitly:
+
+```ruby
+require "rubydb"
+require "active_record/connection_adapters/rubydb_adapter"
+```
+
+## Development: embedded database
+
+Embedded mode is convenient for local development and a controlled
+single-process application. The process owns the database file:
+
+```yaml
+# config/database.yml
+development:
+  adapter: rubydb
+  embedded: true
+  database: <%= Rails.root.join("tmp/development.rdb") %>
+```
+
+Run migrations normally:
+
+```sh
+bin/rails db:migrate
+bin/rails console
+bin/rails server
+```
+
+Do not open the same embedded path from multiple independent Rails processes.
+For multiple web workers, job workers, or hosts, use a managed RubyDB server.
+
+## Production: managed server
+
+Use a network connection when the application has more than one process or
+when the database must be operated independently from the application. Keep
+credentials in the platform secret manager and map them into `database.yml`:
+
+```yaml
+# config/database.yml
+production:
+  adapter: rubydb
+  embedded: false
+  url: <%= ENV.fetch("RUBYDB_URL") %>
+  pool: <%= ENV.fetch("RAILS_MAX_THREADS", "5") %>
+  timeout: <%= ENV.fetch("RUBYDB_TIMEOUT", "30") %>
+```
+
+Use `rubydb://` for a plain private-network connection or `rubydbs://` for TLS:
+
+```text
+rubydbs://app_user:URL_ENCODED_PASSWORD@db.internal.example:7432/app?verify_peer=true&ca_file=%2Fetc%2Frubydb%2Ftls%2Fca.crt
+```
+
+The server must be deployed separately with persistent storage,
+authentication, TLS, backups, monitoring, resource limits, and a tested
+restore procedure. Size its connection limit for the total Rails pool across
+all application processes, with headroom for administration and replication.
+See the repository's [Rails database configuration](../../docs/rails/database-yml.md)
+and [production guidance](../../docs/rails/production.md).
+
+## Adapter surface
+
+The release test suite exercises:
+
+- ActiveRecord CRUD, binds, quoted identifiers, type casting, and false/zero values
+- transactions and savepoints
+- `joins`, qualified filters, ordering, eager loading, and nested associations
+- table/column/index/foreign-key introspection
+- Rails migrations, defaults, indexes, schema dumps, and populated-table changes
+- embedded and network connection setup paths
+
+RubyDB currently has documented SQL and schema boundaries. Features outside
+the tested surface—such as dialect-specific extensions, generated columns,
+complex table rebuilds, or application-specific Arel—need explicit tests
+before deployment.
+
+## Validation
+
+Run the adapter's integration suite from this directory:
+
+```sh
+bundle install
+bundle exec rspec spec
+```
+
+Run the repository's Rails-focused checks from the repository root:
+
+```sh
+bundle exec rspec spec/rails_adapter_live_engine_spec.rb spec/rails_adapter_schema_dump_spec.rb spec/rails_schema_statements_spec.rb
+```
+
+Before a production release, run a real migration and smoke query through the
+same server URL, TLS settings, pool size, and secret-management path used by
+the deployment. Keep a verified backup before migrations and rehearse restore
+and rollback on a representative copy.
+
+## Support and release policy
+
+The adapter version is coupled to the RubyDB 0.1.x release line. Pin both gems
+in the application lockfile, upgrade them together, and run the adapter suite
+before upgrading Rails. Report reproducible adapter or engine issues at the
+project's [issue tracker](https://github.com/aldanedev-create/rubydb/issues)
+with Ruby/Rails/RubyDB versions, the SQL or migration involved, and a redacted
+configuration summary. Never include passwords, connection URLs, database
+files, or private keys in reports.

data/adapters/activerecord/lib/active_record/connection_adapters/rubydb_adapter.rb

@@ -775,9 +775,15 @@ module ActiveRecord
             column.is_a?(Hash) ? (column[:name] || column["name"] || column) : column
           end.map(&:to_s)
         end
-        values = rows.map do |row|
-          columns.map { |column| row[column] || row[column.to_sym] }
-        end
+        values = rows.map do |row|
+          columns.map do |column|
+            if row.respond_to?(:key?) && row.key?(column)
+              row[column]
+            elsif row.respond_to?(:key?) && row.key?(column.to_sym)
+              row[column.to_sym]
+            end
+          end
+        end
         ActiveRecord::Result.new(columns, values)
       end
 

data/adapters/activerecord/rubydb-activerecord.gemspec

@@ -10,12 +10,17 @@ Gem::Specification.new do |spec|
   spec.description = "ActiveRecord adapter for the RubyDB database"
   spec.homepage = "https://github.com/aldanedev-create/rubydb"
   spec.license = "MIT"
-  spec.required_ruby_version = ">= 3.2.0"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = spec.homepage
-
-  spec.files = Dir.glob("lib/**/*.rb") + %w[README.md]
+  # rubydb itself requires Ruby 3.3 or newer. Keep the adapter's runtime
+  # contract aligned so Bundler cannot select an unsupported combination.
+  spec.required_ruby_version = ">= 3.3.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "#{spec.homepage}/tree/main/adapters/activerecord"
+  spec.metadata["bug_tracker_uri"] = "https://github.com/aldanedev-create/rubydb/issues"
+  spec.metadata["changelog_uri"] = "https://github.com/aldanedev-create/rubydb/blob/main/CHANGELOG.md"
+  spec.metadata["documentation_uri"] = "https://github.com/aldanedev-create/rubydb/tree/main/docs"
+
+  spec.files = Dir.glob("lib/**/*.rb") + %w[README.md rubydb-activerecord.gemspec]
   spec.require_paths = ["lib"]
 
   spec.add_dependency "activerecord", ">= 7.1", "< 8.1"

data/adapters/activerecord/spec/rubydb_adapter_integration_spec.rb

@@ -31,15 +31,25 @@ RSpec.describe ActiveRecord::ConnectionAdapters::RubyDBAdapter do
     end
   end
 
-  it "creates and finds an ActiveRecord model through the embedded engine" do
+  it "creates and finds an ActiveRecord model through the embedded engine" do
     connection = ActiveRecord::Base.connection
     connection.execute("CREATE TABLE accounts (id INTEGER PRIMARY KEY, email VARCHAR(255) NOT NULL, active BOOLEAN NOT NULL)")
 
     created = model.create!(id: 1, email: "ada@example.test", active: true)
     loaded = model.find(created.id)
 
-    expect(loaded.attributes).to include("id" => 1, "email" => "ada@example.test", "active" => true)
-  end
+    expect(loaded.attributes).to include("id" => 1, "email" => "ada@example.test", "active" => true)
+  end
+
+  it "preserves false and zero values in ActiveRecord results" do
+    connection = ActiveRecord::Base.connection
+    connection.execute("CREATE TABLE flags (id INTEGER PRIMARY KEY, enabled BOOLEAN NOT NULL, attempts INTEGER NOT NULL)")
+    connection.execute("INSERT INTO flags (id, enabled, attempts) VALUES (1, FALSE, 0)")
+
+    result = connection.exec_query("SELECT enabled, attempts FROM flags WHERE id = 1")
+
+    expect(result.first).to include("enabled" => false, "attempts" => 0)
+  end
 
   it "runs a Rails migration that creates a table, adds a column, and adds an index" do
     migration = Class.new(ActiveRecord::Migration[migration_version]) do

data/lib/rubydb/version.rb

@@ -11,13 +11,13 @@ module RubyDB
   # - MAJOR: Incompatible API changes
   # - MINOR: Backwards-compatible new functionality
   # - PATCH: Backwards-compatible bug fixes
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 
   # Version components for easy access
   module Version
     MAJOR = 0
     MINOR = 1
-    PATCH = 0
+    PATCH = 1
     PRE = nil  # e.g., "alpha", "beta", "rc1"
 
     def self.to_s
@@ -30,4 +30,4 @@ module RubyDB
       version
     end
   end
-end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubydb
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Aldane Hutchinson