mongoid-sleeping_king_studios 0.7.4 → 0.7.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2cecfeaed22c4e05ac78539fe9bb2682e4fbc3b7
-  data.tar.gz: 8534f60f040e4b8c21725e15e20d1109bf141cfe
+  metadata.gz: 29178b4032ba47697556efe5804600c73450fb69
+  data.tar.gz: 1df094986f9fba1e988117c46df89ae85b44134c
 SHA512:
-  metadata.gz: 4c69faf4df40ad27f95e41a94e8ebc4a9da64ed9713002855a88335f8d835f83335e57eb335bd8889e199e17d951e64c84f31a6f6822c1c5886a51ab35b8ed7b
-  data.tar.gz: 453227de6bf3d50c1db4b0cf0fae1656baa646702024ed52af811526a89b258c50e5a9b55a14a165a9127009db52650570eda7018cff8edbe4abc20c37372145
+  metadata.gz: c492123648a5e294f516a5b06494ae133166ae1c8c565453dc427ab066479e88ab0c1ae1dfe30a234a294149cc64526eab701c61112c7314e8db83f84accad7a
+  data.tar.gz: 163787e59bc295cac492c8da46e21563c2f98cc441729c91f045149caa71d7cf814865740d92ff6e5fe970a4129b3c7e2aefcb5b6ca7d2aafc7fe8bbd289244d

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.7.5
+
+## New Features
+
+* Add #first and #last helpers to Orderable concern.
+
 ## 0.7.4
 
 * Remove bson_ext dependency.

data/README.md

@@ -108,6 +108,14 @@ via the :as option (see below). For example, providing :as =>
 :alphabetical_order will generate helpers \#next_alphabetical, 
 \#prev_alphabetical, and ::reorder_alphabetical!.
 
+##### \#first_ordering_name
+
+Finds the first document, based on the stored ordering values.
+
+##### \#last_ordering_name
+
+Finds the last document, based on the stored ordering values.
+
 ##### \#next_ordering_name
 
 Finds the next document, based on the stored ordering values.

data/lib/mongoid/sleeping_king_studios/orderable.rb

@@ -107,20 +107,26 @@ module Mongoid::SleepingKingStudios
     # @param [Metadata] metadata The metadata for the relation.
     def self.define_helpers base, metadata
       base_name = metadata.field_name.to_s.gsub(/_order\z/,'')
+      filtered  = metadata.filter_criteria(base)
+
+      base.send :define_method, :"first_#{base_name}" do
+        filtered.order_by(metadata.field_name.asc).limit(1).first
+      end # method
+
+      base.send :define_method, :"last_#{base_name}" do
+        filtered.order_by(metadata.field_name.desc).limit(1).first
+      end # method
       
-      name = :"next_#{base_name}"
-      base.send :define_method, name do
-        base.order_by(metadata.field_name.asc).where(metadata.field_name.gt => send(metadata.field_name)).limit(1).first
+      base.send :define_method, :"next_#{base_name}" do
+        filtered.order_by(metadata.field_name.asc).where(metadata.field_name.gt => send(metadata.field_name)).limit(1).first
       end # method
 
-      name = :"prev_#{base_name}"
-      base.send :define_method, name do
-        base.order_by(metadata.field_name.desc).where(metadata.field_name.lt => send(metadata.field_name)).limit(1).first
+      base.send :define_method, :"prev_#{base_name}" do
+        filtered.order_by(metadata.field_name.desc).where(metadata.field_name.lt => send(metadata.field_name)).limit(1).first
       end # method
 
-      name = :"reorder_#{base_name}!"
       meta = class << base; self; end
-      meta.send :define_method, name do
+      meta.send :define_method, :"reorder_#{base_name}!" do
         base.update_all(metadata.field_name => nil)
         
         criteria = metadata.sort_criteria(base)
@@ -181,6 +187,26 @@ module Mongoid::SleepingKingStudios
       #   result in a class method ::reorder_alphabetical!.
     end # module
 
+    # @!method first_ordering_name
+    #   Finds the first document, based on the stored ordering values.
+    # 
+    #   The generated name of this method will depend on the sort params or the
+    #   :as option provided. For example, :as => :alphabetical_order will
+    #   result in an instance method #first_alphabetical.
+    # 
+    #   @return [Mongoid::Document, nil] The first document in the order, or
+    #     nil if there are no documents in the collection.
+
+    # @!method last_ordering_name
+    #   Finds the last document, based on the stored ordering values.
+    # 
+    #   The generated name of this method will depend on the sort params or the
+    #   :as option provided. For example, :as => :alphabetical_order will
+    #   result in an instance method #last_alphabetical.
+    # 
+    #   @return [Mongoid::Document, nil] The last document in the order, or nil
+    #     if there are no documents in the collection.
+
     # @!method next_ordering_name
     #   Finds the next document, based on the stored ordering values.
     # 

data/lib/mongoid/sleeping_king_studios/version.rb

@@ -3,6 +3,6 @@
 module Mongoid
   module SleepingKingStudios
     # The current version of the gem.
-    VERSION = '0.7.4'
+    VERSION = '0.7.5'
   end # module
 end # module

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mongoid-sleeping_king_studios
 version: !ruby/object:Gem::Version
-  version: 0.7.4
+  version: 0.7.5
 platform: ruby
 authors:
 - Rob "Merlin" Smith
@@ -177,3 +177,4 @@ signing_key:
 specification_version: 4
 summary: A collection of Mongoid concerns and extensions.
 test_files: []
+has_rdoc: