standby 4.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6dca656d9e0b7b23ba371c78eece948316152faa75952dfba92567b4f6cd7e79
+  data.tar.gz: f8c9f94c39debceb101f69207ebefba5b1dd7092ec58f53713846782f87b32fc
+SHA512:
+  metadata.gz: 93b848675402550dd940ee266f31f8c533ff27bf7f99663ff1e8c538d5dbec0a4c9e2615ec253a074f453cc89abfea95536af62640bff9e77dd326a3772db709
+  data.tar.gz: 48eb1b450fbf589cc5a13e65f5fdd2ed1689ad5a346e26670fead52b522abfa73d35659b97032651e2819a3d1dddbd3ac57463a1d876aa48dc9cb80dc8d6f8d6

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+gemfiles/*.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+test_db
+test_standby_one
+test_standby_two

data/.rspec

@@ -0,0 +1 @@
+--color

data/.travis.yml

@@ -0,0 +1,13 @@
+language: ruby
+
+rvm:
+ - 2.2.2
+ - 2.3.3
+
+gemfile:
+  - Gemfile
+  - gemfiles/rails3.2.gemfile
+  - gemfiles/rails4.gemfile
+  - gemfiles/rails4.2.gemfile
+
+script: bundle exec rspec spec

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec name: 'standby'

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Kenn Ejima
+
+MIT License
+
+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,189 @@
+# Standby - Read from standby databases for ActiveRecord (formerly Slavery)
+
+[![Build Status](https://travis-ci.org/kenn/slavery.svg)](https://travis-ci.org/kenn/slavery)
+
+Standby is a simple, easy to use gem for ActiveRecord that enables conservative reading from standby databases, which means it won't automatically redirect all SELECTs to standbys.
+
+Instead, you can do `Standby.on_standby { User.count }` to send a particular query to a standby.
+
+Background: Probably your app started off with one single database. As it grows, you would upgrade to a primary-standby (or master-slave) replication for redundancy. At this point, all queries still go to the primary and standbys are just backups. With that configuration, it's tempting to run some long-running queries on one of the standbys. And that's exactly what Standby does.
+
+* Conservative - Safe by default. Installing Standby won't change your app's current behavior.
+* Future proof - No dirty hacks. Simply works as a proxy for `ActiveRecord::Base.connection`.
+* Simple code - Intentionally small. You can read the entire source and completely stay in control.
+
+Standby works with ActiveRecord 3 or later.
+
+## Install
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'standby'
+```
+
+And create standby configs for each environment.
+
+```yaml
+development:
+  database: myapp_development
+
+development_standby:
+  database: myapp_development
+```
+
+By convention, config keys with `[env]_standby` are automatically used for standby reads.
+
+Notice that we just copied the settings of `development` to `development_standby`. For `development` and `test`, it's actually recommended as probably you don't want to have replicating multiple databases on your machine. Two connections to the same identical database should be fine for testing purpose.
+
+In case you prefer DRYer definition, YAML's aliasing and key merging might help.
+
+```yaml
+common: &common
+  adapter: mysql2
+  username: root
+  database: myapp_development
+
+development:
+  <<: *common
+
+development_standby:
+  <<: *common
+```
+
+Optionally, you can use a database url for your connections:
+
+```yaml
+development: postgres://root:@localhost:5432/myapp_development
+development_standby: postgres://root:@localhost:5432/myapp_development_standby
+```
+
+At this point, Standby does nothing. Run tests and confirm that nothing is broken.
+
+## Usage
+
+To start using Standby, you need to add `Standby.on_standby` in your code. Queries in the `Standby.on_standby` block run on the standby.
+
+```ruby
+Standby.on_standby { User.count }   # => runs on standby
+Standby.on_standby(:two) { User.count }  # => runs on another standby configured as `development_standby_two`
+```
+
+You can nest `on_standby` and `on_primary` interchangeably. The following code works as expected.
+
+```ruby
+Standby.on_standby do
+  ...
+  Standby.on_primary do
+    ...
+  end
+  ...
+end
+```
+
+Alternatively, you may call `on_standby` directly on the scope, so that the query will be read from standby when it's executed.
+
+```ruby
+User.on_standby.where(active: true).count
+```
+
+Caveat: `pluck` is not supported by the scope syntax, you still need `Standby.on_standby` in this case.
+
+## Read-only user
+
+For an extra safeguard, it is recommended to use a read-only user for standby access.
+
+```yaml
+development_standby:
+  <<: *common
+  username: readonly
+```
+
+With MySQL, `GRANT SELECT` creates a read-only user.
+
+```SQL
+GRANT SELECT ON *.* TO 'readonly'@'localhost';
+```
+
+With this user, writes on a standby should raise an exception.
+
+```ruby
+Standby.on_standby { User.create }  # => ActiveRecord::StatementInvalid: Mysql2::Error: INSERT command denied...
+```
+
+With Postgres you can set the entire database to be readonly:
+
+```SQL
+ALTER DATABASE myapp_development_standby SET default_transaction_read_only = true;
+```
+
+It is a good idea to confirm this behavior in your test code as well.
+
+## Disable temporarily
+
+You can quickly disable standby reads by dropping the following line in `config/initializers/standby.rb`.
+
+```ruby
+Standby.disabled = true
+```
+
+With this line, Standby stops connection switching and all queries go to the primary.
+
+This may be useful when one of the primary or the standby goes down. You would rewrite `database.yml` to make all queries go to the surviving database, until you restore or rebuild the failed one.
+
+## Transactional fixtures
+
+When `use_transactional_fixtures` is set to `true`, it's NOT recommended to
+write to the database besides fixtures, since the standby connection is not aware
+of changes performed in the primary connection due to [transaction isolation](https://en.wikipedia.org/wiki/Isolation_(database_systems)).
+
+In that case, you are suggested to disable Standby in the test environment by
+putting the following in `test/test_helper.rb`
+(or `spec/spec_helper.rb` for RSpec users):
+
+```ruby
+Standby.disabled = true
+```
+
+## Upgrading from version 3 to version 4
+
+The gem name has been changed from `slavery` to `standby`.
+
+Update your Gemfile
+
+```ruby
+gem 'standby'
+```
+
+Replace `Slavery` with `Standby`, `on_slave` with `on_standby`, and `on_master` with `on_primary`.
+
+```sh
+grep -e Slavery **/*.rake **/*.rb -s -l | xargs sed -i "" "s|Slavery|Standby|g"
+grep -e on_slave **/*.rake **/*.rb -s -l | xargs sed -i "" "s|on_slave|on_standby|g"
+grep -e on_master **/*.rake **/*.rb -s -l | xargs sed -i "" "s|on_master|on_primary|g"
+```
+
+## Upgrading from version 2 to version 3
+
+Please note that `Standby.spec_key=` method has been removed from version 3.
+
+## Support for non-Rails apps
+
+If you're using ActiveRecord in a non-Rails app (e.g. Sinatra), be sure to set `RACK_ENV` environment variable in the boot sequence, then:
+
+```ruby
+require 'standby'
+
+ActiveRecord::Base.configurations = {
+  'development' =>          { adapter: 'mysql2', ... },
+  'development_standby' =>  { adapter: 'mysql2', ... }
+}
+ActiveRecord::Base.establish_connection(:development)
+```
+
+## Changelog
+
+* v4.0.0: Rename gem from Slavery to Standby
+* v3.0.0: Support for multiple standby targets ([@punchh](https://github.com/punchh))
+* v2.1.0: Debug log support / Database URL support / Rails 3.2 & 4.0 compatibility (Thanks to [@citrus](https://github.com/citrus))
+* v2.0.0: Rails 5 support

data/Rakefile

@@ -0,0 +1,7 @@
+# require 'bundler/gem_tasks'
+Bundler::GemHelper.install_tasks(name: 'standby')
+
+# RSpec
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+task :default => :spec

data/bin/console

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require_relative "../spec/spec_helper"
+require "irb"
+
+ActiveRecord::Base.logger = ActiveSupport::Logger.new(STDOUT)
+
+IRB.start

data/gemfiles/rails3.2.gemfile

@@ -0,0 +1,9 @@
+source "https://rubygems.org"
+
+gem 'activerecord', '~> 3.2'
+
+group :development, :test do
+  gem 'test-unit', '~> 3.0'
+end
+
+gemspec :path => '../'

data/gemfiles/rails4.2.gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem 'activerecord', '~> 4.2'
+
+gemspec :path => '../'

data/gemfiles/rails4.gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem 'activerecord', '~> 4.0.0'
+
+gemspec :path => '../'

data/lib/standby.rb

@@ -0,0 +1,29 @@
+require 'active_record'
+require 'standby/version'
+require 'standby/base'
+require 'standby/error'
+require 'standby/connection_holder'
+require 'standby/transaction'
+require 'standby/active_record/base'
+require 'standby/active_record/connection_handling'
+require 'standby/active_record/relation'
+require 'standby/active_record/log_subscriber'
+
+module Standby
+  class << self
+    attr_accessor :disabled
+
+    def standby_connections
+      @standby_connections ||= {}
+    end
+
+    def on_standby(name = :null_state, &block)
+      raise Standby::Error.new('invalid standby target') unless name.is_a?(Symbol)
+      Base.new(name).run &block
+    end
+
+    def on_primary(&block)
+      Base.new(:primary).run &block
+    end
+  end
+end

data/lib/standby/active_record/base.rb

@@ -0,0 +1,25 @@
+module ActiveRecord
+  class Base
+    class << self
+      alias_method :connection_without_standby, :connection
+
+      def connection
+        case Thread.current[:_standby]
+        when :primary, NilClass
+          connection_without_standby
+        else
+          Standby.connection_holder(Thread.current[:_standby]).connection_without_standby
+        end
+      end
+
+      # Generate scope at top level e.g. User.on_standby
+      def on_standby(name = :null_state)
+        # Why where(nil)?
+        # http://stackoverflow.com/questions/18198963/with-rails-4-model-scoped-is-deprecated-but-model-all-cant-replace-it
+        context = where(nil)
+        context.standby_target = name || :null_state
+        context
+      end
+    end
+  end
+end

data/lib/standby/active_record/connection_handling.rb

@@ -0,0 +1,6 @@
+module ActiveRecord
+  module ConnectionHandling
+    # Already defined in Rails 4.1+
+    RAILS_ENV ||= -> { (Rails.env if defined?(Rails.env)) || ENV["RAILS_ENV"] || ENV["RACK_ENV"] }
+  end
+end

data/lib/standby/active_record/log_subscriber.rb

@@ -0,0 +1,12 @@
+module ActiveRecord
+  class LogSubscriber
+
+    alias_method :debug_without_standby, :debug
+
+    def debug(msg)
+      db = Standby.disabled ? "" : color("[#{Thread.current[:_standby] || "primary"}]", ActiveSupport::LogSubscriber::GREEN, true)
+      debug_without_standby(db + msg)
+    end
+
+  end
+end

data/lib/standby/active_record/relation.rb

@@ -0,0 +1,28 @@
+module ActiveRecord
+  class Relation
+    attr_accessor :standby_target
+
+    # Supports queries like User.on_standby.to_a
+    alias_method :exec_queries_without_standby, :exec_queries
+
+    def exec_queries
+      if standby_target
+        Standby.on_standby(standby_target) { exec_queries_without_standby }
+      else
+        exec_queries_without_standby
+      end
+    end
+
+
+    # Supports queries like User.on_standby.count
+    alias_method :calculate_without_standby, :calculate
+
+    def calculate(*args)
+      if standby_target
+        Standby.on_standby(standby_target) { calculate_without_standby(*args) }
+      else
+        calculate_without_standby(*args)
+      end
+    end
+  end
+end

data/lib/standby/base.rb

@@ -0,0 +1,40 @@
+module Standby
+  class Base
+    def initialize(target)
+      @target = decide_with(target)
+    end
+
+    def run(&block)
+      run_on @target, &block
+    end
+
+  private
+
+    def decide_with(target)
+      if Standby.disabled || target == :primary
+        :primary
+      elsif inside_transaction?
+        raise Standby::Error.new('on_standby cannot be used inside transaction block!')
+      elsif target == :null_state
+        :standby
+      elsif target.present?
+        "standby_#{target}".to_sym
+      else
+        raise Standby::Error.new('on_standby cannot be used with a nil target!')
+      end
+    end
+
+    def inside_transaction?
+      open_transactions = run_on(:primary) { ActiveRecord::Base.connection.open_transactions }
+      open_transactions > Standby::Transaction.base_depth
+    end
+
+    def run_on(target)
+      backup = Thread.current[:_standby] # Save for recursive nested calls
+      Thread.current[:_standby] = target
+      yield
+    ensure
+      Thread.current[:_standby] = backup
+    end
+  end
+end

data/lib/standby/connection_holder.rb

@@ -0,0 +1,28 @@
+module Standby
+  class ConnectionHolder < ActiveRecord::Base
+    self.abstract_class = true
+
+    class << self
+      # for delayed activation
+      def activate(target)
+        spec = ActiveRecord::Base.configurations["#{ActiveRecord::ConnectionHandling::RAILS_ENV.call}_#{target}"]
+        raise Error.new("Standby target '#{target}' is invalid!") if spec.nil?
+        establish_connection spec
+      end
+    end
+  end
+
+  class << self
+    def connection_holder(target)
+      klass_name = "Standby#{target.to_s.camelize}ConnectionHolder"
+      standby_connections[klass_name] ||= begin
+        klass = Class.new(Standby::ConnectionHolder) do
+          self.abstract_class = true
+        end
+        Object.const_set(klass_name, klass)
+        klass.activate(target)
+        klass
+      end
+    end
+  end
+end

data/lib/standby/error.rb

@@ -0,0 +1,4 @@
+module Standby
+  class Error < StandardError
+  end
+end

data/lib/standby/transaction.rb

@@ -0,0 +1,29 @@
+module Standby
+  class Transaction
+    # The methods on ActiveSupport::TestCase which can potentially be used
+    # to determine if transactional fixtures are enabled
+    TEST_CONFIG_METHODS = [
+      :use_transactional_tests,
+      :use_transactional_fixtures
+    ]
+
+    class << self
+      def base_depth
+        @base_depth ||= if defined?(ActiveSupport::TestCase) &&
+          transactional_fixtures_enabled?
+        then
+          1
+        else
+          0
+        end
+      end
+
+      private
+
+      def transactional_fixtures_enabled?
+        config = ActiveSupport::TestCase
+        TEST_CONFIG_METHODS.any? {|m| config.respond_to?(m) and config.send(m) }
+      end
+    end
+  end
+end

data/lib/standby/version.rb

@@ -0,0 +1,3 @@
+module Standby
+  VERSION = '4.0.0'
+end

data/slavery.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'standby/version'
+
+Gem::Specification.new do |gem|
+  gem.post_install_message = 'The slavery gem has been deprecated and has ' \
+                             'been replaced by standby. Please switch to ' \
+                             'standby as soon as possible.'
+  gem.name          = 'slavery'
+  gem.version       = Standby::VERSION
+  gem.authors       = ['Kenn Ejima']
+  gem.email         = ['kenn.ejima@gmail.com']
+  gem.description   = %q{Simple, conservative slave reads for ActiveRecord}
+  gem.summary       = %q{Simple, conservative slave reads for ActiveRecord}
+  gem.homepage      = 'https://github.com/kenn/slavery'
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^exe/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ['lib']
+
+  gem.add_runtime_dependency 'activerecord', '>= 3.0.0'
+
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'sqlite3'
+end

data/spec/active_record/log_subscriber_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+require 'logger'
+
+describe ActiveRecord::LogSubscriber do
+
+  describe 'logging' do
+
+    let(:log) { StringIO.new }
+    let(:logger) { Logger.new(log) }
+
+    before do
+      ActiveRecord::Base.logger = logger
+      @backup_disabled = Standby.disabled
+    end
+
+    after do
+      Standby.disabled = @backup_disabled
+    end
+
+    it 'it prefixes log messages with primary' do
+      User.count
+      log.rewind
+      expect(log.read).to include('[primary]')
+    end
+
+    it 'it prefixes log messages with the standby connection' do
+      User.on_standby.count
+      log.rewind
+      expect(log.read).to include('[standby]')
+    end
+
+    it 'it does nothing when standby is disabled' do
+      Standby.disabled = true
+      User.count
+      log.rewind
+      expect(log.read).to_not include('[primary]')
+    end
+
+  end
+
+end

data/spec/configuration_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+describe 'configuration' do
+  before do
+    # Backup connection and configs
+    @backup_conn = Standby.instance_variable_get :@standby_connections
+    @backup_config = ActiveRecord::Base.configurations.dup
+    @backup_disabled = Standby.disabled
+    @backup_conn.each_key do |klass_name|
+      Object.send(:remove_const, klass_name) if Object.const_defined?(klass_name)
+    end
+    Standby.instance_variable_set :@standby_connections, {}
+  end
+
+  after do
+    # Restore connection and configs
+    Standby.instance_variable_set :@standby_connections, @backup_conn
+    ActiveRecord::Base.configurations = @backup_config
+    Standby.disabled = @backup_disabled
+  end
+
+  it 'raises error if standby configuration not specified' do
+    ActiveRecord::Base.configurations['test_standby'] = nil
+
+    expect { Standby.on_standby { User.count } }.to raise_error(Standby::Error)
+  end
+
+  it 'connects to primary if standby configuration is disabled' do
+    ActiveRecord::Base.configurations['test_standby'] = nil
+    Standby.disabled = true
+
+    expect(Standby.on_standby { User.count }).to be 2
+  end
+end

data/spec/slavery_spec.rb

@@ -0,0 +1,107 @@
+require 'spec_helper'
+
+describe Standby do
+  def standby_value
+    Thread.current[:_standby]
+  end
+
+  def on_standby?
+    standby_value == :standby
+  end
+
+  it 'sets thread local' do
+    Standby.on_primary { expect(standby_value).to be :primary }
+    Standby.on_standby { expect(standby_value).to be :standby }
+    Standby.on_standby(:two) { expect(standby_value).to be :standby_two}
+  end
+
+  it 'returns value from block' do
+    expect(Standby.on_primary { User.count }).to be 2
+    expect(Standby.on_standby  { User.count }).to be 1
+    expect(Standby.on_standby(:two) { User.count }).to be 0
+  end
+
+  it 'handles nested calls' do
+    # Standby -> Standby
+    Standby.on_standby do
+      expect(on_standby?).to be true
+
+      Standby.on_standby do
+        expect(on_standby?).to be true
+      end
+
+      expect(on_standby?).to be true
+    end
+
+    # Standby -> Primary
+    Standby.on_standby do
+      expect(on_standby?).to be true
+
+      Standby.on_primary do
+        expect(on_standby?).to be false
+      end
+
+      expect(on_standby?).to be true
+    end
+  end
+
+  it 'raises error in transaction' do
+    User.transaction do
+      expect { Standby.on_standby { User.first } }.to raise_error(Standby::Error)
+    end
+  end
+
+  it 'disables by configuration' do
+    backup = Standby.disabled
+
+    Standby.disabled = false
+    Standby.on_standby { expect(standby_value).to be :standby }
+
+    Standby.disabled = true
+    Standby.on_standby { expect(standby_value).to be :primary }
+
+    Standby.disabled = backup
+  end
+
+  it 'avoids stack overflow with 3rdparty gem that defines alias_method. namely newrelic...' do
+    class ActiveRecord::Relation
+      alias_method :calculate_without_thirdparty, :calculate
+
+      def calculate(*args)
+        calculate_without_thirdparty(*args)
+      end
+    end
+
+    expect(User.count).to be 2
+
+    class ActiveRecord::Relation
+      alias_method :calculate, :calculate_without_thirdparty
+    end
+  end
+
+  it 'works with nils like standby' do
+    expect(User.on_standby(nil).count).to be User.on_standby.count
+  end
+
+  it 'raises on blanks and strings' do
+    expect { User.on_standby("").count }.to raise_error(Standby::Error)
+    expect { User.on_standby("two").count }.to raise_error(Standby::Error)
+    expect { User.on_standby("standby").count }.to raise_error(Standby::Error)
+  end
+
+  it 'raises with non existent extension' do
+    expect { Standby.on_standby(:non_existent) { User.first } }.to raise_error(Standby::Error)
+  end
+
+  it 'works with any scopes' do
+    expect(User.count).to be 2
+    expect(User.on_standby(:two).count).to be 0
+    expect(User.on_standby.count).to be 1
+
+    # Why where(nil)?
+    # http://stackoverflow.com/questions/18198963/with-rails-4-model-scoped-is-deprecated-but-model-all-cant-replace-it
+    expect(User.where(nil).to_a.size).to be 2
+    expect(User.on_standby(:two).where(nil).to_a.size).to be 0
+    expect(User.on_standby.where(nil).to_a.size).to be 1
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,58 @@
+require 'rubygems'
+require 'bundler/setup'
+
+ENV['RACK_ENV'] = 'test'
+
+require 'standby'
+
+ActiveRecord::Base.configurations = {
+  'test'            =>  { 'adapter' => 'sqlite3', 'database' => 'test_db' },
+  'test_standby'      =>  { 'adapter' => 'sqlite3', 'database' => 'test_standby_one' },
+  'test_standby_two'  =>  { 'adapter' => 'sqlite3', 'database' => 'test_standby_two'},
+  'test_standby_url'  =>  'postgres://root:@localhost:5432/test_standby'
+}
+
+# Prepare databases
+class User < ActiveRecord::Base
+  has_many :items
+end
+
+class Item < ActiveRecord::Base
+  belongs_to :user
+end
+
+class Seeder
+  def run
+    # Populate on primary
+    connect(:test)
+    create_tables
+    User.create
+    User.create
+    User.first.items.create
+
+    # Populate on standby, emulating replication lag
+    connect(:test_standby)
+    create_tables
+    User.create
+
+    # Populate on standby two
+    connect(:test_standby_two)
+    create_tables
+
+    # Reconnect to primary
+    connect(:test)
+  end
+
+  def create_tables
+    ActiveRecord::Base.connection.create_table :users, force: true
+    ActiveRecord::Base.connection.create_table :items, force: true do |t|
+      t.references :user
+    end
+  end
+
+  def connect(env)
+    ActiveRecord::Base.establish_connection(env)
+  end
+end
+
+Seeder.new.run

data/standby.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'standby/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = 'standby'
+  gem.version       = Standby::VERSION
+  gem.authors       = ['Kenn Ejima']
+  gem.email         = ['kenn.ejima@gmail.com']
+  gem.description   = %q{Read from stand-by databases for ActiveRecord}
+  gem.summary       = %q{Read from stand-by databases for ActiveRecord}
+  gem.homepage      = 'https://github.com/kenn/standby'
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^exe/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ['lib']
+
+  gem.add_runtime_dependency 'activerecord', '>= 3.0.0'
+
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'sqlite3'
+end

metadata

@@ -0,0 +1,116 @@
+--- !ruby/object:Gem::Specification
+name: standby
+version: !ruby/object:Gem::Version
+  version: 4.0.0
+platform: ruby
+authors:
+- Kenn Ejima
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-07-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Read from stand-by databases for ActiveRecord
+email:
+- kenn.ejima@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- gemfiles/rails3.2.gemfile
+- gemfiles/rails4.2.gemfile
+- gemfiles/rails4.gemfile
+- lib/standby.rb
+- lib/standby/active_record/base.rb
+- lib/standby/active_record/connection_handling.rb
+- lib/standby/active_record/log_subscriber.rb
+- lib/standby/active_record/relation.rb
+- lib/standby/base.rb
+- lib/standby/connection_holder.rb
+- lib/standby/error.rb
+- lib/standby/transaction.rb
+- lib/standby/version.rb
+- slavery.gemspec
+- spec/active_record/log_subscriber_spec.rb
+- spec/configuration_spec.rb
+- spec/slavery_spec.rb
+- spec/spec_helper.rb
+- standby.gemspec
+homepage: https://github.com/kenn/standby
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: Read from stand-by databases for ActiveRecord
+test_files:
+- spec/active_record/log_subscriber_spec.rb
+- spec/configuration_spec.rb
+- spec/slavery_spec.rb
+- spec/spec_helper.rb