dekiru 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 69be6523ac8efcf2cfd2d1ffe1f076af877e66cf71a49ee8bd657764d6bed300
-  data.tar.gz: 2084793dd23ab85c1ad750f86957f99c914ff479e1fc0715e0bd8c16a2808032
+  metadata.gz: a1c032693e2658b61ee9744b7e872a4379eb194d9f4e3a4ac1147c4b5025682b
+  data.tar.gz: 14321e4bf0b2574358bfc29147bf801480801181af1c8e40879d8f4357cc7fca
 SHA512:
-  metadata.gz: 7c1f0b0d3d2035149fdc21d07402a586bfe354920622ecbdf083cc48210be8c0811a1fe436d453e6f1475c64982c2dbb20af7893e49924a41c1028cb125e411e
-  data.tar.gz: d1abc1daa96ca6c3c3ecf936bb46101387926bca31cd628e0286ee508d627b83e140b67ac4883f064422b054b6b71457e431366cf664eeb06ab23c8b94b792ef
+  metadata.gz: a5f36a181ddd30cf6500c5d454ceffb5cb058a5aeb5de29b1f44b96eb9eb6fe4796522bd8e0b20f0e3ae09cb5ca83f86688ac7ff1df4421522c0bbacc83ad9ac
+  data.tar.gz: e39f08ff48c0f412c7fbe7ff755b2c2dd77378aca03172bff6622b09d26c6bc7f94e08cefbe5ebdff575504550520da146e7b4f312b9c3b14fef6b6f96242523

data/README.md

@@ -25,7 +25,7 @@ Or install it yourself as:
 ```ruby
 require 'dekiru/capybara/helpers'
 RSpec.configure do |config|
-  config.include Dekiru::Capybara::Helpers, type: :feature
+  config.include Dekiru::Capybara::Helpers, type: :system
 end
 ```
 
@@ -55,7 +55,7 @@ wait_for_element_position_stable(element)
 ```ruby
 require 'dekiru/capybara/matchers'
 RSpec.configure do |config|
-  config.include Dekiru::Capybara::Matchers, type: :feature
+  config.include Dekiru::Capybara::Matchers, type: :system
 end
 ```
 
@@ -64,7 +64,7 @@ end
 ```ruby
 # javascriptエラーがあったらテスト失敗するように
 RSpec.configure do |config|
-  config.after(:each, type: :feature) do |example|
+  config.after(:each, type: :system) do |example|
     if example.metadata[:js] == true
       expect(page).to have_no_js_errors
     end
@@ -201,6 +201,46 @@ Dekiru.configure do |config|
 end
 ```
 
+### Dekiru::TransactionProvider
+
+`Dekiru::DataMigrationOperator` を使うスクリプトにおいて、複数データベースへの書き込みが必要な場合など、`ActiveRecord::Base.transaction` によるトランザクション開始だけでは不十分な場合があります。`Dekiru::TransactionProvider` を実装することで `Dekiru::DataMigrationOperator` のトランザクション開始の挙動をカスタマイズすることができます。
+
+以下のようなアプリケーションコードがあるとします。
+
+```ruby
+class LegacyRecord < ApplicationRecord
+  connects_to database: { writing: :legacy, reading: :legacy }
+end
+
+class ApplicationRecord < ActiveRecord::Base
+  connects_to database: { writing: :primary, reading: :primary }
+
+  def self.with_legacy_transaction
+    ActiveRecord::Base.transaction do
+      LegacyRecord.transaction do
+        yield
+      end
+    end
+  end
+end
+```
+
+`Dekiru::DataMigrationOperator` においても `ApplicationRecord.with_legacy_transaction` を使ってトランザクション開始するために、以下のような設定を用意します。
+
+```ruby
+# config/initializer/dekiru.rb
+class MyTransactionProvider < Dekiru::TransactionProvider
+  def within_transaction(&)
+    ApplicationRecord.with_legacy_transaction(&)
+  end
+end
+
+Dekiru.configure do |config|
+  config.transaction_provider = MyTransactionProvider.new
+end
+```
+
+
 ## Refinements
 
 ### Dekiru::CamelizeHash

data/lib/dekiru/data_migration_operator.rb

@@ -30,7 +30,7 @@ module Dekiru
       else
         raise NestedTransactionError if current_transaction_open?
 
-        @result = ActiveRecord::Base.transaction do
+        @result = transaction_provider.within_transaction do
           run(&block)
           log "Finished execution: #{title}"
           confirm?("\nAre you sure to commit?")
@@ -75,10 +75,6 @@ module Dekiru
 
     private
 
-    def current_transaction_open?
-      ActiveRecord::Base.connection.current_transaction.open?
-    end
-
     def log(message)
       if @pb && !@pb.finished?
         @pb.log(message)
@@ -148,5 +144,11 @@ module Dekiru
         instance_eval(&block)
       end
     end
+
+    def transaction_provider
+      Dekiru.configuration.transaction_provider
+    end
+
+    delegate :current_transaction_open?, to: :transaction_provider
   end
 end

data/lib/dekiru/transaction_provider.rb

@@ -0,0 +1,11 @@
+module Dekiru
+  class TransactionProvider
+    def within_transaction(&)
+      ActiveRecord::Base.transaction(&)
+    end
+
+    def current_transaction_open?
+      ActiveRecord::Base.connection.current_transaction.open?
+    end
+  end
+end

data/lib/dekiru/version.rb

@@ -1,3 +1,3 @@
 module Dekiru
-  VERSION = '0.7.0'
+  VERSION = '0.8.0'
 end

data/lib/dekiru.rb

@@ -4,6 +4,7 @@ require 'dekiru/helper'
 require 'dekiru/data_migration_operator'
 require 'dekiru/mail_security_interceptor'
 require 'dekiru/camelize_hash'
+require 'dekiru/transaction_provider'
 
 require 'active_support'
 require 'active_support/all'
@@ -20,11 +21,12 @@ module Dekiru
   end
 
   class Configuration
-    attr_accessor :mail_security_hook, :maintenance_script_directory
+    attr_accessor :mail_security_hook, :maintenance_script_directory, :transaction_provider
 
     def initialize
       @mail_security_hook = false # default
       @maintenance_script_directory = 'scripts'
+      @transaction_provider = TransactionProvider.new
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dekiru
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Akihiro Matsumura
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-08-14 00:00:00.000000000 Z
+date: 2025-04-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -139,6 +139,7 @@ files:
 - lib/dekiru/railtie.rb
 - lib/dekiru/task_with_logger.rb
 - lib/dekiru/tasks/db.rake
+- lib/dekiru/transaction_provider.rb
 - lib/dekiru/version.rb
 - lib/generators/maintenance_script/USAGE
 - lib/generators/maintenance_script/maintenance_script_generator.rb