activerecord-slave 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3bf6fde1390af45c8e95d55e2405f19d092127c8
+  data.tar.gz: f5ab29a82e819cba72cdb3f6803c1c4be457d454
+SHA512:
+  metadata.gz: 4501a56c331b50a00083accf835dd77ece806d469a8de242f3fa52b6d1ee4ff8bcfa6e43060d4c007b5856bf3044cac0a2128e7952106b6da9adf8389ecfa732
+  data.tar.gz: b0433107d0c77d13215581c9d2541307b01cf06edac34682a6588c4aa38c48986392c9166b1b2ac7fb0d7f6eae09e8aa666259483d8761d9024969df3424e6d1

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+log
+vendor

data/.rspec

@@ -0,0 +1,3 @@
+--require spec_helper
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,56 @@
+AllCops:
+  Exclude:
+    - "vendor/**/*"
+  DisplayCopNames: true
+
+Style/AsciiComments:
+  Enabled: false
+
+Style/BracesAroundHashParameters:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/ExtraSpacing:
+  Enabled: false
+
+Style/GuardClause:
+  MinBodyLength: 5
+
+Style/MethodDefParentheses:
+  EnforcedStyle: require_parentheses
+
+Style/ModuleFunction:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/HashSyntax:
+  EnforcedStyle: ruby19_no_mixed_keys
+  Exclude:
+    - "**/*.rake"
+    - "Rakefile"
+
+Metrics/LineLength:
+  Max: 160
+  Exclude:
+    - "db/migrate/*.rb"
+
+NumericLiterals:
+  MinDigits: 7
+
+Lint/AssignmentInCondition:
+  Enabled: false
+
+Lint/BlockAlignment:
+  Enabled: false
+
+Metrics/MethodLength:
+  Max: 12
+
+FileName:
+  Exclude:
+    - 'lib/activerecord-slave.rb'
+    - 'spec/tasks/activerecord-slave_spec.rb'

data/.ruby-version

@@ -0,0 +1 @@
+2.2.3

data/.travis.yml

@@ -0,0 +1,31 @@
+language: ruby
+install: bundle install --jobs=3 --retry=3
+cache:
+  directories:
+  - vendor/bundle
+rvm:
+  - 2.2.3
+  - 2.1.7
+  - 2.0.0-p647
+services:
+  - mysql
+addons:
+  apt:
+    packages:
+    - libaio-dev
+    - libaio1
+env:
+  - DEBIAN_FRONTEND=noninteractive PERL_MM_USE_DEFAULT=1 PERL5LIB=$HOME/perl5/lib/perl5 PATH=$HOME/bin:$HOME/perl5/bin/:$PATH
+before_install:
+  - mkdir ~/bin
+  - cd ~/bin
+  - curl -O https://github.com/miyagawa/cpanminus/raw/master/cpanm
+  - curl -L https://cpanmin.us/ -o cpanm
+  - chmod +x cpanm
+  - cd -
+  - cpanm MySQL::Sandbox
+  - wget http://ftp.kaist.ac.kr/mysql/Downloads/MySQL-5.6/mysql-5.6.26-linux-glibc2.5-x86_64.tar.gz
+  - make_replication_sandbox mysql-5.6.26-linux-glibc2.5-x86_64.tar.gz
+  - gem install bundler -v 1.10.6
+script:
+  - bundle exec rake spec

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in activerecord-slave.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,46 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+## Uncomment and set this to only include directories you want to watch
+# directories %w(app lib config test spec features) \
+#  .select{|d| Dir.exists?(d) ? d : UI.warning("Directory #{d} does not exist")}
+
+## Note: if you are using the `directories` clause above and you are not
+## watching the project directory ('.'), then you will want to move
+## the Guardfile to a watched dir and symlink it back, e.g.
+#
+#  $ mkdir config
+#  $ mv Guardfile config/
+#  $ ln -s config/Guardfile .
+#
+# and, you'll have to watch "config/Guardfile" instead of "Guardfile"
+
+# Note: The cmd option is now required due to the increasing number of ways
+#       rspec may be run, below are examples of the most common uses.
+#  * bundler: 'bundle exec rspec'
+#  * bundler binstubs: 'bin/rspec'
+#  * spring: 'bin/rspec' (This will use spring if running and you have
+#                          installed the spring binstubs per the docs)
+#  * zeus: 'zeus rspec' (requires the server to be started separately)
+#  * 'just' rspec: 'rspec'
+
+guard :rspec, cmd: "bundle exec rspec", all_on_start: true, all_after_pass: true do
+  require "guard/rspec/dsl"
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # Feel free to open issues for suggestions and improvements
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  dsl.watch_spec_files_for(ruby.lib_files)
+
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch("spec/spec_helper.rb")  { "spec" }
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 hirocaster
+
+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,141 @@
+# Activerecord::Slave
+
+[![Build Status](https://travis-ci.org/hirocaster/activerecord-slave.svg?branch=master)](https://travis-ci.org/hirocaster/activerecord-slave) [![Coverage Status](https://coveralls.io/repos/hirocaster/activerecord-slave/badge.svg?branch=master&service=github)](https://coveralls.io/github/hirocaster/activerecord-slave?branch=master) [![Code Climate](https://codeclimate.com/github/hirocaster/activerecord-slave/badges/gpa.svg)](https://codeclimate.com/github/hirocaster/activerecord-slave) [![Dependency Status](https://gemnasium.com/hirocaster/activerecord-slave.svg)](https://gemnasium.com/hirocaster/activerecord-slave)
+
+ActiveRecord for MySQL Replication databases(master/slave).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'activerecord-slave'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install activerecord-slave
+
+## Usage
+
+Add database connections to your application's config/database.yml:
+
+```yaml
+default: &default
+  adapter: mysql2
+  encoding: utf8
+  pool: 5
+  database: user
+  username: root
+  password:
+  host: localhost
+
+user_master:
+  <<: *default
+  host: master.db.example.com
+
+user_slave_001:
+  <<: *default
+  host: slave_001.db.example.com
+
+user_slave_002:
+<<: *default
+  host: slave_002.db.example.com
+  ```
+
+Add this example, your application's config/initializers/active_record_slave.rb:
+
+```ruby
+ActiveRecord::Slave.configure do |config|
+  config.define_replication(:user) do |replication| # replication name
+    replication.register_master(:user_master)       # master connection
+
+    replication.register_slave(:user_slave_001, 70) # slave connection, weight
+    replication.register_slave(:user_slave_002, 30)
+  end
+end
+```
+
+### Model
+
+app/model/user.rb
+
+```ruby
+class User < ActiveRecord::Base
+  has_many :items
+  include ActiveRecord::Slave::Model
+  use_slave :user # replicaition name
+end
+
+class Item < ActiveRecord::Base
+  belongs_to :user
+  include ActiveRecord::Slave::Model
+  use_slave :user # replicaition name
+end
+```
+
+Query for master database.
+
+```ruby
+User.all
+User.find(1)
+User.where(name: "foobar")
+```
+
+Query for slave databases.
+
+distrebute(load-balance) connection by configured weight settings.
+
+```ruby
+User.slave_for.all
+User.slave_for.find(1)
+User.slave_for.where(name: "foobar")
+```
+
+Association case. If select from slave, should use #slave_for. Not use assosiaion daynamic methods.
+
+```ruby
+User.find(1).items # items from master database
+
+user = User.find(1)
+Item.slave_for(user_id: user.id) # items from slave databases
+```
+
+### Tasks
+
+Database create/drop tasks.
+
+```
+rake active_record:slave:db_create[replicaition]  # Create database for replicaition master
+rake active_record:slave:db_drop[replicaition]    # Drop database for replicaition master
+```
+
+### Migration
+
+You shuld write `#connection` to migration file for replication databases.
+
+```
+class CreateUsers < ActiveRecord::Migration
+  def connection
+    User.connection
+  end
+
+  def change
+    create_table :users do |t|
+      t.string :name
+
+      t.timestamps null: false
+    end
+  end
+end
+```
+
+## Contributing
+
+1. Fork it ( http://github.com/hirocaster/activerecord-slave/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/activerecord-slave.gemspec

@@ -0,0 +1,40 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "active_record/slave/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "activerecord-slave"
+  spec.version       = ActiveRecord::Slave::VERSION
+  spec.authors       = ["hirocaster"]
+  spec.email         = ["hohtsuka@gmail.com"]
+  spec.summary       = "MySQL Replicaition(master/slave) for ActiveRecord"
+  spec.description   = "MySQL Replicaition(master/slave) for ActiveRecord"
+  spec.homepage      = "https://github.com/hirocaster/activerecord-slave"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = ">= 2.0"
+
+  spec.add_dependency "activerecord", ">= 4.1.0"
+  spec.add_dependency "pickup"
+
+  spec.add_development_dependency "awesome_print"
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "codeclimate-test-reporter"
+
+  spec.add_development_dependency "coveralls"
+  spec.add_development_dependency "database_rewinder"
+  spec.add_development_dependency "guard-rspec"
+  spec.add_development_dependency "mysql2", "~> 0.3.18"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "pry-byebug"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "rspec-retry"
+  spec.add_development_dependency "simplecov"
+end

data/lib/active_record/slave/config.rb

@@ -0,0 +1,20 @@
+module ActiveRecord
+  module Slave
+    class Config
+      def initialize
+        @replication_configs = {}
+      end
+
+      def define_replication(replication_name, &block)
+        replication_config = ReplicationConfig.new(replication_name)
+        replication_config.instance_eval(&block)
+        replication_config.validate_config!
+        @replication_configs[replication_name] = replication_config
+      end
+
+      def fetch_replication_config(replication_name)
+        @replication_configs.fetch replication_name
+      end
+    end
+  end
+end

data/lib/active_record/slave/database_tasks.rb

@@ -0,0 +1,30 @@
+module ActiveRecord
+  module Slave
+    module DatabaseTasks
+      extend self
+
+      def create_database(args)
+        configuration = database_configuration args
+        ActiveRecord::Tasks::DatabaseTasks.create configuration
+      end
+
+      def drop_database(args)
+        configuration = database_configuration args
+        ActiveRecord::Tasks::DatabaseTasks.drop configuration
+      end
+
+      def database_configuration(args)
+        replication_name = args[:replicaition]
+        replication_config = fetch_replication_config replication_name.to_sym
+        connection_name = replication_config.master_connection_name
+        ActiveRecord::Base.configurations[connection_name.to_s]
+      end
+
+      def fetch_replication_config(replication_name)
+        ActiveRecord::Slave.config.fetch_replication_config replication_name
+      rescue KeyError
+        raise "Not exist #{replication_name} replicaition."
+      end
+    end
+  end
+end