gametel 0.1

data/ChangeLog

@@ -0,0 +1,2 @@
+=== Version 0.1 / 2012-7-17
+Initial release with very basic support for a few controls

data/Gemfile

@@ -0,0 +1,12 @@
+source 'https://rubygems.org'
+
+gem 'rake'
+gem 'fuubar'
+gem 'fuubar-cucumber'
+gem 'rb-fsevent', :require => false if RUBY_PLATFORM =~ /darwin/i
+gem 'growl'
+gem 'guard-rspec'
+gem 'guard-cucumber'
+
+# Specify your gem's dependencies in gametel.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,17 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'rspec', :version => 2, :cli => '--color --format Fuubar' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end
+
+
+guard 'cucumber', :notification => true, :all_after_pass => false, :cli => '--profile focus' do
+  watch(%r{^features/.+\.feature$})
+  watch(%r{^features/support/.+$})          { 'features' }
+  watch(%r{^features/step_definitions/(.+)_steps\.rb$}) { |m| Dir[File.join("**/#{m[1]}.feature")][0] || 'features' }
+  watch(%r{^lib/.+\.rb$})                   { "features" }
+  watch(%r{^cucumber.yml$})                 { "features" }
+end

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Jeffrey S. Morgan
+
+MIT License
+
+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,59 @@
+# Gametel
+
+[![Build Status](http://travis-ci.org/leandog/gametel.png)](http://travis-ci.org/leandog/gametel)
+
+A gem to assist in building page-object like structures for testing android applications.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'gametel'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install gametel
+
+## Usage
+
+### Defining your screen object
+````ruby
+class LoginScreen
+  include Gametel
+end
+````
+
+When you include this module methods are added to your class allowing you to declare the items on the screen.
+
+````ruby
+class LoginPage
+  include Gametel
+  
+  text(:username, :index => 0)
+  text(:password, :index => 1)
+  button(:login, :text => 'Login')
+end
+````
+
+In your step definitions you can then access generated methods to interact with the views on your screen.
+
+````ruby
+on(LoginPage) do |screen|
+  screen.username = 'levi'
+  screen.password = 'secret'
+  screen.login
+end
+````
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,24 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+require 'cucumber'
+require 'cucumber/rake/task'
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.ruby_opts = "-I lib:spec"
+  spec.pattern = 'spec/**/*_spec.rb'
+end
+task :spec
+
+Cucumber::Rake::Task.new(:features, "Run all features") do |t|
+  t.profile = 'default'
+end
+
+desc 'Run all specs and features'
+task :test => ['spec', 'features']
+
+task :lib do
+  $LOAD_PATH.unshift(File.expand_path("lib", File.dirname(__FILE__)))
+end
+
+task :default => :spec

data/cucumber.yml

@@ -0,0 +1,6 @@
+<%
+std_opts = "PACKAGE_NAME=com.example.android.apis TEST_PACKAGE_NAME=com.example.android.apis.test APP_PATH=/Users/cheezy/dev/gametel/ApiDemos/bin/ApiDemos.apk TEST_APP_PATH=features/support/Test.apk TEST_SERVER_PORT=34777  --no-source --color --format pretty"
+%>
+
+default: <%= std_opts %>
+focus: <%= std_opts %> --tags @focus

data/features/button.feature

@@ -0,0 +1,16 @@
+Feature: Interacting with buttons
+
+  Scenario: Should be able to click a button by text
+    Given I'm on the buttons screen
+    Then I should be able to click the button by "text"
+
+  Scenario: Should be able to click a button by index
+    Given I'm on the buttons screen
+    Then I should be able to click the button by "index"
+
+  Scenario: Should be able to click a toggle button
+    Given I'm on the buttons screen
+    When I click the on/off button
+    Then I should see the text "ON" on the screen
+    When I click the on/off button
+    Then I should see the text "OFF" on the screen

data/features/checkbox.feature

@@ -0,0 +1,9 @@
+Feature:  Interacting with checkboxes
+
+  Scenario: Clicking a checkbox by index
+    Given I'm on the controls screen
+    Then I should be able to click a checkbox by "index"
+
+  Scenario: Clicking on a checkbox by text
+    Given I'm on the controls screen
+    Then I should be able to click a checkbox by "text"

data/features/list_item.feature

@@ -0,0 +1,13 @@
+Feature: Interacting with the list item control
+
+  Scenario: Should be able to click a list item by text
+    When I click the first list item by "text"
+    Then I should see the "Accessibility Service" list item
+
+  Scenario: Should be able to click a list item by index
+    When I click the first list item by "index"
+    Then I should see the "Accessibility Service" list item
+
+  Scenario: Should be able to click a list item when it is not visible on the screen
+    When I click the list item "Views" from the main menu
+    Then I should see the "Controls" list item

data/features/main_screen.feature

@@ -0,0 +1,18 @@
+Feature: Interacting with the elements on the main screen
+
+  Scenario: Identifying the list items on the main screen
+    Then I should see the "Accessibility" list item
+    And I should see the "App" list item
+    And I should see the "Content" list item
+
+  Scenario: Navigating using the items in the list and the back button
+    When I press the "first" list item
+    And I press the Back button
+    Then I should see the "App" list item
+    And I should see the "Content" list item
+
+  Scenario: Scrolling down and up
+    When I scroll down to the bottom of the screen
+    Then I should see the "Views" list item
+    When I scroll up to the top of the screen
+    Then I should see the "Accessibility" list item

data/features/radio_button.feature

@@ -0,0 +1,6 @@
+Feature:  Interacting with Radio Buttons
+
+  Scenario: Clicking on a radio button by text
+    Given I'm on the controls screen
+    Then I should be able to click a radio button by "text"
+

data/features/step_definitions/button_steps.rb

@@ -0,0 +1,22 @@
+Given /^I\'m on the buttons screen$/ do
+  on(MainMenuScreen) do |screen|
+    screen.views
+    screen.wait_for_text 'Buttons'
+  end
+  on(ViewsMenuScreen) do |screen|
+    screen.buttons
+    screen.wait_for_text 'Normal'
+  end
+end
+
+Then /^I should be able to click the button by "(.*?)"$/ do |how|
+  on(ButtonScreen).send "normal_#{how}"
+end
+
+When /^I click the on\/off button$/ do
+  on(ButtonScreen).on_off
+end
+
+Then /^I should see the text "(.*?)" on the screen$/ do |text|
+  on(ButtonScreen).should have_text text
+end

data/features/step_definitions/calabash_steps.rb

@@ -0,0 +1 @@
+require 'calabash-android/calabash_steps'

data/features/step_definitions/checkbox_steps.rb

@@ -0,0 +1,3 @@
+Then /^I should be able to click a checkbox by "(.*?)"$/ do |how|
+  on(ControlsScreen).send "checkbox_#{how}"
+end

data/features/step_definitions/controls_steps.rb

@@ -0,0 +1,19 @@
+Given /^I\'m on the controls screen$/ do
+  on(MainMenuScreen) do |screen|
+    screen.views
+    screen.wait_for_text 'Controls'
+  end
+  on(ViewsMenuScreen) do |screen|
+    screen.controls
+    screen.wait_for_text 'Light Theme'
+  end
+  on(ControlsMenuScreen).light_theme
+end
+
+When /^I enter "(.*?)" into the text field$/ do |text_value|
+  on(ControlsScreen).text_field = text_value
+end
+
+Then /^I should have the value "(.*?)" on the screen$/ do |text_value|
+  on(ControlsScreen).should have_text text_value
+end

data/features/step_definitions/list_item_steps.rb

@@ -0,0 +1,7 @@
+When /^I click the first list item by "(.+)"$/ do |type|
+  on(MainMenuScreen).send "first_list_item_#{type}"
+end
+
+When /^I click the list item "(.*?)" from the main menu$/ do |list_item|
+  on(MainMenuScreen).send "#{list_item.downcase}"
+end

data/features/step_definitions/main_screen_steps.rb

@@ -0,0 +1,22 @@
+Then /^I should see the "(.*?)" list item$/ do |list_item|
+  on(MainMenuScreen).should have_text list_item
+end
+
+When /^I press the "(.*?)" list item$/ do |list_item|
+  on(MainMenuScreen).send "#{list_item}_list_item_text"
+end
+
+When /^I press the Back button$/ do
+  on(MainMenuScreen) do |screen|
+    screen.wait_for_text 'Accessibility Service'
+    screen.back
+  end
+end
+
+When /^I scroll down to the bottom of the screen$/ do
+  on(MainMenuScreen).scroll_down
+end
+
+When /^I scroll up to the top of the screen$/ do
+  on(MainMenuScreen).scroll_up
+end

data/features/step_definitions/radio_button_steps.rb

@@ -0,0 +1,3 @@
+Then /^I should be able to click a radio button by "(.*?)"$/ do |how|
+  on(ControlsScreen).send "radio_button_#{how}"
+end

data/features/support/app_installation_hooks.rb

@@ -0,0 +1,31 @@
+require 'calabash-android/management/app_installation'
+
+AfterConfiguration do |config|
+  FeatureNameMemory.feature_name = nil
+end
+
+Before do |scenario|
+  deploy_app unless already_installed
+  FeatureNameMemory.feature_name = scenario.feature.name
+end
+
+at_exit do
+  #	uninstall_apps
+end
+
+def already_installed()
+  !FeatureNameMemory.feature_name.nil?
+end
+
+def deploy_app()
+  log "Is first scenario - reinstalling apps"
+  uninstall_apps
+  install_app(ENV["TEST_APP_PATH"])
+  install_app(ENV["APP_PATH"])
+end
+
+FeatureNameMemory = Class.new
+class << FeatureNameMemory
+  @feature_name = nil
+  attr_accessor :feature_name
+end

data/features/support/app_life_cycle_hooks.rb

@@ -0,0 +1,28 @@
+require 'calabash-android/management/adb'
+
+Before do |scenario|
+
+  return if scenario.failed? #No need to start the server is anything before this has failed.
+  cmd = "#{adb_command} shell am instrument -w -e class sh.calaba.instrumentationbackend.InstrumentationBackend #{ENV['TEST_PACKAGE_NAME']}/sh.calaba.instrumentationbackend.CalabashInstrumentationTestRunner"
+  log "Starting test server using:"
+  log cmd
+  if is_windows?
+    system(%Q(start /MIN cmd /C #{cmd}))
+  else
+    `#{cmd} 1>&2 &`
+  end
+  
+  sleep 2
+  begin
+    connect_to_test_server
+    log "Connection established"
+  rescue Exception => e
+    log "Exception:#{e.backtrace}"
+  end
+end
+
+
+
+After do |scenario| 
+  disconnect_from_test_server
+end

data/features/support/env.rb

@@ -0,0 +1,8 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '../../', 'lib'))
+
+require 'rspec/expectations'
+require 'calabash-android/cucumber'
+require 'gametel'
+require 'gametel/navigation'
+
+World(Gametel::Navigation)

data/features/support/hooks.rb

@@ -0,0 +1,18 @@
+
+Before do |scenario|
+  StepCounter.step_index = 0
+  StepCounter.step_line = scenario.raw_steps[StepCounter.step_index].line
+end
+
+AfterStep do |scenario|
+  #Handle multiline steps
+  StepCounter.step_index = StepCounter.step_index + 1
+  StepCounter.step_line = scenario.raw_steps[StepCounter.step_index].line unless scenario.raw_steps[StepCounter.step_index].nil?
+end
+
+StepCounter = Class.new
+class << StepCounter
+  @step_index = 0
+  @step_line = 0
+  attr_accessor :step_index, :step_line
+end

data/features/support/screens/buttons_screen.rb

@@ -0,0 +1,9 @@
+class ButtonScreen
+  include Gametel
+
+  button(:normal_text, :text => 'Normal')
+  button(:normal_index, :index => 0)
+  button(:small, :text => 'Small')
+  button(:on_off, :index => 2)
+  
+end

data/features/support/screens/controls_menu_screen.rb

@@ -0,0 +1,8 @@
+class ControlsMenuScreen
+  include Gametel
+
+  list_item(:light_theme, :text => '1. Light Theme')
+  list_item(:dark_theme, :text => '2. Dark Theme')
+  list_item(:custom_theme, :text => '5. Custom Theme')
+  list_item(:old_theme, :text => '6. Holo or Old Theme')
+end

data/features/support/screens/controls_screen.rb

@@ -0,0 +1,11 @@
+class ControlsScreen
+  include Gametel
+  
+  text(:text_field, :index => 0)
+  button(:enabled_save, :index => 0)
+  button(:disabled_save, :index => 1)
+  checkbox(:checkbox_index, :index => 0)
+  checkbox(:checkbox_text, :text => 'Checkbox 2')
+  radio_button(:radio_button_text, :text => 'RadioButton 1')
+  
+end

data/features/support/screens/main_menu_screen.rb

@@ -0,0 +1,15 @@
+class MainMenuScreen
+  include Gametel
+
+  list_item(:first_list_item_text, :text => 'Accessibility')
+  list_item(:first_list_item_index, :index => 0)
+  list_item(:app, :text => 'App')
+  list_item(:content, :text => 'Content')
+  list_item(:graphics, :text => 'Graphics')
+  list_item(:media, :text => 'Media')
+  list_item(:nfc, :text => 'NFC')
+  list_item(:os, :text => 'OS')
+  list_item(:preference, :text => 'Preference')
+  list_item(:text, :text => 'Text')
+  list_item(:views, :text => 'Views')
+end