sugarcube 0.1.6 → 0.2.0

data/README.md

@@ -54,18 +54,6 @@ Examples
 # create a percentage
 100.0.percent # => 1.00
 55.0.percent # => 0.55
-```
-
- NSNotificationCenter
-----------------------
-
-Makes it easy to post a notification to some or all objects.
-
-```ruby
-# this one is handy, I think:
-"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'})
 ```
 
  NSURL
@@ -76,16 +64,8 @@ Makes it easy to post a notification to some or all objects.
 "https://github.com".nsurl.open  # => UIApplication.sharedApplication.openURL(NSURL.URLWithString("https://github.com"))
 ```
 
- NSUserDefaults
-----------------
-
-```ruby
-['any', 'objects'].save_to_default(:key)  # => NSUserDefaults.standardUserDefaults.setObject(['any', 'objects'], forKey: :key)
-:key.get_default  # => NSUserDefaults.standardUserDefaults.objectForKey(:key)
-```
-
- String
---------
+ NSString
+----------
 
 ```ruby
 # UIImage from name
@@ -178,4 +158,139 @@ button.off(:all)
 You can only remove handlers by "type", not by the action.  e.g. If you bind
 three `:touch` events, calling `button.off(:touch)` will remove all three.
 
+ NSNotificationCenter
+----------------------
+
+Makes it easy to post a notification to some or all objects.
+
+```ruby
+# this one is handy, I think:
+"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'})
+```
+
+ NSUserDefaults
+----------------
+
+```ruby
+:key.set_default(['any', 'objects'])  # => NSUserDefaults.standardUserDefaults.setObject(['any', 'objects'], forKey: :key)
+:key.get_default  # => NSUserDefaults.standardUserDefaults.objectForKey(:key)
+```
+
+This is strange, and backwards, which is just sugarcube's style.  But there is
+one advantage to doing it this way.  Compare these two snippets:
+
+```ruby
+# BubbleWrap
+App::Persistance[:test] = { my: 'test' }
+# sugarcube
+:test.set_default { my: 'test' }
+# k, BubbleWrap looks better
+
+App::Persistance[:test][:my] == 'test'  # true
+:test.get_default[:my]  # true, and odd looking - what's my point?
+
+App::Persistance[:test][:my] = 'new'  # nothing is saved.  bug
+:test.get_default[:my] = 'new'  # nothing is saved, but that's *obvious*
+
+test = App::Persistance[:test]
+test[:my] = 'new'
+App::Persistance[:test] = test  # saved
+
+test = :test.get_default
+test[:my] = 'new'
+:test.set_default test
+```
+
+ CoreGraphics
+--------------
+
+###### Is it `CGMakeRect` or `CGRectMake`?
+
+Instead, just use `Rect`, `Size` and `Point`.  These are namespaced in
+`SugarCube` module, but I recommend you `include SugarCube` in app_delegate.rb.
+
+```ruby
+f = SugarCube::Rect(view.frame)  # converts a CGRect into a CGRectArray
+o = SugarCube::Point(view.frame.origin)  # converts a CGPoint into a CGPointArray
+s = SugarCube::Size(view.frame.size)  # converts a CGSize into a CGSizeArray
+
+# lots of other conversions are possible.  Let's assume `include SugarCube`, too
+# 4 numbers
+f = Rect(x, y, w, h)
+# or two arrays
+p = Point(x, y)  # or just [x, y] works, too
+s = Size(w, h)  # again, [w, h] is fine
+f = Rect(p, s)
+f = Rect([[x, y], [w, h]])  # same as above (the CG*Array objects will get created for you)
+
+view.frame = f  # Rect returns a CGRectArray, which view.frame can accept
+```
+
+###### Animations
+
+jQuery-like animation methods.
+
+```ruby
+# default timeout is 0.3
+view.fadeout { |view|
+  view.removeFromSuperview
+}
+# options:
+view.fadeout(0.5, delay: 0,
+                  options: UIViewAnimationOptionCurveLinear,
+                  opacity: 0.5) { |view|
+  view.removeFromSuperview
+}
+view.move_to([0, 100])  # move to position 0, 100
+view.delta_to([0, 100])  # move over 0, down 100, from current position
+```
+
+ REPL View adjustments
+-----------------------
+
+Pixel pushing is an unfortunate but necessary evil.  Well, at least we can make
+it a little less painful.
+
+These methods help you adjust the frame of a view.  They are in the `SugarCube`
+module so as not to conflict.  If you don't want the prefix, `include SugarCube` in
+app_delegate.rb
+
+```ruby
+# if you are in the REPL, you might not be able to click on the view you want...
+> SugarCube::adjust superview.subviews[4].subviews[1]
+> SugarCube::up 1
+> SugarCube::down 1  # same as up -1, obviously
+> SugarCube::left 1
+> SugarCube::right 1  # same as up -1, obviously
+> SugarCube::origin 10, 12  # move to x:10, y:12
+> SugarCube::wider 1
+> SugarCube::thinner 1
+> SugarCube::taller 1
+> SugarCube::shorter 1
+> SugarCube::size 100, 10  # set size to width:100, height: 10
+> SugarCube::restore
+```
+
+```ruby
+> # short versions!  and let's assume I ran `include SC`
+> a superview.subviews[4].subviews[1]  # this is not uncommon in the REPL
+> u          # up, default value=1
+> d          # down
+> l          # left
+> r          # right
+> o 10, 12   # origin, also accepts an array (or Point() object)
+> w          # wider
+> n          # thinner
+> t          # taller
+> s          # shorter
+> z 100, 10  # size, also accepts an array (or Size() object)
+> r          # restore
+
+# if you forget what view you are adjusting, run `adjust` again
+> a
+=> {UITextField @ x: 46.0 y:214.0, 280.0×33.0} child of UIView
+```
+
 [BubbleWrap]: https://github.com/rubymotion/BubbleWrap

data/lib/sugarcube/adjust.rb

@@ -0,0 +1,93 @@
+module SugarCube
+  module_function
+
+  def adjust view=nil
+    return @@sugarcube_view if not view
+
+    @@sugarcube_view = view
+    @@sugarcube_restore = view.frame
+    view
+  end
+  alias :a :adjust
+
+  ##|  ORIGIN
+  def left val=1
+    SugarCube::right -val
+  end
+  alias :l :left
+
+  def right val=1
+    f = @@sugarcube_view.frame
+    f.origin.x += val
+    @@sugarcube_view.frame = f
+  end
+  alias :r :right
+
+  def up val=1
+    SugarCube::down -val
+  end
+  alias :u :up
+
+  def down val=1
+    f = @@sugarcube_view.frame
+    f.origin.y += val
+    @@sugarcube_view.frame = f
+  end
+  alias :d :down
+
+  def origin x, y=nil
+    f = @@sugarcube_view.frame
+    if y
+      f.origin.x = x
+      f.origin.y = y
+    else
+      f.origin = x
+    end
+    @@sugarcube_view.frame = f
+  end
+  alias :o :origin
+
+  ##|  SIZE
+  def thinner val=1
+    SugarCube::wider -val
+  end
+  alias :n :thinner
+
+  def wider val=1
+    f = @@sugarcube_view.frame
+    f.size.width += val
+    @@sugarcube_view.frame = f
+  end
+  alias :w :wider
+
+  def taller val=1
+    SugarCube::shorter -val
+  end
+  alias :t :taller
+
+  def shorter val=1
+    f = @@sugarcube_view.frame
+    f.size.height += val
+    @@sugarcube_view.frame = f
+  end
+  alias :s :shorter
+
+  def size w, h=nil
+    f = @@sugarcube_view.frame
+    if h
+      f.size.width = w
+      f.size.height = h
+    else
+      f.size = w
+    end
+    @@sugarcube_view.frame = f
+  end
+  alias :z :size
+
+  ##|  RESTORE
+  def restore
+    @@sugarcube_view.frame = @@sugarcube_restore
+  end
+  alias :r :restore
+
+end

data/lib/sugarcube/core_graphics.rb

@@ -1,12 +1,34 @@
 
 class CGRectArray < Array
 
+  def initialize args
+    if args.length == 4
+      super [CGPointArray.new([args[0], args[1]]), CGSizeArray.new([args[2], args[3]])]
+    else
+      unless CGPointArray === args[0]
+        args[0] = Point(args[0])
+      end
+      unless CGSizeArray === args[1]
+        args[1] = Size(args[1])
+      end
+      super [args[0], args[1]]
+    end
+  end
+
   def origin
-    return CGPointArray.new(self[0])
+    return self[0]
+  end
+
+  def origin= val
+    self[0] = Point(val)
   end
 
   def size
-    return CGSizeArray.new(self[1])
+    return self[1]
+  end
+
+  def size= val
+    self[1] = Size(val)
   end
 
 end
@@ -18,10 +40,18 @@ class CGPointArray < Array
     return self[0]
   end
 
+  def x= val
+    self[0] = val
+  end
+
   def y
     return self[1]
   end
 
+  def y= val
+    self[1] = val
+  end
+
 end
 
 class CGSizeArray < Array
@@ -30,28 +60,68 @@ class CGSizeArray < Array
     return self[0]
   end
 
+  def width= val
+    self[0] = val
+  end
+
   def height
     return self[1]
   end
 
+  def height= val
+    self[1] = val
+  end
+
 end
 
 
-class Kernel
+module SugarCube
+  module_function
 
-  def Size(w, h)
-    retun CGSizeArray.new([w, h])
+  def Size(w_or_size, h=nil)
+    if not h
+      if CGSize === w_or_size
+        w = w_or_size.width
+        h = w_or_size.height
+      elsif Array === w_or_size
+        w = w_or_size[0]
+        h = w_or_size[1]
+      else
+        raise RuntimeError.new("Invalid argument sent to Size(#{w_or_size.inspect})")
+      end
+    else
+      w = w_or_size
+    end
+    return CGSizeArray.new([w, h])
   end
 
-  def Point(x, y)
-    retun CGPointArray.new([x, y])
+  def Point(x_or_origin, y=nil)
+    if not y
+      if CGPoint === x_or_origin
+        x = x_or_origin.x
+        y = x_or_origin.y
+      elsif Array === x_or_origin
+        x = x_or_origin[0]
+        y = x_or_origin[1]
+      else
+        raise RuntimeError.new("Invalid argument sent to Point(#{x_or_origin.inspect})")
+      end
+    else
+      x = x_or_origin
+    end
+    return CGPointArray.new([x, y])
   end
 
   # Accepts 2 or 4 arguments.  2 arguments should be a point and a size,
   # 4 should be x, y, w, h
   def Rect(x_or_origin, y_or_size=nil, w=nil, h=nil)
     if not y_or_size
-      if CGRect === x_or_origin
+      if CGRectArray === x_or_origin
+        x = x_or_origin[0][0]
+        y = x_or_origin[0][1]
+        w = x_or_origin[1][0]
+        h = x_or_origin[1][1]
+      elsif CGRect === x_or_origin
         x = x_or_origin.origin.x
         y = x_or_origin.origin.y
         w = x_or_origin.size.width

data/lib/sugarcube/defaults.rb

@@ -1,21 +1,15 @@
-
 class Symbol
 
   def get_default
     NSUserDefaults.standardUserDefaults.objectForKey(self)
   end
 
-  def remove_default
-    NSUserDefaults.standardUserDefaults.removeObjectForKey(self)
+  def set_default val
+    NSUserDefaults.standardUserDefaults.setObject(val, forKey:self)
   end
 
-end
-
-
-class Object
-
-  def save_to_default(key)
-    NSUserDefaults.standardUserDefaults.setObject(self, forKey:key)
+  def remove_default
+    NSUserDefaults.standardUserDefaults.removeObjectForKey(self)
   end
 
 end

data/lib/sugarcube/document.rb

@@ -1,6 +1,6 @@
 
 
-class String
+class NSString
 
   def document
     @docs ||= NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, true)[0]

data/lib/sugarcube/notifications.rb

@@ -1,6 +1,4 @@
-
-
-class String
+class NSString
 
   def post_notification(object=nil, user_info=nil)
     if user_info and not Hash === user_info

data/lib/sugarcube/string.rb

@@ -1,4 +1,4 @@
-class String
+class NSString
 
   def nsurl
     @url ||= NSURL.alloc.initWithString(self)

data/lib/sugarcube/uicolor.rb

@@ -1,5 +1,7 @@
 
 class UIColor
+  def uicolor ; self ; end
+
 
   def to_s
     alpha = self.alpha.to_s

data/lib/sugarcube/uifont.rb

@@ -0,0 +1,6 @@
+
+class UIFont
+  def uifont ; self ; end
+
+
+end

data/lib/sugarcube/uiimage.rb

@@ -1,6 +1,8 @@
 
 
 class UIImage
+  def uiimage ; self ; end
+
 
   def uicolor(alpha=nil)
     color = UIColor.colorWithPatternImage(self)

data/lib/sugarcube/uiview.rb

@@ -6,19 +6,49 @@ class UIView
     self.addSubview view
   end
 
-  # i like this idea, but view[0] = view doesn't *look* like an insertion,
-  # it lookes like a replacement... it should be written as
-  #     view[0] += sub_view
-  # or
-  #     view[0] << sub_view
-  # def []=(index, view)
-  #   self.insertSubview(view, atIndex:index)
-  # end
-
   def to_s
     "{#{self.class.name} @ x: #{self.frame.origin.x} y:#{self.frame.origin.y}, "\
                         "#{self.frame.size.width}×#{self.frame.size.height}}"\
                         "#{self.superview ? ' child of ' + self.superview.class.name : ''}"
   end
 
+  def fadeout(duration=0.3, options={}, &after)
+    UIView.animateWithDuration(duration,
+                         delay: options[:delay] || 0,
+                       options: options[:options] || UIViewAnimationOptionCurveLinear,
+                    animations: proc{
+                                  self.layer.opacity = options[:opacity] || 0
+                                }, completion:after
+                              )
+  end
+
+  def move_to(position, duration=0.3, options={}, &after)
+    UIView.animateWithDuration(duration,
+                         delay: options[:delay] || 0,
+                       options: options[:options] || UIViewAnimationOptionCurveLinear,
+                    animations: proc{
+                                  f = self.frame
+                                  f.origin = position
+                                  self.frame = position
+                                }, completion:after
+                              )
+  end
+
+  def delta_to(delta, duration=0.3, options={}, &after)
+    f = self.frame
+    delta = Point(delta)
+    position = Point(f.origin)
+    position.x += delta.x
+    position.y += delta.y
+    UIView.animateWithDuration(duration,
+                         delay: options[:delay] || 0,
+                       options: options[:options] || UIViewAnimationOptionCurveLinear,
+                    animations: proc{
+                                  f = self.frame
+                                  f.origin = position
+                                  self.frame = position
+                                }, completion:after
+                              )
+  end
+
 end

data/lib/sugarcube/version.rb

@@ -1,3 +1,3 @@
 module SugarCube
-  Version = '0.1.6'
+  Version = '0.2.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sugarcube
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -10,11 +10,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-07-11 00:00:00.000000000 Z
+date: 2012-07-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70156160598480 !ruby/object:Gem::Requirement
+  requirement: &70353599174140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -22,10 +22,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70156160598480
+  version_requirements: *70353599174140
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70156160597880 !ruby/object:Gem::Requirement
+  requirement: &70353599189900 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -33,7 +33,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70156160597880
+  version_requirements: *70353599189900
 description: ! 'CocoaTouch/iOS is a *verbose* framework.  These extensions hope to
   make
 
@@ -64,6 +64,7 @@ files:
 - README.md
 - Rakefile
 - lib/sugarcube.rb
+- lib/sugarcube/adjust.rb
 - lib/sugarcube/core_graphics.rb
 - lib/sugarcube/defaults.rb
 - lib/sugarcube/document.rb
@@ -76,6 +77,7 @@ files:
 - lib/sugarcube/symbol/symbol_uicolor.rb
 - lib/sugarcube/uicolor.rb
 - lib/sugarcube/uicontrol.rb
+- lib/sugarcube/uifont.rb
 - lib/sugarcube/uiimage.rb
 - lib/sugarcube/uiview.rb
 - lib/sugarcube/version.rb