mobilify 1.0.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in mobilify.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Johnson Denen
+
+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,116 @@
+# Mobilify
+
+We don't like to maintain a lot of test code. Which means, we don't want to rewrite the same tests for the same web application on different platforms. It's easy when those different platforms are browsers, because the site doesn't change much (at all?). 
+
+But, it's a challenge to reuse code when the different platforms are desktop and mobile browsers. The elements move, and their identifiers change. We could create separate page objects for desktop and mobile, with a mixin object for the shared stuff. Or we could create one page object with all the elements, and write two different tests. Seems like a waste both ways.
+
+Mobilify allows you to create one page object and write one test. You write tests for the desktop, and it will grab mobile elements when necessary. Just define the context during page initialization.
+
+#### Usage
+To Mobilify your page objects, ```include Mobilify``` in the page class. For each method requiring a mobile replacement, create an element definition with ```mobile_``` prepended to the original's name.
+
+```ruby
+# method
+text_field(:password, :id => "user-pw")
+# replacement
+text_field(:mobile_password, :id => "mobile-pw")
+```
+
+Mobilify will replace called methods with their ```mobile_``` counterparts if two conditions are met. First, a hash with a key-value pair of ```:agent => :mobile``` is passed to the page object constructor. And second, the page object responds to a ```mobile_``` version of the called method.
+
+```ruby
+# constructor
+my_page = Page.new(@browser, :agent => :mobile)
+```
+
+To navigate to your page object during initialization, pass the key-value pair ```:visit => true``` to the constructor.
+```ruby
+# visiting
+my_page = Page.new(@browser, :visit => true)
+my_page = Page.new(@browser, :visit => true, :agent => :mobile)
+```
+
+#### Example
+
+You're testing a responsive page with a link to your registration form. But you can only identify the link with XPath, and the XPath changes between your desktop-sized application and your mobile-sized application. You could: 
+
+* Call two different methods in two different specs, each pointing to its own XPath 
+* Call two different methods in one spec, using logic to determine the call correctly
+* Call the same method in one spec and Mobilify the page object for mobile testing
+
+```ruby
+# spec/page.rb
+require 'mobilify'
+
+class Page
+  include Mobilify
+  
+  page_url "http://my-page.com"
+  
+  link(:to_registration, :xpath => '//xpath/to/desktop/register/link')
+  link(:mobile_to_registration, :xpath => '//xpath/to/mobile/register/link')
+end
+```
+
+```ruby 
+# spec/spec_helper.rb
+require 'watir-webdriver'
+require 'webdriver-user-agent'
+
+RSpec.configure do |config|
+  
+  config.before :all do
+    case ENV['BROWSER']
+    when 'desktop'
+      @browser = Watir::Browser.new :firefox
+      @agent = :desktop
+    when 'mobile'
+      driver = Webdriver::UserAgent.driver(:browser => :firefox, :agent => :iphone)
+      @browser = Watir::Browser.new driver
+      @agent = :mobile
+    end
+  end
+end
+```
+
+```ruby
+# spec/registration_link_spec.rb
+require 'spec_helper'
+require 'page'
+
+describe Page do
+  let(:page) { Page.new(@browser, :agent => @agent, :visit => true) }
+  
+  describe "#to_registration" do
+    it "takes me to the registration form" do
+      page.to_registration
+      @browser.url.should == "http://my-page.com/registration"
+    end
+  end
+end
+```
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'mobilify'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install mobilify
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## Questions, Comments, Concerns
+Easiest place to reach me is Twitter, [@jpdenen](http://twitter.com/jpdenen)

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/features/desktop_link.feature

@@ -0,0 +1,20 @@
+Feature: Desktop Link
+  To use one spec/feature per functionality
+  Testers will need to use normal page-object functionality on the desktop
+
+  Background:
+    Given I am using Firefox
+    And I navigate to a Manta profile
+
+  Scenario: Finding a link
+    When I query the map link
+    Then I should receive true
+
+  Scenario: Grabbing a link
+    When I ask for the map link element
+    Then I should receive the desktop link element
+
+  Scenario: Clicking a link
+    When I click the map link
+    Then I should land on the map page
+

data/features/mobile_link.feature

@@ -0,0 +1,20 @@
+Feature: Mobile Link
+  To use one spec/feature per functionality
+  Testers will need to use mobilified page-object functionality on mobile devices
+
+  Background:
+    Given I am using a mobile device
+    And I navigate to a Manta profile
+
+  Scenario: Finding a link
+    When I query the map link
+    Then I should receive true
+
+  Scenario: Grabbing a link
+    When I ask for the map link element
+    Then I should receive the mobile link element
+
+  Scenario: Clicking a link
+    When I click the map link
+    Then I should land on the map page
+

data/features/step_definitions/link_steps.rb

@@ -0,0 +1,27 @@
+When /^I query the map link$/ do
+  @query = @page.map?
+end
+
+When /^I ask for the map link element$/ do
+  @element = @page.map_element
+end
+
+When /^I click the map link$/ do
+  @page.map
+end
+
+Then /^I should receive true$/ do
+  @query.should == true
+end
+
+Then /^I should receive the desktop link element$/ do
+  @element.inspect.should include(':id=>"map-tab-link"')
+end
+
+Then /^I should receive the mobile link element$/ do
+  @element.inspect.should include(':class=>"pvm prm"')
+end
+
+Then /^I should land on the map page$/ do
+  @page.current_url.should include('/cmap/')
+end

data/features/step_definitions/navigation_step.rb

@@ -0,0 +1,14 @@
+Given /^I am using Firefox$/ do
+  @browser = Watir::Browser.new
+  @agent = :desktop
+end
+
+Given /^I am using a mobile device$/ do
+  driver = Webdriver::UserAgent.driver(:browser => :firefox, :agent => :iphone)
+  @browser = Watir::Browser.new driver
+  @agent = :mobile
+end
+
+Given /^I navigate to a Manta profile$/ do
+  @page = MantaPage.new(@browser, :agent => @agent, :visit => true)
+end

data/features/support/env.rb

@@ -0,0 +1,6 @@
+require 'rspec'
+require 'rspec-given'
+require 'watir-webdriver'
+require 'webdriver-user-agent'
+
+$:.unshift(File.dirname(File.expand_path('lib')))

data/features/support/hooks.rb

@@ -0,0 +1,3 @@
+After do
+  @browser.close
+end

data/features/support/manta_page.rb

@@ -0,0 +1,10 @@
+require 'mobilify'
+
+class MantaPage
+  include Mobilify
+
+  page_url "http://www.manta.com/c/mm2fqg7"
+
+  link(:map, :id => "map-tab-link")
+  link(:mobile_map, :class => "pvm prm")
+end

data/lib/mobilify.rb

@@ -0,0 +1,36 @@
+require 'page-object'
+
+module Mobilify
+  include PageObject
+
+  def initialize(browser, opts = {})
+    super(browser, opts[:visit] || false)
+    @mobile = opts[:agent] == :mobile
+    mobilify! if mobile?
+  end
+
+  def self.included(klass)
+    klass.send :include, PageObject
+  end
+
+  def mobile?
+    @mobile
+  end
+
+  private
+
+  def mobilify!
+    methods.
+      select { |m| m.to_s.start_with? 'mobile_' }.
+      select { |m| respond_to? m.to_s.gsub('mobile_', '') }.
+      map { |m| self.method(m) }.each do |method|
+        (class << self; self; end).class_eval do
+          define_method(method.name.to_s.gsub('mobile_', ''), method)
+        end
+      end
+  end
+
+end
+
+
+require 'mobilify/version'

data/lib/mobilify/version.rb

@@ -0,0 +1,3 @@
+module Mobilify
+  VERSION = "1.0.0"
+end

data/mobilify.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'mobilify/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "mobilify"
+  spec.version       = Mobilify::VERSION
+  spec.authors       = ["Johnson Denen"]
+  spec.email         = ["jdenen@manta.com"]
+  spec.description   = %q{Make your mobile testing easier with mobilified page objects}
+  spec.summary       = %q{Make your mobile testing easier with mobilified page objects}
+  spec.homepage      = "http://github.com/jdenen/mobilify"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "page-object"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "watir-webdriver"
+  spec.add_development_dependency "webdriver-user-agent"
+  spec.add_development_dependency "cucumber"
+end

metadata

@@ -0,0 +1,165 @@
+--- !ruby/object:Gem::Specification
+name: mobilify
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Johnson Denen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-12-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: page-object
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: watir-webdriver
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webdriver-user-agent
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Make your mobile testing easier with mobilified page objects
+email:
+- jdenen@manta.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- features/desktop_link.feature
+- features/mobile_link.feature
+- features/step_definitions/link_steps.rb
+- features/step_definitions/navigation_step.rb
+- features/support/env.rb
+- features/support/hooks.rb
+- features/support/manta_page.rb
+- lib/mobilify.rb
+- lib/mobilify/version.rb
+- mobilify.gemspec
+homepage: http://github.com/jdenen/mobilify
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Make your mobile testing easier with mobilified page objects
+test_files:
+- features/desktop_link.feature
+- features/mobile_link.feature
+- features/step_definitions/link_steps.rb
+- features/step_definitions/navigation_step.rb
+- features/support/env.rb
+- features/support/hooks.rb
+- features/support/manta_page.rb
+has_rdoc: