random_order 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 44c17e681b84961986ec40faa61117db2eebe889be510822c905bbed642cffa1
-  data.tar.gz: 6c180250b563a70cff7aaca0aca869cc845e06a67a9e8f99217b8c18cec99d06
+  metadata.gz: 10e667214867ab310d3fc617f281ab0ee66fda471f88ef29a3852ddb0df82fb2
+  data.tar.gz: fac5acfe2fc876b7ea100be7a5aedbd1d39fc09074cbe35d518b741959571912
 SHA512:
-  metadata.gz: 4284befb9765296e151379f4ab765bcfbae71168e2625f2367af371d862f3673c829dbbe33cfb0bd11f94816a4e86afc9ffca468326c7f958efbc2bcf22be672
-  data.tar.gz: a40069226504d3f50a353d146735a6fe00c1e71e49d683146fca0538463e5ed713a9f7e5e3fc0e8bc8aa5e220719a411c0adff87fcb7a35627cd9b6ffad72f22
+  metadata.gz: 86c24d152df40b67170ddec0626dc90e467178edd7155efc47ce885ff05e8a228ad669fc6780af7f58e5007259b47b0a52b8a177947d8dc073a7cbf57422f1b6
+  data.tar.gz: e7d7d1d94617c711d0994da133353e2fed7095fcaa0b788ec5430f4cde63f409de8100ab1252a6da39635068ff8ebbcc3b3e1bb231d4c2f374c91e67171fc2f3

data/README.md

@@ -4,7 +4,7 @@ With this gem, you can return a random record from the database using SQL or use
 ## Usage
 Works with `MySQL`, `SQLite`, `PostgreSQL`.
 
-This gem is adding three methods to ActiveRecord Relations - `random` , `find_random` and `find_many_random(...)`, `fast_random(n = 1)`.
+This gem is adding three methods to ActiveRecord Relations - `random` and `fast_random(n = 1)`.
 
 You can do the following:
 ```ruby
@@ -13,40 +13,58 @@ u2 = User.create(name: 'Metamorph')
 u3 = User.create(name: 'Diablo')
 
 assert_equal User.random.is_a?(ActiveRecord::Relation), true
-assert_equal User.find_many_random(10).is_a?(ActiveRecord::Relation), true
 assert_equal User.fast_random.is_a?(ActiveRecord::Relation), true
-assert_equal User.find_random.is_a?(User), true
 ```
 ## Fast Random method
 As you may know `order by RANDOM()` might be slow in case you have many records in DB. I think the case I suggest to use another method which is bundled with this gem fast_random which is using another SQL to return random records from DB. It has some limitations like your table must have a primary key column.
-Simple benchmark on the table with `88000 records` shows that it's `20` times faster. See screenshot with logs below:
+Simple benchmark on the table with `113000 records` shows that it's faster. See screenshot with logs below:
 
 ```ruby
-n = 10
+n = 1000
+
 Benchmark.bm do |benchmark|
-  benchmark.report("find_many_random(100)") do
-    n.times do
-      Business.find_many_random(100).to_a
+  benchmark.report("random.limit(10)") do
+    n.times do |nn|
+      Events.random.limit(10).to_a
     end
   end
-  benchmark.report("fast_random(100)") do
-    n.times do
-      Business.fast_random(100).to_a
+
+  benchmark.report("fast_random(10)") do
+    n.times do |nn|
+      Events.fast_random(10).to_a
     end
   end
 end
+                    user     system      total        real
+random.limit(10)  2.612499   0.193492   2.805991 (1162.501909)
+fast_random(10)   2.234706   0.140195   2.374901 ( 37.173482)
+
+# Find one random record
+Benchmark.bm do |benchmark|
+  benchmark.report("random.first.id") do
+    n.times do |nn|
+      Events.random.first.id
+    end
+  end
+
+  benchmark.report("fast_random.first.id") do
+    n.times do |nn|
+      Events.fast_random.first.id
+    end
+  end
+end
+#
+                        user     system      total        real
+random.first.id       2.014658   0.134942   2.149600 (1151.981899)
+fast_random.first.id  1.661777   0.067484   1.729261 ( 35.350424)
 #
-                         user     system      total        real
-find_many_random(100)  0.088990   0.025837   0.114827 ( 13.836576)
-fast_random(100)       0.060209   0.013933   0.074142 (  0.699557)
 ```
 
 #### Examples:
 ```ruby
 User.friends.random # return ActiveRecord::Relation with user`s random friends
-User.find_random.friends.random # return ActiveRecord::Relation with random user`s random friends
+User.random.first.friends.random # return ActiveRecord::Relation with random user`s random friends
 Post.published.random.limit(3) # return ActiveRecord::Relation with 3 published posts
-Post.published.find_many_random(3) # --//--
 Post.published.fast_random(3) # --//-- and faster
 ```
 

data/lib/random_order/random_order/extension.rb

@@ -1,13 +1,5 @@
 module RandomOrder
   module Extension
-    def find_many_random(n)
-      random.limit(n)
-    end
-
-    def find_random
-      random.first
-    end
-
     def random
       self.order(RandomOrder.order_func)
     end

data/lib/random_order/version.rb

@@ -1,3 +1,3 @@
 module RandomOrder
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: random_order
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Vitalii Kasianchuk
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-02-21 00:00:00.000000000 Z
+date: 2020-02-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails