sugarcube 0.10 → 0.11

data/README.md

@@ -86,6 +86,41 @@ Examples
 # convert multiples of pi
 2.pi   # => 2 * Math::PI
 0.5.pi # => 0.5 * Math::PI
+```
+
+ NSCoder
+---------
+
+Shorthands and hash-like access to the coder/decoder objects.
+
+```ruby
+# hash access is the handiest
+coder['key'] = self.value
+self.value = decoder['key']
+
+# but if you want to store booleans and such in the MOST compact way:
+coder.set('sugarcube_is_neat', toBool:self.is_sugarcube_neat?)
+self.sugarcube_is_neat = decoder.bool('sugarcube_is_neat')
+
+coder.set('number_of_things', toInt:self.number_of_things)
+self.number_of_things = decoder.int('number_of_things')
+
+# the entire list:
+coder.set(key, toBool:value)
+coder.set(key, toDouble:value)
+coder.set(key, toFloat:value)
+coder.set(key, toInt:value)
+coder.set(key, toPoint:value)
+coder.set(key, toRect:value)
+coder.set(key, toSize:value)
+
+decoder.bool(key)
+decoder.double(key)
+decoder.float(key)
+decoder.int(key)
+decoder.point(key)
+decoder.rect(key)
+decoder.size(key)
 ```
 
  NSDate
@@ -332,6 +367,14 @@ This is the "big daddy".  Lots of sugar here...
 ```ruby
 image = "my_image".uiimage
 image.uicolor # => UIColor.colorWithPatternImage(image)
+```
+
+###### Image Manipulation
+
+```ruby
+image.scale_to [37, 37]
+image.rounded  # default: 5 pt radius
+image.rounded(10)
 ```
 
  UIAlertView
@@ -810,15 +853,18 @@ Assume I ran `include SugarCube::Adjust` in these examples.
 > adjust superview.subviews[4].subviews[1]
 > up 1
 > down 1  # same as up -1, obviously
+> down  # defaults to 1 anyway
 > left 1
 > right 1  # same as up -1, obviously
+> left  # => left 1
 > origin 10, 12  # move to x:10, y:12
 > wider 1
 > thinner 1
-> taller 1
-> shorter 1
+> taller  # => taller 1
+> shorter  # => shorter 1
 > size 100, 10  # set size to width:100, height: 10
 > shadow(opacity: 0.5, offset: [0, 0], color: :black, radius: 1) # and path, which is a CGPath object.
+> center  # See `Centering` section below
 > restore  # original frame and shadow is saved when you call `adjust`
 ```
 
@@ -907,6 +953,78 @@ This better facilitates copy/paste of the values.  Currently supported is:
 
 Note: The `format` parameter can be passed as either a symbol or a string
 
+###  CENTER (in parent frame)
+It is called as `center(which_element, of_total_number, horizontal_or_vertical, verbose_output)`
+#### you can set 'direction' with any number of forms: 'horiz', 'vert', 'x', 'x and y'
+
+Here are a few examples:
+
+The default is to center the current element _horizontally_
+
+```
+(main)> center
+[[145.0, 30.0], [30.0, 200.0]]
+UIRoundedRectButton.origin = [145.0, 30.0]
+=> "[[145.0, 30.0], [30.0, 200.0]]"
+```
+
+In order to place that same button in the CENTER of the screen, you can use this shorthand syntax:
+`center 1,1,"xy"` or `center 1,1,:xy`
+
+For the `horizontal_or_vertical` parameter, strings and symbols are interchangable
+
+If you have three buttons and want them spaced evenly (vertically) across their parent frame, you can call it this way:
+```
+(main)> tree
+  0: . UIWindow(#6e1f950: [[0.0, 0.0], [320.0, 480.0]])
+  1: `-- UIView(#8b203b0: [[0.0, 20.0], [320.0, 460.0]])
+  2:     +-- UIButton(#d028de0: [[10.0, 10.0], [320.0, 463.400512695312]])
+  3:     |   `-- UIImageView(#d02aaa0: [[0.0, 0.0], [320.0, 463.400512695312]])
+  4:     +-- UIRoundedRectButton(#d02adb0: [[55.0, 110.0], [210.0, 20.0]])
+  5:     |   `-- UIButtonLabel(#d02af00: [[73.0, 0.0], [63.0, 19.0]])
+  6:     +-- UIRoundedRectButton(#d028550: [[60.0, 30.0], [200.0, 20.0]])
+  7:     |   `-- UIButtonLabel(#d02afb0: [[68.0, 0.0], [63.0, 19.0]])
+  8:     `-- UIRoundedRectButton(#d02b220: [[70.0, 30.0], [300.0, 20.0]])
+  9:         `-- UIButtonLabel(#d02b300: [[118.0, 0.0], [63.0, 19.0]])
+=> UIWindow(#6e1f950, [[0.0, 0.0], [320.0, 480.0]])
+(main)> a 4; center 1, 3, :vert, false; center
+[[55.0, 110.0], [210.0, 20.0]]
+[[55.0, 110.0], [210.0, 20.0]]
+UIRoundedRectButton.origin = [55.0, 110.0]
+=> "[[55.0, 110.0], [210.0, 20.0]]"
+(main)> a 6; center 2, 3, :vert, false; center
+[[60.0, 220.0], [200.0, 20.0]]
+[[60.0, 220.0], [200.0, 20.0]]
+UIRoundedRectButton.origin = [60.0, 220.0]
+=> "[[60.0, 220.0], [200.0, 20.0]]"
+(main)> a 8; center 3, 3, :vert, false; center
+[[70.0, 330.0], [300.0, 20.0]]
+[[10.0, 330.0], [300.0, 20.0]]
+UIRoundedRectButton.origin = [10.0, 330.0]
+=> "[[10.0, 330.0], [300.0, 20.0]]"
+```
+The calculated positions (x,y) are in the REPL output
+
+
+**Don't stop there!**
+
+You can analyze `UIViewController` hierarchies, too.  There's even a handy
+`root` method to grab the `rootViewController`:
+
+```ruby
+(main)> tree root
+  0: . #<MainScreenController:0xac23b80>
+  1: +-- #<ScheduleViewController:0x13185d00>
+  2: |   +-- #<ScheduleTableController:0x131862f0>
+  3: |   `-- #<ScheduleCalendarController:0x131bba90>
+  4: +-- #<CameraViewController:0x13191380>
+  5: +-- #<UINavigationController:0xac01ea0>
+  6: |   `-- #<UITableController:0xac04e30>
+  7: +-- #<PicturesViewController:0x1403ede0>
+  8: `-- #<MessagesViewController:0x131a1bc0>
+=> #<MainScreenController:0xac23b80>
+```
+
 
  Pointers
 ----------
@@ -944,3 +1062,21 @@ Quick wrapper for `CFUUIDCreate()` and `CFUUIDCreateString()`.  Identical to the
 [teacup]: https://github.com/rubymotion/teacup
 [Fusionbox]: http://www.fusionbox.com/
 [fusionbox announcement]: http://fusionbox.org/projects/rubymotion-sugarcube/
+
+ Ruby on Rails Ripoffs (RoR-R?)
+---------------
+
+```ruby
+# truthiness with `blank?`
+nil.blank?    # => true
+false.blank?  # => true
+''.blank?     # => true
+[].blank?     # => true
+{}.blank?     # => true
+
+0.blank?        # => false
+true.blank?     # => false
+'a'.blank?      # => false
+['a'].blank?    # => false
+{a: 'a'}.blank? # => false
+```

data/lib/sugarcube/adjust.rb

@@ -18,21 +18,24 @@ module SugarCube
       return @@sugarcube_view if not view
 
       if view.is_a? Fixnum
-        @@sugarcube_views ||= nil
-        raise "no views have been assigned to SugarCube::Adjust::tree" unless @@sugarcube_views
+        @@sugarcube_items ||= nil
+        raise "no views have been assigned to SugarCube::Adjust::tree" unless @@sugarcube_items
 
-        view = @@sugarcube_views[view]
+        view = @@sugarcube_items[view]
       end
 
-      @@sugarcube_view = view
-      @@sugarcube_restore = {
-        frame: SugarCube::Adjust.frame,
-        shadow: SugarCube::Adjust.shadow,
-      }
+      if view.is_a?(UIView)
+        @@sugarcube_view = view
+        @@sugarcube_restore = {
+          frame: SugarCube::Adjust.frame,
+          shadow: SugarCube::Adjust.shadow,
+        }
 
-      if format
-        puts format_frame view.frame
+        if format
+          puts format_frame view.frame
+        end
       end
+
       view
     end
     alias a adjust
@@ -165,6 +168,52 @@ module SugarCube
     end
     alias z size
 
+    def center(*args)
+      @@sugarcube_view ||= nil
+      raise "no view has been assigned to SugarCube::Adjust::adjust" unless @@sugarcube_view
+
+      element = nil
+      total = nil
+      direction = 'h'
+      args.each do |option|
+        case option
+        when String, Symbol  # accept string or symbol
+          direction = option.to_s
+        when Numeric
+          if not total
+            total = option
+          elsif not element
+            element = option
+          else
+            raise "I don't know what to do with #{option.inspect}"
+          end
+        else
+          raise "I don't know what to do with #{option.inspect}"
+        end
+      end
+      element = 1 unless element
+      total = 1 unless total
+
+      view = @@sugarcube_view
+
+      left = view.origin.x
+      top = view.origin.y
+
+      if /h|x/.match(direction.downcase)
+        swidth = view.frame.width
+        pwidth = view.superview.frame.width / total
+        left = (pwidth - swidth) / 2 + pwidth * (element - 1)
+      end
+      if /v|y/.match(direction.downcase)
+        sheight = view.frame.height
+        pheight = view.superview.frame.height / total
+        top = (pheight - sheight) / 2 + pheight * (element - 1)
+      end
+
+      self.origin left, top
+    end
+    alias c center
+
     ##|  SHADOW
     def shadow shadow=nil
       @@sugarcube_view ||= nil
@@ -201,64 +250,110 @@ module SugarCube
     alias h shadow
 
     ##|  TREE
-    def tree(view=nil, tab=nil, is_last=true, views_index=nil)
-      unless view
-        view = UIApplication.sharedApplication.keyWindow
+    def tree(item=nil, selector=nil, &sel_blk)
+      unless item
+        item = UIApplication.sharedApplication.keyWindow
+      end
+      if not item
+        puts 'View is nil (no window, view, or controller to display)'
+        return
       end
 
-      if not views_index
-        is_first = true
-        @@sugarcube_views = [view]
-        views_index = 0
+      if sel_blk
+        if selector
+          raise "You can't hand me a block AND a selector.  I don't know what to do with them!"
+        end
+        if sel_blk.arity != 1
+          raise "The block you passed should accept one and only one object"
+        end
+        selector = sel_blk
+      elsif ! selector
+        if item.is_a? UIView
+          selector = :subviews
+        elsif item.is_a? UIViewController
+          selector = lambda { |ctlr|
+                      ret = Array.new ctlr.childViewControllers
+                      if ctlr.presentedViewController && ctlr.presentedViewController.presentingViewController == ctlr
+                        ret << ctlr.presentedViewController
+                      end
+                      ret
+                    }
+        else
+          raise "Unable to determine a SugarCube::Adjust::tree selector for #{item.class.name}"
+        end
+      end
+
+      @@sugarcube_items = []
+      if self.respond_to? :draw_tree
+        total = draw_tree(item, selector)
       else
-        is_first = false
-        @@sugarcube_views << view
+        total = SugarCube::Adjust::draw_tree(item, selector)
       end
+      puts ''
+
+      return item
+    end
+
+    def draw_tree(item, selector, tab=nil, is_last=true, items_index=0)
+      @@sugarcube_items << item
 
       space = ' '
-      if views_index < 10
-        print "  "
-      elsif views_index < 100
-        print " "
-      elsif views_index > 999  # good god, man!
+      if items_index < 10
+        print '  '
+      elsif items_index < 100
+        print ' '
+      elsif items_index > 999  # good god, man!
         space = ''
       end
-      print views_index.to_s + ":" + space
+      print items_index.to_s + ":" + space
 
       if tab
         print tab
-        print is_last ? "`-- " : "+-- "
-        tab += is_last ? "    " : "|   "
+        if is_last
+          print '`-- '
+          tab += '    '
+        else
+          print '+-- '
+          tab += '|   '
+        end
       else
-        print ". "
-        tab = ""
+        print '. '
+        tab = ''
       end
 
-      if not view
-        puts "View is nil (no window or view to display)"
+      if self == item
+        print "\033[1m"
+      end
+      if item.is_a? UIView
+        puts item.to_s superview: false
       else
-        if self == view
-          print "\033[1m"
-        end
-        puts "#{view.class.name}(##{view.object_id.to_s(16)}: #{format_frame(view.frame)})"
-        if self == view
-          print "\033[0m"
-        end
+        puts item.to_s
+      end
+      if self == item
+        print "\033[0m"
+      end
 
-        view.subviews.each_index {|index|
-          subview = view.subviews[index]
-          views_index += 1
-          views_index = tree(subview, tab, index == view.subviews.length - 1, views_index)
-        }
+      if selector.is_a? Proc
+        items = selector.call(item)
+      else
+        items = item.send(selector)
       end
+      items.each_with_index { |subview, index|
+        items_index += 1
+        items_index = SugarCube::Adjust::draw_tree(subview, selector, tab, index == items.length - 1, items_index)
+      }
 
-      return is_first ? view : views_index
+      return items_index
+    end
+
+    def root
+      (UIApplication.sharedApplication.keyWindow || UIApplication.sharedApplication.windows[0]).rootViewController
     end
 
     ##|  RESTORE
     def restore
       @@sugarcube_view ||= nil
-      raise "no view has been assigned to SugarCube::Adjust::adjust" unless @@sugarcube_view
+      raise 'no view has been assigned to SugarCube::Adjust::adjust' unless @@sugarcube_view
 
       @@sugarcube_restore.each do |msg, value|
         SugarCube::Adjust.send(msg, value)
@@ -267,9 +362,9 @@ module SugarCube
 
     def format_frame(frame)
       case SugarCube::Adjust::repl_format
-        when :json then "[x: #{frame.origin.x}, y: #{frame.origin.y}, height: #{frame.size.width}, width: #{frame.size.height}]"
+        when :json then "{x: #{frame.origin.x}, y: #{frame.origin.y}, width: #{frame.size.width}, height: #{frame.size.height}}"
         when :ruby then "[[#{frame.origin.x}, #{frame.origin.y}], [#{frame.size.width}, #{frame.size.height}]]"
-        when nil, :objc
+        when :objc
           frame.to_s
         else
           raise "Unknown repl_format #{SugarCube::Adjust::repl_format.inspect}"

data/lib/sugarcube/nsindexpath.rb

@@ -34,7 +34,7 @@ class IndexPath
       @values.each do |val|
         next_val = other[other_i]
         other_i += 1
-        unless val === next_val
+        unless val == true || val === next_val
           ret = false
           break
         end

data/lib/sugarcube/nsurl.rb

@@ -4,4 +4,8 @@ class NSURL
     NSUIApplication.sharedApplication.openURL(NSUrl.URLWithString(self))
   end
 
+  def can_open?
+    NSUIApplication.sharedApplication.canOpenURL(NSUrl.URLWithString(self))
+  end
+
 end

data/lib/sugarcube/nsuserdefaults.rb

@@ -0,0 +1,16 @@
+class NSUserDefaults
+
+  class << self
+    # Retrieves the object for the passed key
+    def [](key)
+      self.standardUserDefaults.objectForKey(key.to_s)
+    end
+
+    # Sets the value for a given key and save it right away.
+    def []=(key, val)
+      self.standardUserDefaults.setObject(val, forKey: key.to_s)
+      self.standardUserDefaults.synchronize
+    end
+  end
+
+end

data/lib/sugarcube/ror.rb

@@ -0,0 +1,9 @@
+# thanks ruby on rails!
+#
+# these are all blatent, unapologetic rip offs of RoR extensions.
+
+class Object
+  def blank?
+    respond_to?(:empty?) ? empty? : !self
+  end
+end

data/lib/sugarcube/symbol.rb

@@ -31,6 +31,7 @@ class Symbol
     attr_accessor :barmetrics
     attr_accessor :barbuttomitems
     attr_accessor :keyboardtypes
+    attr_accessor :autoresizemasks
 
     attr_accessor :textalignments
     attr_accessor :linebreakmodes
@@ -120,6 +121,8 @@ class Symbol
     touch_up: UIControlEventTouchUpInside,
     touch_down: UIControlEventTouchDown,
     change:  UIControlEventValueChanged|UIControlEventEditingChanged,
+    begin: UIControlEventEditingDidBegin,
+    end: UIControlEventEditingDidEnd,
     # I'm leaving this for backwards compatibility.  please use 'change' or
     # 'editing_did_change':
     changed: UIControlEventValueChanged|UIControlEventEditingChanged,
@@ -291,6 +294,25 @@ class Symbol
     email:                 UIKeyboardTypeEmailAddress,
   }
 
+  @autoresizemasks = {
+    none: UIViewAutoresizingNone,
+
+    flexibleleft:   UIViewAutoresizingFlexibleLeftMargin,
+    flexiblewidth:  UIViewAutoresizingFlexibleWidth,
+    flexibleright:  UIViewAutoresizingFlexibleRightMargin,
+    flexibletop:    UIViewAutoresizingFlexibleTopMargin,
+    flexibleheight: UIViewAutoresizingFlexibleHeight,
+    flexiblebottom: UIViewAutoresizingFlexibleBottomMargin,
+
+    # aliases
+    left:   UIViewAutoresizingFlexibleLeftMargin,
+    width:  UIViewAutoresizingFlexibleWidth,
+    right:  UIViewAutoresizingFlexibleRightMargin,
+    top:    UIViewAutoresizingFlexibleTopMargin,
+    height: UIViewAutoresizingFlexibleHeight,
+    bottom: UIViewAutoresizingFlexibleBottomMargin,
+  }
+
   private
   def look_in(here)
     return here[self] if here.has_key? self
@@ -406,6 +428,11 @@ class Symbol
     look_in(Symbol.keyboardtypes)
   end
 
+  def uiautoresize
+    look_in(Symbol.autoresizemasks)
+  end
+  alias uiviewautoresizing uiautoresize
+
   def uifont(size=UIFont.systemFontSize)
     # system fonts
     if Symbol.system_fonts.has_key? self

data/lib/sugarcube/to_s/nserror.rb

@@ -1,4 +1,9 @@
 class NSError
+  def localized
+    localizedDescription
+  end
+  alias _ localized
+
   def to_s
     "#<#{self.class.name}:0x#{self.object_id.to_s(16)}, "+
       "description=#{self.localizedDescription.inspect}, code=#{code}, "+

data/lib/sugarcube/to_s/uilabel.rb

@@ -0,0 +1,7 @@
+class UILabel
+
+  def to_s(options={})
+    super options.merge(inner: 'text: ' + text.inspect)
+  end
+
+end

data/lib/sugarcube/to_s/uiview.rb

@@ -1,8 +1,11 @@
 class UIView
 
-  def to_s
-    "#{self.class.name}(##{self.object_id.to_s(16)}, #{SugarCube::Adjust::format_frame(self.frame)})" +
-                        (self.superview ? ",  child of #{self.superview.class.name}(##{self.superview.object_id.to_s(16)})" : '')
+  def to_s(options={})
+    options[:superview] = true if options[:superview].nil?
+    "#{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)})" : '')
   end
 
 end

data/lib/sugarcube/to_s/uiviewcontroller.rb

@@ -0,0 +1,11 @@
+class UIViewController
+
+  def to_s
+    ret = super
+    if self.presentingViewController
+      ret += " presented by #{self.presentingViewController.to_s}"
+    end
+    ret
+  end
+
+end

data/lib/sugarcube/uiactivityindicator.rb

@@ -13,4 +13,5 @@ class UIActivityIndicatorView
       self.alloc.initWithActivityIndicatorStyle(:gray.uiactivityindicatorstyle)
     end
   end
-end
+
+end

data/lib/sugarcube/uialertview.rb

@@ -9,6 +9,10 @@ class UIAlertView
   #   success: proc{ |pressed| puts "pressed: #{pressed}" },
   #   )
   def self.alert(title, options={}, &block)
+    if options.is_a? String
+      options = {message: options}
+    end
+
     # create the delegate
     delegate = SugarCube::AlertViewDelegate.new
     delegate.on_success = options[:success] || block

data/lib/sugarcube/uiimage.rb

@@ -14,5 +14,26 @@ class UIImage
     @uiimageview = UIImageView.alloc.initWithImage(self)
   end
 
+  ##|
+  ##|  REALLY HANDY STUFF!
+  ##|
+  def scale_to new_size
+    UIGraphicsBeginImageContextWithOptions(new_size, false, 0.0)
+    self.drawInRect([[0, 0], new_size])
+    image = UIGraphicsGetImageFromCurrentImageContext()
+    UIGraphicsEndImageContext()
+    return image
+  end
+
+  def rounded(corner_radius=5)
+    UIGraphicsBeginImageContext(size)
+    path = UIBezierPath.bezierPathWithRoundedRect([[0, 0], size], cornerRadius:corner_radius)
+    path.addClip
+    self.drawInRect([[0, 0], size])
+    image = UIGraphicsGetImageFromCurrentImageContext()
+
+    UIGraphicsEndImageContext()
+    return image
+  end
 
 end

data/lib/sugarcube/uiviewcontroller.rb

@@ -1,26 +1,27 @@
-class UINavigationController
+class UIViewController
 
   def push(view_controller)
-    self.pushViewController(view_controller, animated: true)
+    self.addChildViewController(view_controller)
     self
   end
+  alias << push
+
+end
+
+
+class UINavigationController
 
-  def <<(view_controller)
+  def push(view_controller)
     self.pushViewController(view_controller, animated: true)
     self
   end
+  alias << push
 
   def pop(to_view=nil)
-    return self.!(to_view) if to_view
-
-    self.popViewControllerAnimated(true)
-  end
-
-  def !(to_view=nil)
     if to_view
       self.popToViewController(to_view, animated: true)
     else
-      self.popToRootViewControllerAnimated(true)
+      self.popViewControllerAnimated(true)
     end
   end
 
@@ -29,11 +30,12 @@ end
 
 class UITabBarController
 
-  def <<(view_controller)
+  def push(view_controller)
     view_controllers = [] + self.viewControllers
     view_controllers << view_controller
     self.setViewControllers(view_controllers, animated: true)
     self
   end
+  alias << push
 
 end

data/lib/sugarcube/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sugarcube
 version: !ruby/object:Gem::Version
-  version: '0.10'
+  version: '0.11'
   prerelease: 
 platform: ruby
 authors:
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-19 00:00:00.000000000 Z
+date: 2012-10-24 00:00:00.000000000 Z
 dependencies: []
 description: ! '== Description
 
@@ -60,7 +60,9 @@ files:
 - lib/sugarcube/nsindexset.rb
 - lib/sugarcube/nsstring.rb
 - lib/sugarcube/nsurl.rb
+- lib/sugarcube/nsuserdefaults.rb
 - lib/sugarcube/numeric.rb
+- lib/sugarcube/ror.rb
 - lib/sugarcube/symbol.rb
 - lib/sugarcube/symbol/symbol_uicolor.rb
 - lib/sugarcube/timer.rb
@@ -68,8 +70,10 @@ files:
 - lib/sugarcube/to_s/nsset.rb
 - lib/sugarcube/to_s/uicolor.rb
 - lib/sugarcube/to_s/uievent.rb
+- lib/sugarcube/to_s/uilabel.rb
 - lib/sugarcube/to_s/uitouch.rb
 - lib/sugarcube/to_s/uiview.rb
+- lib/sugarcube/to_s/uiviewcontroller.rb
 - lib/sugarcube/uiactivityindicator.rb
 - lib/sugarcube/uialertview.rb
 - lib/sugarcube/uibutton.rb