crash_monkey 0.1.7 → 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d470a651eddb157e7ac2731e05540776be327c65
+  data.tar.gz: dd44b5fadd94a093c47b2e4841976519ca28988b
+SHA512:
+  metadata.gz: 3266dfc8968cd88839a926976a0cfa71dbc36f4992a1271070d706ffb257be8c4c1c2e71aecb4b7488e5aad2d11231d2356c386fe4ab7c6b7da0d7d0a1dd08d3
+  data.tar.gz: 26e71a962b45f54fa00d8d911fcca4224c24ad74ac33d1889d18182a4db947ac391947763671b450ea17bbe0ce0c0337281040f25894bafcfdcc9aa1715fd83d

data/Gemfile

@@ -13,5 +13,9 @@ group :development do
   gem 'rdoc', '~> 3.12'
   gem 'bundler', '> 1.0.0'
   gem 'jeweler', '~> 1.8.4'
-  gem 'rcov', '>= 0'
+  if RUBY_VERSION > '1.9' then
+    gem 'simplecov', '>= 0.8.2'
+  else
+    gem 'rcov', '>= 0'
+  end
 end

data/Gemfile.lock

@@ -1,13 +1,14 @@
 GEM
   remote: http://rubygems.org/
   specs:
-    addressable (2.3.5)
+    addressable (2.3.6)
     builder (3.2.2)
     diff-lcs (1.1.3)
+    docile (1.1.3)
     erubis (2.7.0)
-    faraday (0.8.7)
-      multipart-post (~> 1.1)
-    git (1.2.5)
+    faraday (0.8.9)
+      multipart-post (~> 1.2.0)
+    git (1.2.6)
     github_api (0.10.1)
       addressable
       faraday (~> 0.8.1)
@@ -16,9 +17,8 @@ GEM
       nokogiri (~> 1.5.2)
       oauth2
     hashie (2.0.5)
-    highline (1.6.19)
-    httpauth (0.2.0)
-    jeweler (1.8.6)
+    highline (1.6.21)
+    jeweler (1.8.8)
       builder
       bundler (~> 1.0)
       git (>= 1.2.5)
@@ -27,23 +27,21 @@ GEM
       nokogiri (= 1.5.10)
       rake
       rdoc
-    json (1.8.0)
-    jwt (0.1.8)
+    json (1.8.1)
+    jwt (0.1.11)
       multi_json (>= 1.5)
-    multi_json (1.7.7)
-    multi_xml (0.5.4)
+    multi_json (1.9.2)
+    multi_xml (0.5.5)
     multipart-post (1.2.0)
     nokogiri (1.5.10)
-    oauth2 (0.9.2)
-      faraday (~> 0.8)
-      httpauth (~> 0.2)
-      jwt (~> 0.1.4)
-      multi_json (~> 1.0)
+    oauth2 (0.9.3)
+      faraday (>= 0.8, < 0.10)
+      jwt (~> 0.1.8)
+      multi_json (~> 1.3)
       multi_xml (~> 0.5)
       rack (~> 1.2)
     rack (1.5.2)
-    rake (10.1.0)
-    rcov (1.0.0)
+    rake (10.2.2)
     rdoc (3.12.2)
       json (~> 1.4)
     rspec (2.8.0)
@@ -54,6 +52,11 @@ GEM
     rspec-expectations (2.8.0)
       diff-lcs (~> 1.1.2)
     rspec-mocks (2.8.0)
+    simplecov (0.8.2)
+      docile (~> 1.1.0)
+      multi_json
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
 
 PLATFORMS
   ruby
@@ -63,6 +66,6 @@ DEPENDENCIES
   erubis (>= 2.7.0)
   jeweler (~> 1.8.4)
   json (>= 1.7.0)
-  rcov
   rdoc (~> 3.12)
   rspec (~> 2.8.0)
+  simplecov (>= 0.8.2)

data/README.md

@@ -1,24 +1,42 @@
 CrashMonkey
 ===========
+[Japanese](README_jp.md)
 
-概要
+About
 ----
 
-iOSのアプリケーションをモンキーテスト（ランダムな操作をひたすら行う）するためのツールです。
-動作イメージはこの[デモ動画](http://youtu.be/y5PZGVbLHtI)を御覧ください。
-iPhone Simulatorの操作にはUIAutomationを使っていて、ベースとして[ui-auto-monkey](https://github.com/jonathanpenn/ui-auto-monkey)を使わせて頂きました。
+This is a tool of monkey test(random operation test) for iOS applications.
+Please watch the [demo movie](http://youtu.be/y5PZGVbLHtI).
+CrashMonkey uses UIAutomation and modified [ui-auto-monkey](https://github.com/jonathanpenn/ui-auto-monkey) for iPhone Simulator manipulation.
 
 
-動作環境
+Environment
 -------
 
-以下の環境でのみ確認してあります。
+It is confirmed only in the following environment.
 
 * Max OS X 10.8.4
 * Xcode 4.6.3(Build version 4H1503)
 * Ruby 1.8.7-p371
 
-Rubyについては、1.9系, 2.0系でも動くと思います。
+Ruby versions may be OK 1.9.x and 2.0.x.
+
+Features
+---------
+
+### Good Points
+
+* No need to modify the app's project.
+* It can specify the running period and times.
+* The results of Screenshots and Operations history can be shown as HTML.
+* the console log and crash report can be shown.
+* It is easy to be used from CI tools like Jenkins.
+
+### Restrictions
+
+* It can be run only in iPhone Simulator.
+* The test can not continue when another application(like Safari) is the most front. (detect and finish the test).
+* It can not input suitable characters like ID/Pass.
 
 
 Install
@@ -28,16 +46,19 @@ Install
 gem install crash_monkey --no-ri --no-rdoc
 ```
 
-使いかた
+How to use
 ------
 
+### Simple Usage
+
 ```
 crash_monkey -a <APP_NAME or APP_PATH>
 ```
 
-`-a`でアプリの名前かPATHを指定します。
+`-a` specify AppName or PATH.
+
 
-#### 例
+#### Example
 
 ```
 crash_monkey -a MyAwesomeApp.app                               # (1)
@@ -45,11 +66,10 @@ crash_monkey -a build/Debug-iphonesimulator/MyAwesomeApp.app   # (2)
 crash_monkey -a ~/Library/Developer/Xcode/DerivedData/MyAwesomeApp-ffumcy/Build/Products/Debug-iphonesimulator/MyAwesomeApp.app # (3)
 ```
 
-* (1) の指定方法では、iPhone Simulatorにインストールされているアプリで名前が一致するものを実行します。同名のものが複数ある場合は更新時刻が一番新しいものを使います
-* (2)(3) の指定方法では、PATHにあるアプリを実行します。ただし、iPhone Simulator用にビルドされたものじゃないと使えないので注意して下さい。
-	* Dir名に **iphonesimulator** と入っているものが大抵そうです
-
+* in (1) case, an application is executed which matches the app's name installed in iPhone Simulator. If there are same name apps, the app of latest updated time is used.
 
+* in (2)(3) cases, an app which in the PATH is excuted. It is required that the app is built for iPhone Simlator.
+ 
 
 
 ### Options
@@ -62,29 +82,91 @@ Usage: crash_monkey [options]
     -d result_dir                    Where to output result(default: ./crash_monkey_result)
     -t time_limit_sec                Time limit of running(default: 100 sec)
     -c config_path                   Configuration JSON Path
+    -e extend_javascript_path        Extend Uiautomation Javascript for such Login scripts
         --show-config                Show Current Configuration JSON
         --list-app                   Show List of Installed Apps in iOS Simulator
+        --reset-iPhone-Simulator     Reset iPhone Simulator
 ```
 
 
 #### -n
-Monkey Testを実行する回数を指定します。
+The times for monkey test excution.
 
 #### -d
-結果を出力するDirを指定します。
+The directory for output results.
 
 #### -t
-1回のテストのTimeoutを秒で指定します。
+Timeout seconds for one monkey test.
 
 #### -c
-UIAutomationの実行時に使うJSON形式のConfigファイルを指定します。雛形については `--show-config`オプションで取得してください。
+Specify configuration file(JSON format) for UIAutomation library.
+The template is shown by `--show-config` option.
+
+#### -e
+Specify extend Javascript file for UIAutomation library.    
+It could be used for login.([example](https://gist.github.com/jollychang/8972186))
 
 #### --show-config
-UIAutomationの実行時に使うConfigファイルをJSON形式で出力します。変更したい場合は、一度ファイルに保存してから変更し、 `-c` で指定してください。
+Output configuration for UIAutomation library by JSON format.
 
 #### --list-app
+List apps for iPhone Simulator.
+
+#### --reset-iPhone-Simulator.
+Reset iPhone Simulator.
+
+
+For Jenkins
+--------------
+
+CrashMonkey has CUI interface, so easy to use from Jenkins.
+There are a few notes.
+
+### Confirmation dialog from UIAutomation is displayed and stop tests.
+
+The first time in the Mac CrashMonkey run, Instruments(UIAutomation) may display a confirmation dialog and require to input password.
+
+In this case, the test can not run if the password is not entered. The following management may be valid.
+
+
+* The Jenkins running User has Administration privilege.
+* In case Jenkins is running as slave, launch with X like following.
+
+	```
+	javaws http://<SERVER>/computer/<NodeName>/slave-agent.jnlp
+	```
+
+* The first time a Jenkins Job runs in the Mac, if the dialog is displyed then input correct password.
+
+Other conditions may be OK, but this is also work.
+
+
+Troubleshooting
+-------------------
+
+### CASE: xcode-select is not set.
+
+
+#### symptoms
+
+```
+% crash_monkey -a MyGoodApp.app
+.....
+Run: ["instruments", "-l", "100000", "-t", ........... ]
+xcode-select: Error: No Xcode folder is set. Run xcode-select -switch <xcode_folder_path> to set the path to the Xcode folder.
+.....
+```
+
+#### measures
+
+Please specify the install path of Xcode by **xcode-select**.
+
+ex）
+
+```
+sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
+```
 
-iPhone Simulatorにインストールされているアプリの名前の一覧を表示します。
 
 
 Contributing to CrashMonkey

data/Rakefile

@@ -31,9 +31,17 @@ RSpec::Core::RakeTask.new(:spec) do |spec|
   spec.pattern = FileList['spec/**/*_spec.rb']
 end
 
-RSpec::Core::RakeTask.new(:rcov) do |spec|
-  spec.pattern = 'spec/**/*_spec.rb'
-  spec.rcov = true
+if RUBY_VERSION =~ /^1\.9/
+  desc "Code coverage detail"
+  task :simplecov do
+    ENV['COVERAGE'] = "true"
+    Rake::Task['spec'].execute
+  end
+else
+  RSpec::Core::RakeTask.new(:rcov) do |spec|
+    spec.pattern = 'spec/**/*_spec.rb'
+    spec.rcov = true
+  end
 end
 
 task :default => :spec

data/bin/crash_monkey

@@ -14,8 +14,10 @@ ARGV.options do |o|
   o.on('-d result_dir', 'Where to output result(default: ./crash_monkey_result)') {|b| opts[:result_base_dir] = File.expand_path(b)}
   o.on('-t time_limit_sec', 'Time limit of running(default: 100 sec)') {|b| opts[:time_limit_sec] = b.to_i}
   o.on('-c config_path', 'Configuration JSON Path') {|b| opts[:config_path] = File.expand_path(b)}
+  o.on('-e extend_javascript_path', 'Extend Uiautomation Javascript for such Login scripts') {|b| opts[:extend_javascript_path] = File.expand_path(b)}
   o.on('--show-config', 'Show Current Configuration JSON') {|_| opts[:show_config] = true}
   o.on('--list-app', 'Show List of Installed Apps in iOS Simulator') {|_| opts[:list_app] = true}
+  o.on('--reset-iPhone-Simulator', 'Reset iPhone Simulator')
   o.parse!
 end
 

data/crash_monkey.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{crash_monkey}
-  s.version = "0.1.7"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Ken Morishita"]
@@ -76,7 +76,11 @@ Gem::Specification.new do |s|
       s.add_dependency(%q<rdoc>, ["~> 3.12"])
       s.add_dependency(%q<bundler>, ["> 1.0.0"])
       s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
-      s.add_dependency(%q<rcov>, [">= 0"])
+      if RUBY_VERSION =~ /^1\.9/ then
+        s.add_dependency(%q<simplecov>, [">= 0"])
+      else
+        s.add_dependency(%q<rcov>, [">= 0"])
+      end
     end
   else
     s.add_dependency(%q<erubis>, [">= 2.7.0"])

data/lib/crash_monkey/monkey_runner.rb

@@ -23,6 +23,8 @@ module UIAutoMonkey
       elsif @options[:list_app]
         list_app
         return true
+      elsif @options[:reset_iphone_simulator]
+        reset_iphone_simulator
       end
       ###########
       log @options.inspect
@@ -118,6 +120,13 @@ module UIAutoMonkey
       puts File.read(config_json_path)
     end
 
+    def show_extend_javascript
+      if @options[:extend_javascript_path]
+        filename = @options[:extend_javascript_path]
+        return File.exist?(filename), filename
+      end
+    end
+
     def list_app
       puts find_apps('*.app').map{|n| File.basename n}.uniq.sort.join("\n")
     end
@@ -126,6 +135,10 @@ module UIAutoMonkey
       puts msg
     end
 
+    def reset_iphone_simulator
+      `rm -rf ~/Library/Application\ Support/iPhone\ Simulator/`
+    end
+
     def total_test_count
       (@options[:run_count] || 2)
     end
@@ -206,10 +219,14 @@ module UIAutoMonkey
     end
 
     def generate_ui_auto_monkey
+      extend_javascript_flag, extend_javascript_path =  show_extend_javascript
       orig = File.read(ui_auto_monkey_original_path)
       config = JSON.parse(File.read(config_json_path))
       replace_str = "    config: #{JSON.pretty_generate(config, :indent => ' '*6)}, \n"
       js = replace_text(orig, replace_str, '__UIAutoMonkey Configuration Begin__', '__UIAutoMonkey Configuration End__')
+      if extend_javascript_flag
+        js = File.read(extend_javascript_path) + "\n" + js
+      end
       File.open(ui_auto_monkey_path, 'w') {|f| f.write(js)}
     end
 

metadata

@@ -1,143 +1,123 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: crash_monkey
-version: !ruby/object:Gem::Version 
-  hash: 21
-  prerelease: 
-  segments: 
-  - 0
-  - 1
-  - 7
-  version: 0.1.7
+version: !ruby/object:Gem::Version
+  version: 0.2.0
 platform: ruby
-authors: 
+authors:
 - Ken Morishita
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2013-07-11 00:00:00 +09:00
-default_executable: crash_monkey
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  prerelease: false
-  type: :runtime
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 19
-        segments: 
-        - 2
-        - 7
-        - 0
-        version: 2.7.0
+date: 2013-07-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: erubis
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  prerelease: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.7.0
   type: :runtime
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 11
-        segments: 
-        - 1
-        - 7
-        - 0
-        version: 1.7.0
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.7.0
+- !ruby/object:Gem::Dependency
   name: json
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+  type: :runtime
   prerelease: false
-  type: :development
-  requirement: &id003 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 47
-        segments: 
-        - 2
-        - 8
-        - 0
+      - !ruby/object:Gem::Version
         version: 2.8.0
-  name: rspec
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
-  prerelease: false
   type: :development
-  requirement: &id004 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 31
-        segments: 
-        - 3
-        - 12
-        version: "3.12"
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+- !ruby/object:Gem::Dependency
   name: rdoc
-  version_requirements: *id004
-- !ruby/object:Gem::Dependency 
-  prerelease: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
   type: :development
-  requirement: &id005 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">"
-      - !ruby/object:Gem::Version 
-        hash: 23
-        segments: 
-        - 1
-        - 0
-        - 0
-        version: 1.0.0
-  name: bundler
-  version_requirements: *id005
-- !ruby/object:Gem::Dependency 
   prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>'
+      - !ruby/object:Gem::Version
+        version: 1.0.0
   type: :development
-  requirement: &id006 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>'
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 63
-        segments: 
-        - 1
-        - 8
-        - 4
+      - !ruby/object:Gem::Version
         version: 1.8.4
-  name: jeweler
-  version_requirements: *id006
-- !ruby/object:Gem::Dependency 
-  prerelease: false
   type: :development
-  requirement: &id007 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+- !ruby/object:Gem::Dependency
   name: rcov
-  version_requirements: *id007
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: This is a Monkey Test Tool using UIAutomation.
 email: mokemokechicken@gmail.com
-executables: 
+executables:
 - crash_monkey
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - LICENSE.txt
 - README.md
 - README.rdoc
-files: 
+files:
 - .document
 - .rspec
 - Gemfile
@@ -169,39 +149,28 @@ files:
 - lib/ui-auto-monkey/README.md
 - lib/ui-auto-monkey/UIAutoMonkey.js
 - spec/spec_helper.rb
-has_rdoc: true
 homepage: https://github.com/mokemokechicken/CrashMonkey
-licenses: 
+licenses:
 - MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+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: 1.6.2
+rubygems_version: 2.0.14
 signing_key: 
 specification_version: 3
 summary: Monkey Test For iOS Application
 test_files: []
-