sugarcube 0.20.25 → 1.0.0

data/lib/sugarcube-pipes.rb

@@ -0,0 +1,15 @@
+unless defined?(Motion::Project::Config)
+  raise "The sugarcube gem must be required within a RubyMotion project Rakefile."
+end
+
+
+Motion::Project::App.setup do |app|
+  # scans app.files until it finds app/ (the default)
+  # if found, it inserts just before those files, otherwise it will insert to
+  # the end of the list
+  insert_point = app.files.find_index { |file| file =~ /^(?:\.\/)?app\// } || 0
+
+  Dir.glob(File.join(File.dirname(__FILE__), 'sugarcube-pipes/**/*.rb')).reverse.each do |file|
+    app.files.insert(insert_point, file)
+  end
+end

data/lib/sugarcube-pipes/pipes.rb

@@ -0,0 +1,78 @@
+class UIImage
+
+  # Operator shorthand for `apply_filter`, or coerces the image into other
+  # formats.
+  #
+  # @example
+  #   image = 'test'.uiimage
+  #   new_image = image | CIFilter.gaussian_blur  # => returns a CIImage
+  #   new_image = (image | CIFilter.gaussian_blur).uiimage  # => coerce to UIImage
+  #   new_image = image | CIFilter.gaussian_blur | UIImage  # => coerce to UIImage via chaining
+  def |(filter)
+    if CIFilter === filter
+      apply_filter(filter)
+    elsif filter == UIImage
+      self
+    elsif filter == UIView || filter == UIImageView
+      self.uiimageview
+    elsif filter == CIImage
+      ciimage
+    elsif filter == UIColor
+      uicolor
+    elsif filter == NSData
+      nsdata
+    else
+      raise "The `|` operator is not supported for the #{filter.is_a?(Class) ? filter.name : filter.class.name} class"
+    end
+  end
+
+end
+
+
+class UIView
+
+   # Applies a filter (to a UIImage representation) or coerces to another format
+   def |(filter)
+    if filter == UIImage
+      self.uiimage
+    else
+      raise "The `|` operator is not supported for the #{filter.is_a?(Class) ? filter.name : filter.class.name} class"
+    end
+   end
+
+end
+
+
+class CIImage
+
+  def |(filter)
+    if CIFilter === filter
+      apply_filter(filter)
+    elsif filter == UIImage
+      self.uiimage
+    elsif filter == UIView || filter == UIImageView
+      self.uiimage.uiimageview
+    elsif filter == CIImage
+      self
+    else
+      raise "The `|` operator is not supported for the #{filter.is_a?(Class) ? filter.name : filter.class.name} class"
+    end
+  end
+
+end
+
+
+class String
+
+  def |(filter)
+    if Regexp === filter
+      match = filter.match(self)
+      match && match[0]
+    elsif String === filter
+      self.index(filter) && filter
+    else
+      raise "The `|` operator is not supported for the #{filter.is_a?(Class) ? filter.name : filter.class.name} class"
+    end
+  end
+
+end

data/lib/sugarcube-pointer.rb

@@ -0,0 +1,15 @@
+unless defined?(Motion::Project::Config)
+  raise "The sugarcube gem must be required within a RubyMotion project Rakefile."
+end
+
+
+Motion::Project::App.setup do |app|
+  # scans app.files until it finds app/ (the default)
+  # if found, it inserts just before those files, otherwise it will insert to
+  # the end of the list
+  insert_point = app.files.find_index { |file| file =~ /^(?:\.\/)?app\// } || 0
+
+  Dir.glob(File.join(File.dirname(__FILE__), 'sugarcube-pointer/**/*.rb')).reverse.each do |file|
+    app.files.insert(insert_point, file)
+  end
+end

data/lib/sugarcube-pointer/nsarray.rb

@@ -0,0 +1,13 @@
+class NSArray
+
+  # @param type [Symbol] type A pointer type from the list at {http://www.rubymotion.com/developer-center/guides/runtime/ RubyMotion Pointers Reference#_pointers}
+  # @return [Pointer] A pointer to the array, of the specified type
+  def to_pointer(type)
+    ret = Pointer.new(type, self.length)
+    self.each_index do |i|
+      ret[i] = self[i]
+    end
+    ret
+  end
+
+end

data/lib/sugarcube-repl.rb

@@ -7,15 +7,7 @@ Motion::Project::App.setup do |app|
   # scans app.files until it finds app/ (the default)
   # if found, it inserts just before those files, otherwise it will insert to
   # the end of the list
-  insert_point = 0
-  app.files.each_index do |index|
-    file = app.files[index]
-    if file =~ /^(?:\.\/)?app\//
-      # found app/, so stop looking
-      break
-    end
-    insert_point = index + 1
-  end
+  insert_point = app.files.find_index { |file| file =~ /^(?:\.\/)?app\// } || 0
 
   Dir.glob(File.join(File.dirname(__FILE__), 'sugarcube-repl/**/*.rb')).reverse.each do |file|
     app.files.insert(insert_point, file)

data/lib/sugarcube-resources.rb

@@ -0,0 +1,15 @@
+unless defined?(Motion::Project::Config)
+  raise "The sugarcube gem must be required within a RubyMotion project Rakefile."
+end
+
+
+Motion::Project::App.setup do |app|
+  # scans app.files until it finds app/ (the default)
+  # if found, it inserts just before those files, otherwise it will insert to
+  # the end of the list
+  insert_point = app.files.find_index { |file| file =~ /^(?:\.\/)?app\// } || 0
+
+  Dir.glob(File.join(File.dirname(__FILE__), 'sugarcube-resources/**/*.rb')).reverse.each do |file|
+    app.files.insert(insert_point, file)
+  end
+end

data/lib/sugarcube-timer.rb

@@ -0,0 +1,15 @@
+unless defined?(Motion::Project::Config)
+  raise "The sugarcube gem must be required within a RubyMotion project Rakefile."
+end
+
+
+Motion::Project::App.setup do |app|
+  # scans app.files until it finds app/ (the default)
+  # if found, it inserts just before those files, otherwise it will insert to
+  # the end of the list
+  insert_point = app.files.find_index { |file| file =~ /^(?:\.\/)?app\// } || 0
+
+  Dir.glob(File.join(File.dirname(__FILE__), 'sugarcube-timer/**/*.rb')).reverse.each do |file|
+    app.files.insert(insert_point, file)
+  end
+end

data/lib/sugarcube-to_s.rb

@@ -0,0 +1,15 @@
+unless defined?(Motion::Project::Config)
+  raise "The sugarcube gem must be required within a RubyMotion project Rakefile."
+end
+
+
+Motion::Project::App.setup do |app|
+  # scans app.files until it finds app/ (the default)
+  # if found, it inserts just before those files, otherwise it will insert to
+  # the end of the list
+  insert_point = app.files.find_index { |file| file =~ /^(?:\.\/)?app\// } || 0
+
+  Dir.glob(File.join(File.dirname(__FILE__), 'sugarcube-to_s/**/*.rb')).reverse.each do |file|
+    app.files.insert(insert_point, file)
+  end
+end

data/lib/{sugarcube/to_s → sugarcube-to_s}/nserror.rb

@@ -1,8 +1,4 @@
 class NSError
-  def localized
-    localizedDescription
-  end
-  alias _ localized
 
   def to_s
     "#<#{self.class.name}:0x#{self.object_id.to_s(16)}, "+
@@ -10,4 +6,5 @@ class NSError
       "domain=#{domain.inspect}, userInfo=#{userInfo.inspect}"+
      ">"
   end
+
 end

data/lib/sugarcube-to_s/nsindexpath.rb

@@ -0,0 +1,7 @@
+class NSIndexPath
+
+  def to_s
+    "<NSIndexPath #{to_a.to_s}>"
+  end
+
+end

data/lib/sugarcube-uicolor.rb

@@ -0,0 +1 @@
+raise "I changed the 'sugarcube-\033[0;1muicolor\033[0m' package to 'sugarcube-\033[0;1mcolor\033[0m'."

data/lib/sugarcube-uifont.rb

@@ -0,0 +1,15 @@
+unless defined?(Motion::Project::Config)
+  raise "The sugarcube gem must be required within a RubyMotion project Rakefile."
+end
+
+
+Motion::Project::App.setup do |app|
+  # scans app.files until it finds app/ (the default)
+  # if found, it inserts just before those files, otherwise it will insert to
+  # the end of the list
+  insert_point = app.files.find_index { |file| file =~ /^(?:\.\/)?app\// } || 0
+
+  Dir.glob(File.join(File.dirname(__FILE__), 'sugarcube-uifont/**/*.rb')).reverse.each do |file|
+    app.files.insert(insert_point, file)
+  end
+end

data/lib/sugarcube-uiimage.rb

@@ -0,0 +1 @@
+raise "I changed the 'sugarcube-\033[0;1muiimage\033[0m' package to 'sugarcube-\033[0;1mimage\033[0m'."

data/lib/sugarcube-uikit.rb

@@ -0,0 +1,15 @@
+unless defined?(Motion::Project::Config)
+  raise "The sugarcube gem must be required within a RubyMotion project Rakefile."
+end
+
+
+Motion::Project::App.setup do |app|
+  # scans app.files until it finds app/ (the default)
+  # if found, it inserts just before those files, otherwise it will insert to
+  # the end of the list
+  insert_point = app.files.find_index { |file| file =~ /^(?:\.\/)?app\// } || 0
+
+  Dir.glob(File.join(File.dirname(__FILE__), 'sugarcube-uikit/**/*.rb')).reverse.each do |file|
+    app.files.insert(insert_point, file)
+  end
+end

data/lib/sugarcube-uikit/nsattributedstring.rb

@@ -0,0 +1,12 @@
+class NSAttributedString
+
+  # @return [UILabel]
+  def uilabel
+    UILabel.alloc.initWithFrame([[0, 0], [0, 0]]).tap do |label|
+      label.attributedText = self
+      label.backgroundColor = :clear.uicolor
+      label.sizeToFit
+    end
+  end
+
+end

data/lib/sugarcube-uikit/nsstring.rb

@@ -0,0 +1,38 @@
+class NSString
+
+  # @return [UIImage]
+  def uiimage
+    UIImage.imageNamed(self).tap do |retval|
+      NSLog("No image named #{self}") unless retval
+    end
+  end
+
+  # @return [UIFont]
+  def uifont(size=nil)
+    size ||= UIFont.systemFontSize
+    UIFont.fontWithName(self, size:size)
+  end
+
+  # @param font [UIFont] Optional, defaults to UIFont.systemFontOfSize(UIFont.systemFontSize)
+  # @return [UILabel]
+  def uilabel(font=nil)
+    font ||= :system.uifont(UIFont.labelFontSize)
+    size = self.sizeWithFont(font)
+    UILabel.alloc.initWithFrame([[0, 0], size]).tap { |label|
+      label.text = self
+      label.font = font
+      # why isn't this just the default!?
+      label.backgroundColor = :clear.uicolor
+    }
+  end
+
+  # @return [UIImageView]
+  def uiimageview
+    image = UIImage.imageNamed(self)
+    unless image
+      NSLog("No image named #{self}")
+    end
+    UIImageView.alloc.initWithImage(image)
+  end
+
+end

data/lib/sugarcube-uikit/symbol.rb

@@ -0,0 +1,67 @@
+=begin
+Example:
+
+    # fonts
+    :system.uifont => UIFont.systemFontOfSize(UIFont.systemFontSize)
+    :label.uifont => UIFont.systemFontOfSize(UIFont.labelFontSize)
+
+You can extend the defaults by adding entries:
+
+    Symbol.uifontsize[:big] = 40
+
+    :big.uifont => UIFont
+
+=end
+class Symbol
+
+  def uifont(size=nil)
+    size ||= UIFont.systemFontSize
+    # system fonts
+    if Symbol.uifont.has_key? self
+      font = SugarCube.look_in(self, Symbol.uifont)
+      if size.is_a?(Symbol)
+        size = size.uifontsize
+      end
+
+      if font.is_a?(Symbol)
+        return UIFont.send(font, size)
+      else
+        return font.uifont(size)
+      end
+    else
+      if size.is_a?(Symbol)
+          size = size.uifontsize
+      end
+      return UIFont.systemFontOfSize(size)
+    end
+  end
+
+  def uifontsize
+    size = SugarCube.look_in(self, Symbol.uifontsize)
+    if size.is_a?(Symbol)
+      return UIFont.send(size)
+    end
+    return size.to_f
+  end
+
+  class << self
+    attr :uifont
+    attr :uifontsize
+  end
+
+  @uifont = {
+    system: :"systemFontOfSize:",
+    bold:   :"boldSystemFontOfSize:",
+    italic: :"italicSystemFontOfSize:",
+    monospace: 'Courier New',
+  }
+
+  @uifontsize = {
+    label:  :labelFontSize,
+    button: :buttonFontSize,
+    small:  :smallSystemFontSize,
+    system: :systemFontSize,
+  }
+
+
+end

data/lib/{sugarcube → sugarcube-uikit}/uifont.rb

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

data/lib/sugarcube-uikit/uiimage.rb

@@ -0,0 +1,9 @@
+class UIImage
+  def uiimage ; self ; end
+
+  # @return [UIImageView]
+  def uiimageview
+    UIImageView.alloc.initWithImage(self)
+  end
+
+end

data/lib/sugarcube-uikit/uiview.rb

@@ -0,0 +1,100 @@
+class UIView
+
+  class << self
+
+    # returns the first responder, starting at the Window and searching every subview
+    def first_responder
+      UIApplication.sharedApplication.keyWindow.first_responder
+    end
+
+    def attr_updates(*attrs)
+      attr_accessor(*attrs)
+      attrs.each do |attr|
+        define_method("#{attr}=") { |value|
+          if instance_variable_get("@#{attr}") != value
+            setNeedsDisplay
+          end
+          instance_variable_set("@#{attr}", value)
+        }
+      end
+    end
+
+  end
+
+  # superview << view
+  # => superview.addSubview(view)
+  def <<(view)
+    self.addSubview(view)
+    return self
+  end
+
+  def unshift(view)
+    self.insertSubview(view, atIndex:0)
+    return self
+  end
+
+  # returns the first responder, or nil if it cannot be found
+  def first_responder
+    if self.firstResponder?
+      return self
+    end
+
+    found = nil
+    self.subviews.each do |subview|
+      found = subview.first_responder
+      break if found
+    end
+
+    return found
+  end
+
+  # returns the nearest nextResponder instance that is a UIViewController. Goes
+  # up the responder chain until the nextResponder is a UIViewController
+  # subclass, or returns nil if none is found.
+  def controller
+    if nextResponder && nextResponder.is_a?(UIViewController)
+      nextResponder
+    elsif nextResponder
+      nextResponder.controller
+    else
+      nil
+    end
+  end
+
+   # Easily take a snapshot of a `UIView`.
+   #
+   # Calling `uiimage` with no arguments will return the image based on the
+   # `bounds` of the image.  In the case of container views (notably
+   # `UIScrollView` and its children) this does not include the entire contents,
+   # which is something you probably want.
+   #
+   # If you pass a truthy value to this method, it will use the `contentSize` of
+   # the view instead of the `bounds`, and it will draw all the child views, not
+   # just those that are visible in the viewport.
+   #
+   # It is guaranteed that `true` and `:all` will always have this behavior.  In
+   # the future, if this argument becomes something that accepts multiple values,
+   # those two are sacred.
+  def uiimage(use_content_size=false)
+     scale = UIScreen.mainScreen.scale
+     if use_content_size
+       UIGraphicsBeginImageContextWithOptions(contentSize, false, scale)
+       context = UIGraphicsGetCurrentContext()
+       subviews.each do |subview|
+         CGContextSaveGState(context)
+         CGContextTranslateCTM(context, subview.frame.origin.x, subview.frame.origin.y)
+         subview.layer.renderInContext(context)
+         CGContextRestoreGState(context)
+       end
+       image = UIGraphicsGetImageFromCurrentImageContext()
+       UIGraphicsEndImageContext()
+     else
+       UIGraphicsBeginImageContextWithOptions(bounds.size, false, scale)
+       layer.renderInContext(UIGraphicsGetCurrentContext())
+       image = UIGraphicsGetImageFromCurrentImageContext()
+       UIGraphicsEndImageContext()
+     end
+     return image
+   end
+
+end