bubble-wrap 1.0.0.pre → 1.0.0.pre.2

data/GETTING_STARTED.md

@@ -0,0 +1,109 @@
+# Getting Started with BubbleWrap
+
+A short guide to starting a RubyMotion application using the bubble wrappers.
+
+## A quick note about RubyMotion
+
+[RubyMotion](http://www.rubymotion.com/) is a commercial product available from
+[HipByte SPRL](http://www.hipbyte.com/). RubyMotion needs a recent (10.6 or newer)
+version of Mac OS X and Apple's Xcode tools installed. If you don't have a working
+RubyMotion install take a look at the [getting started guide](http://www.rubymotion.com/developer-center/guides/getting-started/).
+
+## Create a new RubyMotion project
+
+RubyMotion ships with the `motion` command-line tool to handle creating projects,
+updating and creatint support tickets.
+
+```
+$ motion create bw-demo
+    Create bw-demo
+    Create bw-demo/.gitignore
+    Create bw-demo/Rakefile
+    Create bw-demo/app
+    Create bw-demo/app/app_delegate.rb
+    Create bw-demo/resources
+    Create bw-demo/spec
+    Create bw-demo/spec/main_spec.rb
+```
+
+This gives us an empty project (and one failing spec).  That's fine for now.
+
+## Set up Bundler
+
+[Bundler](http://www.gembundler.com/) is a project to manage your project's
+RubyGem dependencies. You can get by without it if you want to, but it will
+save time and hassle as the number of BubbleWrap gems grows over time.
+
+```
+$ gem install bundler
+```
+
+Create a new file called `Gemfile` in your project directory and add the
+following:
+
+```ruby
+source :rubygems
+gem 'bubble-wrap', '~> 1.0.0'
+gem 'rake'
+```
+
+Then run `bundle` from the command-line in the same directory and Bundler
+should install BubbleWrap and Rake for you.
+
+
+## Adding BubbleWrap
+
+Now that we have BubbleWrap installed we need to configure the project to use
+it - the easiest way is to add Bundler to our build-environment and tell it 
+to take care of everything for us.
+
+Edit your project's `Rakefile` and add the following just under `require 'motion/project'`:
+
+```ruby
+require 'bundler'
+Bundler.setup
+Bundler.require
+```
+
+Now when you build your project by running `rake` you will see the BubbleWrap files
+being compiled into your project.
+
+## Customising BubbleWrap requires
+
+By default BubbleWrap will include all the bubble wrappers into your project, but often
+you won't need them all - perhaps you only want to use BubbleWrap's `http` wrappers?
+You can change your bubble-wrap line in your `Gemfile` as follows:
+
+```ruby
+gem 'bubble-wrap', '~> 1.0.0', :require => 'bubble-wrap/http'
+```
+
+If you just want core, the change is similarly easy:
+
+```ruby
+gem 'bubble-wrap', '~> 1.0.0', :require => 'bubble-wrap/core'
+```
+
+Also, if you don't want any of BubbleWrap loaded by default, and you just want to use
+it's ability to add projects to your build system you can change it to:
+
+```ruby
+gem 'bubble-wrap', '~> 1.0.0', :require => 'bubble-wrap/loader'
+```
+
+And modify your `Rakefile` to include one or more `BW.require` lines:
+
+```ruby
+BW.require '/path/to/some/files/**/*.rb'
+```
+
+For more information in using `BW.require` take a look at
+[the bubblewrap hacking guide](http://bubblewrap.io/hacking.html).
+
+## Go forth and conquer!
+
+The developers wish to thank you for using BubbleWrap.
+Please feel free to open issues or pull requests on 
+[GitHub](https://www.github.com/mattetti/BubbleWrap), join our
+[mailing list](https://groups.google.com/forum/#!forum/bubblewrap)
+or join us on `#bubblewrap` on `irc.freenode.net`.

data/Rakefile

@@ -6,13 +6,19 @@ Bundler.require
 
 require 'bubble-wrap/test'
 
-task :lib_spec do
-  sh "bacon #{Dir.glob("lib_spec/**/*_spec.rb").join(' ')}"
-end
-
-task :test => [ :lib_spec, :spec ]
-
 Motion::Project::App.setup do |app|
   app.name = 'testSuite'
   app.identifier = 'io.bubblewrap.testSuite'
+  app.specs_dir = './spec/motion'
+end
+
+namespace :spec do
+  task :lib do
+    sh "bacon #{Dir.glob("spec/lib/**/*_spec.rb").join(' ')}"
+  end
+
+  task :motion => 'spec'
+
+  task :all => [:lib, :motion]
 end
+

data/lib/bubble-wrap/ext/motion_project_config.rb

@@ -1,14 +1,23 @@
-module Motion
-  module Project
-    class Config
+module BubbleWrap
+  module Ext
+    module ConfigTask
 
-      # HACK NEEDED since RubyMotion doesn't support full path
-      # dependencies.
-      def files_dependencies(deps_hash)
+      def self.included(base) 
+        base.class_eval do
+          alias_method :files_dependencies_without_bubblewrap, :files_dependencies
+          alias_method :files_dependencies, :files_dependencies_with_bubblewrap
+        end
+      end
+
+      def path_matching_expression
+        /^\.?\//
+      end
+
+      def files_dependencies_with_bubblewrap(deps_hash)
         res_path = lambda do |x|
-          path = /^\.?\//.match(x) ? x : File.join('.', x)
+          path = path_matching_expression.match(x) ? x : File.join('.', x)
           unless @files.include?(path)
-            App.fail "Can't resolve dependency `#{x}' because #{path} is not in #{@files.inspect}"
+            Motion::Project::App.send(:fail, "Can't resolve dependency `#{x}' because #{path} is not in #{@files.inspect}")
           end
           path
         end
@@ -17,6 +26,9 @@ module Motion
           @dependencies[res_path.call(path)] = deps.map(&res_path)
         end
       end
+
     end
   end
 end
+
+Motion::Project::Config.send(:include, BubbleWrap::Ext::ConfigTask)

data/lib/bubble-wrap/requirement/path_manipulation.rb

@@ -10,7 +10,10 @@ module BubbleWrap
 
       def convert_caller_to_path(string)
         chunks = string.split(':')
-        return chunks[0..-3].join(':') if chunks.size >= 3
+        if chunks.size >= 3
+          string = chunks[0..-3].join(':')
+          string = File.dirname(string)
+        end
         string
       end
 

data/lib/bubble-wrap/version.rb

@@ -1,3 +1,3 @@
 module BubbleWrap
-  VERSION = '1.0.0.pre'
+  VERSION = '1.0.0.pre.2'
 end

data/spec/lib/bubble-wrap/ext/motion_project_config_spec.rb

@@ -0,0 +1,44 @@
+require 'mocha-on-bacon'
+require File.expand_path('../../../motion_stub', __FILE__)
+require 'bubble-wrap'
+
+describe BubbleWrap::Ext::ConfigTask do
+
+  before do
+    klass = Class.new do
+      def initialize
+        @files = [ '/fake/a', '/fake/b' ]
+        @dependencies = {}
+      end
+
+      def files_dependencies
+      end
+    end
+    klass.send(:include, BubbleWrap::Ext::ConfigTask)
+    @subject = klass.new
+  end
+
+  describe '.included' do
+    it 'aliases :files_dependencies to :files_dependencies_without_bubblewrap' do
+      @subject.respond_to?(:files_dependencies_without_bubblewrap).should == true
+    end
+
+    it 'aliass :files_dependencies_with_bubblewrap to :files_dependencies' do
+      @subject.method(:files_dependencies).should == @subject.method(:files_dependencies_with_bubblewrap)
+    end
+  end
+
+  describe '#path_matching_expression' do
+    it 'returns a regular expression' do
+      @subject.path_matching_expression.is_a?(Regexp).should == true
+    end
+  end
+
+  describe '#files_dependencies_with_bubblewrap' do
+    it 'should call #path_matching_expression' do
+      @subject.expects(:path_matching_expression).twice().returns(/^\.?\//)
+      @subject.files_dependencies_with_bubblewrap '/fake/a' => '/fake/b'
+    end
+  end
+
+end

data/{lib_spec → spec/lib}/bubble-wrap/requirement/path_manipulation_spec.rb

@@ -1,4 +1,4 @@
-require File.expand_path('../../../../lib/bubble-wrap/requirement/path_manipulation', __FILE__)
+require File.expand_path('../../../../../lib/bubble-wrap/requirement/path_manipulation', __FILE__)
 
 describe BubbleWrap::Requirement::PathManipulation do
   
@@ -9,7 +9,7 @@ describe BubbleWrap::Requirement::PathManipulation do
 
   describe '#convert_caller_to_path' do
     it 'strips off from the second-to-last colon' do
-      @subject.convert_caller_to_path("/fake/:path:91:in `fake_method'").
+      @subject.convert_caller_to_path("/fake/:path/foo:91:in `fake_method'").
         should == '/fake/:path'
     end
 

data/{lib_spec → spec/lib}/bubble-wrap/requirement_spec.rb

@@ -10,7 +10,7 @@ describe BubbleWrap::Requirement do
   describe '.scan' do
     before do
       @subject.paths = {}
-      @root_path = File.expand_path('../../../', __FILE__) 
+      @root_path = File.expand_path('../../../../', __FILE__) 
     end
 
     it 'asking for a not-yet-found file raises an exception' do

data/spec/lib/bubble-wrap_spec.rb

@@ -0,0 +1,30 @@
+require 'mocha-on-bacon'
+require File.expand_path('../motion_stub.rb', __FILE__)
+require 'bubble-wrap'
+
+describe BubbleWrap do
+  describe '.root' do
+    it 'returns an absolute path' do
+      BubbleWrap.root[0].should == '/'
+    end
+  end
+
+  describe '.require' do
+    it 'delegates to Requirement.scan' do
+      BW::Requirement.expects(:scan)
+      BW.require('foo')
+    end
+
+    it 'finds files with relative paths' do
+      BW::Requirement.paths = {}
+      BW.require '../motion/core.rb'
+      BW::Requirement.files.member?(File.expand_path('../../../motion/core.rb', __FILE__)).should == true
+    end 
+
+    it 'finds files with absolute paths' do
+      BW::Requirement.paths = {}
+      BW.require File.expand_path('../../../motion/core.rb', __FILE__)
+      BW::Requirement.files.member?(File.expand_path('../../../motion/core.rb', __FILE__)).should == true
+    end
+  end
+end

data/{lib_spec → spec/lib}/motion_stub.rb

@@ -7,6 +7,8 @@ module Motion
     end
     
     class Config
+      def files_dependencies
+      end
     end
   end
 end

metadata

@@ -1,82 +1,62 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: bubble-wrap
-version: !ruby/object:Gem::Version 
-  hash: 1390682719
+version: !ruby/object:Gem::Version
+  version: 1.0.0.pre.2
   prerelease: 6
-  segments: 
-  - 1
-  - 0
-  - 0
-  - pre
-  version: 1.0.0.pre
 platform: ruby
-authors: 
+authors:
 - Matt Aimonetti
 - Francis Chong
 - James Harton
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2012-06-08 00:00:00 +02:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2012-06-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: bacon
-  type: :development
-  version_requirements: &id001 !ruby/object:Gem::Requirement 
+  requirement: &70345019044780 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
   prerelease: false
-  requirement: *id001
-- !ruby/object:Gem::Dependency 
+  version_requirements: *70345019044780
+- !ruby/object:Gem::Dependency
   name: mocha-on-bacon
-  type: :development
-  version_requirements: &id002 !ruby/object:Gem::Requirement 
+  requirement: &70345019044360 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
   prerelease: false
-  requirement: *id002
-- !ruby/object:Gem::Dependency 
+  version_requirements: *70345019044360
+- !ruby/object:Gem::Dependency
   name: rake
-  type: :development
-  version_requirements: &id003 !ruby/object:Gem::Requirement 
+  requirement: &70345019043940 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
   prerelease: false
-  requirement: *id003
-description: RubyMotion wrappers and helpers (Ruby for iOS) - Making Cocoa APIs more Ruby like, one API at a time. Fork away and send your pull request.
-email: 
+  version_requirements: *70345019043940
+description: RubyMotion wrappers and helpers (Ruby for iOS) - Making Cocoa APIs more
+  Ruby like, one API at a time. Fork away and send your pull request.
+email:
 - mattaimonetti@gmail.com
 - francis@ignition.hk
 - james@sociable.co.nz
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - lib/bubble-wrap/ext/motion_project_app.rb
 - lib/bubble-wrap/ext/motion_project_config.rb
-- lib_spec/bubble-wrap/ext/motion_project_app_spec.rb
-- lib_spec/motion_stub.rb
 - motion/core.rb
 - motion/core/app.rb
 - motion/core/device.rb
@@ -95,10 +75,28 @@ extra_rdoc_files:
 - motion/core/ui_view_controller.rb
 - motion/http.rb
 - motion/test_suite_delegate.rb
-files: 
+- spec/lib/bubble-wrap/ext/motion_project_app_spec.rb
+- spec/lib/bubble-wrap/ext/motion_project_config_spec.rb
+- spec/lib/motion_stub.rb
+- spec/motion/core/app_spec.rb
+- spec/motion/core/device/screen_spec.rb
+- spec/motion/core/device_spec.rb
+- spec/motion/core/gestures_spec.rb
+- spec/motion/core/json_spec.rb
+- spec/motion/core/kvo_spec.rb
+- spec/motion/core/ns_index_path_spec.rb
+- spec/motion/core/ns_notification_center_spec.rb
+- spec/motion/core/persistence_spec.rb
+- spec/motion/core/string_spec.rb
+- spec/motion/core/time_spec.rb
+- spec/motion/core/ui_control_spec.rb
+- spec/motion/core_spec.rb
+- spec/motion/http_spec.rb
+files:
 - .gitignore
 - CHANGELOG.md
 - GEM.md
+- GETTING_STARTED.md
 - Gemfile
 - HACKING.md
 - LICENSE
@@ -116,11 +114,6 @@ files:
 - lib/bubble-wrap/requirement/path_manipulation.rb
 - lib/bubble-wrap/test.rb
 - lib/bubble-wrap/version.rb
-- lib_spec/bubble-wrap/ext/motion_project_app_spec.rb
-- lib_spec/bubble-wrap/requirement/path_manipulation_spec.rb
-- lib_spec/bubble-wrap/requirement_spec.rb
-- lib_spec/bubble-wrap_spec.rb
-- lib_spec/motion_stub.rb
 - motion/core.rb
 - motion/core/app.rb
 - motion/core/device.rb
@@ -139,73 +132,72 @@ files:
 - motion/core/ui_view_controller.rb
 - motion/http.rb
 - motion/test_suite_delegate.rb
-- spec/core/app_spec.rb
-- spec/core/device/screen_spec.rb
-- spec/core/device_spec.rb
-- spec/core/gestures_spec.rb
-- spec/core/json_spec.rb
-- spec/core/kvo_spec.rb
-- spec/core/ns_index_path_spec.rb
-- spec/core/ns_notification_center_spec.rb
-- spec/core/persistence_spec.rb
-- spec/core/string_spec.rb
-- spec/core/time_spec.rb
-- spec/core/ui_control_spec.rb
-- spec/core_spec.rb
-- spec/http_spec.rb
-has_rdoc: true
+- spec/lib/bubble-wrap/ext/motion_project_app_spec.rb
+- spec/lib/bubble-wrap/ext/motion_project_config_spec.rb
+- spec/lib/bubble-wrap/requirement/path_manipulation_spec.rb
+- spec/lib/bubble-wrap/requirement_spec.rb
+- spec/lib/bubble-wrap_spec.rb
+- spec/lib/motion_stub.rb
+- spec/motion/core/app_spec.rb
+- spec/motion/core/device/screen_spec.rb
+- spec/motion/core/device_spec.rb
+- spec/motion/core/gestures_spec.rb
+- spec/motion/core/json_spec.rb
+- spec/motion/core/kvo_spec.rb
+- spec/motion/core/ns_index_path_spec.rb
+- spec/motion/core/ns_notification_center_spec.rb
+- spec/motion/core/persistence_spec.rb
+- spec/motion/core/string_spec.rb
+- spec/motion/core/time_spec.rb
+- spec/motion/core/ui_control_spec.rb
+- spec/motion/core_spec.rb
+- spec/motion/http_spec.rb
 homepage: http://bubblewrap.io/
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
       - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+      hash: 1063659465596723229
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">"
-    - !ruby/object:Gem::Version 
-      hash: 25
-      segments: 
-      - 1
-      - 3
-      - 1
+  requirements:
+  - - ! '>'
+    - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.5.3
+rubygems_version: 1.8.16
 signing_key: 
 specification_version: 3
-summary: RubyMotion wrappers and helpers (Ruby for iOS) - Making Cocoa APIs more Ruby like, one API at a time. Fork away and send your pull request.
-test_files: 
-- lib_spec/bubble-wrap/ext/motion_project_app_spec.rb
-- lib_spec/bubble-wrap/requirement/path_manipulation_spec.rb
-- lib_spec/bubble-wrap/requirement_spec.rb
-- lib_spec/bubble-wrap_spec.rb
-- lib_spec/motion_stub.rb
-- spec/core/app_spec.rb
-- spec/core/device/screen_spec.rb
-- spec/core/device_spec.rb
-- spec/core/gestures_spec.rb
-- spec/core/json_spec.rb
-- spec/core/kvo_spec.rb
-- spec/core/ns_index_path_spec.rb
-- spec/core/ns_notification_center_spec.rb
-- spec/core/persistence_spec.rb
-- spec/core/string_spec.rb
-- spec/core/time_spec.rb
-- spec/core/ui_control_spec.rb
-- spec/core_spec.rb
-- spec/http_spec.rb
+summary: RubyMotion wrappers and helpers (Ruby for iOS) - Making Cocoa APIs more Ruby
+  like, one API at a time. Fork away and send your pull request.
+test_files:
+- spec/lib/bubble-wrap/ext/motion_project_app_spec.rb
+- spec/lib/bubble-wrap/ext/motion_project_config_spec.rb
+- spec/lib/bubble-wrap/requirement/path_manipulation_spec.rb
+- spec/lib/bubble-wrap/requirement_spec.rb
+- spec/lib/bubble-wrap_spec.rb
+- spec/lib/motion_stub.rb
+- spec/motion/core/app_spec.rb
+- spec/motion/core/device/screen_spec.rb
+- spec/motion/core/device_spec.rb
+- spec/motion/core/gestures_spec.rb
+- spec/motion/core/json_spec.rb
+- spec/motion/core/kvo_spec.rb
+- spec/motion/core/ns_index_path_spec.rb
+- spec/motion/core/ns_notification_center_spec.rb
+- spec/motion/core/persistence_spec.rb
+- spec/motion/core/string_spec.rb
+- spec/motion/core/time_spec.rb
+- spec/motion/core/ui_control_spec.rb
+- spec/motion/core_spec.rb
+- spec/motion/http_spec.rb

data/lib_spec/bubble-wrap_spec.rb

@@ -1,18 +0,0 @@
-require 'mocha-on-bacon'
-require File.expand_path('../motion_stub.rb', __FILE__)
-require 'bubble-wrap'
-
-describe BubbleWrap do
-  describe '.root' do
-    it 'returns an absolute path' do
-      BubbleWrap.root[0].should == '/'
-    end
-  end
-
-  describe '.require' do
-    it 'delegates to Requirement.scan' do
-      BW::Requirement.expects(:scan)
-      BW.require('foo')
-    end
-  end
-end