partial-date 0.1.0 → 1.0.0

data/ChangeLog.textile

@@ -1,3 +1,9 @@
+h3. 1.0.0 / 2012-05-27
+
+* Refactored to use array backing store for element and computed date
+values for better performance.
+* Implemented Comparable
+
 h3. 0.1.0 / 2012-05-26
 
 * Initial release:

data/README.textile

@@ -16,7 +16,7 @@ h2. Examples
 
 bc.. require 'partial-date' 
 
-#Default initializer 
+# Default initializer 
 date = PartialDate::Date.new
 # => 
 date.value
@@ -50,7 +50,9 @@ h2. Install
 
 h2. TODO
 
-Implement @PartialDate::Date.parse@ method for construction from strings.
+# @PartialDate::Date.parse@ method for construction from strings.
+# A Hash or Array backing store for date components for better performance.
+# Include Comparable
 
 h2. Copyright
 

data/lib/partial-date/date.rb

@@ -17,6 +17,7 @@ module PartialDate
   #   date = PartialDate::Date.new {|d| d.year = 2012 }
   #
   class Date
+    include Comparable
 
     # Public: Create a new partial date class from a block of integers
     # or strings.
@@ -35,10 +36,10 @@ module PartialDate
     #
     # Returns a date object.
     def initialize
+      @data = [0,0,0,0]
       yield self if block_given?
     end
 
-
     # Public: Get the integer date value in partial date format.
     #
     # Examples
@@ -49,7 +50,7 @@ module PartialDate
     #
     # Returns an integer representation of a partial date.
     def value
-      @value ||= 0
+      get_value(0)
     end
 
     # Public: Set a date value using an interger in partial date format.
@@ -61,13 +62,14 @@ module PartialDate
     # Returns nothing  
     def value=(value)
       if value.is_a?(Integer) && (value >= 10000 && value <= 99991231)
-        @value = value
+        set_value(0, value)
       else
         raise PartialDateError, "Date value must be an integer betwen 10000 and 99991231"
       end
     end
 
-    # Public: Loads an 8 digit date value into a date object.
+    # Public: Loads an 8 digit date value into a date object. Can be used 
+    # when rehydrating a date object from a persisted partial date value.
     #
     # value - an 8 digit value in partial date format.
     #
@@ -114,7 +116,7 @@ module PartialDate
       end
 
       if value.is_a?(Integer) && (value <= 9999 && value > 0) 
-        @value = (self.value - self.year) * 10000 + (value * 10000) 
+        set_value(1, value)
       else
         raise PartialDateError, "Year must be an integer between 1 and 9999"
       end
@@ -122,7 +124,7 @@ module PartialDate
 
     # Public: Get the year from a partial date.
     def year
-      self.value > 9999 ? (self.value / 10000).abs : 0
+      get_value(1)
     end
 
     # Public: Set the month of a partial date.
@@ -141,7 +143,7 @@ module PartialDate
       end
 
       if value.is_a?(Integer) && (value <= 12 && value >= 0)
-        @value  = self.value - (self.month * 100) + (value * 100)
+        set_value(2, value)
       else
         raise PartialDateError, "Month must an be integer between 1 and 12"
       end
@@ -149,7 +151,7 @@ module PartialDate
 
     # Public: Get the month from a partial date.
     def month
-      self.value > 99 ? ((self.value - (self.value / 10000).abs * 10000) / 100).abs : 0
+      get_value(2)
     end
 
 
@@ -172,7 +174,8 @@ module PartialDate
       if value.is_a?(Integer) && (value >= 0 && value <= 31)
         begin
           date = ::Date.civil(self.year, self.month, value) if value > 0
-          @value  = (self.value - self.day + value)
+          #@value  = (self.value - self.day + value)
+          set_value(3, value)
         rescue 
           raise PartialDateError, "Day must be a valid day for the given month"
         end
@@ -183,7 +186,8 @@ module PartialDate
 
     # Public: Get the day from a partial date.
     def day
-      self.value > 0 ? self.value - (self.value / 100).abs * 100 : 0
+      #self.value > 0 ? self.value - (self.value / 100).abs * 100 : 0
+      get_value(3)
     end
 
     # Public: Returns a formatted string representation of the partial date.
@@ -205,5 +209,46 @@ module PartialDate
         return ""
       end
     end
+
+    # Public: Spaceship operator for date comparisons.
+    #
+    # Returns -1, 1, or 0
+    def <=>(other_date)
+      self.value <=> other_date.value
+    end
+
+
+    private
+
+    # Internal: Retreive a value from the array backing store.
+    #
+    # Returns an integer value for partial date, year, month or day.
+    def get_value(element)
+      @data[element]
+    end
+
+    # Internal: Set a value in the array backing store - either the
+    # complete date value (from load or value accessors), or a year, 
+    # month, or day value after which the partial date will be recomputed.
+    #
+    # Returns nothing
+    def set_value(element, value)
+      case element
+      when 0
+        @data[1] = (value / 10000).abs 
+        @data[2] = ((value - (value / 10000).abs * 10000) / 100).abs
+        @data[3] = value - (value / 100).abs * 100 
+      when 1
+        @data[0] = @data[0] - (self.year * 10000) + (value * 10000)
+      when 2
+        @data[0] = @data[0] - (self.month * 100) + (value * 100)
+      when 3
+        @data[0] = @data[0] - self.day + value
+      end 
+
+      # Important - update the old element value _after_ @data[0] 
+      # has been recalculated above.
+      @data[element] = value
+    end
   end
 end

data/lib/partial-date/version.rb

@@ -1,4 +1,4 @@
 module PartialDate
   # partial-date version
-    VERSION = "0.1.0"
+    VERSION = "1.0.0"
 end

data/spec/{partial-date_spec.rb → date_spec.rb}

@@ -43,17 +43,17 @@ describe PartialDate::Date do
     expect {new_date = PartialDate::Date.new {|d| d.value = 100000000}}.to raise_error(PartialDate::PartialDateError, "Date value must be an integer betwen 10000 and 99991231")
   end
 
-  it "should return a string represntation of date in the correct format" do
+  it "should return a string representation of date in the correct format" do
     new_date = PartialDate::Date.new {|d| d.year = 2012; d.month = 12; d.day = 31}
     new_date.to_s.should match(/\A\d{4}-\d{2}-\d{2}\z/)
   end
 
-  it "should return a string represntation of a partial date in the correct format" do
+  it "should return a string representation of a partial date in the correct format" do
     new_date = PartialDate::Date.new {|d| d.year = 2012; d.month = 12}
     new_date.to_s.should match(/\A\d{4}-\d{2}\z/)
   end
 
-  it "should return a string represntation of a partial date in the correct format" do
+  it "should return a string representation of a partial date in the correct format" do
     new_date = PartialDate::Date.new {|d| d.year = 2012}
     new_date.to_s.should match(/\A\d{4}\z/)
   end
@@ -164,4 +164,25 @@ describe PartialDate::Date do
       date.day.should == 10
     end
   end
+
+  describe "Comparisons" do
+    it "should determine if one date is greater than another" do
+        a = PartialDate::Date.new {|d| d.year = 2012; d.month = 12; d.day = 31}
+        b = PartialDate::Date.new {|d| d.year = 2012; d.month = 12; d.day = 30}
+        a.should be > b
+    end
+
+    it "should determine if one date is less than another" do
+        a = PartialDate::Date.new {|d| d.year = 2012; d.month = 0; d.day = 0}
+        b = PartialDate::Date.new {|d| d.year = 2012; d.month = 12; d.day = 30}
+        a.should be < b
+    end
+
+    it "should determine if one date is equal to another" do
+        a = PartialDate::Date.new {|d| d.year = 2012; d.month = 12; d.day = 30}
+        b = PartialDate::Date.new {|d| d.year = 2012; d.month = 12; d.day = 30}
+        a.should be == b
+    end
+  end
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: partial-date
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-05-26 00:00:00.000000000 Z
+date: 2012-05-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rubygems-tasks
@@ -82,7 +82,7 @@ files:
 - lib/partial-date/error.rb
 - lib/partial-date/version.rb
 - partial-date.gemspec
-- spec/partial-date_spec.rb
+- spec/date_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/58bits/partial-date#readme
 licenses:
@@ -111,5 +111,5 @@ specification_version: 3
 summary: A simple date class that can be used to store partial date values in a single
   column/attribute.
 test_files:
-- spec/partial-date_spec.rb
+- spec/date_spec.rb
 - spec/spec_helper.rb