sugarcube 0.13 → 0.13.2

data/README.md

@@ -141,6 +141,20 @@ decoder.int(key)
 decoder.point(key)
 decoder.rect(key)
 decoder.size(key)
+```
+
+NSData
+------
+
+Going to and from `NSData` is really useful when doing HTTP posts.
+
+```ruby
+string_data = 'String'.nsdata  # => default encoding is UTF8.
+image = 'an image'.uiimage
+image_data = image.nsdata  # PNG data representation
+
+string_data.nsstring  # => 'String'
+image_data.nsimage  # => whatever 'an image' was
 ```
 
  NSDate
@@ -294,6 +308,22 @@ The `delta` method is smart.
 # unfortunately you will, in the edge cases, end up with stuff like this:
 (main)> feb_28_2012 == feb_28_2012.delta(days:1, months:12).delta(months:-12)
 => true
+```
+
+NSError
+-------
+
+`NSError.new` was just a mess, so I made it a legal method.
+
+```ruby
+NSError.new('Error Message')  # code: 0, domain: 'Error'
+# with options
+NSError.new('Error Message', code: 404)
+
+# error messages ('Error Message' in this example) are stored in a Hash with the
+# key 'NSLocalizedDescriptionKey'. If you pass a `userInfo` option, it will get
+# merged with this array.  So you can ignore that ugly-looking key.
+NSError.new('Error Message', code: 404, userInfo: { warnings: ['blabla'] })
 ```
 
  NSURL
@@ -332,6 +362,7 @@ The `delta` method is smart.
 # file location
 "my.plist".exists?   # => NSFileManager.defaultManager.fileExistsAtPath("my.plist")
 "my.plist".document  # => NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, true)[0].stringByAppendingPathComponent("my.plist")
+"my.plist".remove!  # => NSFileManager.defaultManager.removeItemAtPath("my.plist".document, error: error)  (returns error, if any occurred)
 
 # NSURL
 "https://github.com".nsurl  # => NSURL.URLWithString("https://github.com")
@@ -486,6 +517,7 @@ UIActionSheet.alert 'I mean, is this cool?', buttons: ['Nah', 'With fire!', 'Sur
 ```ruby
 UIView.first_responder  # => returns the first responder, starting at UIApplication.sharedApplication.keyWindow
 my_view.first_responder  # => also returns the first responder, but starts looking in my_view
+my_view.controller  # => returns the UIViewController that this view belongs to
 self.view << subview  # => self.view.addSubview(subview)
 self.view.show  # => self.hidden = false
 self.view.hide  # => self.hidden = true
@@ -548,14 +580,21 @@ UIButton.contact_add       => UIButton.buttonWithType(:contact_add.uibuttontype)
 
 ###### UITableView
 
+Default frame is `[[0, 0], [0, 0]]`, but most containers will resize it to be
+the correct size.  But heads up, it *used* to be `[[0, 0], [320, 480]]` (until
+the iphone 5 / 4-inch retina came out).
+
 ```ruby
+UITableView.alloc.initWithFrame([[0, 0], [0, 0]], style: :plain.uitableviewstyle)
 UITableView.alloc.initWithFrame([[0, 0], [320, 480]], style: :plain.uitableviewstyle)
+UITableView.alloc.initWithFrame([[0, 0], [320, 568]], style: :plain.uitableviewstyle)
 # custom frame:
 UITableView.alloc.initWithFrame([[0, 0], [320, 400]], style: :grouped.uitableviewstyle)
 
 # =>
-
 UITableView.plain
+UITableView.plain([[0, 0], [320, 480]])
+UITableView.plain([[0, 0], [320, 568]])
 # custom frame:
 UITableView.grouped([[0, 0], [320, 400]])
 ```
@@ -744,6 +783,8 @@ end
 # other time-related methods
 # for compatibility with Time methods, the mins/secs (and min/sec) aliases are provided.  Personally,
 # I like the more verbose minutes/seconds.
+1.millisecond  || 2.milliseconds
+1.millisec     || 2.millisecs
 1.second  || 2.seconds
 1.sec     || 2.secs     # aliases
 1.minute  || 2.minutes  # 1.minute = 60 seconds
@@ -762,9 +803,22 @@ date1.today?
 date2.same_day? date1
 ```
 
- NSUserDefaults
+NSUserDefaults
 ----------------
 
+This file does *one* thing very **DANGEROUS**... to "help" with defaults.
+
+When storing `nil` into `NSUserDefaults`, it is converted into `false`, because
+Cocoa complains if you give it `nil`, and the RubyMotion runtime refuses to
+allow the `NSNull.null` object. Without relying on an external project (like
+[nsnulldammit]<https://github.com/colinta/nsnulldammit>) I don't know of a
+sensible workaround...
+
+If you want to "tap into" the defaults system that SugarCube uses, add a
+`to_nsuserdefaults` method an that will get called if you hand your object to
+`NSUserDefaults[]=`.  However, there's no way to get it *back* later, so the
+usefulness of this is very limited.
+
 ```ruby
 'key'.set_default(['any', 'objects'])  # => NSUserDefaults.standardUserDefaults.setObject(['any', 'objects'], forKey: :key)
 'key'.get_default  # => NSUserDefaults.standardUserDefaults.objectForKey(:key)

data/lib/sugarcube/calayer.rb

@@ -5,4 +5,4 @@ class CALayer
     return self
   end
 
-end
+end

data/lib/sugarcube/modal.rb

@@ -1,21 +1,22 @@
 module SugarCube
   module Modal
     module_function
-    def present_modal(view_ctlr, target=nil, &block)
-      target ||= UIApplication.sharedApplication.keyWindow.rootViewController
-      target.presentViewController(view_ctlr, animated:true, completion:block)
+    def present_modal(view_ctlr, options={}, &block)
+      target = options.fetch(:target, UIApplication.sharedApplication.keyWindow.rootViewController)
+      animated = options.fetch(:animated, true)
+      target.presentViewController(view_ctlr, animated:animated, completion:block)
     end
 
-    def present_modal_in_nav(view_ctlr, target=nil, &block)
+    def present_modal_in_nav(view_ctlr, options={}, &block)
       ctlr = UINavigationController.alloc.initWithRootViewController(view_ctlr)
       ctlr.modalTransitionStyle = UIModalTransitionStyleCoverVertical
 
-      SugarCube::Modal.present_modal(ctlr, target, &block)
+      SugarCube::Modal.present_modal(ctlr, options, &block)
       ctlr
     end
 
-    def dismiss_modal(target=nil, &block)
-      target ||= UIApplication.sharedApplication.keyWindow.rootViewController
+    def dismiss_modal(options={}, &block)
+      target = options.fetch(:target, UIApplication.sharedApplication.keyWindow.rootViewController)
       target.dismissViewControllerAnimated(true, completion:block)
     end
   end
@@ -24,16 +25,19 @@ end
 
 class UIViewController
 
-  def present_modal(view_ctlr, &block)
-    SugarCube::Modal.present_modal(view_ctlr, self, &block)
+  def present_modal(view_ctlr, options={}, &block)
+    options = options.merge(target: self)
+    super(view_ctlr, options, &block)
   end
 
-  def present_modal_in_nav(view_ctlr, &block)
-    SugarCube::Modal.present_modal_in_nav(view_ctlr, self, &block)
+  def present_modal_in_nav(view_ctlr, options={}, &block)
+    options = options.merge(target: self)
+    super(view_ctlr, options, &block)
   end
 
-  def dismiss_modal(view_ctlr, &block)
-    SugarCube::Modal.dismiss_modal(view_ctlr, self, &block)
+  def dismiss_modal(view_ctlr, options={}, &block)
+    options = options.merge(target: self)
+    super(view_ctlr, options, &block)
   end
 
 end

data/lib/sugarcube/symbol.rb

@@ -553,7 +553,7 @@ class Symbol
   def uiautoresizemask
     look_in(Symbol.autoresizemasks)
   end
-  alias uiviewautoresizing uiautoresize
+  alias uiviewautoresizing uiautoresizemask
   alias uiautoresizingmask uiautoresizemask
   alias uiautoresize uiautoresizemask
 

data/lib/sugarcube/uicolor.rb

@@ -1,6 +1,5 @@
 class UIColor
   def uicolor ; self ; end
-  alias cgcolor CGColor
 
   def red
     _sugarcube_colors[:red]

data/lib/sugarcube/uiview.rb

@@ -153,8 +153,11 @@ class UIView
       options = { duration: options }
     end
 
+    original_opacity = self.layer.opacity
+
     after_remove = proc {
       removeFromSuperview
+      self.layer.opacity = original_opacity
       after.call if after
     }
 

data/lib/sugarcube/version.rb

@@ -1,3 +1,3 @@
 module SugarCube
-  Version = '0.13'
+  Version = '0.13.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sugarcube
 version: !ruby/object:Gem::Version
-  version: '0.13'
+  version: 0.13.2
   prerelease: 
 platform: ruby
 authors:
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-12-27 00:00:00.000000000 Z
+date: 2012-12-28 00:00:00.000000000 Z
 dependencies: []
 description: ! '== Description