second_level_cache 2.0.0.rc1 → 2.0.0

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+2.0.0.rc1
+-----
+* ActiveRecord 4 ready!
+* read multi support for preloading. `Article.includes(:user).limit(5).to_a` will fetch all articles' users from cache preferentially.
+* remove dependency warning
+* remove support for find_by_xx which will be removed in Rails 4.1
+
 1.6.2
 -----
 * [can disable/enable fetch_by_uinq_key method]

data/README.md

@@ -17,7 +17,13 @@ Write-Through: As objects are created, updated, and deleted, all of the caches a
 In your gem file:
 
 ```ruby
-gem "second_level_cache", "~> 2.0.0"
+gem "second_level_cache", "~> 2.0.0.rc1"
+```
+
+For ActiveRecord 3:
+
+```ruby
+gem "second_level_cache", "~> 1.6"
 ```
 
 ## Usage
@@ -34,8 +40,6 @@ Then it will fetch cached object in this situations:
 
 ```ruby
 User.find(1)
-User.where(:status => 1).find_by_id(1)
-user.articles.find_by_id(1)
 user.articles.find(1)
 User.where(:status => 1).find(1)
 article.user
@@ -130,6 +134,14 @@ user = User.fetch_by_uniq_key("hooopo", :nick_name)
 user = User.fetch_by_uniq_key!("hooopo", :nick_name) # this will raise `ActiveRecord::RecordNotFound` Exception when nick name not exists.
 ```
 
+* You can use Rails's [Eager Loading](http://guides.rubyonrails.org/active_record_querying.html#eager-loading-associations) feature as normal. Even better, second_level_cache will transform the `IN` query into a Rails.cache.multi_read operation. For example:
+
+```ruby
+Answer.includes(:question).limit(10).order("id DESC").each{|answer| answer.question.title}
+Answer Load (0.2ms)  SELECT `answers`.* FROM `answers` ORDER BY id DESC LIMIT 10 # Only one SQL query and one Rails.cache.read_multi fetching operation.
+```
+[Details for read_multi feature](http://hooopo.writings.io/articles/a9cae5e0).
+
 ## Contributors
 
 * [chloerei](https://github.com/chloerei)

data/lib/second_level_cache/version.rb

@@ -1,4 +1,4 @@
 # -*- encoding : utf-8 -*-
 module SecondLevelCache 
-  VERSION = "2.0.0.rc1"
+  VERSION = "2.0.0"
 end

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: second_level_cache
 version: !ruby/object:Gem::Version
-  version: 2.0.0.rc1
-  prerelease: 6
+  version: 2.0.0
+  prerelease: 
 platform: ruby
 authors:
 - Hooopo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-24 00:00:00.000000000 Z
+date: 2013-07-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -151,9 +151,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
-  - - ! '>'
+  - - ! '>='
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.25
@@ -185,3 +185,4 @@ test_files:
 - test/record_marshal_test.rb
 - test/require_test.rb
 - test/test_helper.rb
+has_rdoc: