sparkling_watir 0.0.3 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cb95d81bc23cf2938bd4b20fa4cb06e18b7b104f4a2db9477f0e5d4b822577d0
-  data.tar.gz: dd4d2c67b98376c94707109e38d26e938f4af779e5f92e1752b77cc7d97e78c7
+  metadata.gz: 54f71df6f4b8e0ceb12704a5cf715840de8938bc6869acd23842d75af023190c
+  data.tar.gz: b37575d1b9aa5e422f69b7a9bd3343336d93e0696d5e977b5ee5ffb9d62f37e8
 SHA512:
-  metadata.gz: 3b7d5973211467df06ede87056ad6269359c7e0fbc420831ef956a27eb28050e0dd208ad4b35b628e38a127c24840f35a359a0fb74c2c83a22e5a684847094d9
-  data.tar.gz: 8aed1b54a5c1b2815abe4e77af649aff96efdadd217bee16869f68f9b4e4c63821759dbb1bacf550307ded1d52debd3fa34e46105c6ec4d0283a9dd800cca269
+  metadata.gz: 23e94769776fadcb8dd912fc1b857a34690719212867446ca2d300b7dfa1a1a2260251f71d01ba9bac9701cca8b7317891e07c1b6e9157fff60c4041ca1394ee
+  data.tar.gz: e0e4f5d9fa929e79813a577aecaf3ccc34298bc322dba70684cb5cf511f0289a9edabd53c44032203d6ada657136f6df6324c818f4809619aa66a1f67ee34e45

data/lib/sparkling_watir/element.rb

@@ -8,7 +8,8 @@ module SparklingWatir
   # This is a element in the native app context
   #
   class Element
-    include Gestures
+    attr_reader :driver
+
     include Waitable
 
     def initialize(driver, selector)
@@ -68,6 +69,20 @@ module SparklingWatir
       }
     end
 
+    def attribute(attribute_name)
+      wd.attribute(attribute_name)
+    end
+
+    def value
+      if driver.capabilities[:platform_name] == 'Android'
+        attribute('text')
+      else
+        attribute('value')
+      end
+    end
+
+    alias text value
+
     private
 
     def locate

data/lib/sparkling_watir/gestures.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require 'appium_lib_core/common/touch_action/touch_actions'
 require 'selenium/webdriver/common/interactions/interactions'
 
 module SparklingWatir
@@ -16,57 +15,88 @@ module SparklingWatir
       @driver.perform_actions actions
     end
 
-    def tap(timeout = nil)
-      wait_until(timeout: timeout, &:present?)
+    def tap(opts = {})
+      coordinates = { x: opts[:x] || opts[:on].center[:x], y: opts[:y] || opts[:on].center[:y] }
       tap = action(:touch, 'tap')
-      tap.create_pointer_move(duration: 0.1, x: center[:x], y: center[:y], origin: VIEWPORT)
+      tap.create_pointer_move(duration: 0.1, x: coordinates[:x], y: coordinates[:y], origin: VIEWPORT)
       tap.create_pointer_down(:left)
+      tap.create_pause(opts[:duration] || 0)
       tap.create_pointer_up(:left)
       perform tap
     end
 
     alias press tap
 
-    def double_tap
-      wait_until(&:present?)
+    def double_tap(opts = {})
       double_tap = action(:touch, 'double_tap')
-      tap.create_pointer_move(duration: 0.1, x: center[:x], y: center[:y], origin: VIEWPORT)
+      coordinates = { x: opts[:x] || opts[:on].center[:x], y: opts[:y] || opts[:on].center[:y] }
+      double_tap.create_pointer_move(duration: 0, x: coordinates[:x], y: coordinates[:y], origin: VIEWPORT)
       double_tap.create_pointer_down(:left)
+      double_tap.create_pause(0.1)
       double_tap.create_pointer_up(:left)
+      double_tap.create_pause(0.1)
       double_tap.create_pointer_down(:left)
+      double_tap.create_pause(0.1)
       double_tap.create_pointer_up(:left)
 
       perform double_tap
     end
 
+    def long_press(opts = {})
+      tap(duration: opts[:duration] || 0.5, on: opts[:on])
+    end
+
     def swipe(opts = {})
-      wait_until(&:present?)
-      start_coordinates = self.center
-      end_coordinates = select_direction(opts[:to].wait_until(&:exists?).center[:x], opts[:to].wait_until(&:exists?).center[:y], opts[:direction])
-      duration = opts[:duration] || 1
-      execute_swipe(duration, start_coordinates, end_coordinates)
+      coordinates = select_direction(opts[:to], opts[:direction])
+      execute_swipe(coordinates)
     end
 
     private
 
-    def execute_swipe(duration, start_coordinates, end_coordinates)
+    def execute_swipe(coordinates)
       finger = action(:touch, 'swipe')
-      finger.create_pointer_move(duration: duration, x: start_coordinates[:x], y: start_coordinates[:y],
+      finger.create_pointer_move(duration: 0, x: coordinates[:start_coordinates][:x],
+                                 y: coordinates[:start_coordinates][:y],
                                  origin: VIEWPORT)
       finger.create_pointer_down(:left)
-      finger.create_pointer_move(duration: duration, x: end_coordinates[:x], y: end_coordinates[:y],
+      finger.create_pause(0.6)
+      finger.create_pointer_move(duration: 0.6, x: coordinates[:end_coordinates][:x],
+                                 y: coordinates[:end_coordinates][:y],
                                  origin: VIEWPORT)
       finger.create_pointer_up(:left)
+      finger.create_pointer_down(:left)
+
       perform finger
     end
 
-    def select_direction(x, y, direction)
+    def select_direction(element, direction)
       case direction
-      when :down then { x: x, y: - y } # For swipe down, increase y-coordinate
-      when :up then { x: x, y: y * 20 } # For swipe up, decrease y-coordinate
-      when :left, :right then { x: x, y: y }
+      when :down
+        start_x = element.center[:x]
+        start_y = @driver.window_size.height * 0.8
+        end_x = element.center[:x]
+        end_y = element.center[:y]
+      when :up
+        start_x = @driver.window_size.width / 2
+        start_y = @driver.window_size.height * 0.2
+        end_x = element.center[:x]
+        end_y = element.center[:y] / 0.5
+      when :left
+        start_x = @driver.window_size.width
+        start_y = element.center[:y]
+        end_x = element.center[:x]
+        end_y = element.center[:y]
+      when :right
+        start_x = @driver.window_size.width
+        start_y = element.center[:y]
+        end_x = element.center[:x]
+        end_y = element.center[:y]
       else raise "You selected an invalid direction. The valid directions are: :down, :up, :left, :right"
       end
+      {
+        start_coordinates: { x: start_x, y: start_y },
+        end_coordinates: { x: end_x, y: end_y }
+      }
     end
   end
 end

data/lib/sparkling_watir/logger.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+# 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.
+
+require 'forwardable'
+require 'logger'
+
+module SparklingWatir
+  module Logger
+    #
+    # @example Use logger manually
+    #   SparklingWatir::Logger.debug('This is info message')
+    #   SparklingWatir::Logger.warn('This is warning message')
+    #
+    class << self
+      extend Forwardable
+      def_delegators :logger, :fatal, :error, :warn, :info, :debug, :level, :level=, :formatter, :formatter=
+
+      attr_writer :logger
+
+      private
+
+      def logger
+        @logger ||= begin
+                      logger = ::Logger.new($stdout)
+                      logger.progname = 'sparkling_watir'
+                      logger.level = ::Logger::WARN
+                      logger.formatter = proc { |_severity, _datetime, _progname, msg| "#{msg}\n" }
+                      logger
+                    end
+      end
+    end # class << self
+  end # module Logger
+end # module SparklingWatir

data/lib/sparkling_watir/screenshot.rb

@@ -0,0 +1,50 @@
+module SparklingWatir
+  class Screenshot
+    attr_reader :driver
+
+    def initialize(driver)
+      @driver = driver
+    end
+
+    #
+    # Saves screenshot to given path.
+    #
+    # @example
+    #   driver.screenshot.save "screenshot.png"
+    #
+    # @param [String] path
+    #
+
+    def save(path)
+      driver.save_screenshot(path)
+    end
+
+    #
+    # Represents screenshot as PNG image string.
+    #
+    # @example
+    #   driver.screenshot.png
+    #   #=> '\x95\xC7\x8C@1\xC07\x1C(Edb\x15\xB2\vL'
+    #
+    # @return [String]
+    #
+
+    def png
+      driver.screenshot_as(:png)
+    end
+
+    #
+    # Represents screenshot as Base64 encoded string.
+    #
+    # @example
+    #   driver.screenshot.base64
+    #   #=> '7HWJ43tZDscPleeUuPW6HhN3x+z7vU/lufmH0qNTtTum94IBWMT46evImci1vnFGT'
+    #
+    # @return [String]
+    #
+
+    def base64
+      driver.screenshot_as(:base64)
+    end
+  end # Screenshot
+end # SparklingWatir

data/lib/sparkling_watir.rb

@@ -2,17 +2,22 @@
 
 require 'appium_lib_core'
 require 'watir'
+require_relative './sparkling_watir/gestures'
+require_relative './sparkling_watir/logger'
+require_relative './sparkling_watir/screenshot'
 
 module SparklingWatir
   #
-  # For driving a native application or a native app context
+  # For driving a native application
   #
   class App
     attr_accessor :driver
 
+    include Gestures
+
     def initialize(opts)
-      url = opts[:caps]
-      @driver = Appium::Core::Driver.for(opts).start_driver(server_url: 'http://localhost:4723/wd/hub')
+      url = opts[:caps]['url']
+      @driver = Appium::Core::Driver.for(opts).start_driver(server_url: url)
     end
 
     def quit
@@ -25,6 +30,10 @@ module SparklingWatir
       Element.new(driver, selector)
     end
 
+    def screenshot
+      Screenshot.new self
+    end
+
     def method_missing(method_name, *arguments, &block)
       if driver.respond_to? method_name
         driver.send method_name, *arguments, &block

data/sparkling_watir.gemspec

@@ -5,10 +5,10 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name          = 'sparkling_watir'
-  spec.version       = '0.0.3'
+  spec.version       = '0.0.5'
   spec.authors       = ['Agustin Pequeno']
   spec.email         = ['agustin.pe94@gmail.com']
-
+  spec.homepage = 'https://github.com/aguspe/sparkling_watir'
   spec.summary       = 'A watir adaptation for testing your native mobile apps'
   spec.description   = 'Sparkling watir takes heavy inspiration from tap watir and is a mobile adaptation of watir'
   spec.license       = 'MIT'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sparkling_watir
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.5
 platform: ruby
 authors:
 - Agustin Pequeno
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-07-11 00:00:00.000000000 Z
+date: 2023-07-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -138,10 +138,12 @@ files:
 - lib/sparkling_watir.rb
 - lib/sparkling_watir/element.rb
 - lib/sparkling_watir/gestures.rb
+- lib/sparkling_watir/logger.rb
+- lib/sparkling_watir/screenshot.rb
 - lib/sparkling_watir/wait.rb
 - lib/sparkling_watir/wait/timer.rb
 - sparkling_watir.gemspec
-homepage:
+homepage: https://github.com/aguspe/sparkling_watir
 licenses:
 - MIT
 metadata: {}