sugarcube 0.11 → 0.11.1

data/README.md

@@ -17,7 +17,7 @@ view << subview.
 
 The basic idea of sugarcube is to turn some operations on their head.  Insead of
 
-    UIApplication.sharedApplication.openURL(NSUrl.URLWithString(url))
+    UIApplication.sharedApplication.openURL(NSURL.URLWithString(url))
 
 How about:
 
@@ -70,6 +70,16 @@ Examples
 # create a UIColor from a hex value
 0xffffff.uicolor # => UIColor.colorWithRed(1.0, green:1.0, blue:1.0, alpha:1.0)
 0xffffff.uicolor(0.5) # => UIColor.colorWithRed(1.0, green:1.0, blue:1.0, alpha:0.5)
+
+# some number-to-string stuff
+1.nth  # => 'st'
+2.nth  # => 'nd'
+3.nth  # => 'rd'
+4.nth  # => 'th'
+11.nth  # => 'th'
+13.nth  # => 'th'
+21.nth  # => 'st'
+23.nth  # => 'rd'
 ```
 
  Numeric
@@ -86,6 +96,12 @@ Examples
 # convert multiples of pi
 2.pi   # => 2 * Math::PI
 0.5.pi # => 0.5 * Math::PI
+
+# if you thought conversion from degrees to radians looks weird, you'll hate
+# conversion from meters to miles:
+distance = 1500  # this is in meters.  why?  because all the methods that return
+  # a "distance" return it in meters
+distance.miles  # => 0.932056427001953
 ```
 
  NSCoder
@@ -375,6 +391,10 @@ image.uicolor # => UIColor.colorWithPatternImage(image)
 image.scale_to [37, 37]
 image.rounded  # default: 5 pt radius
 image.rounded(10)
+
+# these both use UIEdgeInsetsZero (for now)
+image.tileable
+image.stretchable
 ```
 
  UIAlertView
@@ -677,6 +697,10 @@ end
 # hemorrhaging):
 1.month   || 2.months   # 1.month = 30 days
 1.year    || 2.years    # 1.year = 365 days
+
+# some comparison methods
+date1.today?
+date2.same_day? date1
 ```
 
  NSUserDefaults
@@ -836,6 +860,28 @@ CGRect([0.0, 0.0],{1.0 × 1.0})
 
 [CGGeometry Reference]: https://developer.apple.com/library/mac/documentation/graphicsimaging/reference/CGGeometry/Reference/reference.html
 
+ CoreLocation
+--------------
+
+Open up `CLLocationCoordinate2D` to provide handy-dandies
+
+```ruby
+> denver_co = CLLocationCoordinate2D.new(39.739188,-104.985223)
+=> #<CLLocationCoordinate2D latitude=39.7391815185547 longitude=-104.985198974609>
+> loveland_oh = CLLocationCoordinate2D.new(39.268128,-84.257648)
+=> #<CLLocationCoordinate2D latitude=39.2681274414062 longitude=-84.2576293945312>
+> denver_co.distance_to(loveland_oh)
+=> 1773425.5  # in meters
+> denver_co.distance_to(loveland_oh).miles
+=> 1101.955078125
+> denver_co.delta_miles(1101.6, -32.556)
+=> #<CLLocationCoordinate2D latitude=39.2681427001953 longitude=-84.2577209472656>
+> denver_co.delta_miles(1101.6, -32.556).distance_to(loveland_oh)
+=> 8.0804328918457   # this is in meters
+> denver_co.delta_miles(1101.6, -32.556).distance_to(loveland_oh).miles
+=> 0.00502094626426697
+```
+
  REPL View adjustments
 -----------------------
 

data/lib/sugarcube/adjust.rb

@@ -18,9 +18,7 @@ module SugarCube
       return @@sugarcube_view if not view
 
       if view.is_a? Fixnum
-        @@sugarcube_items ||= nil
-        raise "no views have been assigned to SugarCube::Adjust::tree" unless @@sugarcube_items
-
+        @@sugarcube_items ||= SugarCube::Adjust::build_tree(UIApplication.sharedApplication.keyWindow, :subviews)
         view = @@sugarcube_items[view]
       end
 
@@ -283,7 +281,7 @@ module SugarCube
         end
       end
 
-      @@sugarcube_items = []
+      @@sugarcube_items = SugarCube::Adjust::build_tree(item, selector)
       if self.respond_to? :draw_tree
         total = draw_tree(item, selector)
       else
@@ -295,8 +293,6 @@ module SugarCube
     end
 
     def draw_tree(item, selector, tab=nil, is_last=true, items_index=0)
-      @@sugarcube_items << item
-
       space = ' '
       if items_index < 10
         print '  '
@@ -346,6 +342,19 @@ module SugarCube
       return items_index
     end
 
+    def build_tree(item, selector)
+      if selector.is_a? Proc
+        items = selector.call(item)
+      else
+        items = item.send(selector)
+      end
+      ret = [item]
+      items.each_with_index { |subview, index|
+        ret.concat SugarCube::Adjust::build_tree(subview, selector)
+      }
+      ret
+    end
+
     def root
       (UIApplication.sharedApplication.keyWindow || UIApplication.sharedApplication.windows[0]).rootViewController
     end

data/lib/sugarcube/core_location.rb

@@ -0,0 +1,29 @@
+# denver = CLLocationCoordinate2D.new(39.764032,-104.963112)
+# cincinnati = CLLocationCoordinate2D.new(39.267024,-84.251736)
+# denver.distance_to(cincinnati).miles
+# denver.delta_miles()
+class CLLocationCoordinate2D
+
+  def delta_miles(dx, dy)
+    earth_radius = 3960.0
+
+    radius_at_latitude = earth_radius * Math.cos(self.latitude * Math::PI / 180.0)
+    if radius_at_latitude > 0
+      delta_lng = dx / radius_at_latitude
+      delta_lng *= 180.0 / Math::PI
+    else
+      delta_lng = 0
+    end
+
+    delta_lat = dy / earth_radius
+    delta_lat *= 180.0 / Math::PI
+    CLLocationCoordinate2D.new(self.latitude + delta_lat, self.longitude + delta_lng)
+  end
+
+  def distance_to(cl_location_2d)
+    my_location = CLLocation.alloc.initWithLatitude(self.latitude, longitude:self.longitude)
+    other_location = CLLocation.alloc.initWithLatitude(cl_location_2d.latitude, longitude:cl_location_2d.longitude)
+    my_location.distanceFromLocation(other_location)
+  end
+
+end

data/lib/sugarcube/fixnum.rb

@@ -15,4 +15,21 @@ class Fixnum
     UIColor.colorWithRed(red, green:green, blue:blue, alpha:alpha.to_f)
   end
 
+  def nth
+    # if the first two digits of rank are between 11 and 20, it's an
+    # 'up-teenth' kinda number
+    if self % 100 < 10 || self % 100 > 20
+      case self % 10
+      when 1
+        return "st"
+      when 2
+        return "nd"
+      when 3
+        return "rd"
+      end
+    end
+
+    return "th"
+  end
+
 end

data/lib/sugarcube/modal.rb

@@ -5,6 +5,14 @@ module SugarCube
       UIApplication.sharedApplication.keyWindow.rootViewController.presentViewController(view_ctlr, animated:true, completion:block)
     end
 
+    def present_modal_in_nav(view_ctlr, &block)
+      ctlr = UINavigationController.alloc.initWithRootViewController(view_ctlr)
+      ctlr.modalTransitionStyle = UIModalTransitionStyleCoverVertical
+
+      SugarCube::Modal.present_modal(ctlr, &block)
+      ctlr
+    end
+
     def dismiss_modal(&block)
       UIApplication.sharedApplication.keyWindow.rootViewController.dismissViewControllerAnimated(true, completion:block)
     end

data/lib/sugarcube/nsdate.rb

@@ -4,6 +4,22 @@ class NSDate
   end
   alias timeZone timezone
 
+  def era
+    return _calendar_components(NSEraCalendarUnit).era
+  end
+
+  def today?
+    today = self.class.new
+    return same_day?(today)
+  end
+
+  def same_day?(other)
+    return other.day == self.day &&
+           other.month == self.month &&
+           other.year == self.year &&
+           other.era == self.era
+  end
+
   # In the rare case you actually get an NSDate object - not a Time object - this
   # method is actually useful.
   def utc_offset

data/lib/sugarcube/nsstring_files.rb

@@ -0,0 +1,25 @@
+class NSString
+
+  def document
+    @@sugarcube_docs ||= NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, true)[0]
+    return self if self.hasPrefix(@@sugarcube_docs)
+
+    @@sugarcube_docs.stringByAppendingPathComponent(self)
+  end
+
+  def exists?
+    NSFileManager.defaultManager.fileExistsAtPath(self.document)
+  end
+
+  def resource
+    @@sugarcube_resources ||= NSBundle.mainBundle.resourcePath
+    return self if self.hasPrefix(@@sugarcube_resources)
+
+    @@sugarcube_resources.stringByAppendingPathComponent(self)
+  end
+
+  def resource_exists?
+    NSFileManager.defaultManager.fileExistsAtPath(self.resource)
+  end
+
+end

data/lib/sugarcube/nsurl.rb

@@ -1,11 +1,11 @@
 class NSURL
 
   def open
-    NSUIApplication.sharedApplication.openURL(NSUrl.URLWithString(self))
+    UIApplication.sharedApplication.openURL(NSURL.URLWithString(self))
   end
 
   def can_open?
-    NSUIApplication.sharedApplication.canOpenURL(NSUrl.URLWithString(self))
+    UIApplication.sharedApplication.canOpenURL(NSURL.URLWithString(self))
   end
 
 end

data/lib/sugarcube/numeric.rb

@@ -4,6 +4,10 @@ class Numeric
     self / 100.0
   end
 
+  def radians
+    self
+  end
+
   def degrees
     self / 180.0 * Math::PI
   end
@@ -12,4 +16,20 @@ class Numeric
     self * Math::PI
   end
 
+  def meters
+    self
+  end
+
+  def kilometers
+    self / 1000.0
+  end
+
+  def miles
+    self * 0.000621371
+  end
+
+  def feet
+    self * 3.28084
+  end
+
 end

data/lib/sugarcube/ror.rb

@@ -6,4 +6,8 @@ class Object
   def blank?
     respond_to?(:empty?) ? empty? : !self
   end
+
+  def present?
+    !blank?
+  end
 end

data/lib/sugarcube/symbol.rb

@@ -52,6 +52,11 @@ class Symbol
     attr_accessor :tableview_cellstyles
     attr_accessor :tableview_cellaccessorytype
     attr_accessor :tableview_cellselectionstyle
+
+    attr_accessor :image_sourcetypes
+    attr_accessor :image_capturemode
+    attr_accessor :image_cameradevice
+    attr_accessor :image_quality
   end
 
   @devices = {
@@ -313,6 +318,32 @@ class Symbol
     bottom: UIViewAutoresizingFlexibleBottomMargin,
   }
 
+  @image_sourcetypes = {
+    camera:  UIImagePickerControllerSourceTypeCamera,
+    library: UIImagePickerControllerSourceTypePhotoLibrary,
+    album:   UIImagePickerControllerSourceTypeSavedPhotosAlbum,
+  }
+  @image_capturemode = {
+    photo: UIImagePickerControllerCameraCaptureModePhoto,
+    video: UIImagePickerControllerCameraCaptureModeVideo,
+  }
+  @image_cameradevice = {
+    front: UIImagePickerControllerCameraDeviceFront,
+    rear:  UIImagePickerControllerCameraDeviceRear,
+  }
+  @image_quality = {
+    high:       UIImagePickerControllerQualityTypeHigh,
+    medium:     UIImagePickerControllerQualityTypeMedium,
+    low:        UIImagePickerControllerQualityTypeLow,
+    vga:        UIImagePickerControllerQualityType640x480,
+    i1280x720:  UIImagePickerControllerQualityTypeIFrame1280x720,
+    i1280:      UIImagePickerControllerQualityTypeIFrame1280x720,
+    i720:       UIImagePickerControllerQualityTypeIFrame1280x720,
+    i960x540:   UIImagePickerControllerQualityTypeIFrame960x540,
+    i960:       UIImagePickerControllerQualityTypeIFrame960x540,
+    i540:       UIImagePickerControllerQualityTypeIFrame960x540,
+  }
+
   private
   def look_in(here)
     return here[self] if here.has_key? self
@@ -433,6 +464,27 @@ class Symbol
   end
   alias uiviewautoresizing uiautoresize
 
+  def uiimagesource
+    look_in(Symbol.image_sourcetypes)
+  end
+  alias uiimagesourcetype uiimagesource
+
+  def uiimagecapture
+    look_in(Symbol.image_capturemode)
+  end
+  alias uiimagecapturemode uiimagecapture
+
+  def uiimagecamera
+    look_in(Symbol.image_cameradevice)
+  end
+  alias uiimagecameradevice uiimagecamera
+  alias uiimagedevice uiimagecamera
+
+  def uiimagequality
+    look_in(Symbol.image_quality)
+  end
+  alias uiimagequalitytype uiimagequality
+
   def uifont(size=UIFont.systemFontSize)
     # system fonts
     if Symbol.system_fonts.has_key? self

data/lib/sugarcube/timer.rb

@@ -39,11 +39,11 @@ class Numeric
   alias year years
 
   def later(user_info=nil, &fire)
-    NSTimer.scheduledTimerWithTimeInterval(self.to_f, target: fire, selector: 'call:', userInfo: user_info, repeats: false)
+    NSTimer.scheduledTimerWithTimeInterval(self, target: fire, selector: 'call:', userInfo: user_info, repeats: false)
   end
 
   def every(user_info=nil, &fire)
-    NSTimer.scheduledTimerWithTimeInterval(self.to_f, target: fire, selector: 'call:', userInfo: user_info, repeats: true)
+    NSTimer.scheduledTimerWithTimeInterval(self, target: fire, selector: 'call:', userInfo: user_info, repeats: true)
   end
 end
 

data/lib/sugarcube/to_s/uiview.rb

@@ -2,10 +2,16 @@ class UIView
 
   def to_s(options={})
     options[:superview] = true if options[:superview].nil?
+    if self.respond_to? :stylename and self.stylename
+      suffix = ' stylename: ' + self.stylename.inspect
+    else
+      suffix = ''
+    end
     "#{self.class.name}(##{self.object_id.to_s(16)}, #{SugarCube::Adjust::format_frame(self.frame)}" +
                         (options[:inner] ? ', ' + options[:inner] : '') +
                         ')' +
-                        (options[:superview] && self.superview ? ", child of #{self.superview.class.name}(##{self.superview.object_id.to_s(16)})" : '')
+                        (options[:superview] && self.superview ? ", child of #{self.superview.class.name}(##{self.superview.object_id.to_s(16)})" : '') +
+                        suffix
   end
 
 end

data/lib/sugarcube/uiimage.rb

@@ -36,4 +36,12 @@ class UIImage
     return image
   end
 
+  def tileable
+    resizableImageWithCapInsets(UIEdgeInsetsZero, resizingMode:UIImageResizingModeTile)
+  end
+
+  def stretchable
+    resizableImageWithCapInsets(UIEdgeInsetsZero, resizingMode:UIImageResizingModeStretch)
+  end
+
 end

data/lib/sugarcube/uiviewcontroller.rb

@@ -4,7 +4,12 @@ class UIViewController
     self.addChildViewController(view_controller)
     self
   end
-  alias << push
+
+  # `alias << push` won't work. it doesn't "respect" subclasses overriding the
+  # `push` method.
+  def <<(view_controller)
+    push view_controller
+  end
 
 end
 
@@ -15,7 +20,6 @@ class UINavigationController
     self.pushViewController(view_controller, animated: true)
     self
   end
-  alias << push
 
   def pop(to_view=nil)
     if to_view
@@ -36,6 +40,5 @@ class UITabBarController
     self.setViewControllers(view_controllers, animated: true)
     self
   end
-  alias << push
 
 end

data/lib/sugarcube/version.rb

@@ -1,3 +1,3 @@
 module SugarCube
-  Version = '0.11'
+  Version = '0.11.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sugarcube
 version: !ruby/object:Gem::Version
-  version: '0.11'
+  version: 0.11.1
   prerelease: 
 platform: ruby
 authors:
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-24 00:00:00.000000000 Z
+date: 2012-11-01 00:00:00.000000000 Z
 dependencies: []
 description: ! '== Description
 
@@ -47,8 +47,8 @@ files:
 - lib/sugarcube/adjust.rb
 - lib/sugarcube/array.rb
 - lib/sugarcube/core_graphics.rb
+- lib/sugarcube/core_location.rb
 - lib/sugarcube/defaults.rb
-- lib/sugarcube/document.rb
 - lib/sugarcube/exceptions.rb
 - lib/sugarcube/fixnum.rb
 - lib/sugarcube/modal.rb
@@ -59,6 +59,7 @@ files:
 - lib/sugarcube/nsindexpath.rb
 - lib/sugarcube/nsindexset.rb
 - lib/sugarcube/nsstring.rb
+- lib/sugarcube/nsstring_files.rb
 - lib/sugarcube/nsurl.rb
 - lib/sugarcube/nsuserdefaults.rb
 - lib/sugarcube/numeric.rb

data/lib/sugarcube/document.rb

@@ -1,14 +0,0 @@
-class NSString
-
-  def document
-    @@docs ||= NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, true)[0]
-    return self if self.hasPrefix(@@docs)
-
-    @@docs.stringByAppendingPathComponent(self)
-  end
-
-  def exists?
-    NSFileManager.defaultManager.fileExistsAtPath(self.document)
-  end
-
-end