appium_console 0.5.5 → 0.5.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ab6b9095d3d5615359f7e8820357a484600ce5f0
-  data.tar.gz: 261214de26a655a9c1c0cf39a52da04d3cc3de06
+  metadata.gz: 74be2d00f202b86c997aba0ea94b95dbe2ed6954
+  data.tar.gz: d6f971c2792cbb3b2bca32f5b1e7ed382356fd6b
 SHA512:
-  metadata.gz: 4e8e5bf3ed0acb0654a0d0ec9a6fb191fcfa7912cec059ca7a7ca765d76540afc5938cb13e8665bd9adf66491fe8947d563227f102bd7e15c2925d4494cd779d
-  data.tar.gz: b17f506cc7fd35614f99c7b4607ffecc3675a7d7cee19e967788a3b7621f4f659fe9f8c9b8ae1b167bac5b9d1a874a76acceb4f9faad24fc4de6b364c4e9eb47
+  metadata.gz: 525d836b48afdc521142be2175cae6758a595c20aef31d607b9005be0094dbb12a91e818da673be1fd61b95b6d84019cd43c9d11560ac01515a0c56abcec7815
+  data.tar.gz: 94aeba1407b2e96b8c2c236aa09909d27bceecbbfe47165da3527d816e1c28cdaac035d4c290af5682b0172494511f97682513154b0fb8c0395e3e3532ccf78c

data/ios_v_android.md

@@ -1,5 +1,13 @@
 #### Notes on iOS and Android Appium compatibility
 
+#### iOS Ghosting
+
+It's not uncommon to have multiple elements from different pages. To find the correct back button for example,
+it's necessary to find all the back buttons `names('Back')` and then return the first one that's displayed.
+
+This has implications for searching by index. If you select textfield 1 for the 1st textfield, then you may
+be getting a textfield from a previous page. The solution is to ensure each element has a unique accessibility identifier
+and to verify visibility and type.
 
 #### iPhone vs iPad
 

data/lib/appium_console.rb

@@ -5,6 +5,13 @@ require 'pry'
 
 module Appium; end unless defined? Appium
 
+def define_reload paths
+  Pry.send(:define_singleton_method, :reload) do
+    paths.each { |p| load p }
+  end
+  nil
+end
+
 module Appium::Console
   require 'appium_lib'
   AwesomePrint.pry!
@@ -14,6 +21,7 @@ module Appium::Console
   cmd = ['-r', start]
 
   if to_require && !to_require.empty?
+    define_reload to_require
     load_files = to_require.map { |f| %(require "#{f}";) }.join "\n"
     cmd += [ '-e', load_files ]
   end

data/lib/appium_console/version.rb

@@ -2,6 +2,6 @@
 # Define Appium module so version can be required directly.
 module Appium; end unless defined? Appium
 module Appium::Console
-  VERSION = '0.5.5' unless defined? ::Appium::Console::VERSION
-  DATE = '2013-08-23' unless defined? ::Appium::Console::DATE
+  VERSION = '0.5.6' unless defined? ::Appium::Console::VERSION
+  DATE = '2013-11-18' unless defined? ::Appium::Console::DATE
 end

data/lib/start.rb

@@ -12,4 +12,9 @@ begin
   # NoMethodError: undefined method `assert_equal' for nil:NilClass
   Minitest::Spec.new 'pry'
 rescue
+end
+
+def reload
+  Pry.reload
+  nil
 end

data/osx.md

@@ -1,13 +1,43 @@
-#### Getting Started
+### Getting Started
 
-This document is written for OS X 10.8.3 or better. iOS testing requires OS X. Android testing works on OS X, Windows, and Linux.
+This document is written for OS X 10.8.4 or better. iOS testing requires OS X. Android testing works on OS X, Windows, and Linux. 
 
-Install `Xcode` from the Mac app store and the command line build tools (Xcode -> Preferences -> Downloads).
+For OS X, there is rake script which will attempt to do most of this for you, with
+```
+rake -f osx_install.rake
+```
+The rake script will not install Xcode, etc., nor Java, but should take care of everything else. 
+Changes to these instructions might imply changes to that script as well.
+
+#### Steps to install
+
+Install `Xcode` 4.6.3 (iOS 6) or 5.0.0 (iOS 7).
+
+- Xcode 5.0.0 shouldn't be used for iOS 6 as it's flaky.
+- Xcode 5.0.1 is broken.
+- Xcode 4.6.3 doesn't support iOS 7.
+
+After that, install the command line build tools (Xcode -> Preferences -> Downloads).
+ 
+If you're testing iOS 6, then install `Xcode 4.6.3` from [Apple](https://developer.apple.com/downloads/index.action).
+For iOS 7+ make sure to use Xcode 5.
+
+That done, you'll need to create a symlink for
+`gcc` to get the ruby build (particularly FFI) to install properly. This isn't required on OS X 10.9.
+If `/usr/local/bin` is in your path, you can do:
+```
+ln -s /usr/bin/gcc /usr/local/bin/gcc-4.2
+```
+Otherwise
+```
+sudo ln -s /usr/bin/gcc /usr/bin/gcc-4.2
+```
+Reinstall Ruby if you didn't set this symlink and have FFI issues.
 
 - Install Java 7 if there's no Java on the system.
   - [JDK 7](http://www.oracle.com/technetwork/java/javase/downloads/index.html)
 
-- Ensure you have Ruby 1.9.3-p392 or better (1.8 is not supported). Install the latest stable patch release of Ruby 2.0.
+- Install the latest stable patch release of Ruby 2.0.
 
 `$ \curl -L https://get.rvm.io | bash -s stable --ruby=2.0.0`
 
@@ -21,7 +51,8 @@ $ rvm --default use 2.0.0
 - If you have an old ruby, you can installing Ruby 2.0 instead
 
 ```
-$ rvm get stable
+$ rvm get head
+$ rvm autolibs homebrew
 $ rvm install 2.0.0
 ```
 
@@ -38,6 +69,13 @@ gem update ;\
 gem cleanup
 ```
 
+- Check that RubyGems is >= 2.1.5
+
+```bash
+$ gem --version
+2.1.5
+```
+
 - Install appium_console gem.
 
 ```ruby
@@ -46,6 +84,13 @@ gem uninstall -aIx appium_console ;\
 gem install --no-rdoc --no-ri appium_console
 ```
 
+- Install [flaky](https://github.com/appium/flaky) gem.
+
+```ruby
+gem uninstall -aIx flaky ;\
+gem install --no-rdoc --no-ri flaky
+```
+
 - Install [brew](http://mxcl.github.io/homebrew/)
 
 `ruby -e "$(curl -fsSL https://raw.github.com/mxcl/homebrew/go)"`
@@ -58,7 +103,7 @@ brew upgrade node ;\
 brew install node
 ```
 
-- Node should be `v0.10.2` or better.
+- Node should be `v0.10.5` or better.
 Don't use the big green install button on nodejs.org or all npm commands will require sudo.
 
 `$ node --version`
@@ -69,6 +114,8 @@ Don't use the big green install button on nodejs.org or all npm commands will re
 
 `npm install -g grunt grunt-cli`
 
+- Run the version command from the appium folder. If you're not in that folder, the grunt version will not display.
+
 ```bash
 $ grunt --version
 grunt-cli v0.1.6
@@ -76,7 +123,7 @@ grunt v0.4.1
 ```
 
 - Install [ant](http://ant.apache.org/) if it's not already installed.
-- Install [maven](http://maven.apache.org/download.cgi) if it's not already installed.
+- Install [maven 3.0.5](http://maven.apache.org/download.cgi) if it's not already installed. Do not use maven 3.1.1.
 
 ```
 $ ant -version
@@ -97,6 +144,10 @@ If you see config errors, try cleaning git. `git clean -dfx; git reset --hard`
 
 You can also reset by platform. `./reset.sh --android`
 
+If npm is having issues, you may have to disable https. I don't recommend this, however if you must this is how to do so:
+
+`npm config set registry http://registry.npmjs.org/`
+
 
 - Authorize for iOS testing. Must run reset.sh as mentioned above before running the grunt task.
 
@@ -107,7 +158,7 @@ You can also reset by platform. `./reset.sh --android`
 `node server.js`
 
 
-# Bash Profile
+#### Bash Profile
 - Add the Android SDK tools folder to your path so you can run `android`.
 - Define the `ANDROID_HOME` env var pointing to SDK root. On OSX place it in `~/.bash_profile`
 - You may have to add grunt as well `/usr/local/share/npm/bin/grunt`
@@ -118,8 +169,9 @@ export ANDROID_HOME=$HOME/Downloads/android-sdk-macosx
 export ANDROID_SDK=$ANDROID_HOME
 PATH=$PATH:/Applications/apache-ant-1.8.4/bin
 PATH=$PATH:/usr/local/share/npm/bin/
-PATH=$PATH:$HOME/Downloads/android-sdk-macosx/platform-tools
-PATH=$PATH:$HOME/Downloads/android-sdk-macosx/tools
+PATH=$PATH:$ANDROID_HOME/build-tools
+PATH=$PATH:$ANDROID_HOME/platform-tools
+PATH=$PATH:$ANDROID_HOME/tools
 export JAVA_HOME="`/System/Library/Frameworks/JavaVM.framework/Versions/Current/Commands/java_home`"
 export APP_PATH="/path/to/MyiOS.app"
 export APK_PATH="/path/to/my.apk"
@@ -132,22 +184,23 @@ export PATH
 
 - Run `android` to open the SDK manager. 
 - Install `Intel x86 Emulator Accelerator (HAXM)` under Extras
-- Install API 17 `SDK Platform`, `Intel x86 Atom System Image`, `Google APIs` as in the picture.
+- Install API 18 `SDK Platform`, `Intel x86 Atom System Image`, `Google APIs`
 If there are any problems viewing or downloading the packages, go to `Packages -> Reload` and try again.
 
-![](img/packages.png)
-
 - Create a new Android virtual device that uses the Intel image. Ensure `Use Host GPU` is checked. Set `VM Heap` to `64`. `32` is too small.
 
-`android avd`
-
 ![](img/avd_settings.png)
 
+`android avd`
+
 - Check that `hax is working` If it's not, install hax [directly from Intel](http://software.intel.com/en-us/articles/intel-hardware-accelerated-execution-manager)
 
-![](img/hax.png)
+```bash
+$ emulator @t18
+HAX is working and emulator runs in fast virt mode
+```
 
-- Launch the emulator with `emulator @t17`
+- Launch the emulator with `emulator @t18`
 
 - After launching the emulator, check that it's listed in adb devices. Run the following commands a few times until it's listed.
 
@@ -167,6 +220,10 @@ If you see `error: protocol fault (no status)` just keep running the command unt
 
 - See [running on OS X](https://github.com/appium/appium/blob/master/docs/running-on-osx.md)
 
+#### Troubleshooting
+
+- If install fails, keep trying to install a few times.
+
 When using `Appium.app` make sure to set Appium -> Preferences... -> Check "Use External Appium Package" and set it to the path of Appium cloned from GitHub.
 
 Fix permission errors. npm shouldn't require sudo.
@@ -175,7 +232,40 @@ Fix permission errors. npm shouldn't require sudo.
 brew uninstall node
 brew install node
 rm -rf ./node_modules # run from the appium folder
-rm -rf /Users/`whoami`/.npm
+rm -rf "/Users/`whoami`/.npm"
+rm -rf /usr/local/lib/node_modules/ 
 ./reset.sh --ios
 ./reset.sh --android
 ```
+
+- [Helper bash methods](https://gist.github.com/bootstraponline/5580587)
+
+#### SSL Issues
+
+> Unable to download data from https://rubygems.org/ - SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed 
+
+- [Fix SSL issues](http://railsapps.github.io/openssl-certificate-verify-failed.html) with:
+
+```bash
+$ rvm osx-ssl-certs update all
+$ rvm osx-ssl-certs status all
+```
+
+#### Maven on OS X 10.9
+
+```bash
+$ cd /usr/local
+$ git reset --hard origin/master
+
+$ brew update
+$ brew install maven
+```
+
+#### HAXM on OS X 10.9
+
+Install the [HAXM 10.9 hotfix](http://software.intel.com/en-us/articles/intel-hardware-accelerated-execution-manager-end-user-license-agreement-macos-hotfix
+).
+
+#### Restore dev tools on 10.9
+
+`xcode-select --install`

data/osx_install.rake

@@ -0,0 +1,135 @@
+# For OS X, installs all the dependencies for Appium's ruby console, per these instructions:
+#
+# https://github.com/appium/ruby_console/blob/master/osx.md
+#
+# Changes to this file might imply changes to those instructions as well.
+
+def sh_success(cmd)
+  success = false
+  begin
+    success, status = sh cmd
+  rescue
+    # do nothing  
+  end
+  
+  success
+end
+  
+def has_cmd(cmd)
+  sh_success "which #{cmd}"
+end
+
+THIS_DIR     = File.expand_path(File.dirname(__FILE__))
+APPIUM_DIR = "#{THIS_DIR}/appium"
+  
+GCC = '/usr/bin/gcc'
+GCC42_CMD = 'gcc-4.2'
+GCC42 = "/usr/local/bin/#{GCC42_CMD}"
+
+file GCC do
+	fail "#{GCC} does not exist. This is likely because you do not have Xcode command line tools installed."
+end
+
+file GCC42 => [GCC] do
+  sh "ln -s #{GCC} #{GCC42}"
+end
+
+task :gcc do
+  if !has_cmd('gcc-4.2') then
+    Rake::Task[GCC42].invoke
+  end
+end
+    
+task :java do
+  if !has_cmd('java') then
+    puts "You must install java to continue."
+    puts "cf. http://www.oracle.com/technetwork/java/javase/downloads/index.html"
+  end
+end
+
+task :ruby => [:gcc] do
+  if has_cmd('rvm') then
+    # doesn't hurt anything if already installed
+    sh 'rvm install 2.0.0'
+  else
+    sh '\curl -L https://get.rvm.io | bash -s stable --ruby=2.0.0'
+  end
+  
+  system '/bin/bash --login -i -c "rvm use --default 2.0.0"'
+  sh 'rvm osx-ssl-certs update all'
+end
+
+task :gems => [:ruby] do
+  sh 'gem update --system'
+  sh 'gem install --no-rdoc --no-ri bundler'
+  sh 'gem update'
+  sh 'gem cleanup'
+  sh 'gem uninstall -aIx appium_lib'
+  sh 'gem uninstall -aIx appium_console'
+  sh 'gem install --no-rdoc --no-ri appium_console'
+  sh 'gem uninstall -aIx flaky'
+  sh 'gem install --no-rdoc --no-ri flaky'
+end
+
+task :brew do
+  if has_cmd('brew') then
+    sh 'brew update'
+  else
+    sh 'ruby -e "$(curl -fsSL https://raw.github.com/mxcl/homebrew/go)"'
+  end
+end
+
+task :ant do
+  if !has_cmd('ant') then
+    fail "Ant must be installed to complete this setup."
+  end
+end
+
+task :maven do
+  if !has_cmd('mvn') then
+    Rake::Task[:brew].invoke    
+    sh 'brew install maven'
+  end
+end
+
+task :nodejs => [:brew] do
+  sh 'brew install node' # noop if already installed
+  if sh_success 'brew outdated | grep node' then
+    sh 'brew upgrade node'
+  end if
+
+  # make sure it's installed
+  sh 'node --version' 
+  sh 'npm --version'
+end
+
+task :grunt => [:nodejs] do
+  if !sh_success('grunt --version') then
+    sh 'npm install -g grunt grunt-cli'
+    sh 'grunt --version'
+  end
+end
+
+# we only clone when the directory doesn't already exist
+directory APPIUM_DIR do
+  cd THIS_DIR
+  sh 'git clone git://github.com/appium/appium.git'
+end
+
+# appium goes into the directory below where this Rakefile is
+desc 'Downloads appium and all dependencies, and starts up appium. May require a superuser password.'
+task :appium => [APPIUM_DIR, :grunt, :maven, :ant, :gems, :ruby, :java] do
+  cd APPIUM_DIR
+  sh 'git pull origin master'
+  sh './reset.sh'
+
+  begin
+    sh 'sudo `which grunt` authorize'
+  rescue
+    # grunt errors if it has already been authorized, so ... I guess we'll ignore errors then
+  end
+
+  sh 'node server.js'
+end
+
+task :default => :appium  

data/release_notes.md

@@ -1,3 +1,45 @@
+#### v0.5.6 2013-11-18
+
+- [ce14efa](https://github.com/appium/ruby_console/commit/ce14efa1bb139a2f8a8f391d28588376757739bc) Release 0.5.6
+- [e6ee1f5](https://github.com/appium/ruby_console/commit/e6ee1f5704ceb5358997af77dc43c4bc401e204e) Add "reload" command
+- [877a42b](https://github.com/appium/ruby_console/commit/877a42b728ac8d3d7093ce92feab69010701893a) Update ios_v_android.md
+- [86eed78](https://github.com/appium/ruby_console/commit/86eed78ebcb4ab06bf148e629aad1f4de35c3309) Update osx.md
+- [c32fa78](https://github.com/appium/ruby_console/commit/c32fa7859afa659dce46ec61494544b3a9b9f2b9) Add note about iOS duplicate elements
+- [cdd23c7](https://github.com/appium/ruby_console/commit/cdd23c7e8a21e83f19763796b33a17b163de1e43) Update hotfix section
+- [a4800ab](https://github.com/appium/ruby_console/commit/a4800abc1e366fd31c1cfa5fddd2f00ae6253fe6) Merge pull request #32 from bkone/patch-2
+- [2e24615](https://github.com/appium/ruby_console/commit/2e24615366622cd658a0516850d07dda45ab7428) Update osx.md
+- [bb90e04](https://github.com/appium/ruby_console/commit/bb90e048b9835f6ee43ec43ee537ca2a5691aea5) Merge pull request #31 from bkone/patch-1
+- [c85b39d](https://github.com/appium/ruby_console/commit/c85b39d375b8dce6e97ade8701f8ab57d48e5833) install_osx.rake to osx_install.rake
+- [ff59f4d](https://github.com/appium/ruby_console/commit/ff59f4dba3557a69867af5bb53008ed2d0fb15dd) Add rvm fix for OS X 10.9
+- [add328a](https://github.com/appium/ruby_console/commit/add328a34506915f9b453722730d4f7217504658) Clarify maven version
+- [db263d3](https://github.com/appium/ruby_console/commit/db263d36fac3ef673e363cf36d93d5bb8bab03db) Clarify Xcode versions
+- [7cdd5de](https://github.com/appium/ruby_console/commit/7cdd5dead03fc08eb495e9118c337fe465b7d66e) Update osx.md
+- [869e4a4](https://github.com/appium/ruby_console/commit/869e4a4454d115a8b171e92b61b420e7e4c0152b) HAXM on OS X 10.9
+- [85f9f39](https://github.com/appium/ruby_console/commit/85f9f39eadf12b993d4389759bdcd863aaac4fbc) Add Maven OS X 10.9 doc
+- [793d780](https://github.com/appium/ruby_console/commit/793d7805705e5709c990714e545013a16189e743) Update osx.md
+- [78fbc94](https://github.com/appium/ruby_console/commit/78fbc9473b009af39043f89b50fe34105dad0870) Merge pull request #30 from claybridges/clay-rake-install
+- [604a385](https://github.com/appium/ruby_console/commit/604a3857a4612c5db7c0c2c157a51e513235f385) Add osx_install.rake, and associated changes
+- [0efa857](https://github.com/appium/ruby_console/commit/0efa857b561edf7370e27a165f9fb8b2dc68dff7) Recommend RubyGems >= 2.1.5
+- [7ba2e04](https://github.com/appium/ruby_console/commit/7ba2e042b62b1c8c6658f390b0db66b356791a33) Add flaky gem to osx.md
+- [0574a34](https://github.com/appium/ruby_console/commit/0574a3400b9f489838ace4894fde787a3361a88e) Update SSL issue docs
+- [ccb94ce](https://github.com/appium/ruby_console/commit/ccb94cebaceccdc067e646be8c6016803afd1ffe) Add SSL issue fix
+- [594c8c3](https://github.com/appium/ruby_console/commit/594c8c3100576f0168874e70bab551ae6b226a52) Use quotes
+- [763e6d4](https://github.com/appium/ruby_console/commit/763e6d48296459044b112fcfe1fb3fc3ae9dc0e4) Improve troubleshooting
+- [f60791e](https://github.com/appium/ruby_console/commit/f60791eca5166c7925f4dc8f35663142fbf5414d) Update osx.md
+- [e79b668](https://github.com/appium/ruby_console/commit/e79b6684e5321c4b393fafe0892bad7b72651b3f) Update osx.md
+- [3e2a8ae](https://github.com/appium/ruby_console/commit/3e2a8aece693227a83ab79b61c84bd400005a31a) Update osx.md
+- [21b0240](https://github.com/appium/ruby_console/commit/21b0240194a03bc4f4a33abbfc0063e1af19d48f) Update avd settings to API 18
+- [5390c80](https://github.com/appium/ruby_console/commit/5390c80febeb15ecb0d9b667694181850065a7c4) Update osx.md
+- [05e312c](https://github.com/appium/ruby_console/commit/05e312c3918686fe5e9a9769e3f1571623915dc7) Add helper bash methods for launching Appium
+- [afcb37f](https://github.com/appium/ruby_console/commit/afcb37f1b9951ff2caa41f2a4c802ee2b7ebcf16) Update to API 18
+
+
+#### v0.5.5 2013-08-23
+
+- [e048325](https://github.com/appium/ruby_console/commit/e04832589c71359fc4c30e45a3da2a04f93fbd66) Release 0.5.5
+- [fdc7749](https://github.com/appium/ruby_console/commit/fdc7749b7fd074b89643407a1cd4c7ba71ff15f2) Load minitest by default
+
+
 #### v0.5.4 2013-08-19
 
 - [97f5c4f](https://github.com/appium/ruby_console/commit/97f5c4f67c8f689f7342336b428262975e3f8421) Release 0.5.4

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appium_console
 version: !ruby/object:Gem::Version
-  version: 0.5.5
+  version: 0.5.6
 platform: ruby
 authors:
 - code@bootstraponline.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-23 00:00:00.000000000 Z
+date: 2013-11-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: appium_lib
@@ -88,6 +88,7 @@ files:
 - lib/appium_console/version.rb
 - lib/start.rb
 - osx.md
+- osx_install.rake
 - readme.md
 - release_notes.md
 - test/simple.rb
@@ -111,7 +112,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.6
+rubygems_version: 2.1.11
 signing_key: 
 specification_version: 4
 summary: Appium Ruby Console