tako 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9861d9ec9b928c4ed0bbe68ada132a9335fd6077
-  data.tar.gz: 78351b4438784d0b40bf5a4e3b826ef5c60624eb
+  metadata.gz: 251999f9587d91e10a4124565e939a832f1a07da
+  data.tar.gz: 4161bbab1056d2c22a2984fd4b4429f73f51f4da
 SHA512:
-  metadata.gz: cbb4e884798a8dbb5d2de722ffcc196c048a82df49ce45b56c9530c878e492489bae0f8e5d3a71f577f765c8c41ff87fb90da93877b7efdc7237075838f66acc
-  data.tar.gz: 29f14c874dbf1d539dfbdfc263121406daee76fd53f3ca44a9c06eeec724cadcea11adfee04fde6aab5b1512d71f53164340adac25a96cc802749fe7efa7fbb9
+  metadata.gz: 80506c988bd63b6b3a437c16998a79bccd22126e6b667e5f2fd917d097f44488ba52f1a615aea3c86f0d811275a00c9bb53e42d5dd807ebf2495f57393243f54
+  data.tar.gz: 5473bc23a5dcfaf1d96bb437c4d3b7796fce09e816b2226a02406a0bed008859b86b48e0df1f14417a5a4a577261ace70daa58874414e556a6c046d297ef8dc8

data/README.md

@@ -1,9 +1,13 @@
 # Tako
 [![CircleCI](https://circleci.com/gh/the40san/tako/tree/master.svg?style=svg)](https://circleci.com/gh/the40san/tako/tree/master)
 
-Provides features for Database Sharding in ActiveRecord.
-The main goal of tako is implementing sharding features with less ActiveRecord-dependent, catching up Rails version up.
-Rails 5 Ready.
+Tako provides Database-Sharding features for ActiveRecord.
+Respecting [Octopus](https://github.com/thiagopradi/octopus)
+
+# Motivation
+The main goal of Tako is　implementing sharding features with less ActiveRecord-dependent; catching up Rails version up.
+And also, Tako supports migration from Octopus because it is no longer maintained.
+
 
 ## Installation
 
@@ -29,7 +33,7 @@ Or install it yourself as:
 
 ## Usage
 ## How to use Tako?
-First, you need to create a config file, shards.yml, inside your config/ directory.
+First, you need to create a config file, `shards.yml`, inside your config/ directory.
 Also you can override config file path with environment variable.
 
 ### Syntax
@@ -37,22 +41,49 @@ Tako adds a method to each AR Class and object: the shard method is used to sele
 
 ```ruby
   User.shard(:slave_one).where(:name => "Thiago").limit(3)
+  # => Query will run in :slave_one
 ```
 
 Tako also supports queries within a block. When you pass a block to the shard method, all queries inside the block will be sent to the specified shard.
 
 ```ruby
+User.create(name: "Bob")
+# => Query will run in default connection in database.yml
+
 Tako.shard(:slave_two) do
-  User.create(:name => "Mike")
+  User.create(name: "Mike")
+  # => Query will run in :slave_two
 end
 
 # or
 
-ModelA.shard(:slave_two) do
-  User.create(:name => "Mike")
+User.shard(:slave_two) do
+  User.create(name: "Mike")
+  # => Query will run in :slave_two
 end
 ```
 
+## Associations
+
+```
+class User < ActiveRecord::Base
+  has_many :logs
+  has_one :life
+end
+
+user = User.shard(:shard01).create(name: "Jerry")
+
+user.logs.create
+# => Query will run in :shard01 (same as user)
+
+user.logs << Log.shard(:shard02).new
+# => Query will run in :shard02 (careful)
+
+life = user.build_life
+life.save!
+# => Query will run in :shard01 (same as user)
+```
+
 ## Vertical Sharding
 
 Add `force_shard` definition to your Vertical-Sharding model
@@ -61,8 +92,20 @@ Add `force_shard` definition to your Vertical-Sharding model
 class YourModel < ActiveRecord::Base
   force_shard :shard01
 end
+
+YourModel.create
+# => Query will run in :shard01
+
+Tako.shard(:shard02) do
+  YourModel.create
+  # => Query will run in :shard01
+end
 ```
 
+## TODO
+
+ * Make more independent　of ActiveRecord implementation.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
@@ -73,14 +116,15 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 Run `bundle exec rake` to run rspec
 
-Run `bundle exec rake` in `spec/dummy5` will run rspec with rails 5
+Run `bundle exec rake` in `spec/dummy5` will run rspec with rails 5.0.0.1
 
-Run `bundle exec rake` in `spec/dummy42` will run rspec with rails 4.2
+Run `bundle exec rake` in `spec/dummy42` will run rspec with rails 4.2.7.1
 
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/the40san/tako. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+Contributors are welcome on GitHub at https://github.com/the40san/tako. Documentation contributors also welcome!
+This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
 
 ## License

data/lib/tako.rb

@@ -23,6 +23,7 @@ module Tako
     end
 
     def load_connections_from_yaml
+      Tako::Repository.clear
       (config[env] || []).each do |shard_name, conf|
         Tako::Repository.add(shard_name, conf)
       end

data/lib/tako/repository.rb

@@ -9,6 +9,15 @@ module Tako
         @proxy_connections ||= {}
       end
 
+      def clear
+        proxy_connections.each do |shard_name, connection|
+          connection.disconnect!
+          remove_const("TAKO_AR_CLASS_#{shard_name.upcase}")
+        end
+        proxy_configs.clear
+        proxy_connections.clear
+      end
+
       def add(shard_name, conf)
         shard_name = shard_name.to_sym
         return if proxy_configs[shard_name]

data/lib/tako/version.rb

@@ -1,3 +1,3 @@
 module Tako
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tako
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Masashi AKISUE
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-10-19 00:00:00.000000000 Z
+date: 2016-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord