tarantool-rails 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 824fd7e958e18a4576a55a510ae6713557bb7d0e6a36ce202f18d72785eb18ef
-  data.tar.gz: e33adb1ed56190a0d11f32c1994a71f2e247c2548e30bb594344b581794f03ba
+  metadata.gz: 80ffc3cc37871dc29b1b3fb3b9da05958369823bca8e9685ed6f341ebbb9212e
+  data.tar.gz: e8428bdd33eb1e8ecb1107bd3b8eb657b8906f0220325048aa1bea8402303a69
 SHA512:
-  metadata.gz: cd86cbe614985b58a745dfa2807df813e8b1eb95f7ea0a044f26f0a539577c15dac3cbeffa33bcec5774c31583a9a324a7706fbbb72ba16392a4c7e46088bd2f
-  data.tar.gz: 5afa1af094609b0ed6f6637b7a1aa08dbe6afcf8b9ae3cda57031ad0f4a3565bb23ff204e37c5e9f779366cc916fdcb83025f8dec3de43501eda8b9ae5f90451
+  metadata.gz: d10aff0d221c3ab0c395a6e1dea3e106c50befda2dd38425f6ac2e926158350ac2859aa39bee54335e21d4e78ac679fc6e291cc2576b31768616006e820084c7
+  data.tar.gz: 19c895b419c10098ea3d347848f74d216d29b76206630d6979f0ae14ad8d59f0b0a50274c51ea10b854d89fef50a1ab9716aa7c597481f4f2f7dd287093487e4

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.2.0 (2026-10-17)
+
+- `tarantool:schema:dump` writes the live schema to `config/tarantool_schema.rb` (`FORCE=1` to overwrite,
+  `dump[users,codes]` to limit the spaces).
+- `plan`, `apply` and `check` take `alter` names as a task argument: `"tarantool:schema:apply[add_field]"`.
+- `LogSubscriber` logs `shutdown.tarantool` (tarantool-client 0.3.0) at info.
+- Depends on `tarantool-schema ~> 0.2`.
+
 ## 0.1.0 (2026-10-17)
 
 First release.

data/README.md

@@ -101,7 +101,7 @@ Completed 200 OK in 4ms (Views: 1.9ms | Tarantool: 0.5ms)
 Request lines are debug, colored like ActiveRecord's when `colorize_logging` is on. Keys, tuples and
 arguments never appear: the client does not put them in the event payload. A failed request shows the error
 class and code, not the message. Lifecycle events are logged too: `disconnect` at warn, `reconnect_failed` at
-error, `reconnect`, `fork` and `role_change` at info.
+error, `reconnect`, `fork`, `role_change` and `shutdown` at info.
 
 ## Schema
 
@@ -118,10 +118,14 @@ end
 | Task | |
 |---|---|
 | `rails tarantool:schema:plan` | prints what `apply` would create; drift raises `MismatchError` with the diff |
-| `rails tarantool:schema:apply` | creates the missing spaces and indexes and prints them; never alters or drops |
+| `rails tarantool:schema:apply` | creates the missing spaces and indexes and prints them; never drops |
 | `rails tarantool:schema:check` | for CI: exits 1 and prints `pending: ...` when anything would be created, 0 when live equals declared |
+| `rails tarantool:schema:dump` | writes the live schema to `config/tarantool_schema.rb` for bootstrapping; refuses to overwrite unless `FORCE=1`; `dump[users,codes]` limits the spaces |
 
-The tasks connect with `admin_uri`; see the tarantool-schema README for the privileges that user needs.
+`plan`, `apply` and `check` take the tarantool-schema `alter:` names as an argument: `rails
+"tarantool:schema:apply[add_field]"` appends nullable fields declared past the end of a live format. Without it
+such a format is drift. The tasks connect with `admin_uri`; see the tarantool-schema README for the privileges
+that user needs.
 
 ## Generators
 

data/lib/tarantool/rails/log_subscriber.rb

@@ -57,6 +57,10 @@ module Tarantool
         info "Tarantool #{event.payload[:address]} is now #{event.payload[:read_only] ? 'read-only' : 'writable'}"
       end
 
+      def shutdown(event)
+        info "Tarantool #{event.payload[:address]} is shutting down, #{event.payload[:pending]} requests in flight"
+      end
+
       private
 
       def request_name(payload)

data/lib/tarantool/rails/tasks/schema.rake

@@ -1,24 +1,47 @@
 # frozen_string_literal: true
 
+# Task arguments are one String: rails "tarantool:schema:apply[add_field]", "tarantool:schema:dump[users,codes]".
+TARANTOOL_SCHEMA_NAME_SEPARATOR = /[\s,]+/
+
+def tarantool_schema_names(argument) = argument.to_s.split(TARANTOOL_SCHEMA_NAME_SEPARATOR).reject(&:empty?)
+
+def tarantool_schema_dump(path, only)
+  abort "#{path} exists; set FORCE=1 to overwrite" if File.exist?(path) && ENV['FORCE'].to_s.empty?
+
+  definition = Tarantool::Rails.admin_client do |client|
+    Tarantool::Schema::Definition.from_live(client, only: only.empty? ? nil : only)
+  end
+  File.write(path, "# frozen_string_literal: true\n\nTarantool::Rails.schema = #{definition.to_ruby}")
+  puts path
+end
+
 namespace :tarantool do
   namespace :schema do
     desc 'Print what tarantool:schema:apply would create; fail on drift'
-    task plan: :environment do
-      Tarantool::Rails.admin_client { |client| puts Tarantool::Rails.schema.plan(client) }
+    task :plan, [:alter] => :environment do |_task, args|
+      alter = tarantool_schema_names(args[:alter]).map(&:to_sym)
+      Tarantool::Rails.admin_client { |client| puts Tarantool::Rails.schema.plan(client, alter:) }
     end
 
     desc 'Create missing Tarantool spaces and indexes; fail on drift'
-    task apply: :environment do
-      Tarantool::Rails.admin_client { |client| puts Tarantool::Rails.schema.apply(client) }
+    task :apply, [:alter] => :environment do |_task, args|
+      alter = tarantool_schema_names(args[:alter]).map(&:to_sym)
+      Tarantool::Rails.admin_client { |client| puts Tarantool::Rails.schema.apply(client, alter:) }
     end
 
     desc 'Fail unless the live schema equals the declaration, for CI'
-    task check: :environment do
-      pending = Tarantool::Rails.admin_client { |client| Tarantool::Rails.schema.plan(client) }
+    task :check, [:alter] => :environment do |_task, args|
+      alter = tarantool_schema_names(args[:alter]).map(&:to_sym)
+      pending = Tarantool::Rails.admin_client { |client| Tarantool::Rails.schema.plan(client, alter:) }
       next if pending.empty?
 
       pending.each { |line| puts "pending: #{line}" }
       exit 1
     end
+
+    desc 'Write the live schema to config/tarantool_schema.rb (FORCE=1 to overwrite; spaces as [users,codes])'
+    task :dump, [:only] => :environment do |_task, args|
+      tarantool_schema_dump(Tarantool::Rails.schema_path.to_s, tarantool_schema_names(args[:only]))
+    end
   end
 end

data/lib/tarantool/rails/version.rb

@@ -2,6 +2,6 @@
 
 module Tarantool
   module Rails
-    VERSION = '0.1.0'
+    VERSION = '0.2.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tarantool-rails
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Starlexxx
@@ -64,14 +64,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
 description: config/tarantool.yml per environment, one connection pool per process,
   models on it without an initializer, ActiveRecord-style log lines, schema rake tasks
   and generators.