sugarcube 0.20.25 → 1.0.0

data/lib/sugarcube-localized.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-localized/**/*.rb')).reverse.each do |file|
+    app.files.insert(insert_point, file)
+  end
+end

data/lib/sugarcube-localized/nserror.rb

@@ -0,0 +1,8 @@
+class NSError
+
+  def localized
+    localizedDescription
+  end
+  alias _ localized
+
+end

data/lib/sugarcube-localized/nsstring.rb

@@ -0,0 +1,10 @@
+class NSString
+
+  # 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)
+    @localized = NSBundle.mainBundle.localizedStringForKey(self, value:value, table:table)
+  end
+  alias _ localized
+
+end

data/lib/sugarcube-modal.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-modal/**/*.rb')).reverse.each do |file|
+    app.files.insert(insert_point, file)
+  end
+end

data/lib/sugarcube-notifications.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-notifications/**/*.rb')).reverse.each do |file|
+    app.files.insert(insert_point, file)
+  end
+end

data/lib/sugarcube-nscoder.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-nscoder/**/*.rb')).reverse.each do |file|
+    app.files.insert(insert_point, file)
+  end
+end

data/lib/sugarcube-nsdata.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-nsdata/**/*.rb')).reverse.each do |file|
+    app.files.insert(insert_point, file)
+  end
+end

data/lib/sugarcube-nsdata/nsstring.rb

@@ -0,0 +1,9 @@
+class NSString
+
+  # @return [NSData] NSData representation encoded using UTF8, or a specified
+  #   encoding
+  def nsdata(encoding=NSUTF8StringEncoding)
+    dataUsingEncoding(encoding)
+  end
+
+end

data/lib/sugarcube-nsdata/nsurl.rb

@@ -0,0 +1,7 @@
+class NSURL
+
+  def nsdata
+    NSData.dataWithContentsOfURL(self)
+  end
+
+end

data/lib/sugarcube-nsdata/uiimage.rb

@@ -0,0 +1,8 @@
+class UIImage
+
+  # @return [NSData] an NSData object in PNG format
+  def nsdata
+    UIImagePNGRepresentation(self)
+  end
+
+end

data/lib/sugarcube-nsdate.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-nsdate/**/*.rb')).reverse.each do |file|
+    app.files.insert(insert_point, file)
+  end
+end

data/lib/sugarcube-nsdate/fixnum.rb

@@ -0,0 +1,23 @@
+class Fixnum
+
+  def nstimezone
+    NSTimeZone.timeZoneForSecondsFromGMT(self)
+  end
+
+  def before(date)
+    date - self
+  end
+
+  def ago
+    self.before(NSDate.new)
+  end
+
+  def after(date)
+    date + self
+  end
+
+  def hence
+    self.after(NSDate.new)
+  end
+
+end

data/lib/{sugarcube → sugarcube-nsdate}/nsdate.rb

@@ -17,6 +17,11 @@ class NSDate
     return calendar.dateFromComponents(date_components)
   end
 
+  # Time.now is defined, but not NSDate.now.
+  def self.now
+    NSDate.new
+  end
+
   def self.today
     NSDate.new.start_of_day
   end
@@ -44,7 +49,7 @@ class NSDate
   # See
   # <https://developer.apple.com/library/mac/#documentation/Cocoa/Conceptual/DataFormatting/Articles/dfDateFormatting10_4.html#//apple_ref/doc/uid/TP40002369-SW1>
   # and
-  # <http://www.unicode.org/reports/tr35/tr35-19.html#Date_Format_Patterns>
+  # <http://www.unicode.org/reports/tr35/tr35-19.html#Date_Field_Symbol_Table>
   # for more information about date format strings.
   def string_with_format(format)
     if format.is_a?(Symbol)

data/lib/sugarcube-nsdate/nsstring.rb

@@ -0,0 +1,16 @@
+class NSString
+
+  def nstimezone
+    case self
+    when /([+-]?\d{4})/
+      sec = $1[-4,2].to_i * 3600
+      NSTimeZone.timeZoneForSecondsFromGMT(sec)
+    when /(GMT|UTC)([+-]\d{1,2})?/
+      sec = $2 ? $2.to_i * 3600 : 0
+      NSTimeZone.timeZoneForSecondsFromGMT(sec)
+    else
+      NSTimeZone.timeZoneWithName(self)
+    end
+  end
+
+end

data/lib/sugarcube-nsuserdefaults.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-nsuserdefaults/**/*.rb')).reverse.each do |file|
+    app.files.insert(insert_point, file)
+  end
+end

data/lib/sugarcube-numbers.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-numbers/**/*.rb')).reverse.each do |file|
+    app.files.insert(insert_point, file)
+  end
+end

data/lib/sugarcube-numbers/fixnum.rb

@@ -0,0 +1,25 @@
+class Fixnum
+
+  def nth
+    # if the first two digits of rank are between 11 and 20, it's an
+    # 'up-teenth' kinda number
+    modulo_100 = self % 100
+    if modulo_100 < 10 || modulo_100 > 20
+      case self % 10
+      when 1
+        return "st"
+      when 2
+        return "nd"
+      when 3
+        return "rd"
+      end
+    end
+
+    return "th"
+  end
+
+  def ordinalize
+    return "#{self}#{nth}"
+  end
+
+end

data/lib/sugarcube-numbers/nsstring.rb

@@ -0,0 +1,13 @@
+class NSString
+
+  # @return boolean
+  def nan?
+    self.to_number.nil?
+  end
+
+  def to_number
+    number_formatter = NSNumberFormatter.new
+    number_formatter.numberFromString(self)
+  end
+
+end

data/lib/{sugarcube → sugarcube-numbers}/numeric.rb

@@ -1,9 +1,21 @@
 class Numeric
 
+  ##|
+  ##|  MISC
+  ##|
+
   def percent
     self / 100.0
   end
 
+  def g
+    self * 9.78033
+  end
+
+  def in_g
+    self / 9.78033
+  end
+
   def radians
     self
   end
@@ -36,7 +48,7 @@ class Numeric
   end
 
   def kilometers
-    self * 1000.0
+    self * 1000.0  # 1000 m / km
   end
   alias kilometer kilometers
 
@@ -45,7 +57,7 @@ class Numeric
   end
 
   def miles
-    self * 1609.344
+    self * 1609.344  # 1609.344 m / mi
   end
   alias mile miles
 
@@ -54,7 +66,7 @@ class Numeric
   end
 
   def feet
-    self / 3.28084
+    self / 3.28084  # 3.28084 m / ft
   end
   alias foot feet
 
@@ -97,8 +109,36 @@ class Numeric
   end
   alias exabyte exabytes
 
+  def in_bytes
+    self
+  end
+
+  def in_kilobytes
+    self / 1024**1
+  end
+
+  def in_megabytes
+    self / 1024**2
+  end
+
+  def in_gigabytes
+    self / 1024**3
+  end
+
+  def in_terabytes
+    self / 1024**4
+  end
+
+  def in_petabytes
+    self / 1024**5
+  end
+
+  def in_exabytes
+    self / 1024**6
+  end
+
   def string_with_style(style=NSNumberFormatterDecimalStyle)
-    if style.is_a? Symbol
+    if style.respond_to?(:nsnumberstyle)
       style = style.nsnumberstyle
     end
     NSNumberFormatter.localizedStringFromNumber(self, numberStyle:style)

data/lib/sugarcube-osx/adjust.rb

@@ -0,0 +1,373 @@
+$sugarcube_view = nil
+$sugarcube_items = nil
+$sugarcube_restore = nil
+
+module SugarCube
+  module Adjust
+    module_function
+
+    def repl_format(format=nil)
+      if format
+        @@repl_format = format
+      else
+        # if adjust has not been called, the instance variable has not yet been set
+        @@repl_format ||= :ruby
+      end
+      @@repl_format
+    end
+
+    def adjust(view=nil, format=nil)
+      SugarCube::Adjust::repl_format(format.to_sym) if format
+      return $sugarcube_view if not view
+
+      if view.is_a? Fixnum
+        window = NSApplication.sharedApplication.keyWindow
+        window ||= NSApplication.sharedApplication.mainWindow
+        window ||= NSApplication.sharedApplication.windows[0]
+        $sugarcube_items ||= SugarCube::Adjust::build_tree(window, :subviews)
+        view = $sugarcube_items[view]
+      end
+
+      # a/adjust will return this object
+      $sugarcube_view = view
+
+      if view.is_a?(NSView)
+        $sugarcube_restore = {
+          frame: SugarCube::Adjust.frame,
+        }
+
+        if format
+          puts format_frame view.frame
+        end
+      end
+
+      view
+    end
+    alias a adjust
+
+    ##|  FRAME
+    def frame f=nil
+      raise "no view has been assigned to SugarCube::Adjust::adjust" unless $sugarcube_view
+
+      return $sugarcube_view.frame if not f
+
+      f = SugarCube::CoreGraphics::Rect(f)
+      $sugarcube_view.frame = f
+      puts format_frame(f)
+
+      $sugarcube_view
+    end
+    alias f frame
+
+    ##|  ORIGIN
+    def left val=1
+      SugarCube::Adjust::right -val
+    end
+    alias l left
+
+    def right val=1
+      raise "no view has been assigned to SugarCube::Adjust::adjust" unless $sugarcube_view
+
+      f = $sugarcube_view.frame
+      f.origin.x += val
+      $sugarcube_view.frame = f
+      puts format_frame(f)
+
+      $sugarcube_view
+    end
+    alias r right
+
+    def up val=1
+      SugarCube::Adjust::down -val
+    end
+    alias u up
+
+    def down val=1
+      raise "no view has been assigned to SugarCube::Adjust::adjust" unless $sugarcube_view
+
+      f = $sugarcube_view.frame
+      f.origin.y += val
+      $sugarcube_view.frame = f
+      puts format_frame(f)
+
+      $sugarcube_view
+    end
+    alias d down
+
+    def origin x=nil, y=nil
+      raise "no view has been assigned to SugarCube::Adjust::adjust" unless $sugarcube_view
+
+      f = $sugarcube_view.frame
+      return f.origin if not x
+
+      if y
+        f.origin.x = x
+        f.origin.y = y
+      else
+        f.origin = SugarCube::CoreGraphics::Point(x)
+      end
+      $sugarcube_view.frame = f
+      puts format_frame(f)
+
+      $sugarcube_view
+    end
+    alias o origin
+
+    ##|  SIZE
+    def thinner val=1
+      SugarCube::Adjust::wider -val
+    end
+    alias n thinner
+
+    def wider val=1
+      raise "no view has been assigned to SugarCube::Adjust::adjust" unless $sugarcube_view
+
+      f = $sugarcube_view.frame
+      f.size.width += val
+      $sugarcube_view.frame = f
+      puts format_frame(f)
+
+      $sugarcube_view
+    end
+    alias w wider
+
+    def shorter val=1
+      SugarCube::Adjust::taller -val
+    end
+    alias s shorter
+
+    def taller val=1
+      raise "no view has been assigned to SugarCube::Adjust::adjust" unless $sugarcube_view
+
+      f = $sugarcube_view.frame
+      f.size.height += val
+      $sugarcube_view.frame = f
+      puts format_frame(f)
+
+      $sugarcube_view
+    end
+    alias t taller
+
+    def size w=nil, h=nil
+      raise "no view has been assigned to SugarCube::Adjust::adjust" unless $sugarcube_view
+
+      f = $sugarcube_view.frame
+      return f.size if not w
+
+      if h
+        f.size.width = w
+        f.size.height = h
+      else
+        f.size = SugarCube::CoreGraphics::Size(w)
+      end
+      $sugarcube_view.frame = f
+      puts format_frame(f)
+
+      $sugarcube_view
+    end
+    alias z size
+
+    def center(*args)
+      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
+
+    # @param item this can be a tree-like item (UIView, UIViewController,
+    #     CALayer) or an integer, in which case it will select that window from
+    #     UIApplication.sharedApplication.window.  Defalt is to display the
+    #     keyWindow
+    # @param selector If you pass an unsupported object to tree, you will need
+    #     to pass a selector as well - this method should return an array of
+    #     items which are passed recursively to tree
+    # @block sel_blk If a block is passed, it will be used to build the array of
+    #     items that are called recursively
+    def tree(item=nil, selector=nil, &sel_blk)
+      if item.is_a?(Fixnum)
+        item = NSApplication.sharedApplication.windows[item]
+      elsif ! item
+        item = NSApplication.sharedApplication.keyWindow || NSApplication.sharedApplication.mainWindow || NSApplication.sharedApplication.windows[0]
+      end
+      unless item
+        puts 'View is nil (no window, view, or controller to display)'
+        return
+      end
+
+      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? NSView
+          selector = :subviews
+        elsif item.is_a? NSWindow
+          item = item.contentView
+          selector = :subviews
+        elsif item.is_a? NSViewController
+          selector = lambda { |ctlr|
+                      ret = Array.new ctlr.childViewControllers
+                      if ctlr.presentedViewController && ctlr.presentedViewController.presentingViewController == ctlr
+                        ret << ctlr.presentedViewController
+                      end
+                      ret
+                    }
+        elsif item.is_a? CALayer
+          selector = :sublayers
+        else
+          raise "Unable to determine a SugarCube::Adjust::tree selector for #{item.class.name}"
+        end
+      end
+
+      $sugarcube_items = SugarCube::Adjust::build_tree(item, selector)
+      if self.respond_to? :draw_tree
+        draw_tree(item, selector)
+      else
+        SugarCube::Adjust::draw_tree(item, selector)
+      end
+      puts ''
+
+      return item
+    end
+
+    # Draws the tree items
+    def draw_tree(item, selector, tab=nil, is_last=true, items_index=0)
+      space = ' '
+      if items_index < 10
+        print '  '
+      elsif items_index < 100
+        print ' '
+      elsif items_index > 999  # good god, man!
+        space = ''
+      end
+      print items_index.to_s + ":" + space
+
+      if tab
+        print tab
+        if is_last
+          print '`-- '
+          tab += '    '
+        else
+          print '+-- '
+          tab += '|   '
+        end
+      else
+        print '. '
+        tab = ''
+      end
+
+      if self == item || $sugarcube_view == item
+        print "\033[1m"
+      end
+      if item.is_a? NSView
+        puts "#{item} frame: [[#{item.frame.origin.x}, #{item.frame.origin.y}], [#{item.frame.size.width}, #{item.frame.size.height}]]"
+      else
+        puts item.to_s
+      end
+      if self == item || $sugarcube_view == item
+        print "\033[0m"
+      end
+
+      if selector.is_a? Proc
+        items = selector.call(item)
+      else
+        items = item.send(selector)
+      end
+      items ||= []
+
+      items.each_with_index { |subview, index|
+        items_index += 1
+        if self.respond_to? :draw_tree
+          items_index = draw_tree(subview, selector, tab, index == items.length - 1, items_index)
+        else
+          items_index = SugarCube::Adjust::draw_tree(subview, selector, tab, index == items.length - 1, items_index)
+        end
+      }
+
+      return items_index
+    end
+
+    def build_tree(item, selector)
+      if selector.is_a? Proc
+        items = selector.call(item)
+      else
+        items = item.send(selector)
+      end
+      items ||= []
+
+      ret = [item]
+      items.each_with_index { |subview, index|
+        ret.concat SugarCube::Adjust::build_tree(subview, selector)
+      }
+      ret
+    end
+
+    def root
+      (NSApplication.sharedApplication.keyWindow || NSApplication.sharedApplication.windows[0]).windowController
+    end
+
+    ##|  RESTORE
+    def restore
+      raise 'no view has been assigned to SugarCube::Adjust::adjust' unless $sugarcube_view
+
+      $sugarcube_restore.each do |msg, value|
+        SugarCube::Adjust.send(msg, value)
+      end
+    end
+
+    def format_frame(frame)
+      case SugarCube::Adjust::repl_format
+        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 :objc
+          frame.to_s
+        else
+          raise "Unknown repl_format #{SugarCube::Adjust::repl_format.inspect}"
+      end
+    end
+  end
+end