README.md in mongoid-eager-loading-0.2.0 vs README.md in mongoid-eager-loading-0.3.0

- old
+ new

@@ -3,11 +3,11 @@ mongoid-eager-loading adds the eager loading feature for mongoid. Originally it is my [pull request][0] for mongoid, but it is not accepted yet, so I created this gem to get the eager loading benefits easily for my projects. -I only test it in mongoid-2.0.0.beta.19, maybe you can try it on other mongoid version, and let me know if it works fine. +I only test it in mongoid 2.0.0.beta.19 and 2.0.0.beta.20, maybe you can try it on other mongoid version, and let me know if it works fine. Usage ----- define it in your Gemfile @@ -16,34 +16,36 @@ suppose you have a mongoid model Post class Post include Mongoid::Document - + referenced_in :user references_many :comments end then you can use the eager loading like Post.includes(:user) Post.includes(:user, :comments) - + eager loading can be only used on referenced_in, references_one and references_many associations. - + Benchmark --------- I also run a [benchmark][1] on my local computer, the result is as follows Starting benchmark... user system total real - Finding 10 posts with person, without eager loading 0.010000 0.000000 0.010000 ( 0.006538) - Finding 10 posts with person, with eager loading 0.000000 0.000000 0.000000 ( 0.005235) - Finding 50 posts with person, without eager loading 0.020000 0.000000 0.020000 ( 0.027912) - Finding 50 posts with person, with eager loading 0.020000 0.000000 0.020000 ( 0.020103) - Finding 100 posts with person, without eager loading 0.040000 0.000000 0.040000 ( 0.055197) - Finding 100 posts with person, with eager loading 0.030000 0.010000 0.040000 ( 0.040644) + Finding 10 posts with person, without eager loading 0.000000 0.000000 0.000000 ( 0.005373) + Finding 10 posts with person, with eager loading 0.010000 0.000000 0.010000 ( 0.002984) + Finding 50 posts with person, without eager loading 0.010000 0.000000 0.010000 ( 0.022207) + Finding 50 posts with person, with eager loading 0.010000 0.000000 0.010000 ( 0.006831) + Finding 100 posts with person, without eager loading 0.040000 0.000000 0.040000 ( 0.050991) + Finding 100 posts with person, with eager loading 0.010000 0.000000 0.010000 ( 0.012867) + Finding 1000 posts with person, without eager loading 0.390000 0.050000 0.440000 ( 0.477983) + Finding 1000 posts with person, with eager loading 0.120000 0.010000 0.130000 ( 0.128879) Author ------ Richard Huang :: flyerhzm@gmail.com :: @flyerhzm