run_loop_tcc 2.1.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 92e7d3e3de5717d3d8d9af2eaf64b7e21c008899
+  data.tar.gz: 6307dfe028d32b2951502a42e5705beb62dc15f0
+SHA512:
+  metadata.gz: 0213881ee96522fe96f450b7a3cbeea9f0493de793997e9eaeb706dc14161e43dc6ef49dfd54ac1586426fd10d400a170635a02147f16c1199ab1133136ed1b2
+  data.tar.gz: f5e66cb58ddea5e573454be69f3bce8b9438b7703a9739082a1a0d7bf8f17cdf04f22dc9de05ba6253cd187e2a1be1ec0be560ee88786dbb64d9acfd10d27f31

data/LICENSE

@@ -0,0 +1,21 @@
+run-loop
+
+Copyright (c) LessPainful ApS (https://www.lesspainful.com). All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/bin/run-loop

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+require 'run_loop/cli/cli'
+require 'run_loop/cli/errors'
+require 'run_loop/environment'
+
+begin
+  RunLoop::CLI::Tool.start
+  exit 0
+rescue RunLoop::CLI::ValidationError, Thor::RequiredArgumentMissingError, Thor::UndefinedCommandError => e
+  puts e.message
+  exit 64
+rescue Thor::Error => e
+  puts e.message
+  if RunLoop::Environment.debug?
+    puts e.backtrace.join("\n") if e.backtrace
+    p e.class
+  end
+  exit 70
+end

data/lib/run_loop/abstract.rb

@@ -0,0 +1,18 @@
+
+module RunLoop
+  module Abstract
+    # @!visibility private
+    class AbstractMethodError < StandardError; end
+
+    # @!visibility private
+    def abstract_method!
+      if Kernel.method_defined?(:caller_locations)
+        method_name = icaller_locations.first.label
+      else
+        method_name = caller.first[/\`(.*)\'/, 1]
+      end
+
+      raise AbstractMethodError.new("Abstract method '#{method_name}'")
+    end
+  end
+end

data/lib/run_loop/app.rb

@@ -0,0 +1,372 @@
+module RunLoop
+  # A class for interacting with .app bundles.
+  class App
+
+    # @!attribute [r] path
+    # @return [String] The path to the app bundle .app
+    attr_reader :path
+
+    # Creates a new App instance.
+    #
+    # @note The `app_bundle_path` is expanded during initialization.
+    #
+    # @param [String] app_bundle_path A path to a .app
+    # @return [RunLoop::App] A instance of App with a path.
+    def initialize(app_bundle_path)
+      @path = File.expand_path(app_bundle_path)
+
+      if !App.valid?(app_bundle_path)
+        raise ArgumentError,
+%Q{App does not exist at path or is not an app bundle.
+
+#{app_bundle_path}
+
+Bundle must:
+
+1. be a directory that exists,
+2. have a .app extension,
+3. contain an Info.plist,
+4. and the app binary (CFBundleExecutable) must exist
+}
+      end
+    end
+
+    # @!visibility private
+    def to_s
+      cf_bundle_version = bundle_version
+      cf_bundle_short_version = short_bundle_version
+
+      if cf_bundle_version && cf_bundle_short_version
+        version = "#{cf_bundle_version.to_s} / #{cf_bundle_short_version}"
+      elsif cf_bundle_version
+        version = cf_bundle_version.to_s
+      elsif cf_bundle_short_version
+        version = cf_bundle_short_version
+      else
+        version = ""
+      end
+
+      "#<APP #{bundle_identifier} #{version} #{path}>"
+    end
+
+    # @!visibility private
+    def inspect
+      to_s
+    end
+
+    # Is this a valid app?
+    def valid?
+      App.valid?(path)
+    end
+
+    # @!visibility private
+    def self.valid?(app_bundle_path)
+      return false if app_bundle_path.nil?
+
+      return false if !File.directory?(app_bundle_path)
+      return false if !File.extname(app_bundle_path) == ".app"
+
+      return false if !self.info_plist_exist?(app_bundle_path)
+      return false if !self.executable_file_exist?(app_bundle_path)
+      true
+    end
+
+    # Returns the Info.plist path.
+    # @raise [RuntimeError] If there is no Info.plist.
+    def info_plist_path
+      @info_plist_path ||= File.join(path, 'Info.plist')
+    end
+
+    # Inspects the app's Info.plist for the bundle identifier.
+    # @return [String] The value of CFBundleIdentifier.
+    # @raise [RuntimeError] If the plist cannot be read or the
+    #   CFBundleIdentifier is empty or does not exist.
+    def bundle_identifier
+      identifier = plist_buddy.plist_read("CFBundleIdentifier", info_plist_path)
+      unless identifier
+        raise "Expected key 'CFBundleIdentifier' in '#{info_plist_path}'"
+      end
+      identifier
+    end
+
+    # Inspects the app's Info.plist for the executable name.
+    # @return [String] The value of CFBundleExecutable.
+    # @raise [RuntimeError] If the plist cannot be read or the
+    #   CFBundleExecutable is empty or does not exist.
+    def executable_name
+      name = plist_buddy.plist_read("CFBundleExecutable", info_plist_path)
+      unless name
+        raise "Expected key 'CFBundleExecutable' in '#{info_plist_path}'"
+      end
+      name
+    end
+
+    # Returns the arches for the binary.
+    def arches
+      @arches ||= lipo.info
+    end
+
+    # True if the app has been built for the simulator
+    def simulator?
+      arches.include?("i386") || arches.include?("x86_64")
+    end
+
+    # True if the app has been built for physical devices
+    def physical_device?
+      arches.any? do |arch|
+        arch[/arm/, 0]
+      end
+    end
+
+    # Inspects the app's file for the server version
+    def calabash_server_version
+      version = nil
+      executables.each do |executable|
+        version = strings(executable).server_version
+        break if version
+      end
+      version
+    end
+
+    # @!visibility private
+    def codesign_info
+      RunLoop::Codesign.info(path)
+    end
+
+    # @!visibility private
+    def developer_signed?
+      RunLoop::Codesign.developer?(path)
+    end
+
+    # @!visibility private
+    def distribution_signed?
+      RunLoop::Codesign.distribution?(path)
+    end
+
+    # Returns the CFBundleShortVersionString of the app as Version instance.
+    #
+    # Apple docs:
+    #
+    # CFBundleShortVersionString specifies the release version number of the
+    # bundle, which identifies a released iteration of the app. The release
+    # version number is a string comprised of three period-separated integers.
+    #
+    # The first integer represents major revisions to the app, such as revisions
+    # that implement new features or major changes. The second integer denotes
+    # revisions that implement less prominent features. The third integer
+    # represents maintenance releases.
+    #
+    # The value for this key differs from the value for CFBundleVersion, which
+    # identifies an iteration (released or unreleased) of the app. This key can
+    # be localized by including it in your InfoPlist.strings files.
+    #
+    # @return [RunLoop::Version, nil] Returns a Version instance if the
+    #  CFBundleShortVersion string is well formed and nil if not.
+    def marketing_version
+      string = plist_buddy.plist_read("CFBundleShortVersionString", info_plist_path)
+      begin
+        version = RunLoop::Version.new(string)
+      rescue
+        if string && string != ""
+          RunLoop.log_debug("CFBundleShortVersionString: '#{string}' is not a well formed version string")
+        else
+          RunLoop.log_debug("CFBundleShortVersionString is not defined in Info.plist")
+        end
+        version = nil
+      end
+      version
+    end
+
+    # See #marketing_version
+    alias_method :short_bundle_version, :marketing_version
+
+    # Returns the CFBundleVersionString of the app as Version instance.
+    #
+    # Apple docs:
+    #
+    # CFBundleVersion specifies the build version number of the bundle, which
+    # identifies an iteration (released or unreleased) of the bundle. The build
+    # version number should be a string comprised of three non-negative,
+    # period-separated integers with the first integer being greater than zero.
+    # The string should only contain numeric (0-9) and period (.) characters.
+    # Leading zeros are truncated from each integer and will be ignored (that
+    # is, 1.02.3 is equivalent to 1.2.3).
+    #
+    # @return [RunLoop::Version, nil] Returns a Version instance if the
+    #  CFBundleVersion string is well formed and nil if not.
+    def build_version
+      string = plist_buddy.plist_read("CFBundleVersionString", info_plist_path)
+      begin
+        version = RunLoop::Version.new(string)
+      rescue
+        if string && string != ""
+          RunLoop.log_debug("CFBundleVersionString: '#{string}' is not a well formed version string")
+        else
+          RunLoop.log_debug("CFBundleVersionString is not defined in Info.plist")
+        end
+        version = nil
+      end
+      version
+    end
+
+    # See #build_version
+    alias_method :bundle_version, :build_version
+
+    # @!visibility private
+    # Collects the paths to executables in the bundle.
+    def executables
+      executables = []
+      Dir.glob("#{path}/**/*") do |file|
+        next if skip_executable_check?(file)
+        if otool(file).executable?
+          executables << file
+        end
+      end
+      executables
+    end
+
+    # Returns the sha1 of the application.
+    def sha1
+      RunLoop::Directory.directory_digest(path)
+    end
+
+    private
+
+    # @!visibility private
+    def self.info_plist_exist?(app_bundle_path)
+      info_plist = File.join(app_bundle_path, "Info.plist")
+      File.exist?(info_plist)
+    end
+
+    # @!visibility private
+    def self.executable_file_exist?(app_bundle_path)
+      return false if !self.info_plist_exist?(app_bundle_path)
+      info_plist = File.join(app_bundle_path, "Info.plist")
+      pbuddy = RunLoop::PlistBuddy.new
+      name = pbuddy.plist_read("CFBundleExecutable", info_plist)
+      if name
+        File.exist?(File.join(app_bundle_path, name))
+      else
+        false
+      end
+    end
+
+    # @!visibility private
+    def lipo
+      @lipo ||= RunLoop::Lipo.new(path)
+    end
+
+    # @!visibility private
+    def plist_buddy
+      @plist_buddy ||= RunLoop::PlistBuddy.new
+    end
+
+    # @!visibility private
+    # An otool factory.
+    def otool(file)
+      RunLoop::Otool.new(file)
+    end
+
+    # @!visibility private
+    # A strings factory
+    def strings(file)
+      RunLoop::Strings.new(file)
+    end
+
+    # @!visibility private
+    def skip_executable_check?(file)
+      File.directory?(file) ||
+        image?(file) ||
+        text?(file) ||
+        plist?(file) ||
+        lproj_asset?(file) ||
+        code_signing_asset?(file) ||
+        core_data_asset?(file) ||
+        font?(file)
+    end
+
+    # @!visibility private
+    def text?(file)
+       extension = File.extname(file)
+       filename = File.basename(file)
+
+       extension == ".txt" ||
+         extension == ".md" ||
+         extension == ".html" ||
+         extension == ".xml" ||
+         extension == ".json" ||
+         extension == ".yaml" ||
+         extension == ".yml" ||
+         extension == ".rtf" ||
+
+         ["NOTICE", "LICENSE", "README", "ABOUT"].any? do |elm|
+           filename[/#{elm}/]
+         end
+    end
+
+    # @!visibility private
+    def image?(file)
+      extension = File.extname(file)
+
+      extension == ".jpeg" ||
+      extension == ".jpg" ||
+      extension == ".gif" ||
+      extension == ".png" ||
+      extension == ".tiff" ||
+      extension == ".svg" ||
+      extension == ".pdf" ||
+      extension == ".car" ||
+      file[/iTunesArtwork/, 0]
+    end
+
+    # @!visibility private
+    def plist?(file)
+      File.extname(file) == ".plist"
+    end
+
+    # @!visibility private
+    def lproj_asset?(file)
+      extension = File.extname(file)
+      dir_extension = File.extname(File.dirname(file))
+
+      dir_extension == ".lproj" ||
+        dir_extension == ".storyboard" ||
+        dir_extension == ".storyboardc" ||
+        extension == ".strings" ||
+        extension == ".xib" ||
+        extension == ".nib"
+    end
+
+    # @!visibility private
+    def code_signing_asset?(file)
+      name = File.basename(file)
+      extension = File.extname(file)
+      dirname = File.basename(File.dirname(file))
+
+      name == "PkgInfo" ||
+        name == "embedded" ||
+        extension == ".mobileprovision" ||
+        extension == ".xcent" ||
+        dirname == "_CodeSignature"
+    end
+
+    # @!visibility private
+    def core_data_asset?(file)
+      extension = File.extname(file)
+      dir_extension = File.extname(File.dirname(file))
+
+      dir_extension == ".momd" ||
+        extension == ".mom" ||
+        extension == ".db" ||
+        extension == ".omo"
+    end
+
+    # @!visibility private
+    def font?(file)
+      extension = File.extname(file)
+
+      extension == ".tff" || extension == ".otf"
+    end
+  end
+end
+

data/lib/run_loop/cache/cache.rb

@@ -0,0 +1,68 @@
+module RunLoop
+
+  # @!visibility private
+  # A class for managing an on-disk cache.
+  class Cache
+
+    require 'fileutils'
+
+    def initialize(path)
+      @path = path
+    end
+
+    def clear
+      raise NotImplementedError, 'Subclasses must implement #clear'
+    end
+
+    def refresh
+      raise NotImplementedError, 'Subclasses must implement #refresh'
+    end
+
+    # Reads the current cache.
+    # @return [Hash] A hash representation of the cache on disk.
+    def read
+      if File.exist? path
+        File.open(path) do |file|
+          Marshal.load(file)
+        end
+      else
+        write({})
+      end
+    end
+
+    private
+
+    attr_reader :path
+
+    # @!visibility private
+    #
+    # Writes `hash` as a serial object.  The existing data is overwritten.
+    #
+    # @param [Hash] hash The hash to write.
+    # @raise [ArgumentError] The `hash` parameter must not be nil and it must
+    #  be a Hash.
+    # @raise [TypeError] If the hash contains objects that cannot be written
+    #  by Marshal.dump.
+    #
+    # @return [Hash] Returns the `hash` argument.
+    def write(hash)
+      if hash.nil?
+        raise ArgumentError, 'Expected the hash parameter to be non-nil'
+      end
+
+      unless hash.is_a?(Hash)
+        raise ArgumentError, "Expected #{hash} to a Hash, but it is a #{hash.class}"
+      end
+
+      directory = File.dirname(path)
+      unless File.exist?(directory)
+        FileUtils.mkdir_p(directory)
+      end
+
+      File.open(path, 'w') do |file|
+        Marshal.dump(hash, file)
+      end
+      hash
+    end
+  end
+end

data/lib/run_loop/cli/cli.rb

@@ -0,0 +1,48 @@
+require 'thor'
+require 'run_loop'
+require 'run_loop/cli/errors'
+require 'run_loop/cli/instruments'
+require 'run_loop/cli/simctl'
+require "run_loop/cli/locale"
+require "run_loop/cli/codesign"
+require "run_loop/cli/tcc"
+
+trap 'SIGINT' do
+  puts 'Trapped SIGINT - exiting'
+  exit 10
+end
+
+module RunLoop
+
+  module CLI
+
+    class Tool < Thor
+      include Thor::Actions
+
+      def self.exit_on_failure?
+        true
+      end
+
+      desc 'version', 'Prints version of the run_loop gem'
+      def version
+        puts RunLoop::VERSION
+      end
+
+      desc 'instruments', "Interact with Xcode's command-line instruments"
+      subcommand 'instruments', RunLoop::CLI::Instruments
+
+      desc 'simctl', "Interact with Xcode's command-line simctl"
+      subcommand 'simctl', RunLoop::CLI::Simctl
+
+      desc "locale", "Tools for interacting with locales"
+      subcommand "locale", RunLoop::CLI::Locale
+
+      desc "codesign", "Tools for interacting with codesign"
+      subcommand "codesign", RunLoop::CLI::Codesign
+
+      desc "tcc", "Tools for interacting with simulator privacy settings"
+      subcommand "tcc", RunLoop::CLI::TCC
+
+    end
+  end
+end

data/lib/run_loop/cli/codesign.rb

@@ -0,0 +1,24 @@
+require "thor"
+require "run_loop"
+require "run_loop/cli/errors"
+
+module RunLoop
+  module CLI
+    class Codesign < Thor
+
+      desc "info ARTIFACT", "Print codesign information about ARTIFACT (ipa, app, or library)"
+
+      def info(app_or_ipa)
+        extension = File.extname(app_or_ipa)
+
+        if extension == ".app"
+          puts RunLoop::App.new(app_or_ipa).codesign_info
+        elsif extension == ".ipa"
+          puts RunLoop::Ipa.new(app_or_ipa).codesign_info
+        else
+          puts RunLoop::Codesign.info(app_or_ipa)
+        end
+      end
+    end
+  end
+end

data/lib/run_loop/cli/errors.rb

@@ -0,0 +1,11 @@
+require 'thor'
+
+module RunLoop
+  module CLI
+    class ValidationError < Thor::InvocationError
+    end
+
+    class NotImplementedError < Thor::InvocationError
+    end
+  end
+end