sugarcube 0.1.4 → 0.1.5

data/README.md

@@ -15,7 +15,23 @@ Some UI classes are opened up as well, like adding the '<<' operator to a UIView
 instance, instead of view.addSubview(subview), you can use the more idiomatic:
 view << subview.
 
-examples
+The basic idea of sugarcube is to turn some operations on their head.  Insead of
+
+    NSUIApplication.sharedApplication.openURL(NSUrl.URLWithString(url))
+
+How about:
+
+    url.nsurl.open
+
+**DISCLAIMER**
+
+It is possible that you *will not like sugarcube*.  That is perfectly fine!
+Some people take milk in their coffee, some take sugar.  Some crazy maniacs
+don't even *drink* coffee, if you can imagine that... All I'm saying is: to each
+their own.  You should checkout [BubbleWrap][] for another take on
+Cocoa-wrappage.
+
+Examples
 ========
 
  Fixnum
@@ -38,6 +54,26 @@ 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
+-------
+
+```ruby
+# see String for easy URL creation
+"https://github.com".nsurl.open  # => UIApplication.sharedApplication.openURL(NSURL.URLWithString("https://github.com"))
 ```
 
  String
@@ -62,7 +98,15 @@ examples
 
 # NSLocalizedString from string
 "hello".localized  # => NSBundle.mainBundle.localizedStringForKey("hello", value:nil, table:nil)
+"hello"._          # == "hello".localized
 "hello".localized('Hello!', 'hello_table')  # => ...("hello", value:'Hello!', table:'hello_table')
+
+# file location
+"my.plist".exists?   # => NSFileManager.defaultManager.fileExistsAtPath("my.plist")
+"my.plist".document  # => NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, true)[0].stringByAppendingPathComponent("my.plist")
+
+# NSURL
+"https://github.com".nsurl  # => NSURL.URLWithString("https://github.com")
 ```
 
  Symbol
@@ -106,8 +150,8 @@ self.view << subview  # => self.view.addSubview(subview)
  UIControl
 -----------
 
-Inspired by BubbleWrap's `when` method, but I prefer jQuery-style verbs and
-sugarcube symbols.
+Inspired by [BubbleWrap's][BubbleWrap] `when` method, but I prefer jQuery-style
+verbs and sugarcube symbols.
 
 ```ruby
 button = UIButton.alloc.initWithFrame([0, 0, 10, 10])
@@ -125,3 +169,5 @@ 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.
+
+[BubbleWrap]: https://github.com/rubymotion/BubbleWrap

data/lib/sugarcube/document.rb

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

data/lib/sugarcube/notifications.rb

@@ -0,0 +1,33 @@
+=begin
+"my notification".observe(obj, :notified)
+  # => NSNotificationCenter.defaultCenter.addObserver(obj, selector::'notified:', name:"my notification", object: nil)
+"my notification".observe(obj) { |notification| puts notification }
+  # => NSNotificationCenter.defaultCenter.addObserver(obj, selector::'__sugarcube_notified__:', name:"my notification", object: Proc.new { |notification| puts notification })
+"my notification".observe { |notification| puts notification }
+  # => NSNotificationCenter.defaultCenter.addObserverForName("my notification", object: nil, queue:NSOperationQueue.mainQueue, usingBlock:{ |notification| puts notification })
+
+"my notification".removeObserver(obj)
+  # => NSNotificationCenter.defaultCenter.removeObserver(object, name:"my notification", object: nil)
+"my notification".removeObserver(obj, obj2)
+  # => NSNotificationCenter.defaultCenter.removeObserver(object, name:"my notification", object: obj2)
+=end
+
+class String
+
+  def post_notification(object=nil, user_info=nil)
+    if user_info and not Hash === user_info
+      raise TypeError("Invalid argument #{user_info.class.name} sent to String.post_notification")
+    end
+
+    if user_info
+      NSNotificationCenter.defaultCenter.postNotificationName(self, object:object, userInfo:user_info)
+    else
+      NSNotificationCenter.defaultCenter.postNotificationName(self, object:object)
+    end
+  end
+
+end
+
+
+class Object
+end

data/lib/sugarcube/string.rb

@@ -1,11 +1,15 @@
 class String
 
+  def nsurl
+    @url ||= NSURL.alloc.initWithString(self)
+  end
+
   def uiimage
-    UIImage.imageNamed(self)
+    @uiimage = UIImage.imageNamed(self)
   end
 
   def uifont(size=UIFont.systemFontSize)
-    UIFont.fontWithName(self, size:size)
+    @uifont = UIFont.fontWithName(self, size:size)
   end
 
   def uicolor(alpha=nil)
@@ -28,7 +32,7 @@ class String
   # This can be called as `"Hello".localized` or `"Hello"._`.  The `str._`
   # syntax is meant to be reminiscent of gettext-style `_(str)`.
   def localized(value=nil, table=nil)
-    NSBundle.mainBundle.localizedStringForKey(self, value:value, table:table)
+    @localized = NSBundle.mainBundle.localizedStringForKey(self, value:value, table:table)
   end
   alias :_ :localized
 

data/lib/sugarcube/version.rb

@@ -1,3 +1,3 @@
 module SugarCube
-  Version = '0.1.4'
+  Version = '0.1.5'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sugarcube
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
   prerelease: 
 platform: ruby
 authors:
@@ -10,11 +10,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-07-10 00:00:00.000000000 Z
+date: 2012-07-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &70177756873200 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -22,15 +22,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *70177756873200
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: !ruby/object:Gem::Requirement
+  requirement: &70177756872620 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -38,12 +33,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+  version_requirements: *70177756872620
 description: ! 'CocoaTouch/iOS is a *verbose* framework.  These extensions hope to
   make
 
@@ -75,9 +65,11 @@ files:
 - Rakefile
 - lib/sugarcube.rb
 - lib/sugarcube/core_graphics.rb
+- lib/sugarcube/document.rb
 - lib/sugarcube/exceptions.rb
 - lib/sugarcube/fixnum.rb
 - lib/sugarcube/float.rb
+- lib/sugarcube/notifications.rb
 - lib/sugarcube/string.rb
 - lib/sugarcube/symbol.rb
 - lib/sugarcube/symbol/symbol_uicolor.rb
@@ -107,7 +99,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.19
+rubygems_version: 1.8.11
 signing_key: 
 specification_version: 3
 summary: Extensions for Ruby to make Rubymotion development more enjoyable, and hopefully