watir-device 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5a88d59a32832ae710aae68b6a11121611fb9dce
-  data.tar.gz: 5e5bbfcac8e6c8fb28b174dcc2548494f410e397
+  metadata.gz: d19a7097140b06008672f88a68842c53009da23f
+  data.tar.gz: c4ef967edf21197f47cb1a3003583b5de40c3f05
 SHA512:
-  metadata.gz: 5aeb5129001b535c0091a9ed64c72dc315299851bd511ae77f8d192ad8429beac9d78131f827744fb8b90a9e2109ce692d9954974f8df4a25b25cdc46bd82a4f
-  data.tar.gz: d45a75f1d45608f5d789a10247ca0529736b3211adf538511f64a33a1f0ce1addc08e788e2e15bc965df835d26221c5037beba5279dddd295f8a0c431207f158
+  metadata.gz: 4be0d1ce256e0da60176a4d3a16d76d8c86d82a91ed4dcc58a81541a5159f9ba2612544e09ca2329c77704baa2bc34000e82808c34de934be11e3fc4a8fb6311
+  data.tar.gz: 5f071c64f5027957b3d757238a52bd2084c713ac14cf65c9c76c8bab30c5614f3b5ef4071b800db3a135399607fe034d93552cdf1e6e3d3d6fd1e0bc983e32dd

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.5
+  - 2.2.2
+script: bundle exec rspec spec

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+# CHANGELOG
+
+## v0.1.0 (Sept 1, 2015)
+* Initial release

data/README.md

@@ -1,5 +1,8 @@
 # Watir::Device
 
+[![Gem Version](https://badge.fury.io/rb/watir-device.svg)](http://badge.fury.io/rb/watir-device)
+[![Build Status](https://travis-ci.org/jdenen/watir-device.svg?branch=master)](https://travis-ci.org/jdenen/watir-device)
+
 Automate Chrome Developer Tools' device emulation with watir-webdriver.
 
 ![screenshot](screenshot.png)

data/lib/watir-device/device.rb

@@ -1,25 +1,66 @@
 require 'watir-webdriver'
 
 module Watir
+
+  #
+  # Automate Chrome in mobile emulation mode. Devices availabe for emulation are available in the 
+  # Dev Tool preferences, including "Apple iPhone 6 Plus", "Samsung Galaxy Note 3", "Google Nexus 10", etc.
+  #
+  # @author Johnson Denen
+  #
   class Device
     attr_reader :device_name, :driver, :browser
     
     class << self
+      
+      #
+      # Spin up an instance and navigate to a URL.
+      #
+      # @example Open iPhone 6+ to google.com
+      #   Watir::Device.start "www.google.com", "Apple iPhone 6 Plus"
+      #
+      # @param url [String] URL to visit
+      # @param device_name [String] device to emulate
+      # @return [Watir::Device]
+      #
       def start url, device_name, *args
         new(device_name, *args).tap { |dev| dev.goto url }
       end
     end
 
+    #
+    # Emulate a device browser with Chrome's mobile emulation tool.
+    #
+    # @param device_name [String] device to emulate
+    # @return [Watir::Device]
+    #
     def initialize device_name, *args
       @driver = device_driver(device_name)
       @device_name = device_name
       @browser = Watir::Browser.new driver
     end
 
+    #
+    # Get the emulated device's name.
+    #
+    # @return [String]
+    #
     def device
       device_name
     end
 
+    #
+    # Closed instances will return string ending in CLOSED.
+    #
+    # @return [String]
+    # @see Object#inspect
+    #
+    def inspect
+      '<#%s:0x%x device=%s url=%s>' % [self.class, hash*2, device, browser.url] rescue '<#%s:0x%x device=%s CLOSED>' % [self.class, hash*2, device]
+    end
+
+    # Build a WebDriver to emulate the device.
+    # @api private    
     def device_driver name
       opts = {
         "mobileEmulation" => {
@@ -30,8 +71,9 @@ module Watir
       Selenium::WebDriver.for(:chrome, desired_capabilities: capabilities)
     end
 
-    private
-    
+    # Undefined methods are passed to Watir::Browser.
+    # @see https://github.com/watir/watir-webdriver/blob/master/lib/watir-webdriver/browser.rb Watir::Browser
+    # @api private    
     def method_missing mthd, *args
       browser.send(mthd, *args)
     end

data/lib/watir-device/version.rb

@@ -1,5 +1,5 @@
 module Watir
   module WatirDevice
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
   end
 end

data/watir-device.gemspec

@@ -20,7 +20,8 @@ Gem::Specification.new do |spec|
 
   spec.add_runtime_dependency "watir-webdriver", "~> 0.8.0"
   
-  spec.add_development_dependency "bundler", "~> 1.9"
+  spec.add_development_dependency "bundler", ">= 1.7"
   spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.2"
   spec.add_development_dependency "simplecov", "~> 0.10"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: watir-device
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Johnson Denen
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-09-01 00:00:00.000000000 Z
+date: 2015-09-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: watir-webdriver
@@ -28,16 +28,16 @@ dependencies:
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
-        version: '1.9'
+        version: '1.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
-        version: '1.9'
+        version: '1.7'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -52,6 +52,20 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.2'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -74,6 +88,8 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
+- .travis.yml
+- CHANGELOG.md
 - Gemfile
 - LICENSE
 - README.md