bubble-wrap 1.5.0 → 1.6.0.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4070f3da9b1e9a37c918c5da7aead8bff4fd4b4e
-  data.tar.gz: e654090e81f9ab2b0d2618b95ac3e33935a3bb46
+  metadata.gz: 601f1626c9a3a557c7120181febf1f2acf29ecd1
+  data.tar.gz: 53ea079e1921fe8d05d3ec03f98f4496d19d2040
 SHA512:
-  metadata.gz: d51233858de91c048f290b62989d1a5dce864044ec28465e33582fb65c46baf8008b2209eb77086a870b399b8537468b46d2a1618c697a3f744806a99ea2a778
-  data.tar.gz: bdd4ea650406adfc467181c9a38ea069ad886b0f14e6a91bfc703923104f61013dc40d577f15aafd54fa3dfc635e6eb29ffda2b1b30e2ce5c7fb162fa7f5fea8
+  metadata.gz: b95bf54c3049c7ba4e5bf97df0593195bd63588bc541beb40179f2ccac93eeb1fd33d99d0778facb8d7e20635775e21a32674509fd1bbbf51eb28b34513699d1
+  data.tar.gz: 1ba1653a02a10eca8ff65529afe6d6afc0946fc4b4dbce45545afef2728334aaad163f5fb59fbf8cd8b4e7ca9db083377ff143b510ea6181318b3f8d908388a4

data/.travis.yml

@@ -3,4 +3,9 @@ before_install:
     - (ruby --version)
     - mkdir -p ~/Library/RubyMotion/build
     - sudo motion update
-script: ./travis.sh
+script:
+    - bundle install
+    - bundle exec rake clean
+    - bundle exec rake spec
+    - bundle exec rake clean
+    - bundle exec rake spec osx=true

data/Gemfile.lock

@@ -1,12 +1,14 @@
 PATH
   remote: .
   specs:
-    bubble-wrap (1.5.0)
+    bubble-wrap (1.6.0.rc1)
+      bubble-wrap-http (= 1.6.0.rc1)
 
 GEM
   remote: https://rubygems.org/
   specs:
     bacon (1.1.0)
+    bubble-wrap-http (1.6.0.rc1)
     metaclass (0.0.1)
     mocha (0.11.4)
       metaclass (~> 0.0.1)

data/README.md

@@ -26,7 +26,7 @@ require 'bubble-wrap'
 If you using Bundler:
 
 ```ruby
-gem "bubble-wrap", "~> 1.4.0"
+gem "bubble-wrap", "~> 1.5.0"
 ```
 
 BubbleWrap is split into multiple modules so that you can easily choose which parts
@@ -93,6 +93,12 @@ If you wish to only include the `SMS` wrapper:
 require 'bubble-wrap/sms'
 ```
 
+If you wish to only include the `NetworkIndicator` wrapper:
+
+```ruby
+require 'bubble-wrap/network-indicator'
+```
+
 If you want to include everything (ie kitchen sink mode) you can save time and do:
 
 ```ruby
@@ -146,6 +152,8 @@ BubbleWrap.rgb_color(23, 45, 12)
 => #<UICachedDeviceWhiteColor:0x8bb5be0>
 '#FF8A19'.to_color
 => #<UIDeviceRGBColor:0x8d54110>
+'#88FF8A19'.to_color # ARGB format
+=> #<UIDeviceRGBColor:0xca0fe00>
 ```
 
 Debug flag:
@@ -178,7 +186,10 @@ A module with useful methods related to the running application
 > App.run_after(0.5) {  p "It's #{Time.now}"   }
 # Runs the block after 0.5 seconds.
 > App.open_url("http://matt.aimonetti.net")
-# Opens the url using the device's browser. (accepts a string url or an instance of `NSURL`.
+> App.open_url("tel://123456789")
+# Opens the url using the device's browser. Can also open custom URL schemas (accepts a string url or an instance of `NSURL`.)
+> App.can_open_url("tel://")
+# Returns whether the app can open a given URL resource.
 > App::Persistence['channels'] # application specific persistence storage
 # ['NBC', 'ABC', 'Fox', 'CBS', 'PBS']
 > App::Persistence['channels'] = ['TF1', 'France 2', 'France 3']
@@ -375,7 +386,7 @@ iso8601 formatted string into a Time instance.
 
 ## Location
 
-Added interface for Ruby-like GPS access:
+Added interface for Ruby-like GPS and compass access:
 
 ```ruby
 BW::Location.get do |result|
@@ -384,6 +395,15 @@ BW::Location.get do |result|
 end
 ```
 
+```ruby
+BW::Location.get_compass do |result|
+  p result[:magnetic_heading] # Heading towards magnetic north
+  p result[:true_heading] # Heading towards true north
+  p result[:accuracy] # Potential error between magnetic and true heading
+  p result[:timestamp] # Timestamp of the heading calculation
+end
+```
+
 Also available is `BW::Location.get_significant`, for monitoring significant location changes.
 
 ## Media
@@ -443,7 +463,36 @@ Wrapper for showing an in-app message (SMS) composer view.
        result.canceled?  # => boolean
        result.failed?    # => boolean
        error             # => NSError
-      } 
+      }
+```
+
+## NetworkIndicator
+
+Wrapper for showing and hiding the network indicator (the status bar spinner).
+
+```ruby
+    BW::NetworkIndicator.show  # starts the spinner
+    BW::NetworkIndicator.hide  # stops it
+
+    # the nice thing is if you call 'show' multiple times, the 'hide' method will
+    # not have any effect until you've called it the same number of times.
+    BW::NetworkIndicator.show
+    # ...somewhere else
+    BW::NetworkIndicator.show
+
+    # ...down the line
+    BW::NetworkIndicator.hide
+    # indicator is still visible
+
+    BW::NetworkIndicator.hide
+    # NOW the indicator is hidden!
+
+    # If you *really* want to hide the indicator immediately, you can call `reset!`
+    # but this is in no way encouraged.
+    BW::NetworkIndicator.reset!
+
+    # and for completeness, a check to see if the indicator is visible
+    BW::NetworkIndicator.visible?
 ```
 
 ## UI
@@ -594,6 +643,50 @@ And the `.system` button types are:
 :page_curl
 ```
 
+### UIActivityViewController
+
+`BW::UIActivityViewController` is a subclass of `UIActivityViewController` with an natural Ruby syntax.
+
+You can initiate a `UIActivityViewController` with or without a completion handler block. For more information on `UIActivityViewController`s, see [Apple's documentation](https://developer.apple.com/library/ios/documentation/uikit/reference/UIActivityViewController_Class/Reference/Reference.html).
+
+```ruby
+# Without a completion handler
+BW::UIActivityViewController.new(
+  items: "Some Text", # or ["Some Text", NSURL.URLWithString('http://www.rubymotion.com')] or a UIImage
+  animated: true, # Defaults to true
+  excluded: :add_to_reading_list # One item or an array
+)
+
+# With completion handler
+BW::UIActivityViewController.new(
+  items: "Some Text",
+  animated: true,
+  excluded: [:add_to_reading_list, :print, :air_drop]
+) do |activity_type, completed|
+  puts "completed with activity: #{activity_type} - finished?: #{completed}"
+end
+```
+
+Built in activities that can be passed to the `excluded` option are defined as `UIActivity` class `UIActivityType` constants:
+
+```ruby
+:post_to_facebook
+:post_to_twitter
+:post_to_weibo
+:message
+:mail
+:print
+:copy_to_pasteboard
+:assign_to_contact
+:save_to_camera_roll
+:add_to_reading_list
+:post_to_flickr
+:post_to_vimeo
+:post_to_tencent_weibo
+:air_drop
+```
+
+
 ## HTTP
 
 `BW::HTTP` wraps `NSURLRequest`, `NSURLConnection` and friends to provide Ruby developers with a more familiar and easier to use API.
@@ -677,7 +770,7 @@ class HttpClient
     BW::HTTP.get(user_url(user_id)) do |response|
       # ..
     end
-  end 
+  end
 end
 ```
 

data/Rakefile

@@ -28,7 +28,7 @@ Motion::Project::App.setup do |app|
   app.spec_files
   if Motion::Project::App.osx?
     app.spec_files -= Dir.glob("./spec/motion/**/ios/**.rb")
-    ["font", "location", "media", "ui", "mail", "sms"].each do |package|
+    ["font", "location", "media", "ui", "mail", "sms", "network-indicator"].each do |package|
       app.spec_files -= Dir.glob("./spec/motion/#{package}/**/*.rb")
     end
   else

data/bubble-wrap.gemspec

@@ -16,6 +16,7 @@ Gem::Specification.new do |gem|
 
   gem.extra_rdoc_files = gem.files.grep(%r{motion})
 
+  gem.add_dependency 'bubble-wrap-http', BubbleWrap::VERSION
   gem.add_development_dependency 'mocha', '0.11.4'
   gem.add_development_dependency 'mocha-on-bacon'
   gem.add_development_dependency 'bacon'

data/lib/bubble-wrap/all.rb

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

data/lib/bubble-wrap/http.rb

@@ -1,7 +1,7 @@
 require 'bubble-wrap/version' unless defined?(BubbleWrap::VERSION)
 require 'bubble-wrap/loader'
-BubbleWrap.require('motion/core/ns_url_request.rb')
-BubbleWrap.require('motion/core.rb')
-BubbleWrap.require('motion/http.rb')
-BubbleWrap.require('motion/http/query.rb')
-BubbleWrap.require('motion/http/response.rb')
+require 'bubble-wrap/network-indicator'
+require 'bubble-wrap-http'
+Motion::Project::App.warn "BubbleWrap::HTTP is deprecated and will be removed, see https://github.com/rubymotion/BubbleWrap/issues/308"
+Motion::Project::App.warn "Switch to a different networking library soon - consider AFNetworking: http://afnetworking.com/"
+Motion::Project::App.warn "You can use the 'bubble-wrap-http' gem if you need compatibility: https://github.com/rubymotion/BubbleWrap-HTTP"

data/lib/bubble-wrap/network-indicator.rb

@@ -0,0 +1,6 @@
+require 'bubble-wrap/loader'
+
+BubbleWrap.require_ios("network-indicator") do
+  BubbleWrap.require('motion/core/app.rb')
+  BubbleWrap.require('motion/network-indicator/**/*.rb')
+end

data/lib/bubble-wrap/ui.rb

@@ -1,6 +1,7 @@
 require 'bubble-wrap/loader'
 
 BubbleWrap.require_ios("ui") do
+  BubbleWrap.require('motion/util/constants.rb')
   BubbleWrap.require('motion/ui/**/*.rb') do
     file('motion/ui/pollute.rb').depends_on %w(
       motion/ui/ui_control_wrapper.rb

data/lib/bubble-wrap/version.rb

@@ -1,4 +1,4 @@
 module BubbleWrap
-  VERSION = '1.5.0' unless defined?(BubbleWrap::VERSION)
+  VERSION = '1.6.0.rc1' unless defined?(BubbleWrap::VERSION)
   MIN_MOTION_VERSION = '2.17'
 end

data/motion/core.rb

@@ -9,6 +9,9 @@ module BubbleWrap
   # @return [UIcolor]
   def rgba_color(r,g,b,a)
     r,g,b = [r,g,b].map { |i| i / 255.0}
+    if a > 1.0
+      a = a / 255.0
+    end
     if App.osx?
       NSColor.colorWithDeviceRed(r, green: g, blue: b, alpha: a)
     else

data/motion/core/ios/app.rb

@@ -3,9 +3,10 @@ module BubbleWrap
     module_function
 
     # Opens an url (string or instance of `NSURL`)
-    # in the device's web browser.
+    # in the device's web browser or in the correspondent app for custom schemas
     # Usage Example:
     #   App.open_url("http://matt.aimonetti.net")
+    #   App.open_url("fb://profile")
     def open_url(url)
       unless url.is_a?(NSURL)
         url = NSURL.URLWithString(url)
@@ -13,6 +14,17 @@ module BubbleWrap
       UIApplication.sharedApplication.openURL(url)
     end
 
+    # Returns whether an app can open a given URL resource (string or instance of `NSURL`)
+    # Useful to check if certain apps are installed before calling to their custom schemas.
+    # Usage Example:
+    #   App.open_url("fb://profile") if App.can_open_url("fb://")
+    def can_open_url(url)
+      unless url.is_a?(NSURL)
+        url = NSURL.URLWithString(url)
+      end
+      UIApplication.sharedApplication.canOpenURL(url)
+    end
+
     # Displays a UIAlertView.
     #
     # title - The title as a String.
@@ -80,4 +92,4 @@ module BubbleWrap
       key_window || normal_windows.first
     end
   end
-end
+end

data/motion/core/string.rb

@@ -58,11 +58,15 @@ module BubbleWrap
           colors = hex_color.scan(%r{[0-9A-Fa-f]}).map!{ |el| (el * 2).to_i(16) }
         when 6
           colors = hex_color.scan(%r<[0-9A-Fa-f]{2}>).map!{ |el| el.to_i(16) }
+        when 8
+          colors = hex_color.scan(%r<[0-9A-Fa-f]{2}>).map!{ |el| el.to_i(16) }
         else
           raise ArgumentError
       end 
       if colors.size == 3
         BubbleWrap.rgb_color(colors[0], colors[1], colors[2])
+      elsif colors.size == 4
+        BubbleWrap.rgba_color(colors[1], colors[2], colors[3], colors[0])
       else
         raise ArgumentError
       end 

data/motion/location/location.rb

@@ -70,6 +70,8 @@ module BubbleWrap
 
       if @options[:significant]
         self.location_manager.startMonitoringSignificantLocationChanges
+      elsif @options[:compass]
+        self.location_manager.startUpdatingHeading
       else
         self.location_manager.startUpdatingLocation
       end
@@ -83,10 +85,21 @@ module BubbleWrap
       get(options.merge(once: true), &block)
     end
 
+    def get_compass(options = {}, &block)
+      get(options.merge(compass: true), &block)
+    end
+
+    def get_compass_once(options = {}, &block)
+      get_compass(options.merge(once: true), &block)
+    end
+
     # Stop getting locations
     def stop
+      return unless @options
       if @options[:significant]
         self.location_manager.stopMonitoringSignificantLocationChanges
+      elsif @options[:compass]
+        self.location_manager.stopUpdatingHeading
       else
         self.location_manager.stopUpdatingLocation
       end
@@ -121,6 +134,23 @@ module BubbleWrap
       end
     end
 
+    def locationManager(manager, didUpdateHeading:newHeading)
+      heading = {
+        magnetic_heading: newHeading.magneticHeading,
+        true_heading: newHeading.trueHeading,
+        accuracy: newHeading.headingAccuracy,
+        timestamp: newHeading.timestamp,
+      }
+
+      if @options[:once]
+        @callback && @callback.call(heading)
+        @callback = proc { |result| }
+        stop
+      else
+        @callback && @callback.call(heading)
+      end
+    end
+
     def locationManager(manager, didFailWithError:error)
       if error.domain == KCLErrorDomain
         case error.code
@@ -152,4 +182,4 @@ module BubbleWrap
     end
   end
 end
-::Location = BubbleWrap::Location unless defined?(::Location)
+::Location = BubbleWrap::Location unless defined?(::Location)

data/motion/network-indicator/network-indicator.rb

@@ -0,0 +1,67 @@
+module BubbleWrap
+  module NetworkIndicator
+    DELAY = 0.2
+
+    module_function
+
+    def counter
+      @counter ||= 0
+    end
+
+    def show
+      if Dispatch::Queue.current.to_s == 'com.apple.main-thread'
+        @counter = self.counter + 1
+        self.update_spinner
+      else
+        Dispatch::Queue.main.async do
+          self.show
+        end
+      end
+    end
+
+    def hide
+      if Dispatch::Queue.current.to_s == 'com.apple.main-thread'
+        @counter = [self.counter - 1, 0].max
+        if self.counter == 0
+          if @hide_indicator_timer
+            @hide_indicator_timer.invalidate
+          end
+          @hide_indicator_timer = NSTimer.timerWithTimeInterval(DELAY - 0.01, target: self, selector: :update_spinner_timer, userInfo: nil, repeats: false)
+          NSRunLoop.mainRunLoop.addTimer(@hide_indicator_timer, forMode:NSRunLoopCommonModes)
+        end
+      else
+        Dispatch::Queue.main.async do
+          self.hide
+        end
+      end
+    end
+
+    def update_spinner_timer
+      update_spinner
+    end
+
+    def update_spinner
+      if Dispatch::Queue.current.to_s == 'com.apple.main-thread'
+        if @hide_indicator_timer
+          @hide_indicator_timer.invalidate
+          @hide_indicator_timer = nil
+        end
+        UIApplication.sharedApplication.networkActivityIndicatorVisible = (@counter > 0)
+      else
+        Dispatch::Queue.main.async do
+          self.update_spinner
+        end
+      end
+    end
+
+    def visible?
+      UIApplication.sharedApplication.networkActivityIndicatorVisible?
+    end
+
+    def reset!
+      @counter = 0
+      self.update_spinner
+    end
+
+  end
+end