bubble-wrap 1.1.5 → 1.2.0.pre

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    OWEyMmJlN2FlMjdkMmQyZDRjNjVlZmVhMGJhZGVlNjUzODYyODg5MA==
+  data.tar.gz: !binary |-
+    MTYxYTA5NTgyMWExMTk5NDIwNGY4MGEyNWVkNzFiYjViNGFmNzZhZg==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    MjFiMzNlOTdhOWY4YzVjYTg1NzM5MjlhOTQzNjVhNjhkMWJmYzY3N2M3Yzkw
+    N2M0YzZiM2U2NGFhOTYyOWE0MmNkNTJiYzRiNjQ2ODZiOGYzNmEwNDM2MTAz
+    YTYxZDM5ZWJlNzIyNjY2N2ExYTU2MjBhODgwZWM4ZDQxZDhkMjE=
+  data.tar.gz: !binary |-
+    MjhlNDQ5YWU0MGRkODQ1Zjc3YmIyZGU4YmYyOGIzOTUyNmI1MmViZDI3NWUw
+    ZGUzM2Y3MzNkMTcyZGY3ZWYzNzkwMzdkNWVkOTg0Y2IyM2UwMzMxMGU2YzMy
+    ZTkzZjgwYzZkY2U1NGFlYTcwODI0ZTk0YTk1MDY4MTM4YWY0Y2M=

data/.travis.yml

@@ -0,0 +1,2 @@
+language: objective-c
+before_install: ruby --version

data/CHANGELOG.md

@@ -1,6 +1,30 @@
 ## Unreleased
 
-[Commit history](https://github.com/rubymotion/BubbleWrap/compare/v1.1.4...master)
+## 1.2.0.pre
+
+[Commit history](https://github.com/rubymotion/BubbleWrap/compare/v1.2...master)
+
+* Added `BW::UIBarButtonItem`, a factory-esque wrapper for `UIBarButtonItem` ([#202](https://github.com/rubymotion/BubbleWrap/pull/202))
+* Added `BW::Font`, a wrapper for creating `UIFont` objects ([#206](https://github.com/rubymotion/BubbleWrap/pull/206))
+* Added `BW::Reactor::Eventable#off`, to remove `BW::Reactor` callbacks ([#205](https://github.com/rubymotion/BubbleWrap/pull/205))
+* Added `BW::Constants.get`, which is a class to help wrapper creation ([#203](https://github.com/rubymotion/BubbleWrap/pull/203))
+* Added `BW::Location.get_once` to grab only one location ([#197](https://github.com/rubymotion/BubbleWrap/pull/197))
+* Added `App#environment`, to detect the current RubyMotion environment ([#191](https://github.com/rubymotion/BubbleWrap/pull/191))
+* Added `:follow_urls` option to `BW::HTTP` ([#192](https://github.com/rubymotion/BubbleWrap/pull/192))
+* Added `:common_modes` option to `BW::Reactor`to change the runloop mode (#190)
+* Added `:no_redirect` option to `BW::HTTP` ([#187](https://github.com/rubymotion/BubbleWrap/pull/187))
+* Added `:cookies` option to `BW::HTTP` ([#204](https://github.com/rubymotion/BubbleWrap/pull/204))
+
+## 1.1.5
+
+[Commit history](https://github.com/rubymotion/BubbleWrap/compare/v1.1.4...v1.1.5)
+
+* Fix `BW::Camera` view-controller selection process to pickup a window's `presentedViewController` ([#183](https://github.com/rubymotion/BubbleWrap/pull/183))
+* Fix strings parsed in `BW::JSON` to be mutable ([#175](https://github.com/rubymotion/BubbleWrap/pull/175))
+* Add option for `:credential_persistence`/`NSURLCredentialPersistence` in `BW::HTTP` ([#166](https://github.com/rubymotion/BubbleWrap/pull/166))
+* Change `Device.wide_screen?` to `Device.long_screen?` ([#159](https://github.com/rubymotion/BubbleWrap/pull/159))
+* String escaping fixes to `BW::HTTP` ([#160](https://github.com/rubymotion/BubbleWrap/pull/160) [#161](https://github.com/rubymotion/BubbleWrap/pull/161) [#162](https://github.com/rubymotion/BubbleWrap/pull/162))
+* Add `Device.sdk_version`
 
 ## 1.1.4
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    bubble-wrap (1.1.4)
+    bubble-wrap (1.2.0.pre)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -5,6 +5,10 @@ A collection of (tested) helpers and wrappers used to wrap CocoaTouch code and p
 [BubbleWrap website](http://bubblewrap.io)
 [BubbleWrap mailing list](https://groups.google.com/forum/#!forum/bubblewrap)
 
+[![Code Climate](https://codeclimate.com/github/rubymotion/BubbleWrap.png)](https://codeclimate.com/github/rubymotion/BubbleWrap)
+[![Build Status](https://travis-ci.org/rubymotion/BubbleWrap.png?branch=master)](https://travis-ci.org/rubymotion/BubbleWrap)
+[![Dependency Status](https://gemnasium.com/rubymotion/BubbleWrap.png)](https://gemnasium.com/rubymotion/BubbleWrap)
+
 ## Installation
 
 ```ruby
@@ -159,6 +163,8 @@ A module with useful methods related to the running application
 # ['NBC', 'ABC', 'Fox', 'CBS', 'PBS']
 > App::Persistence['channels'] = ['TF1', 'France 2', 'France 3']
 # ['TF1', 'France 2', 'France 3']
+> App.environment
+# 'test'
 ```
 
 Other available methods:
@@ -171,6 +177,9 @@ Other available methods:
 * `App.shared`
 * `App.window`
 * `App.current_locale`
+* `App.release?`
+* `App.test?`
+* `App.development?`
 
 
 ### Device
@@ -285,6 +294,8 @@ simple interface:
 # ['NBC', 'ABC', 'Fox', 'CBS', 'PBS']
 > App::Persistence['channels'] = ['TF1', 'France 2', 'France 3']
 # ['TF1', 'France 2', 'France 3']
+> App::Persistence['something__new'] # something previously never stored
+# nil
 ```
 
 ### Observers
@@ -400,6 +411,109 @@ button.when(UIControlEventTouchUpInside) do
 end
 ```
 
+### UIBarButtonItem
+
+`BW::UIBarButtonItem` provides an idiomatic Ruby syntax for instantiating `UIBarButtonItem` objects.  Instead of a target-action pair, each method accepts a block.  When the button is tapped, the block is executed.  As a convenience, the block is optional.
+
+```ruby
+BW::UIBarButtonItem.system(:save) do
+  # ...
+end
+
+title = "Friends"
+BW::UIBarButtonItem.styled(:plain, title) do
+  # ...
+end
+
+image = UIImage.alloc.init
+BW::UIBarButtonItem.styled(:bordered, image) do
+  # ...
+end
+
+image     = UIImage.alloc.init
+landscape = UIImage.alloc.init
+BW::UIBarButtonItem.styled(:bordered, image, landscape) do
+  # ...
+end
+
+view = UIView.alloc.init
+BW::UIBarButtonItem.custom(view) do
+  # ...
+end
+# NOTE: The block is attached to the view as a single tap gesture recognizer.
+```
+
+Alternatively, `BW::UIBarButtonItem` provides a flexible, builder-style syntax for dynamically instantiating `UIBarButtonItem` objects.
+
+```ruby
+options = { :system => :save }
+BW::UIBarButtonItem.build(options) do
+  # ...
+end
+
+options = { :styled => :plain, :title => "Friends" }
+BW::UIBarButtonItem.build(options) do
+  # ...
+end
+
+options = { :styled => :bordered, :image => UIImage.alloc.init }
+BW::UIBarButtonItem.build(options) do
+  # ...
+end
+
+options = {
+  :styled    => :bordered,
+  :image     => UIImage.alloc.init,
+  :landscape => UIImage.alloc.init
+}
+BW::UIBarButtonItem.build(options) do
+  # ...
+end
+
+options = { :custom => UIView.alloc.init }
+BW::UIBarButtonItem.build(options) do
+  # ...
+end
+# NOTE: The block is attached to the view as a single tap gesture recognizer.
+```
+
+The `.styled` button types are:
+
+```ruby
+:plain
+:bordered
+:done
+```
+
+And the `.system` button types are:
+
+```ruby
+:done
+:cancel
+:edit
+:save
+:add
+:flexible_space
+:fixed_space
+:compose
+:reply
+:action
+:organize
+:bookmarks
+:search
+:refresh
+:stop
+:camera
+:trash
+:play
+:pause
+:rewind
+:fast_forward
+:undo
+:redo
+:page_curl
+```
+
 ## HTTP
 
 `BW::HTTP` wraps `NSURLRequest`, `NSURLConnection` and friends to provide Ruby developers with a more familiar and easier to use API.
@@ -480,7 +594,7 @@ state callbacks:
 ```ruby
 feed_parser = BW::RSSParser.new("http://feeds.feedburner.com/sdrbpodcast")
 feed_parser.delegate = self
-feed.parse do |item|
+feed_parser.parse do |item|
   p item.title
 end
 
@@ -658,15 +772,22 @@ idiom it is available as a public API.
 
 ```ruby
 > o = Class.new { include EM::Eventable }.new
-=> #<#<Class:0x6dc1310>:0x6dc2ec0>
+=> #<#<Class:0xab63f00>:0xab64430>
 > o.on(:november_5_1955) { puts "Ow!" }
-=> [#<Proc:0x6dc6300>]
-> o.on(:november_5_1955) { puts "Flux capacitor!" }
-=> [#<Proc:0x6dc6300>, #<Proc:0x6dc1ba0>]
+=> [#<Proc:0xad9bf00>]
+> flux = proc{ puts "Flux capacitor!" }
+=> #<Proc:0xab630f0>
+> o.on(:november_5_1955, &flux)
+=> [#<Proc:0xad9bf00>, #<Proc:0xab630f0>]
 > o.trigger(:november_5_1955)
 Ow!
 Flux capacitor!
 => [nil, nil]
+> o.off(:november_5_1955, &flux)
+=> #<Proc:0xab630f0>
+> o.trigger(:november_5_1955)
+Ow!
+=> [nil]
 ```
 
 # Suggestions?

data/lib/bubble-wrap/all.rb

@@ -1,4 +1,4 @@
 require File.expand_path('../loader', __FILE__)
-['core', 'http', 'reactor', 'rss_parser', 'ui', 'location', 'media'].each { |sub|
+['core', 'http', 'reactor', 'rss_parser', 'ui', 'location', 'media', 'font'].each { |sub|
 	require File.expand_path("../#{sub}", __FILE__)
 }

data/lib/bubble-wrap/camera.rb

@@ -1,7 +1,8 @@
 require 'bubble-wrap/loader'
+BubbleWrap.require('motion/util/constants.rb')
 BubbleWrap.require('motion/core/device.rb')
 BubbleWrap.require('motion/core/device/**/*.rb') do
   file('motion/core/device/camera_wrapper.rb').depends_on 'motion/core/device/camera.rb'
-  file('motion/core/device/camera.rb').depends_on 'motion/core/device.rb'
+  file('motion/core/device/camera.rb').depends_on ['motion/core/device.rb', 'motion/util/constants.rb']
   file('motion/core/device/screen.rb').depends_on 'motion/core/device.rb'
 end

data/lib/bubble-wrap/core.rb

@@ -1,8 +1,7 @@
 require 'bubble-wrap/loader'
 BubbleWrap.require('motion/core.rb')
 BubbleWrap.require('motion/core/**/*.rb') do
-  file('motion/core/device/camera.rb').depends_on 'motion/core/device.rb'
-  file('motion/core/device/screen.rb').depends_on 'motion/core/device.rb'
   file('motion/core/pollute.rb').depends_on 'motion/core/ns_index_path.rb'
 end
+require 'bubble-wrap/camera'
 require 'bubble-wrap/ui'

data/lib/bubble-wrap/font.rb

@@ -0,0 +1,2 @@
+require 'bubble-wrap/loader'
+BubbleWrap.require('motion/font/font.rb')

data/lib/bubble-wrap/location.rb

@@ -1,6 +1,8 @@
 require 'bubble-wrap/loader'
+BubbleWrap.require('motion/util/constants.rb')
 BubbleWrap.require('motion/core/string.rb')
 BubbleWrap.require('motion/location/**/*.rb') do
   file('motion/location/pollute.rb').depends_on 'motion/location/location.rb'
+  file('motion/location/location.rb').depends_on 'motion/util/constants.rb'
   file('motion/location/location.rb').uses_framework('CoreLocation')
 end

data/lib/bubble-wrap/version.rb

@@ -1,5 +1,5 @@
 module BubbleWrap
-  VERSION = '1.1.5' unless defined?(BubbleWrap::VERSION)
+  VERSION = '1.2.0.pre' unless defined?(BubbleWrap::VERSION)
   MIN_MOTION_VERSION = '1.24'
 
   module_function

data/motion/core/app.rb

@@ -129,6 +129,23 @@ module BubbleWrap
       end
     end
 
+    # the current application environment : development, test, release
+    def environment
+      RUBYMOTION_ENV
+    end
+
+    def development?
+      environment == 'development'
+    end
+
+    def test?
+      environment == 'test'
+    end
+
+    def release?
+      environment == 'release'
+    end
+
   end
 end
 ::App = BubbleWrap::App unless defined?(::App)

data/motion/core/device/camera.rb

@@ -12,6 +12,9 @@ module BubbleWrap
         CANCELED=1000
       end
 
+      Constants.register UIImagePickerControllerSourceTypePhotoLibrary, UIImagePickerControllerSourceTypeCamera,
+          UIImagePickerControllerSourceTypeSavedPhotosAlbum
+
       MEDIA_TYPE_HASH = {movie: KUTTypeMovie, image: KUTTypeImage}
 
       # The camera location; if :none, then we can't use source_type: :camera
@@ -88,7 +91,7 @@ module BubbleWrap
         end
 
         source_type_readable = options[:source_type]
-        source_type = const_int_get("UIImagePickerControllerSourceType", @options[:source_type])
+        source_type = Constants.get("UIImagePickerControllerSourceType", @options[:source_type])
         if not Camera.source_type_available?(source_type)
           error(Error::SOURCE_TYPE_NOT_AVAILABLE) and return
         end
@@ -176,7 +179,7 @@ module BubbleWrap
 
       private
       def camera_device
-        const_int_get("UIImagePickerControllerCameraDevice", self.location)
+        Constants.get("UIImagePickerControllerCameraDevice", self.location)
       end
 
       # ex media_type_to_symbol(KUTTypeMovie) => :movie
@@ -192,29 +195,6 @@ module BubbleWrap
       def error(type)
         @callback.call({ error: type })
       end
-
-      # @param [String] base of the constant 
-      # @param [Integer, String, Symbol] the 
-      # @return [Integer] the constant for this base
-      # Examples
-      # const_int_get("UIReturnKey", :done) => UIReturnKeyDone == 9
-      # const_int_get("UIReturnKey", "done") => UIReturnKeyDone == 9
-      # const_int_get("UIReturnKey", 9) => 9
-      def const_int_get(base, value)
-        return value if value.is_a? Numeric
-        value = value.to_s.camelize
-        Kernel.const_get("#{base}#{value}")
-      end
-
-      # Looks like RubyMotion adds UIKit constants
-      # at compile time. If you don't use these
-      # directly in your code, they don't get added
-      # to Kernel and const_int_get crashes.
-      def load_constants_hack
-        [UIImagePickerControllerSourceTypePhotoLibrary, UIImagePickerControllerSourceTypeCamera, 
-          UIImagePickerControllerSourceTypeSavedPhotosAlbum
-        ]
-      end
     end
   end
 end

data/motion/font/font.rb

@@ -0,0 +1,85 @@
+module BubbleWrap
+  module Font
+    module_function
+
+    def bold(size = nil)
+      Font.new(:bold, size)
+    end
+
+    def system(size = nil)
+      Font.new(:system, size)
+    end
+
+    def italic(size = nil)
+      Font.new(:italic, size)
+    end
+
+    # Example
+    # Font.new(<# UIFont >)
+    # Font.new("Helvetica")
+    # Font.new("Helvetica", 12)
+    # Font.new("Helvetica", size: 12)
+    # Font.new(name: "Helvetica", size: 12)
+    def new(params = {}, *args)
+      if params.is_a?(UIFont)
+        return params
+      end
+      _font = nil
+
+      if params.is_a?(NSString)
+        params = {name: params}
+      end
+
+      if args && !args.empty?
+        case args[0]
+        when NSDictionary
+          params.merge!(args[0])
+        else
+          params.merge!({size: args[0]})
+        end
+      end
+      params[:size] ||= UIFont.systemFontSize
+
+      case params[:name].to_sym
+      when :system
+        _font = UIFont.systemFontOfSize(params[:size].to_f)
+      when :bold
+        _font = UIFont.boldSystemFontOfSize(params[:size].to_f)
+      when :italic
+        _font = UIFont.italicSystemFontOfSize(params[:size].to_f)
+      else
+        begin
+          _font = UIFont.fontWithName(params[:name], size: params[:size])
+        rescue
+        end
+      end
+
+      if !_font
+        raise "Invalid font for parameters: #{params.inspect} args #{args.inspect}"
+      end
+
+      _font
+    end
+
+    class << self
+      alias_method :named, :new
+    end
+
+    # I.e. for UINavigationBar#titleTextAttributes
+    def attributes(params = {})
+      _attributes = {}
+
+      _attributes[UITextAttributeFont] = Font.new(params[:font]) if params[:font]
+      _attributes[UITextAttributeTextColor] = params[:color].to_color if params[:color]
+      _attributes[UITextAttributeTextShadowColor] = params[:shadow_color].to_color if params[:shadow_color]
+      _attributes[UITextAttributeTextShadowOffset] = begin
+        x = params[:shadow_offset][:x]
+        y = params[:shadow_offset][:y]
+        offset = UIOffsetMake(x,y)
+        NSValue.valueWithUIOffset(offset)
+      end if params[:shadow_offset]
+
+      _attributes
+    end
+  end
+end