random_order 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2c88e7bc11ab8afd4a6ada8c58dba72416dcfce0ab4dfaa17cea9949e75c0369
-  data.tar.gz: 527e4a9fc42c9c4822a544d70236582bab52b84e5fa21d1c79cd0a5d541cc0c4
+  metadata.gz: 85869c402378af9d2b328e80a04f2324bf044ffbabbaed80909e52f37ba3957f
+  data.tar.gz: 5d6ee714b7f0311a88f7ed34134b655dec57ece3543e8a9e1c26ce5468ef4917
 SHA512:
-  metadata.gz: 750f1300766024397ae2074be27174cb136b99c7968e3e1b565e1181c2fcc751c5ab1aaeb3d9a7242a8a7bbfe00cf886979dfac3d824190c601ce99df61434db
-  data.tar.gz: 437860646c3266b4248481da5ee873354ae5cd572a8fc9fe8798cb691f697235e482ead70bca41986c4b079af6f7d9ba8c735718ed9d85d7c2fec3bde341088d
+  metadata.gz: 6b02bb4634682f6872a708be802b7f44b1bafa9ce72a876c6a29f57bb5154653608d609519f1045e67d4f8082c7f23619ed66f826ac947f735f1d8f7c66ba536
+  data.tar.gz: 85796b4d178f8ea035773829df8b8a7a7f8e15bd5f632f7ab01b204f479b44d91b630810e5a34d04262dd761d7eca6ee7c317400b5439bef2acf691ce4e875e2

data/README.md

@@ -1,8 +1,29 @@
 # RandomOrder
-Short description and motivation.
+This gem could DRY your code and return random relation objects or instance object.
 
 ## Usage
-How to use my plugin.
+Works with `MySQL`, `SQLite`, `PostgreSQL`
+
+This gem is adding three methods to ActiveRecord Relations - `random` , `find_random` and `find_many_random(...)`.
+
+You can do the following:
+```ruby
+u1 = User.create(name: 'Lilith')
+u2 = User.create(name: 'Metamorph')
+u3 = User.create(name: 'Diablo')
+
+assert_equal User.find_random.is_a?(User), true
+assert_equal User.random.is_a?(ActiveRecord::Relation), true
+assert_equal User.find_many_random(10).is_a?(ActiveRecord::Relation), true
+```
+#### 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
+Post.published.random.limit(3) # return ActiveRecord::Relation with 3 published posts
+Post.published.find_many_random(3) # --//--
+```
+
 
 ## Installation
 Add this line to your application's Gemfile:
@@ -25,4 +46,4 @@ $ gem install random_order
 Contribution directions go here.
 
 ## License
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The gem is available as open-source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/random_order/railtie.rb

@@ -1,28 +1,11 @@
+require_relative "random_order/extension"
+
 module RandomOrder
   class Railtie < ::Rails::Railtie
-    module Extension
-      def find_many_random(n)
-        random.limit(n || 1)
-      end
-
-      def find_random
-        random.limit(1)
-      end
-
-      def random
-        case ActiveRecord::Base.configurations[Rails.env]['adapter']
-        when 'mysql2'
-          self.order(Arel.sql('RAND()'))
-        when 'sqlite3'
-          self.order(Arel.sql('RANDOM()'))
-        when 'postgresql'
-          self.order(Arel.sql('RANDOM()'))
-        end
-      end
-    end
+    include Extension
 
     initializer 'RandomOrder.initialize' do
-      ActiveSupport.on_load(:active_record) do
+      if RandomOrder.const_defined?("ActiveRecord")
         ActiveRecord::Base.send :extend, Extension
       end
     end

data/lib/random_order/random_order/extension.rb

@@ -0,0 +1,22 @@
+module RandomOrder
+  module Extension
+    def find_many_random(n)
+      random.limit(n)
+    end
+
+    def find_random
+      random.first
+    end
+
+    def random
+      case RandomOrder.adapter
+      when 'mysql2'
+        self.order(Arel.sql('RAND()'))
+      when 'postgresql'
+        self.order(Arel.sql('RANDOM()'))
+      when 'sqlite3'
+        self.order(Arel.sql('RANDOM()'))
+      end
+    end
+  end
+end

data/lib/random_order/version.rb

@@ -1,3 +1,3 @@
 module RandomOrder
-  VERSION = '0.1.0'
+  VERSION = '0.1.1'
 end

data/lib/random_order.rb

@@ -1,5 +1,13 @@
 require "random_order/railtie"
 
 module RandomOrder
-  # Your code goes here...
+  def self.adapter
+    @@adapter ||= detect_adapter
+  end
+
+  def self.detect_adapter
+    if self.const_defined?("ActiveRecord")
+      ActiveRecord::Base.configurations[Rails.env]['adapter']
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: random_order
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Vitalii Kasianchuk
@@ -38,6 +38,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: mysql2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: postgres
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Find random record in your models, just to DRY your code.
 email:
 - kasvit93@gmail.com
@@ -50,6 +78,7 @@ files:
 - Rakefile
 - lib/random_order.rb
 - lib/random_order/railtie.rb
+- lib/random_order/random_order/extension.rb
 - lib/random_order/version.rb
 - lib/tasks/random_order_tasks.rake
 homepage: https://github.com/Kasvit/random_order