fresh_connection 0.2.5 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3e470a4665ec85ef6b012e95e365c5038d996aa6
-  data.tar.gz: a764c721578fbdc080d2351333dbd34716be123a
+  metadata.gz: da070ea6bf04531b1dad24fd2a6b1f267cbe4455
+  data.tar.gz: 20eb3122e428d4ab78ef6987a11bdba2f885c7eb
 SHA512:
-  metadata.gz: 98a9036418869064befea2b8d7f9e539a30bc11a74ab3b3039057f9a00224339855612de0586bdd7cb1aeef451c09fa65ecb51c6378182a6b43151d3788aed9f
-  data.tar.gz: 4456c9b0d2798facd1b8b3c83a55f7d61b52c8708ce899266ac4307b1034290474639dde84909099be02c42d253fce5bbfcf07f2182115f5d51aa13e4ddb67a3
+  metadata.gz: 71365d6a0818a691c86f02e47221c3edce8ea9344542984a72c57f276f4415f8e958cf10971a6c63bbceaf3772605308bd6a37fbda497a4c0a6c9a19569a2966
+  data.tar.gz: 1c1a11a33929b6e0906c3b73ec131954617376c8d04fed23ed8673a0850979071e00afb6f9f203246f57a24f5eef7137f976bb789b63653c6f7dba6f3ecc1a1a

data/.travis.yml

@@ -0,0 +1,19 @@
+language: ruby
+before_script:
+  - mysql -e 'create database fresh_connection_test;'
+  - mysql -e 'create database fresh_connection_test_master;'
+  - mysql -e 'create database fresh_connection_test_slave;'
+  - "bundle exec ruby spec/prepare.rb"
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1
+  - 2.2
+  - ruby-head
+gemfile:
+  - gemfiles/rails3.gemfile
+  - gemfiles/rails40.gemfile
+  - gemfiles/rails41.gemfile
+notifications:
+  emails:
+    - tsukasa.oishi@gmail.com

data/README.md

@@ -1,8 +1,60 @@
 # FreshConnection
 
-FreshConnection supports to connect with Mysql slave servers via Load Balancers.
-All connections will be disconnected every time at the end of the Rails controller's action.
-FreshConnection does not support Rails 2.x.
+FreshConnection allows access to Mysql slave servers in Rails.
+
+[![Gem Version](https://badge.fury.io/rb/fresh_connection.svg)](http://badge.fury.io/rb/fresh_connection) [![Build Status](https://travis-ci.org/tsukasaoishi/fresh_connection.svg?branch=master)](https://travis-ci.org/tsukasaoishi/fresh_connection) [![Code Climate](https://codeclimate.com/github/tsukasaoishi/fresh_connection/badges/gpa.svg)](https://codeclimate.com/github/tsukasaoishi/fresh_connection)
+
+ActiveRecord can only access a single server by default.  
+FreshConnection can access to replicated Mysql slave servers via a loadbalancer.
+
+For example.
+```
+Rails ------------ Mysql(Master)
+             |
+             |                     +------ Mysql(Slave1)
+             |                     |
+             +---- Loadbalancer ---+
+                                   |
+                                   +------ Mysql(Slave2)
+```
+
+When Rails controller's action begins, FreshConnction connects with one of slave servers behind the loadbalacer.  
+Read query goes to the slave server via the loadbalancer.  
+Write query goes to the master server. Inside transaction, all queries go to the master server.  
+All Mysql connections is disconnected at the end of the Rails controller's action.
+
+
+## Usage
+
+Read query goes to the slave server.
+
+```ruby
+Article.where(:id => 1)
+```
+
+If you want to access to the master saver, use readonly(false).
+
+```ruby
+Article.where(:id => 1).readonly(false)
+```
+
+In transaction, All queries go to the master server.
+
+```ruby
+Article.transaction do
+  Article.where(:id => 1)
+end
+```
+
+Create, Update. Delete queries go to the master server.
+
+```ruby
+article = Article.create(...)
+article.title = "FreshConnection"
+article.save
+article.destory
+```
+
 
 ## Installation
 
@@ -92,11 +144,11 @@ AdminUser and Benefit access to ```admin_slave``` slave group.
       master_db_only!
     end
 
-If a model that always access to the master server is exist, You write ```master_db_only!```  in the model.
+If a model that always access to the master server is exist, You write ```master_db_only!```  in the model.  
 The model that master_db_only model's child is always access to master db.
 
 ### Slave Connection Manager
-Default slave connection manager is FreshConnection::ConnectionManager.
+Default slave connection manager is FreshConnection::ConnectionManager.  
 If you would like to change slave connection manager, assign yourself slave connection manager.
 
 #### config/application.rb
@@ -126,22 +178,6 @@ Yourself Slave Connection Manager should be inherited FreshConnection::AbstractC
       end
     end
 
-## Usage
-Read query will be access to slave server.
-
-    Article.where(:id => 1)
-
-If you want to access to master saver, use readonly(false).
-
-    Article.where(:id => 1).readonly(false)
-
-In transaction, Always will be access to master server.
-
-    Article.transaction do
-      Article.where(:id => 1)
-    end
-
-
 
 ## Contributing
 
@@ -153,8 +189,8 @@ In transaction, Always will be access to master server.
 
 ## Test
 
-I'm glad that you would do test!
-To run the test suite, you need mysql installed.
+I'm glad that you would do test!  
+To run the test suite, you need mysql installed.  
 How to setup your test environment.
 
 First of all, you setting the config of the test mysql server in ```spec/database.yml```

data/lib/fresh_connection/extend/ar_relation.rb

@@ -48,6 +48,8 @@ module FreshConnection
             klass.connection.select_all(select(column_name).arel, nil)
           end
 
+          return result if result.nil? || result.empty?
+
           last_columns = result.last.keys.last
 
           result.map do |attributes|

data/lib/fresh_connection/version.rb

@@ -1,4 +1,4 @@
 module FreshConnection
-  VERSION = "0.2.5"
+  VERSION = "0.2.6"
 end
 

data/spec/prepare.rb

@@ -1,4 +1,10 @@
 require 'yaml'
+require 'active_record'
+require 'fresh_connection'
+
+unless ActiveRecord::Base.respond_to?('establish_fresh_connection')
+  FreshConnection::Initializer.extend_active_record
+end
 
 system("mysql -uroot < spec/db_schema.sql")
 

data/spec/unit/fresh_connection_spec.rb

@@ -42,6 +42,10 @@ describe FreshConnection do
     it "pluck is access to slave1" do
       expect(User.pluck(:name).first).to be_include("slave")
     end
+
+    it "pluck returns empty array when result of condition is empty" do
+      expect(User.limit(0).pluck(:name)).to be_empty
+    end
   end
 
   context "access to master" do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fresh_connection
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.2.6
 platform: ruby
 authors:
 - Tsukasa OISHI
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-29 00:00:00.000000000 Z
+date: 2014-09-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -128,6 +128,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".travis.yml"
 - Appraisals
 - Gemfile
 - LICENSE.txt
@@ -181,7 +182,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.1
 signing_key: 
 specification_version: 4
 summary: FreshConnection supports to connect with Mysql slave servers via Load Balancers.