run_loop 0.2.1 → 1.0.0.pre3

data/lib/run_loop/version.rb

@@ -1,3 +1,163 @@
 module RunLoop
-  VERSION = '0.2.1'
+  VERSION = '1.0.0.pre3'
+
+  # A model of a software release version that can be used to compare two versions.
+  #
+  # Calabash and RunLoop try very hard to comply with Semantic Versioning rules.
+  # However, the semantic versioning spec is incompatible with RubyGem's patterns
+  # for pre-release gems.
+  #
+  # > "But returning to the practical: No release version of SemVer is compatible with Rubygems." - _David Kellum_
+  #
+  # Calabash and RunLoop version numbers will be in the form `<major>.<minor>.<patch>[.pre<N>]`.
+  #
+  # @see http://semver.org/
+  # @see http://gravitext.com/2012/07/22/versioning.html
+  class Version
+
+    # @!attribute [rw] major
+    #   @return [Integer] the major version
+    attr_accessor :major
+
+    # @!attribute [rw] minor
+    #   @return [Integer] the minor version
+    attr_accessor :minor
+
+    # @!attribute [rw] patch
+    #   @return [Integer] the patch version
+    attr_accessor :patch
+
+    # @!attribute [rw] pre
+    #   @return [Boolean] true if this is a pre-release version
+    attr_accessor :pre
+
+    # @!attribute [rw] pre_version
+    #   @return [Integer] if this is a pre-release version, returns the
+    #     pre-release version; otherwise this is nil
+    attr_accessor :pre_version
+
+    # Creates a new Version instance with all the attributes set.
+    #
+    # @example
+    #  version = Version.new(0.10.1)
+    #  version.major       => 0
+    #  version.minor       => 10
+    #  version.patch       => 1
+    #  version.pre         => false
+    #  version.pre_release => nil
+    #
+    # @example
+    #  version = Version.new(1.6.3.pre5)
+    #  version.major       => 1
+    #  version.minor       => 6
+    #  version.patch       => 3
+    #  version.pre         => true
+    #  version.pre_release => 5
+    #
+    # @param [String] version the version string to parse.
+    # @raise [ArgumentError] if version is not in the form 5, 6.1, 7.1.2, 8.2.3.pre1
+    def initialize(version)
+      tokens = version.strip.split('.')
+      count = tokens.count
+      if tokens.empty?
+        raise ArgumentError, "expected '#{version}' to be like 5, 6.1, 7.1.2, 8.2.3.pre1"
+      end
+
+      if count < 4 and tokens.any? { |elm| elm =~ /\D/ }
+        raise ArgumentError, "expected '#{version}' to be like 5, 6.1, 7.1.2, 8.2.3.pre1"
+      end
+
+      if count == 4
+        @pre = tokens[3]
+        pre_tokens = @pre.scan(/\D+|\d+/)
+        @pre_version = pre_tokens[1].to_i if pre_tokens.count == 2
+      end
+
+      @major, @minor, @patch = version.split('.').map(&:to_i)
+    end
+
+    # Returns an string representation of this version.
+    # @return [String] a string in the form `<major>.<minor>.<patch>[.pre<N>]`
+    def to_s
+      str = [major, minor, patch].compact.join('.')
+      str = "#{str}.#{pre}" if pre
+      str
+    end
+
+    # Compare this version to another for equality.
+    # @param [Version] other the version to compare against
+    # @return [Boolean] true if this Version is the same as `other`
+    def == (other)
+      Version.compare(self, other) == 0
+    end
+
+    # Compare this version to another for inequality.
+    # @param [Version] other the version to compare against
+    # @return [Boolean] true if this Version is not the same as `other`
+    def != (other)
+      Version.compare(self, other) != 0
+    end
+
+    # Is this version less-than another version?
+    # @param [Version] other the version to compare against
+    # @return [Boolean] true if this Version is less-than `other`
+    def < (other)
+      Version.compare(self, other) < 0
+    end
+
+    # Is this version greater-than another version?
+    # @param [Version] other the version to compare against
+    # @return [Boolean] true if this Version is greater-than `other`
+    def > (other)
+      Version.compare(self, other) > 0
+    end
+
+    # Is this version less-than or equal to another version?
+    # @param [Version] other the version to compare against
+    # @return [Boolean] true if this Version is less-than or equal `other`
+    def <= (other)
+      Version.compare(self, other) <= 0
+    end
+
+    # Is this version greater-than or equal to another version?
+    # @param [Version] other the version to compare against
+    # @return [Boolean] true if this Version is greater-than or equal `other`
+    def >= (other)
+      Version.compare(self, other) >= 0
+    end
+
+    # Compare version `a` to version `b`.
+    #
+    # @example
+    #   compare Version.new(0.10.0), Version.new(0.9.0)  =>  1
+    #   compare Version.new(0.9.0),  Version.new(0.10.0) => -1
+    #   compare Version.new(0.9.0),  Version.new(0.9.0)  =>  0
+    #
+    # @return [Integer] an integer `(-1, 1)`
+    def self.compare(a, b)
+
+      if a.major != b.major
+        return a.major > b.major ? 1 : -1
+      end
+
+      if a.minor != b.minor
+        return a.minor.to_i  > b.minor.to_i ? 1 : -1
+      end
+
+      if a.patch != b.patch
+        return a.patch.to_i > b.patch.to_i ? 1 : -1
+      end
+
+      return 1 if a.pre and (not b.pre)
+      return -1 if (not a.pre) and b.pre
+
+      return 1 if a.pre_version and (not b.pre_version)
+      return -1 if (not a.pre_version) and b.pre_version
+
+      if a.pre_version != b.pre_version
+        return a.pre_version.to_i > b.pre_version.to_i ? 1 : -1
+      end
+      0
+    end
+  end
 end

data/lib/run_loop/xctools.rb

@@ -0,0 +1,184 @@
+require 'open3'
+require 'retriable'
+
+module RunLoop
+
+  # A class for interacting with the Xcode tools.
+  #
+  # @note All command line tools are run in the context of `xcrun`.
+  #
+  # Throughout this class's documentation, there are references to the
+  # _current version of Xcode_.  The current Xcode version is the one returned
+  # by `xcrun xcodebuild`.  The current Xcode version can be set using
+  # `xcode-select` or overridden using the `DEVELOPER_DIR`.
+  #
+  # @todo Refactor instruments related code to instruments class.
+  class XCTools
+
+    # Returns a version instance for `Xcode 6.0`; used to check for the
+    # availability of features and paths to various items on the filesystem.
+    #
+    # @return [RunLoop::Version] 6.0
+    def v60
+      @xc60 ||= Version.new('6.0')
+    end
+
+    # Returns a version instance for `Xcode 5.1`; used to check for the
+    # availability of features and paths to various items on the filesystem.
+    #
+    # @return [RunLoop::Version] 5.1
+    def v51
+      @xc51 ||= Version.new('5.1')
+    end
+
+    # Returns a version instance for `Xcode 5.0`; ; used to check for the
+    # availability of features and paths to various items on the filesystem.
+    #
+    # @return [RunLoop::Version] 5.0
+    def v50
+      @xc50 ||= Version.new('5.0')
+    end
+
+    # Are we running Xcode 6 or above?
+    #
+    # @return [Boolean] `true` if the current Xcode version is >= 6.0
+    def xcode_version_gte_6?
+      @xcode_gte_6 ||= xcode_version >= v60
+    end
+
+    # Are we running Xcode 5.1 or above?
+    #
+    # @return [Boolean] `true` if the current Xcode version is >= 5.1
+    def xcode_version_gte_51?
+      @xcode_gte_51 ||= xcode_version >= v51
+    end
+
+    # Returns the current version of Xcode.
+    #
+    # @return [RunLoop::Version] The current version of Xcode as reported by
+    #  `xcrun xcodebuild -version`.
+    def xcode_version
+      @xcode_version ||= lambda {
+        xcode_build_output = `xcrun xcodebuild -version`.split(/\s/)[1]
+        Version.new(xcode_build_output)
+      }.call
+    end
+
+    # Returns the path to the current developer directory.
+    #
+    # From the man pages:
+    #
+    # ```
+    # $ man xcode-select
+    # DEVELOPER_DIR
+    # Overrides the active developer directory. When DEVELOPER_DIR is set,
+    # its value will be used instead of the system-wide active developer
+    # directory.
+    #```
+    #
+    # @return [String] path to current developer directory
+    def xcode_developer_dir
+      @xcode_developer_dir ||=
+            if ENV['DEVELOPER_DIR']
+              ENV['DEVELOPER_DIR']
+            else
+              # fall back to xcode-select
+              `xcode-select --print-path`.chomp
+            end
+    end
+
+    # Method for interacting with instruments.
+    #
+    # @example Getting a runnable command for instruments
+    #  instruments #=> 'xcrun instruments'
+    #
+    # @example Getting a the version of instruments.
+    #  instruments(:version) #=> 5.1.1 - a Version object
+    #
+    # @example Getting list of known simulators.
+    #  instruments(:sims) #=> < list of known simulators >
+    #
+    # @param [Version] cmd controls the return value.  currently accepts `nil`,
+    #   `:sims`, `:templates`, and `:version` as valid parameters
+    # @return [String,Array,Version] based on the value of `cmd` version, a list known
+    #   simulators, the version of current instruments tool, or the path to the
+    #   instruments binary.
+    # @raise [ArgumentError] if invalid `cmd` is passed
+    def instruments(cmd=nil)
+      instruments = 'xcrun instruments'
+      return instruments if cmd == nil
+
+      case cmd
+        when :version
+          @instruments_version ||= lambda {
+            # Xcode 6 can print out some very strange output, so we have to retry.
+            Retriable.retriable({:tries => 5}) do
+              Open3.popen3("#{instruments}") do |_, _, stderr, _|
+                version_str = stderr.read.chomp.split(/\s/)[2]
+                Version.new(version_str)
+              end
+            end
+          }.call
+        when :sims
+          @instruments_sims ||=  lambda {
+            devices = `#{instruments} -s devices`.chomp.split("\n")
+            devices.select { |device| device.downcase.include?('simulator') }
+          }.call
+
+        when :templates
+          @instruments_templates ||= lambda {
+            cmd = "#{instruments} -s templates"
+            if self.xcode_version >= self.v51
+              `#{cmd}`.split("\n").delete_if do |path|
+                not path =~ /tracetemplate/
+              end.map { |elm| elm.strip }
+            else
+              # prints to $stderr (>_>) - seriously?
+              Open3.popen3(cmd) do |_, _, stderr, _|
+                stderr.read.chomp.split(/(,|\(|")/).map do |elm|
+                   elm.strip
+                end.delete_if { |path| not path =~ /tracetemplate/ }
+              end
+            end
+          }.call
+
+        when :devices
+          @devices ||= lambda {
+            all = `#{instruments} -s devices`.chomp.split("\n")
+            valid = all.select { |device| device =~ /[a-f0-9]{40}/ }
+            valid.map do |device|
+              udid = device[/[a-f0-9]{40}/, 0]
+              version = device[/(\d\.\d(\.\d)?)/, 0]
+              name = device.split('(').first.strip
+              RunLoop::Device.new(name, version, udid)
+            end
+          }.call
+        else
+          candidates = [:version, :sims, :devices]
+          raise(ArgumentError, "expected '#{cmd}' to be one of '#{candidates}'")
+      end
+    end
+
+    # Does the instruments `version` accept the -s flag?
+    #
+    # @example
+    #  instruments_supports_hyphen_s?('4.6.3') => false
+    #  instruments_supports_hyphen_s?('5.0.2') => true
+    #  instruments_supports_hyphen_s?('5.1')   => true
+    #
+    # @param [String, Version] version (instruments(:version))
+    #   a major.minor[.patch] version string or a Version object
+    #
+    # @return [Boolean] true if the version is >= 5.*
+    def instruments_supports_hyphen_s?(version=instruments(:version))
+      @instruments_supports_hyphen_s ||= lambda {
+        if version.is_a? String
+          _version = Version.new(version)
+        else
+          _version = version
+        end
+        _version >= Version.new('5.1')
+      }.call
+    end
+  end
+end

data/scripts/calabash.lldb.erb

@@ -0,0 +1,4 @@
+process attach -n '<%= cf_bundle_executable %>'
+expr (void*)dlopen("<%= dylib_path_for_target %>", 0x2)
+detach
+exit

metadata

@@ -1,78 +1,227 @@
 --- !ruby/object:Gem::Specification
 name: run_loop
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 1.0.0.pre3
 platform: ruby
 authors:
 - Karl Krukow
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-05-26 00:00:00.000000000 Z
+date: 2014-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.19'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.19'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: retriable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: CFPropertyList
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.2'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: travis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.3'
+- !ruby/object:Gem::Dependency
+  name: awesome_print
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4.3'
+- !ruby/object:Gem::Dependency
+  name: guard-bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: growl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rb-readline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.5'
 description: calabash-cucumber drives tests for native iOS apps. RunLoop provides
   a number of tools associated with running Calabash tests.
 email:
-- karl@lesspainful.com
+- karl.krukow@xamarin.com
 executables:
 - run-loop
 extensions: []
 extra_rdoc_files: []
 files:
-- scripts/udidetect
-- .gitignore
-- .gitmodules
-- .irbrc
-- CHANGES.txt
-- Gemfile
-- LICENSE
-- README.md
-- Rakefile
 - bin/run-loop
-- build_to_run_loop.sh
-- docs/intro.md
-- irb.sh
-- lib/run_loop.rb
 - lib/run_loop/cli.rb
 - lib/run_loop/core.rb
+- lib/run_loop/device.rb
+- lib/run_loop/plist_buddy.rb
+- lib/run_loop/sim_control.rb
 - lib/run_loop/version.rb
-- run_loop.gemspec
+- lib/run_loop/xctools.rb
+- lib/run_loop.rb
 - scripts/calabash_script_uia.js
 - scripts/json2-min.js
 - scripts/json2.js
 - scripts/run_dismiss_location.js
 - scripts/run_loop_fast_uia.js
 - scripts/run_loop_host.js
+- scripts/udidetect
+- scripts/calabash.lldb.erb
+- LICENSE
 homepage: http://calaba.sh
-licenses: []
+licenses:
+- MIT
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -82,12 +231,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - '>='
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '1.9'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - '>'
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubyforge_project: 
 rubygems_version: 2.0.3
@@ -95,3 +244,4 @@ signing_key:
 specification_version: 4
 summary: Tools related to running Calabash iOS tests
 test_files: []
+has_rdoc: