sugarcube 0.8.5 → 0.8.6

data/README.md

@@ -85,6 +85,74 @@ Examples
 end
 ```
 
+ NSDate
+--------
+
+NSDate does not make it easy to get the sensible attributes of your datetime
+object.  This *does* make sense, if you are truly thinking globally, but I am
+not.  :-P
+
+Adds the following methods to get a date component: `year, month, day, hour, minute, second, yms, hms, datetime`
+
+`ymd`, `hms`, and `datetime` return arrays, so that comparing dates, times, or
+both become simple `date1.ymd == date2.ymd`.  If you need to *compare* dates,
+use the Foundation method `date1.compare(date2)` => `-1 or 0 or 1`.
+
+```
+(main)> now = NSDate.new
+=> 2012-09-13 09:19:06 -0600
+(main)> now.year
+=> 2012
+(main)> now.month
+=> 9
+(main)> now.day
+=> 13
+(main)> now.hour
+=> 9
+(main)> now.minute
+=> 19
+(main)> now.second
+=> 6
+(main)> now.weekday
+=> 5
+(main)> now.ymd
+=> [2012, 9, 13]
+(main)> now.hms
+=> [9, 19, 6]
+(main)> now.datetime
+=> [2012, 9, 13, 9, 19, 6]
+```
+
+And it is easy to add seconds to the date, and don't forget about the
+time-related methods added to `Numeric`!
+
+```ruby
+(main)> now + 5
+=> 2012-09-13 09:19:11 -0600
+(main)> now - 5
+=> 2012-09-13 09:19:01 -0600
+(main)> now + 5.minutes
+=> 2012-09-13 09:24:06 -0600
+(main)> now + 5.days
+=> 2012-09-18 09:19:06 -0600
+```
+
+Time zone objects are available, but the `utc_offset` is a little more
+immediately useful.  It returns the offset *in seconds*, so divide by `1.0.hour`
+to get the offset in hours.
+
+```ruby
+(main)> now.timezone
+=> #<__NSTimeZone:0x9384c70>
+(main)> now.timezone.name
+=> "America/Denver"
+(main)> now.utc_offset
+=> -21600
+(main)> now.utc_offset / 1.0.hour
+=> -6.0
+```
+
+
  NSURL
 -------
 
@@ -201,10 +269,10 @@ UIAlertView.alert("This is happening, OK?", buttons: ["Nevermind", "OK"],
 # Full on whiz bangery.  Note the success block takes the pressed button, but as
 # a string instead of an index.  The cancel button should be the first entry in
 # `buttons:`
-UIAlertView.alert "I mean, is this cool?", buttons: %w[No! Sure! Hmmmm]
+UIAlertView.alert "I mean, is this cool?", buttons: %w[No! Sure! Hmmmm],
   message: "No going back now",
-  cancel: { self.cancel },
-  success: { |pressed| self.proceed if pressed == "Sure!" }
+  cancel: proc { self.cancel },
+  success: proc { |pressed| self.proceed if pressed == "Sure!" }
 ```
 
  UIView
@@ -365,6 +433,12 @@ Makes it easy to post a notification to some or all objects.
 "my notification".post_notification  # => NSNotificationCenter.defaultCenter.postNotificationName("my notification", object:nil)
 "my notification".post_notification(obj)  # => NSNotificationCenter.defaultCenter.postNotificationName("my notification", object:obj)
 "my notification".post_notification(obj, user: 'dict')  # => NSNotificationCenter.defaultCenter.postNotificationName("my notification", object:obj, userInfo:{user: 'dict'})
+
+# very similar to add or remove an observer
+"my notification".add_observer(observer, :method_name)
+"my notification".add_observer(observer, :method_name, target)
+"my notification".remove_observer(observer)
+"my notification".remove_observer(observer, target)
 ```
 
  NSTimer

data/lib/sugarcube/notifications.rb

@@ -12,4 +12,15 @@ class NSString
     end
   end
 
+  def add_observer(observer, message, object=nil)
+    NSNotificationCenter.defaultCenter.addObserver(observer,
+            selector: message,
+            name: self,
+            object: object)
+  end
+
+  def remove_observer(observer, object=nil)
+    NSNotificationCenter.defaultCenter.removeObserver(observer, name:self, object:object)
+  end
+
 end

data/lib/sugarcube/nsdate.rb

@@ -0,0 +1,62 @@
+class NSDate
+  def year
+    return components(NSYearCalendarUnit).year
+  end
+
+  def month
+    return components(NSMonthCalendarUnit).month
+  end
+
+  def day
+    return components(NSDayCalendarUnit).day
+  end
+
+  def ymd
+    return [self.year, self.month, self.day]
+  end
+
+  def weekday
+    return components(NSWeekdayCalendarUnit).weekday
+  end
+
+  def hour
+    return components(NSHourCalendarUnit).hour
+  end
+
+  def minute
+    return components(NSMinuteCalendarUnit).minute
+  end
+
+  def second
+    return components(NSSecondCalendarUnit).second
+  end
+
+  def timezone
+    return components(NSTimeZoneCalendarUnit).timeZone
+  end
+  alias timeZone timezone
+
+  def utc_offset
+    return self.timezone.secondsFromGMT
+  end
+
+  def hms
+    return [self.hour, self.minute, self.second]
+  end
+
+  def datetime
+    return [self.year, self.month, self.day, self.hour, self.minute, self.second]
+  end
+
+  def +(time_interval)
+    return self.dateByAddingTimeInterval(time_interval)
+  end
+
+  private
+  def components(components)
+    unless (@@calendar ||= nil)
+      @@calendar = NSCalendar.alloc.initWithCalendarIdentifier(NSGregorianCalendar)
+    end
+    return @@calendar.components(components, fromDate:self)
+  end
+end

data/lib/sugarcube/version.rb

@@ -1,3 +1,3 @@
 module SugarCube
-  Version = '0.8.5'
+  Version = '0.8.6'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sugarcube
 version: !ruby/object:Gem::Version
-  version: 0.8.5
+  version: 0.8.6
   prerelease: 
 platform: ruby
 authors:
@@ -10,11 +10,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-09-11 00:00:00.000000000 Z
+date: 2012-09-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70246812196120 !ruby/object:Gem::Requirement
+  requirement: &70094164450360 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -22,10 +22,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70246812196120
+  version_requirements: *70094164450360
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70246812195480 !ruby/object:Gem::Requirement
+  requirement: &70094164449820 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -33,7 +33,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70246812195480
+  version_requirements: *70094164449820
 description: ! '== Description
 
 
@@ -74,6 +74,7 @@ files:
 - lib/sugarcube/exceptions.rb
 - lib/sugarcube/fixnum.rb
 - lib/sugarcube/notifications.rb
+- lib/sugarcube/nsdate.rb
 - lib/sugarcube/nsindexpath.rb
 - lib/sugarcube/nsindexset.rb
 - lib/sugarcube/nsstring.rb