screen-object 1.0.0

data/lib/screen-object/accessors/button.rb

@@ -0,0 +1,36 @@
+=begin
+***********************************************************************************************************
+Copyright 2016 Capital One Services, LLC
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+    http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and limitations under the License. 
+***********************************************************************************************************
+=end
+
+#require_relative File.expand_path('../element',__FILE__)
+
+
+module ScreenObject
+  module AppElements
+    class Button < AppElements::Element
+
+      def tap
+          element.click
+      end
+
+      def enabled?
+        begin
+          element.enabled?
+        rescue
+          false
+        end
+      end
+
+     end
+  end
+end

data/lib/screen-object/accessors/checkbox.rb

@@ -0,0 +1,38 @@
+=begin
+***********************************************************************************************************
+Copyright 2016 Capital One Services, LLC
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+    http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and limitations under the License. 
+***********************************************************************************************************
+=end
+
+
+module ScreenObject
+  module AppElements
+    class CheckBox < AppElements::Element
+
+      def checked?
+        if element.attribute('checked') == 'true'
+          return true
+        else
+          return false
+        end
+      end 
+
+      def check
+        element.click unless checked?
+      end
+
+      def uncheck
+        element.click if checked?
+      end
+      
+    end
+  end
+end

data/lib/screen-object/accessors/element.rb

@@ -0,0 +1,144 @@
+=begin
+***********************************************************************************************************
+Copyright 2016 Capital One Services, LLC
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+    http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and limitations under the License. 
+***********************************************************************************************************
+=end
+
+module ScreenObject
+  module AppElements
+
+    class Element
+
+      attr_reader :locator
+
+      def initialize(locator)
+        @locator=locator.split("~")
+      end
+
+      def driver
+        $driver
+      end
+
+      def click
+          element.click
+      end
+
+      def value
+          element.value
+      end
+
+      def exists?
+        begin
+          element.displayed?
+        rescue
+          false
+        end
+      end
+
+      def element
+        driver.find_element(:"#{locator[0]}",locator[1])
+      end
+
+      def elements
+        driver.find_elements(:"#{locator[0]}",locator[1])
+      end
+
+      def element_attributes
+        %w[name resource-id value text]
+      end
+
+      def dynamic_xpath(text)
+        concat_attribute=[]
+        element_attributes.each{|i| concat_attribute << %Q(contains(@#{i}, '#{text}'))}
+        puts  "//#{locator[0]}[#{concat_attribute.join(' or ')}]"
+        locator1="xpath~//#{locator[0]}[#{concat_attribute.join(' or ')}]"
+        @locator=locator1.split("~")
+        element
+      end
+
+      def dynamic_text_exists? dynamic_text
+        begin
+          dynamic_xpath(dynamic_text).displayed?
+        rescue
+          false
+        end
+      end
+
+      def scroll
+        $driver.execute_script 'mobile: scrollTo',:element => element.ref
+        # $driver.execute_script("mobile: scroll",:direction => direction.downcase, :element => element.ref)
+      end
+
+      def scroll_to_text(text)
+        $driver.scroll_to(text)
+      end
+
+      def scroll_to_exact_text(text)
+        $driver.scroll_to_exact(text)
+      end
+
+      def scroll_for_element_click
+        if element.displayed?
+          element.click
+        else
+          scroll
+          element.click
+        end
+      end
+
+      def scroll_for_dynamic_element_click (expected_text)
+        if dynamic_xpath(expected_text).displayed?
+          element.click
+        else
+          scroll
+          element.click
+        end
+      end
+
+      def click_text(text)
+        if exists?
+          click
+        else
+          scroll_to_text(text)
+          element.click
+        end
+      end
+
+      def click_dynamic_text(text)
+        if dynamic_text_exists?(text)
+          element.click
+        else
+          scroll_to_text(text)
+          element.click
+        end
+      end
+
+      def click_exact_text(text)
+        if exists?
+          click
+        else
+          scroll_to_exact_text(text)
+          element.click
+        end
+      end
+
+      def click_dynamic_exact_text(text)
+        if dynamic_text_exists?(text)
+          element.click
+        else
+          scroll_to_exact_text(text)
+          element.click
+        end
+      end
+
+    end
+  end
+end

data/lib/screen-object/accessors/image.rb

@@ -0,0 +1,25 @@
+=begin
+***********************************************************************************************************
+Copyright 2016 Capital One Services, LLC
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+    http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and limitations under the License. 
+***********************************************************************************************************
+=end
+
+module ScreenObject
+  module AppElements
+    class Image < AppElements::Element
+
+      def click
+        element.click
+      end
+
+    end
+  end
+end

data/lib/screen-object/accessors/table.rb

@@ -0,0 +1,26 @@
+=begin
+***********************************************************************************************************
+Copyright 2016 Capital One Services, LLC
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+    http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and limitations under the License. 
+***********************************************************************************************************
+=end
+
+module ScreenObject
+  module AppElements
+      
+    class Table < AppElements::Element
+
+      def cell_count
+        elements.length
+      end
+
+    end
+  end
+end

data/lib/screen-object/accessors/text.rb

@@ -0,0 +1,46 @@
+=begin
+***********************************************************************************************************
+Copyright 2016 Capital One Services, LLC
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+    http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and limitations under the License. 
+***********************************************************************************************************
+=end
+
+module ScreenObject
+  module AppElements
+    class Text < AppElements::Element
+
+      def text
+        element.text()
+      end
+
+      def click
+        element.click
+      end
+
+      def dynamic_text_exists? dynamic_text
+         begin
+          dynamic_xpath(dynamic_text).displayed?
+        rescue
+          false
+        end
+      end
+
+      def dynamic_text dynamic_text
+        begin
+          dynamic_xpath(dynamic_text).displayed?
+          text
+        rescue
+          false
+        end
+      end
+
+    end
+  end
+end

data/lib/screen-object/accessors/textfield.rb

@@ -0,0 +1,41 @@
+=begin
+***********************************************************************************************************
+Copyright 2016 Capital One Services, LLC
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+    http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and limitations under the License. 
+***********************************************************************************************************
+=end
+
+module ScreenObject
+  module AppElements
+    class TextField < AppElements::Element
+
+      def text=(text)
+        element.send_keys text
+      end
+
+      def text
+        element.text
+      end
+    
+      def clear
+        element.clear
+      end
+
+      def enabled?
+        begin
+          element.enabled?
+        rescue
+          false
+        end
+      end
+
+    end
+  end
+end

data/lib/screen-object/appium_server.rb

@@ -0,0 +1,58 @@
+=begin
+***********************************************************************************************************
+Copyright 2016 Capital One Services, LLC
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+    http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and limitations under the License. 
+***********************************************************************************************************
+=end
+
+require 'childprocess'
+
+#
+# This class is designed to start and stop the appium server process.  In order to use
+# it you must have appium and node installed on your computer.  You can pass parameters
+# to appium at startup via the constructor.
+#
+module ScreenObject
+  class AppiumServer
+
+    attr_accessor :process
+    
+
+    def initialize(params={})
+      @params = params
+    end
+
+    #
+    # Start the appium server
+    #
+    def start
+      @process = ChildProcess.build(*parameters)
+      process.start
+    end
+
+    #
+    # Stop the appium server
+    #
+    def stop
+      process.stop
+    end
+
+    private
+
+    def parameters
+      cmd = ['appium']
+      @params.each do |key, value|
+        cmd << '--'+key.to_s
+        cmd << value.to_s if not value.nil? and value.size > 0
+      end
+      cmd
+    end
+  end
+end

data/lib/screen-object/elements.rb

@@ -0,0 +1,21 @@
+=begin
+***********************************************************************************************************
+Copyright 2016 Capital One Services, LLC
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+    http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and limitations under the License. 
+***********************************************************************************************************
+=end
+
+require 'screen-object/accessors/element'
+require 'screen-object/accessors/button'
+require 'screen-object/accessors/image'
+require 'screen-object/accessors/text'
+require 'screen-object/accessors/textfield'
+require 'screen-object/accessors/checkbox'
+require 'screen-object/accessors/table'