acouchi 0.0.7 → 0.0.8

data/README.md

@@ -74,6 +74,149 @@ Cucumber
       t.cucumber_opts = "features --format pretty"
     end
 
+Pressing Keys
+-------------
+
+```
+page.send_key Acouchi::Solo::MENU
+page.send_key Acouchi::Solo::LEFT
+page.send_key Acouchi::Solo::RIGHT
+```
+
+Modifying Text
+--------------
+
+```
+# Enter text into the only text area on the page
+page.enter_text "Hello"
+
+# This enters text into the fifth text area
+page.enter_text "Hello", 5
+
+# Clear text from the only edit text area on the page
+page.clear_text
+
+# Clear text from the fourth edit text area
+page.clear_text 4
+```
+
+Searching Text
+--------------
+
+```
+# Check if page has_text
+page.has_text? "Bla"
+
+# has_text? default options
+page.has_text?("Text", {
+  :scroll          => true, # Scroll down the page searching for text
+  :minimum_matches => 0,    # Zero means you don't care how many matches there are.
+  :must_be_visible => true  # Whether you care if the text is visible or not.
+})
+
+# List all content currently on the page
+page.content
+
+# List all content currently on the page and scroll up and down
+# to find any content which may have been missed
+page.all_content
+```
+
+Clicking Things
+---------------
+
+```
+# Check if button with text exists
+page.has_button? "Clicky"
+
+# Click on some text
+page.click_text "Hello"
+
+# click_text default options
+page.click_text("Text", {
+  :match       => 1, # The match of the text that should be clicked
+  :auto_scroll => true # Auto scroll to find text to click on
+})
+
+# Click on a view by id
+page.click_view 123
+
+# Click on an image by index
+page.click_image 5
+```
+
+Finding Views
+-------------
+
+```
+# List the buttons currently on the page
+page.buttons
+
+# List the text views currently on the page
+page.text_views
+```
+
+Scrolling
+---------
+
+```
+page.scroll_up
+page.scroll_down
+
+# Scroll up or down the only list on the page
+page.scroll_up_list
+page.scroll_down_list
+
+# Scroll up or down a list by its index
+page.scroll_up_list 4
+page.scroll_down_list 4
+
+# Scroll to left or right
+page.scroll_to_left
+page.scroll_to_right
+```
+
+Navigating
+----------
+
+```
+# Press the back button
+page.go_back
+```
+
+Waiting
+-------
+
+Most methods in acouchi will wait for a while until an element is available.
+
+```
+# Wait for the text "Bla Bla" to appear. Returns true if the text appears.
+page.wait_for_text "Bla Bla"
+
+# wait_for_text default options
+page.wait_for_text "Bla Bla", {
+  # The minimum amount of matches you want to appear
+  :minimum_number_of_matches => 0,
+  # How long to wait for, in seconds
+  :timeout                   => 20,
+  # Scroll the page in search of text
+  :scroll                    => true,
+  # Only take into account visible text
+  :must_be_visible           => true
+}
+```
+
+RSpec
+-----
+
+```
+require "acouchi/rspec/matchers"
+
+# The have_text matcher will now output all page content
+# if the assertion fails
+page.should have_text "Bla"
+```
+
 Troubleshooting
 ---------------
 

data/examples/AcouchiSample/features/step_definitions/steps.rb

@@ -1,9 +1,9 @@
 When /^I write the text "(.*?)"$/ do |text|
-  page.enter_text(0, text)
+  page.enter_text text
 end
 
 When /^I clear the text$/ do
-  page.clear_edit_text(0)
+  page.clear_text
 end
 
 Then /^I see "(.*?)"$/ do |text|

data/lib/acouchi/project_builder.rb

@@ -76,7 +76,7 @@ module Acouchi
     end
 
     def ant
-      Which.find_executable("ant.exe", "ant")
+      Which.find_executable("ant.bat", "ant")
     end
 
     def build_apk

data/lib/acouchi/solo.rb

@@ -11,11 +11,11 @@ module Acouchi
       call_method("sendKey", [key])
     end
 
-    def enter_text index, text
+    def enter_text text, index=0
       call_method("enterText", [index, text])
     end
 
-    def clear_edit_text index
+    def clear_text index=0
       call_method("clearEditText", [index])
     end
 
@@ -111,6 +111,22 @@ module Acouchi
       call_method("goBack")
     end
 
+    def wait_for_text text, options = {}
+      options = {
+        :minimum_number_of_matches => 0,
+        :timeout                   => 20,
+        :scroll                    => true,
+        :must_be_visible           => true
+      }.merge(options)
+      call_method("waitForText", [
+        text,
+        options[:minimum_number_of_matches],
+        options[:timeout],
+        options[:scroll],
+        options[:must_be_visible]
+      ])
+    end
+
     private
       def call_method name, arguments = []
         arguments = arguments.map {|a| a.to_s}

data/lib/acouchi/version.rb

@@ -1,3 +1,3 @@
 module Acouchi
-  VERSION = "0.0.7"
+  VERSION = "0.0.8"
 end

data/lib/acouchi/which.rb

@@ -10,14 +10,20 @@ module Acouchi
 
     private
       def self.which? command
-        exts = ENV['PATHEXT'] ? ENV['PATHEXT'].split(';') : ['']
         ENV['PATH'].split(File::PATH_SEPARATOR).each do |path|
-          exts.each { |ext|
-            exe = "#{path}/#{command}#{ext}"
-            return exe if File.executable? exe
-          }
+          exe = File.join(path, "#{command}")
+          return exe if executable? exe
         end
         return nil
       end
+
+      def self.executable? file
+        return true if File.executable?(file)
+        extensions = ENV["PATHEXT"] ? ENV["PATHEXT"].split(";") : []
+        File.exist?(file) &&
+          File.file?(file) &&
+          extensions.any? &&
+          extensions.any? {|e| file.downcase.end_with?(e.downcase)}
+      end
   end
 end

data/src/com/acouchi/MethodExecutor.java

@@ -86,6 +86,9 @@ public class MethodExecutor
     if (methodName.equals("goBack"))
       solo.goBack();
 
+    if (methodName.equals("waitForText"))
+      result = solo.waitForText(parameters[0], Integer.parseInt(parameters[1]), Long.parseLong(parameters[2]), Boolean.parseBoolean(parameters[3]), Boolean.parseBoolean(parameters[4]));
+
     return methodResultAsJson(result);
   }
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: acouchi
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.8
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-25 00:00:00.000000000 Z
+date: 2012-11-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty