calabash 1.2.1 → 1.9.9.pre1

data/lib/calabash/android/lib/AndroidManifest.xml

@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+      package="#testPackage#"
+      android:versionCode="3"
+      android:versionName="0.3.0">
+    <application android:label="instrumentation_backend">
+      <uses-library android:name="android.test.runner" />
+      <uses-library android:name="com.google.android.maps" android:required="false" />
+      <activity
+              android:name="sh.calaba.instrumentationbackend.WakeUp"
+              android:label="WakeUp"
+              android:exported="true"
+              android:launchMode="singleInstance"
+              android:finishOnTaskLaunch="true"
+              android:stateNotNeeded="true"
+              android:noHistory="false"
+              android:excludeFromRecents="true"/>
+        <activity
+            android:name="sh.calaba.instrumentationbackend.StatusReporterActivity"
+            android:label="StatusReporterActivity"
+            android:exported="true"
+            android:finishOnTaskLaunch="true"
+            android:stateNotNeeded="true"
+            android:noHistory="true"
+            android:excludeFromRecents="true"/>
+        <activity
+            android:name="sh.calaba.instrumentationbackend.ResumeTaskActivity"
+            android:label="ResumeTaskActivity"
+            android:exported="true"
+            android:finishOnTaskLaunch="true"
+            android:stateNotNeeded="true"
+            android:noHistory="true"
+            android:excludeFromRecents="true"/>
+    </application>
+    <uses-sdk android:minSdkVersion="4" />
+    <instrumentation android:targetPackage="#targetPackage#" android:name="sh.calaba.instrumentationbackend.CalabashInstrumentationTestRunner" />
+    <instrumentation android:targetPackage="#targetPackage#" android:name="sh.calaba.instrumentationbackend.ClearAppData" />
+    <instrumentation android:targetPackage="#targetPackage#" android:name="sh.calaba.instrumentationbackend.ClearAppData2" />
+    <instrumentation android:targetPackage="#targetPackage#" android:name="sh.calaba.instrumentationbackend.ClearPreferences" />
+    <instrumentation android:targetPackage="#targetPackage#" android:name="sh.calaba.instrumentationbackend.SetPreferences" />
+    <instrumentation android:targetPackage="#targetPackage#" android:name="sh.calaba.instrumentationbackend.GetPreferences" />
+
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+    <uses-permission android:name="android.permission.ACCESS_MOCK_LOCATION" />
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.GET_TASKS" />
+    <uses-permission android:name="android.permission.REORDER_TASKS" />
+
+</manifest>

data/lib/calabash/android/life_cycle.rb

@@ -0,0 +1,37 @@
+module Calabash
+  module Android
+    module LifeCycle
+      # Resume an application. If the application is already focused, nothing
+      # will happen.
+      #
+      # @example
+      #  go_home
+      #  resume_app
+      #
+      # @param [String, Calabash::Application] path_or_application The
+      #  application to resume.
+      def resume_app(path_or_application = nil)
+        path_or_application ||= Application.default
+
+        unless path_or_application
+          raise 'No application given, and Application.default is not set'
+        end
+
+        Device.default.resume_app(path_or_application)
+
+        true
+      end
+
+
+      # !@visibility private
+      def _send_current_app_to_background(for_seconds)
+        package = focused_package
+        activity = focused_activity
+
+        go_home
+        sleep(for_seconds)
+        Device.default.resume_activity(package, activity)
+      end
+    end
+  end
+end

data/lib/calabash/android/orientation.rb

@@ -0,0 +1,30 @@
+module Calabash
+  module Android
+    module Orientation
+      # @!visibility private
+      def _set_orientation_landscape
+        Device.default.perform_action('set_activity_orientation', 'landscape')
+      end
+
+      # @!visibility private
+      def _set_orientation_portrait
+        Device.default.perform_action('set_activity_orientation', 'portrait')
+      end
+
+      # @!visibility private
+      def _portrait?
+        _orientation == 'portrait'
+      end
+
+      # @!visibility private
+      def _landscape?
+        _orientation == 'landscape'
+      end
+
+      # @!visibility private
+      def _orientation
+        Device.default.perform_action('get_activity_orientation')['message']
+      end
+    end
+  end
+end

data/lib/calabash/android/physical_buttons.rb

@@ -0,0 +1,39 @@
+# @todo: Add not about this class being easily abused
+module Calabash
+  module Android
+    module PhysicalButtons
+      def press_button(key)
+        Device.default.perform_action('press_key', key)
+        true
+      end
+
+      def press_back_button
+        press_button('KEYCODE_BACK')
+      end
+
+      def press_menu_button
+        press_button('KEYCODE_MENU')
+      end
+
+      def press_down_button
+        press_button('KEYCODE_DPAD_DOWN')
+      end
+
+      def press_up_button
+        press_button('KEYCODE_DPAD_UP')
+      end
+
+      def press_left_button
+        press_button('KEYCODE_DPAD_LEFT')
+      end
+
+      def press_right_button
+        press_button('KEYCODE_DPAD_RIGHT')
+      end
+
+      def press_enter_button
+        press_button('KEYCODE_ENTER')
+      end
+    end
+  end
+end

data/lib/calabash/android/screenshot.rb

@@ -0,0 +1,9 @@
+# @!visibility private
+module Calabash
+  module Android
+    # @!visibility private
+    module Screenshot
+      SCREENSHOT_JAR_PATH = File.join(File.dirname(__FILE__), 'lib', 'screenshot_taker.jar')
+    end
+  end
+end

data/lib/calabash/android/scroll.rb

@@ -0,0 +1,5 @@
+module Calabash
+  module Android
+
+  end
+end

data/lib/calabash/android/server.rb

@@ -0,0 +1,10 @@
+module Calabash
+  module Android
+    # A representation of the Calabash Android test server.
+    class Server < ::Calabash::Server
+      def self.default
+        Server.new(URI.parse('http://127.0.0.1:33765'))
+      end
+    end
+  end
+end

data/lib/calabash/android/text.rb

@@ -0,0 +1,54 @@
+module Calabash
+  module Android
+    module Text
+      def dismiss_keyboard
+        Device.default.perform_action('hide_soft_keyboard')
+      end
+
+      # Taps a keyboard action key on the keyboard. Notice that Calabash does
+      # not ensure that this particular action key is actually available on the
+      # current keyboard.
+      #
+      # @example
+      #  tap_keyboard_action_key(:normal)
+      #  tap_keyboard_action_key(:unspecified)
+      #  tap_keyboard_action_key(:none)
+      #  tap_keyboard_action_key(:go)
+      #  tap_keyboard_action_key(:search)
+      #  tap_keyboard_action_key(:send)
+      #  tap_keyboard_action_key(:next)
+      #  tap_keyboard_action_key(:done)
+      #  tap_keyboard_action_key(:previous)
+      #
+      # @see http://developer.android.com/reference/android/view/inputmethod/EditorInfo.html
+      #
+      # @param [Symbol] action_key The key to press.
+      def tap_keyboard_action_key(action_key)
+        Device.default.perform_action('press_user_action_button', action_key.to_s)
+      end
+
+      # @!visibility private
+      def _clear_text
+        Device.default.perform_action('clear_text')
+      end
+
+      def _clear_text_in(view)
+        tap(view)
+        sleep 0.5
+        clear_text
+      end
+
+      # @!visibility private
+      def _enter_text_in(view, text)
+        tap(view)
+        sleep 0.5
+        enter_text(text)
+      end
+
+      # @!visibility private
+      def _tap_current_keyboard_action_key
+        Device.default.perform_action('press_user_action_button')
+      end
+    end
+  end
+end

data/lib/calabash/application.rb

@@ -0,0 +1,74 @@
+require 'digest'
+
+module Calabash
+  # A representation of the application that is under test.
+  class Application
+    include Calabash::Utility
+
+    @@default = nil
+
+    def self.default
+      @@default
+    end
+
+    def self.default=(value)
+      @@default = value
+    end
+
+    attr_reader :path
+
+    def self.from_path(path)
+      extension = File.extname(path)
+
+      case extension
+        when '.apk'
+          Android::Application.new(path, nil)
+        when '.ipa', '.app'
+          IOS::Application.new(path)
+        else
+          Application.new(path)
+      end
+    end
+
+    # @raise [RuntimeError] Raises an error if `application_path` does not
+    #   exist.
+    def initialize(application_path, options = {})
+      if application_path.nil?
+        raise ArgumentError, "Invalid application path '#{application_path}'."
+      end
+
+      @path = File.expand_path(application_path)
+      @logger = options[:logger] || Calabash::Logger.new
+      @identifier = options[:identifier]
+      ensure_application_path
+    end
+
+    def to_s
+      "#<Application #{path}>"
+    end
+
+    def inspect
+      to_s
+    end
+
+    def extract_identifier
+      abstract_method!
+    end
+
+    def identifier
+      @identifier ||= extract_identifier
+    end
+
+    def md5_checksum
+      Digest::MD5.file(path).hexdigest
+    end
+
+    private
+
+    def ensure_application_path
+      unless File.exist?(path)
+        raise "The app '#{path}' does not exist."
+      end
+    end
+  end
+end

data/lib/calabash/cli.rb

@@ -0,0 +1,12 @@
+module Calabash
+  # @!visibility private
+  module CLI
+    require 'calabash/cli/build'
+    require 'calabash/cli/console'
+    require 'calabash/cli/generate'
+    require 'calabash/cli/helpers'
+    require 'calabash/cli/resign'
+    require 'calabash/cli/run'
+    require 'calabash/cli/setup_keystore'
+  end
+end

data/lib/calabash/cli/build.rb

@@ -0,0 +1,33 @@
+module Calabash
+  module CLI
+    # @!visibility private
+    module Build
+      def parse_build_arguments!
+        fail('Should only build test-server for Android') unless @platform.nil? || @platform == :android
+
+        application = @arguments.shift
+
+        if application.nil?
+          fail('Must supply application as first parameter to build', :build)
+        elsif !File.exists?(application)
+          fail("File '#{application}' does not exist", :build)
+        else
+          extension = File.extname(application)
+          application_path = File.expand_path(application)
+
+          case extension
+            when '.apk'
+              set_platform!(:android)
+              Calabash::Android::Build::Builder.new(application_path).build
+            when '.ipa', '.app'
+              set_platform!(:ios)
+              fail('Should only build test-server for Android')
+            else
+              fail('Application must be an apk', :build)
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/calabash/cli/console.rb

@@ -0,0 +1,90 @@
+module Calabash
+  # @!visibility private
+  module CLI
+    # @!visibility private
+    module Console
+      def parse_console_arguments!
+        application = @arguments.shift
+
+        if application.nil?
+          Logger.info("No application specified. Using default application specified by env variable CAL_APP")
+          application = Environment::APP_PATH
+          Logger.debug("New application: '#{application}'")
+
+          fail("No application given and env variable CAL_APP is not set.", :console) if application.nil?
+        end
+
+        if File.exists?(application)
+          extension = File.extname(application)
+          application_path = File.expand_path(application)
+
+          case extension
+            when '.apk'
+              set_platform!(:android)
+
+              # Create the test server if it does not exist
+              test_server = Android::Build::TestServer.new(application_path)
+
+              unless test_server.exists?
+                Logger.info('Test server does not exist. Creating test server.')
+                Calabash::Android::Build::Builder.new(application_path).build
+              end
+
+              enter_console(application_path)
+            when '.ipa'
+              set_platform!(:ios)
+              enter_console(application_path)
+            when '.app'
+              set_platform!(:ios)
+              enter_console(application_path)
+            else
+              fail('Application must be either an .apk, .ipa or .app', :console)
+          end
+        else
+          fail("File '#{application}' does not exist", :console)
+        end
+      end
+
+      def enter_console(application_path)
+        irbrc_path = Environment::IRBRC
+
+        console_environment = {}
+        console_environment['CAL_DEBUG'] = Environment::DEBUG ? '1' : '0'
+
+        if @options[:verbose]
+          console_environment['CAL_DEBUG'] = '1'
+        end
+
+        if @platform == :android
+          irbrc_path ||= File.expand_path(File.join(File.dirname(__FILE__), '..', 'android', 'lib', '.irbrc'))
+
+          console_environment['CAL_APP'] = application_path
+
+          if Environment::TEST_SERVER_PATH
+            console_environment['CAL_TEST_SERVER'] = Environment::TEST_SERVER_PATH
+          else
+            test_server = Android::Build::TestServer.new(application_path)
+
+            raise 'Cannot locate test-server' unless test_server.exists?
+
+            console_environment['CAL_TEST_SERVER'] = test_server.path
+          end
+        elsif @platform == :ios
+          irbrc_path ||= File.expand_path(File.join(File.dirname(__FILE__), '..', 'ios', 'lib', '.irbrc'))
+
+          console_environment['CAL_APP'] = application_path
+        else
+          raise "Invalid platform '#{@platform}'"
+        end
+
+        console_environment['IRBRC'] = irbrc_path
+
+        Logger.info 'Running irb...'
+        Logger.debug "From file: '#{irbrc_path}'"
+        Logger.debug "With ENV: '#{console_environment}'"
+
+        exec(console_environment, RbConfig.ruby, '-S', 'irb')
+      end
+    end
+  end
+end