instrumentality 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 05ae3b363734c9eb4a9c6cbbbb3b2d2f7e4c3d87
+  data.tar.gz: 8ac7c4c91afa271574d1e78e8a09b69eaf48badc
+SHA512:
+  metadata.gz: 4fb9e519ea950637947cc7e06ed3fd895966bd8d554f1016fb1cb7b1b1ea7cab5a3ebed8ad8c9abdbe8ec10b0329b1f4de6f5a1e4d811c5343b0c8eb6f618eb7
+  data.tar.gz: 5432bc1923d7091db9920d82f8e8bfd6bcc50c55026ee7fe51b33e8a332ebde863c899eac44048e9645eed68d80e8b7aa1ea8c6f07f147f2367817e5c01a91c6

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.2.7
+before_install: gem install bundler -v 1.15.4

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in instrumentality.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Renzo Crisóstomo
+
+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/README.md

@@ -0,0 +1,35 @@
+# Instrumentality
+
+Command line interface to profiling tools for iOS development
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'instrumentality'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install instrumentality
+
+## Usage
+
+    $ instr --help
+
+## Development
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/Ruenzuo/instrumentality.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/instr

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.push File.expand_path('../lib', File.dirname(__FILE__))
+require 'instrumentality'
+
+Instrumentality.run

data/bin/instrumentality

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.push File.expand_path('../lib', File.dirname(__FILE__))
+require 'instrumentality'
+
+Instrumentality.run

data/instrumentality.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "instrumentality/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "instrumentality"
+  spec.version       = Instrumentality::VERSION
+  spec.authors       = ["Renzo Crisóstomo"]
+  spec.email         = ["renzo.crisostomo@here.com"]
+
+  spec.summary       = %q{Command line interface to profiling tools for iOS development}
+  spec.description   = %q{Command line interface to profiling tools for iOS development}
+  spec.homepage      = "https://github.com/Ruenzuo/instrumentality"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "bin"
+  spec.executables   = ["instrumentality", "instr"]
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency 'claide', '~> 1.0.2'
+  spec.add_runtime_dependency 'colorize', '~> 0.8.1'
+  spec.add_runtime_dependency 'simctl', '~> 1.6.2'
+
+  spec.add_development_dependency "bundler", "~> 1.15"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

data/lib/instrumentality.rb

@@ -0,0 +1,9 @@
+require 'instrumentality/version'
+require 'instrumentality/command'
+require 'claide'
+
+module Instrumentality
+  def self.run
+    Command.run(ARGV)
+  end
+end

data/lib/instrumentality/command.rb

@@ -0,0 +1,18 @@
+require 'claide'
+require 'instrumentality/version'
+
+module Instrumentality
+  class Command < CLAide::Command
+    require 'instrumentality/command/benchmark'
+    require 'instrumentality/command/file_activity'
+    require 'instrumentality/command/generate_header'
+    require 'instrumentality/command/custom'
+
+    self.abstract_command = true
+    self.command = 'instr'
+    self.version = Instrumentality::VERSION
+    self.description = <<-DESC
+      Command line interface to profiling tools for iOS development
+    DESC
+  end
+end

data/lib/instrumentality/command/benchmark.rb

@@ -0,0 +1,61 @@
+require 'instrumentality/command'
+require 'instrumentality/finder'
+require 'instrumentality/profiler'
+require 'instrumentality/constants'
+require 'ostruct'
+
+module Instrumentality
+  class Benchmark < Command
+    def self.options
+      [
+        ['--workspace=path/to/name.xcworkspace', 'If not set, Instr will try to find one'],
+        ['--project=path/to/name.xcodeproj', 'If not set and workspace search failed, Instr will try to find one'],
+        ['--scheme=name', 'If not set, Instr will use the process name'],
+        ['--server-port=port_number', 'If not set, Instr will use 8080'],
+        ['--interactive', 'If set, Instr will not attempt to run an Xcode scheme, but instead attach DTrace directly'],
+        ['--experimental', "Don't use it if you don't know what it does"],
+      ].concat(super)
+    end
+
+    self.arguments = [
+      CLAide::Argument.new("process", true),
+    ]
+
+    self.summary = <<-DESC
+      Runs a benchmark against a specific iOS process. Requires static probes.
+    DESC
+
+    def initialize(argv)
+      @process = argv.shift_argument
+      @workspace = argv.option('workspace') || Finder.find_workspace
+      @project = argv.option('project')
+      @project ||= Finder.find_project if @workspace.nil?
+      @scheme = argv.option('scheme') || @process
+      @server_port = argv.option('server-port') || Constants::DEFAULT_SERVER_PORT
+      @interactive = argv.flag?('interactive', false)
+      @experimental = argv.flag?('experimental', false)
+      super
+    end
+
+    def validate!
+      super
+
+      help! 'A process name is required' unless @process
+      return if @interactive
+      help! 'Xcode workspace or project files not found' if @workspace.nil? && @project.nil?
+    end
+
+    def run
+      config = OpenStruct.new({'script' => Constants::BENCHMARK_SCRIPT,
+                               'process' => @process,
+                               'workspace' => @workspace,
+                               'project' => @project,
+                               'scheme' => @scheme,
+                               'server_port' => @server_port,
+                               'interactive' => @interactive,
+                               'experimental' => @experimental})
+      profiler = Profiler.new(config, @verbose)
+      profiler.profile
+    end
+  end
+end

data/lib/instrumentality/command/custom.rb

@@ -0,0 +1,62 @@
+require 'instrumentality/command'
+require 'instrumentality/finder'
+require 'instrumentality/profiler'
+require 'instrumentality/constants'
+require 'ostruct'
+
+module Instrumentality
+  class Custom < Command
+    def self.options
+      [
+        ['--workspace=path/to/name.xcworkspace', 'If not set, Instr will try to find one'],
+        ['--project=path/to/name.xcodeproj', 'If not set and workspace search failed, Instr will try to find one'],
+        ['--scheme=name', 'If not set, Instr will use the process name'],
+        ['--server-port=port_number', 'If not set, Instr will use 8080'],
+        ['--interactive', 'If set, Instr will not attempt to run an Xcode scheme, but instead attach DTrace directly'],
+      ].concat(super)
+    end
+
+    self.arguments = [
+      CLAide::Argument.new("process", true),
+      CLAide::Argument.new("script", true),
+    ]
+
+    self.summary = <<-DESC
+      Runs a DTrace script against a specific iOS process.
+    DESC
+
+    def initialize(argv)
+      @process = argv.shift_argument
+      @script = argv.shift_argument
+      @workspace = argv.option('workspace') || Finder.find_workspace
+      @project = argv.option('project')
+      @project ||= Finder.find_project if @workspace.nil?
+      @scheme = argv.option('scheme') || @process
+      @server_port = argv.option('server-port') || Constants::DEFAULT_SERVER_PORT
+      @interactive = argv.flag?('interactive', false)
+      super
+    end
+
+    def validate!
+      super
+
+      help! 'A process name is required' unless @process
+      help! 'A valid script path is required' unless File.exist?(@script)
+      return if @interactive
+      help! 'Xcode workspace or project files not found' if @workspace.nil? && @project.nil?
+    end
+
+    def run
+      config = OpenStruct.new({'script' => @script,
+                               'process' => @process,
+                               'workspace' => @workspace,
+                               'project' => @project,
+                               'scheme' => @scheme,
+                               'server_port' => @server_port,
+                               'interactive' => @interactive,
+                               'experimental' => false})
+      profiler = Profiler.new(config, @verbose)
+      profiler.profile
+    end
+  end
+end

data/lib/instrumentality/command/file_activity.rb

@@ -0,0 +1,61 @@
+require 'instrumentality/command'
+require 'instrumentality/finder'
+require 'instrumentality/profiler'
+require 'instrumentality/constants'
+require 'ostruct'
+
+module Instrumentality
+  class FileActivity < Command
+    def self.options
+      [
+        ['--workspace=path/to/name.xcworkspace', 'If not set, Instr will try to find one'],
+        ['--project=path/to/name.xcodeproj', 'If not set and workspace search failed, Instr will try to find one'],
+        ['--scheme=name', 'If not set, Instr will use the process name'],
+        ['--server-port=port_number', 'If not set, Instr will use 8080'],
+        ['--interactive', 'If set, Instr will not attempt to run an Xcode scheme, but instead attach DTrace directly'],
+        ['--experimental', "Don't use it if you don't know what it does"],
+      ].concat(super)
+    end
+
+    self.arguments = [
+      CLAide::Argument.new("process", true),
+    ]
+
+    self.summary = <<-DESC
+      Prints files read or write by a specific iOS process.
+    DESC
+
+    def initialize(argv)
+      @process = argv.shift_argument
+      @workspace = argv.option('workspace') || Finder.find_workspace
+      @project = argv.option('project')
+      @project ||= Finder.find_project if @workspace.nil?
+      @scheme = argv.option('scheme') || @process
+      @server_port = argv.option('server-port') || Constants::DEFAULT_SERVER_PORT
+      @interactive = argv.flag?('interactive', false)
+      @experimental = argv.flag?('experimental', false)
+      super
+    end
+
+    def validate!
+      super
+
+      help! 'A process name is required' unless @process
+      return if @interactive
+      help! 'Xcode workspace or project files not found' if @workspace.nil? && @project.nil?
+    end
+
+    def run
+      config = OpenStruct.new({'script' => Constants::FILE_ACTIVITY_SCRIPT,
+                               'process' => @process,
+                               'workspace' => @workspace,
+                               'project' => @project,
+                               'scheme' => @scheme,
+                               'server_port' => @server_port,
+                               'interactive' => @interactive,
+                               'experimental' => @experimental})
+      profiler = Profiler.new(config, @verbose)
+      profiler.profile
+    end
+  end
+end

data/lib/instrumentality/command/generate_header.rb

@@ -0,0 +1,35 @@
+require 'instrumentality/command'
+require 'instrumentality/header_generator'
+
+module Instrumentality
+  class GenerateHeader < Command
+    def self.options
+      [
+      ].concat(super)
+    end
+
+    self.arguments = [
+      CLAide::Argument.new("instrument", true),
+    ]
+
+    self.summary = <<-DESC
+      Generates Objective-C header for instrument.
+    DESC
+
+    def initialize(argv)
+      @instrument = argv.shift_argument
+      super
+    end
+
+    def validate!
+      super
+
+      help! 'An instrument name is required' unless @instrument
+    end
+
+    def run
+      header_generator = HeaderGenerator.new(@instrument, @verbose)
+      header_generator.generate
+    end
+  end
+end

data/lib/instrumentality/constants.rb

@@ -0,0 +1,17 @@
+module Instrumentality
+  module Constants
+    TIMEOUT = 60
+    OUTPUT_PREFIX = "[Instr]".freeze
+    BENCHMARK_SCRIPT = "benchmark.d".freeze
+    FILE_ACTIVITY_SCRIPT = "file_activity.d".freeze
+    DTRACE_OUTPUT = "dtrace_output".freeze
+    TRACE_SCRIPT_DELIMITER = ":".freeze
+    RESPONSE_CODE = "200".freeze
+    SUCCESS = "true".freeze
+    JTL_REPORT = "instr.jtl".freeze
+    DEFAULT_RUNTIME = "latest".freeze
+    DEFAULT_DEVICE = "iPhone 6".freeze
+    DEFAULT_SERVER_PORT = 8080
+    EXPERIMENTAL = "experimental_".freeze
+  end
+end

data/lib/instrumentality/executor.rb

@@ -0,0 +1,40 @@
+require 'instrumentality/constants'
+require 'claide'
+require 'colorize'
+require 'timeout'
+
+module Instrumentality
+  class Executor
+    class ExecutorError < StandardError; include CLAide::InformativeError; end
+
+    def self.execute(cmd, verbose = false)
+      puts "#{Constants::OUTPUT_PREFIX} Executing command: #{cmd}"
+      if verbose
+        system(cmd)
+      else
+        `#{cmd}`
+      end
+      status = $?.exitstatus
+      raise ExecutorError, "Previous command execution failed with status: #{status}".red if status != 0
+    end
+
+    def self.execute_async(cmd)
+      spawn("#{cmd}").tap do |pid|
+        puts "#{Constants::OUTPUT_PREFIX} Spawned process (PID: #{pid}) from command: #{cmd}"
+      end
+    end
+
+    def self.timeout(process, seconds = Constants::TIMEOUT)
+      pid = ""
+      Timeout.timeout(seconds) do
+        loop do
+          pid = `ps aux | grep #{process}.app | grep -v grep | awk '{print $2}'`.strip
+          break if pid != ""
+        end
+      end
+      pid.tap do |pid|
+        puts "#{Constants::OUTPUT_PREFIX} Found process #{process} with PID: #{pid}"
+      end
+    end
+  end
+end

data/lib/instrumentality/finder.rb

@@ -0,0 +1,32 @@
+module Instrumentality
+  class Finder
+    def self.find_workspace
+      find('*.xcworkspace', 1).first
+    end
+
+    def self.find_project
+      find('*.xcodeproj', 1).first
+    end
+
+    def self.find_xctestrun(location)
+      find('*.xctestrun', 0, location).first
+    end
+
+    def self.path_for_script(name)
+      return name if File.exist?(name)
+      File.expand_path("../scripts/#{name}", __FILE__)
+    end
+
+    def self.path_for_header(name)
+      File.expand_path("../headers/#{name}", __FILE__)
+    end
+
+    def self.find(name, depth = 0, location = '.')
+      cmd = %W[find #{location} -name '#{name}']
+      cmd += %W[-maxdepth #{depth}] if depth > 0
+      `#{cmd.join(' ')}`.split("\n")
+    end
+
+    private_class_method :find
+  end
+end

data/lib/instrumentality/header_generator.rb

@@ -0,0 +1,21 @@
+require 'instrumentality/executor'
+require 'instrumentality/finder'
+require 'instrumentality/constants'
+
+module Instrumentality
+  class HeaderGenerator
+    attr_reader :instrument, :verbose
+
+    def initialize(instrument, verbose)
+      @instrument = instrument
+      @verbose = verbose
+    end
+
+    def generate
+      dtrace_cmd = %w[dtrace]
+      dtrace_cmd += %W[-h -s #{Finder.path_for_header(Constants::BENCHMARK_SCRIPT)}]
+      cmd = dtrace_cmd.join(' ')
+      Executor.execute(cmd, verbose)
+    end
+  end
+end

data/lib/instrumentality/headers/benchmark.d

@@ -0,0 +1,4 @@
+provider instr {
+  probe benchmark_begin(char *);
+  probe benchmark_end(char *);
+};

data/lib/instrumentality/profiler.rb

@@ -0,0 +1,130 @@
+require 'instrumentality/executor'
+require 'instrumentality/finder'
+require 'instrumentality/constants'
+require 'instrumentality/simctl'
+require 'net/http'
+require 'uri'
+
+module Instrumentality
+  class Profiler
+    class ProfilerInterruptError < StandardError; include CLAide::InformativeError; end
+    class ProfilerError < StandardError; include CLAide::InformativeError; end
+    attr_reader :config, :script_path, :verbose, :xcodebuild_pid, :app_pid, :dtrace_pid
+
+    def initialize(config, verbose)
+      @config = config
+      @verbose = verbose
+      script = config.script.dup
+      script.prepend(Constants::EXPERIMENTAL) if @config.experimental
+      @script_path = Finder.path_for_script(script)
+      raise ProfilerError, "This intrument doesn't support --experimental flag".red unless File.exist?(script_path)
+    end
+
+    def profile
+      return interactive if @config.interactive
+      current_directory = Dir.pwd
+      Dir.mktmpdir do |tmpdir|
+        compile(current_directory, tmpdir)
+        Simctl.execute_with_simulator_ready(Constants::DEFAULT_RUNTIME, Constants::DEFAULT_DEVICE) do |device|
+          run_tests(tmpdir, device)
+          find_app_pid
+          notify_server
+          attach_dtrace(tmpdir)
+          wait
+        end
+        process_dtrace_output(current_directory, tmpdir)
+      end
+    end
+
+    private
+
+    def interactive()
+      find_app_pid
+      attach_dtrace('.')
+      stream_dtrace_output
+    end
+
+    def compile(current_directory, temporary_directory)
+      xcodebuild_cmd = %w[xcodebuild]
+      xcodebuild_cmd += if config.workspace
+                          %W[-workspace #{current_directory}/#{config.workspace}]
+                        else
+                          %W[-project #{current_directory}/#{config.project}]
+                        end
+      xcodebuild_cmd += %W[-scheme #{config.scheme}]
+      xcodebuild_cmd += %w[-sdk iphonesimulator]
+      xcodebuild_cmd += %W[-derivedDataPath #{temporary_directory}/derivedData]
+      xcodebuild_cmd += %w[clean build-for-testing]
+      cmd = xcodebuild_cmd.join(' ')
+      Executor.execute(cmd, verbose)
+    end
+
+    def run_tests(temporary_directory, device)
+      xctestrun = Finder.find_xctestrun(temporary_directory)
+      xcodebuild_cmd = %w[xcodebuild]
+      xcodebuild_cmd += %W[-xctestrun #{xctestrun}]
+      xcodebuild_cmd += %W[-destination 'platform=iOS Simulator,id=#{device.udid}']
+      xcodebuild_cmd += %w[test-without-building]
+      cmd = xcodebuild_cmd.join(' ')
+      @xcodebuild_pid = Executor.execute_async(cmd)
+    end
+
+    def find_app_pid
+      @app_pid = Executor.timeout(config.process)
+    end
+
+    def notify_server
+      uri = URI.parse("http://localhost:#{config.server_port}/")
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.request(Net::HTTP::Get.new(uri.request_uri))
+    rescue
+      retry
+    end
+
+    def attach_dtrace(temporary_directory)
+      dtrace_cmd = %w[sudo dtrace]
+      dtrace_cmd += %W[-q -s #{script_path}]
+      dtrace_cmd += %W[-p #{app_pid}]
+      dtrace_cmd += %W[> #{temporary_directory}/#{Constants::DTRACE_OUTPUT}]
+      cmd = dtrace_cmd.join(' ')
+      @dtrace_pid = Executor.execute_async(cmd)
+    end
+
+    def wait
+      Process.wait(xcodebuild_pid)
+      Process.kill("QUIT", dtrace_pid)
+    end
+
+    def process_dtrace_output(current_directory, temporary_directory)
+      report = "timeStamp,elapsed,label,responseCode,success\n"
+      epoch = Time.now.to_i
+      File.readlines("#{temporary_directory}/#{Constants::DTRACE_OUTPUT}").each do |line|
+        to_parse = line.strip
+        next if to_parse.empty?
+        values = to_parse.split(Constants::TRACE_SCRIPT_DELIMITER)
+        view_controller = values[0]
+        elapsed = values[1].to_f / 1000000
+        report += "#{epoch},%.0f,#{view_controller},#{Constants::RESPONSE_CODE},#{Constants::SUCCESS}\n" % elapsed
+      end
+      File.write("#{current_directory}/#{Constants::JTL_REPORT}", report)
+    end
+
+    def stream_dtrace_output
+      output_file = Constants::DTRACE_OUTPUT
+      FileUtils.rm_rf(output_file) if File.exist? output_file
+      touch_cmd = %W[touch "#{output_file}"]
+      cmd = touch_cmd.join(' ')
+      Executor.execute(cmd, verbose)
+      stream = IO.new(IO.sysopen(output_file))
+      puts "#{Constants::OUTPUT_PREFIX} Started interactive session. #{"Press CTRL+C to finish.".blue}"
+      begin
+        loop do
+          output = stream.gets
+          puts output unless output.nil?
+        end
+      rescue SignalException => e
+        raise ProfilerInterruptError, "Interactive session ended. Full output at ./#{output_file}".green
+      end
+    end
+  end
+end

data/lib/instrumentality/scripts/benchmark.d

@@ -0,0 +1,14 @@
+instr$target:::benchmark_begin
+{
+  time = timestamp;
+  tag = copyinstr(arg0);
+  tag_times[tag] = time;
+}
+
+instr$target:::benchmark_end
+/ tag_times[copyinstr(arg0)] != 0 /
+{
+  tag = copyinstr(arg0);
+  time = (timestamp - tag_times[tag]);
+  printf("%s:%d\n", tag, time);
+}

data/lib/instrumentality/scripts/experimental_file_activity.d

@@ -0,0 +1,12 @@
+syscall::open*:entry
+/ pid == $target /
+{
+  printf("%s file opened by %s\n", copyinstr(arg0), execname);
+}
+
+syscall::read*:entry,syscall::write*:entry
+/ pid == $target /
+{
+  printf("%s file %s by %s\n", fds[arg0].fi_pathname, probefunc, execname)
+}
+

data/lib/instrumentality/scripts/file_activity.d

@@ -0,0 +1,5 @@
+syscall::read*:entry,syscall::write*:entry
+/ pid == $target /
+{
+  printf("%s file %s by %s\n", fds[arg0].fi_pathname, probefunc, execname)
+}

data/lib/instrumentality/simctl.rb

@@ -0,0 +1,47 @@
+require 'instrumentality/constants'
+require 'simctl'
+
+module Instrumentality
+  class Simctl
+    def self.execute_with_simulator_ready(runtime, type)
+      device = create_device(runtime, type)
+      device.launch
+      device.wait(Constants::TIMEOUT) do |d|
+        d.state == :booted && d.ready?
+      end
+      begin
+        yield device
+      rescue StandardError => error
+        throw error
+      ensure
+        delete_device(device)
+      end
+    end
+
+    def self.create_device(runtime, type)
+      runtime = if runtime.eql? 'latest'
+                  SimCtl::Runtime.latest('ios')
+                else
+                  SimCtl.runtime(name: runtime)
+                end
+      device_type = SimCtl.devicetype(name: type)
+      device_name = "#{type}-instr"
+      SimCtl.reset_device(device_name, device_type, runtime)
+    end
+
+    private_class_method :create_device
+
+    def self.delete_device(device)
+      if device.state != :shutdown
+        device.shutdown
+        device.kill
+        device.wait do |d|
+          d.state == :shutdown
+        end
+      end
+      device.delete
+    end
+
+    private_class_method :delete_device
+  end
+end

data/lib/instrumentality/version.rb

@@ -0,0 +1,3 @@
+module Instrumentality
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,158 @@
+--- !ruby/object:Gem::Specification
+name: instrumentality
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Renzo Crisóstomo
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-10-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: claide
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+- !ruby/object:Gem::Dependency
+  name: simctl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.6.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.6.2
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !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'
+description: Command line interface to profiling tools for iOS development
+email:
+- renzo.crisostomo@here.com
+executables:
+- instrumentality
+- instr
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/instr
+- bin/instrumentality
+- instrumentality.gemspec
+- lib/instrumentality.rb
+- lib/instrumentality/command.rb
+- lib/instrumentality/command/benchmark.rb
+- lib/instrumentality/command/custom.rb
+- lib/instrumentality/command/file_activity.rb
+- lib/instrumentality/command/generate_header.rb
+- lib/instrumentality/constants.rb
+- lib/instrumentality/executor.rb
+- lib/instrumentality/finder.rb
+- lib/instrumentality/header_generator.rb
+- lib/instrumentality/headers/benchmark.d
+- lib/instrumentality/profiler.rb
+- lib/instrumentality/scripts/benchmark.d
+- lib/instrumentality/scripts/experimental_file_activity.d
+- lib/instrumentality/scripts/file_activity.d
+- lib/instrumentality/simctl.rb
+- lib/instrumentality/version.rb
+homepage: https://github.com/Ruenzuo/instrumentality
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.2
+signing_key: 
+specification_version: 4
+summary: Command line interface to profiling tools for iOS development
+test_files: []
+has_rdoc: