passive_record 0.3.18 → 0.3.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 55612b91f34d4ac833ad318343274c028a7d9db3
-  data.tar.gz: ee4c132e59ab5c9c2eef23fa7ad6a643b50e9419
+  metadata.gz: 308e4dbc28c56bee86bcd17bfac0e2d88e6e4134
+  data.tar.gz: 26a64acb50009c2ccc9aced0c5aefef4b46560e4
 SHA512:
-  metadata.gz: aad41fefd6877ee5d43bbba3f42efd03c89e86e2600aca84f83a69a66a1186f974beb731c8a2ae2e9aa4de7b5b1958b10df557d95bf00c6b0303cda4bfa664ad
-  data.tar.gz: e331d278b6dcc08bfdb31312018dc8aa727dc7af6d7dd0a49e7f1205e672c6589fdd7d24672dde8d2bae09c4dee07d60158c5385c9d4a90ce6daf2f512c2952d
+  metadata.gz: 06b0384b55def7cab63cd01a7f6b7e142719251885f9c263e845a2ae0bdc503f7300d887fa1149298170aa29477f27fca46de09892c5f32db54146ba440283be
+  data.tar.gz: 6428e64b00eefb4043e8d21925c7ca39b75e83bd2ab58f86c461f87641f7b852e471ef81e548d93bf746a5d941dcf8f99abf703cc754a0ea7fec39fd62255c6b

data/README.md

@@ -162,15 +162,23 @@ PassiveRecord may be right for you!
 
 ### Queries
 
-  `Core::Query` objects acquired through `where` are chainable, accept nested queries and scopes, and have the following public methods:
-
-  - `where(conditions).all`
-  - `where(conditions).each` enumerates over `where(conditions).all`, so we have `where(conditions).count`, `where(conditions).first`, etc.
-  - `where(conditions).create(attrs)`
-  - `where(conditions).first_or_create(attrs)`
-  - `where(conditions).where(further_conditions)` (chaining)
-  - `where.not(conditions)` (negation)
-  - `where.scope` (scoping with model class methods that return a query)
+  You can acquire `Core::Query` objects through the class method `where`. These are chainable, accept nested conditions that traverse relationships, and understand scopes defined as class methods. The query object will have the following public methods:
+
+  - `Post.where(conditions).all`
+  - `Post.where(conditions).each` enumerates over `where(conditions).all`, so we have `where(conditions).count`, `where(conditions).first`, etc.
+  - `Post.where(conditions).create(attrs)`
+  - `Post.where(conditions).first_or_create(attrs)`
+  - `Post.where(conditions).where(further_conditions)` (chaining)
+  - `Post.where.not(conditions)` (negation)
+  - `Post.where(conditions).or(Post.where(conditions))` (disjunction)
+  - `Post.active.recent` (scoping with class methods that return queries; supports chaining)
+
+  `conditions` here is expected to be a hash of attribute values. Note that there is special behavior for certain kinds of values.
+
+  - Ranges select models with an attribute covered by the range (behaving like `BETWEEN`)
+  - Arrays select models with an attribute whose value is in the array (behaving like `IN`)
+  - Hash values (subhashes) select models with related models who attributes match the inner hash. So `Doctor.where(appointments: { patient: patient })` finds doctors whose appointments include an appointment with `patient`.
+ 
 
 ## Hooks
 

data/lib/passive_record/associations/has_many.rb

@@ -40,6 +40,24 @@ module PassiveRecord
         all
       end
 
+      def pluck(attr)
+        all.map(&attr)
+      end
+
+      def sum(attr)
+        pluck(attr).inject(&:+)
+      end
+
+      def average(attr)
+        sum(attr) / count
+      end
+
+      def mode(attr)
+        arr = pluck(attr)
+        freq = arr.inject(Hash.new(0)) { |h,v| h[v] += 1; h }
+        arr.max_by { |v| freq[v] }
+      end
+
       def singular?
         false
       end

data/lib/passive_record/version.rb

@@ -1,4 +1,4 @@
 module PassiveRecord
   # passive_record version
-  VERSION = "0.3.18"
+  VERSION = "0.3.19"
 end

data/spec/passive_record_spec.rb

@@ -340,6 +340,16 @@ describe "passive record models" do
         expect(parent.children.all).to eq([child, another_child])
         expect(parent.child_ids).to eq([child.id, another_child.id])
       end
+
+      it 'should provide arithmetic helpers' do
+        parent.create_child(age: 10)
+        parent.create_child(age: 10)
+        parent.create_child(age: 40)
+        expect(parent.children.pluck(:age)).to eq([10,10,40])
+        expect(parent.children.sum(:age)).to eq(60)
+        expect(parent.children.average(:age)).to eq(20)
+        expect(parent.children.mode(:age)).to eq(10)
+      end
     end
 
     context 'one-to-many through relationships' do

data/spec/spec_helper.rb

@@ -47,6 +47,7 @@ module Family
 
     attr_reader :name
     after_create :give_name
+    attr_accessor :age
 
     def give_name; @name = "Alice" end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: passive_record
 version: !ruby/object:Gem::Version
-  version: 0.3.18
+  version: 0.3.19
 platform: ruby
 authors:
 - Joseph Weissman