percy-appium-app 0.0.1 → 0.0.3

data/percy/lib/ignore_region.rb

@@ -2,7 +2,8 @@
 
 # lib/ignore_region.rb
 require_relative 'region'
-
-class IgnoreRegion < Region
-  # Inherits everything from Region; no additional code needed unless you want to extend or modify the behavior
+module Percy
+  class IgnoreRegion < Percy::Region
+    # Inherits everything from Percy::Region; no additional code needed unless you want to extend or modify the behavior
+  end
 end

data/percy/lib/percy_automate.rb

@@ -10,50 +10,52 @@ IGNORE_ELEMENT_ALT_KEY = 'ignoreRegionAppiumElements'
 CONSIDER_ELEMENT_KEY = 'consider_region_appium_elements'
 CONSIDER_ELEMENT_ALT_KEY = 'considerRegionAppiumElements'
 
-class PercyOnAutomate
-  def initialize(driver)
-    unless driver.is_a?(Appium::Core::Base::Driver)
-      raise DriverNotSupported, 'The provided driver instance is not supported.'
+module Percy
+  class PercyOnAutomate
+    def initialize(driver)
+      unless driver.is_a?(Appium::Core::Base::Driver)
+        raise DriverNotSupported, 'The provided driver instance is not supported.'
+      end
+
+      @driver = driver
+      @percy_options = Percy::PercyOptions.new(@driver.capabilities)
     end
 
-    @driver = driver
-    @percy_options = PercyOptions.new(@driver.capabilities)
-  end
-
-  def screenshot(name, **options)
-    return nil unless @percy_options.enabled
-    raise TypeError, 'Argument name should be a string' unless name.is_a?(String)
-    raise KeyError, 'Please pass the last parameter as "options" key' unless options.key?(:options)
-
-    metadata = DriverMetadata.new(@driver)
-    options = options[:options] || {}
-
-    begin
-      options[IGNORE_ELEMENT_KEY] = options.delete(IGNORE_ELEMENT_ALT_KEY) if options.key?(IGNORE_ELEMENT_ALT_KEY)
-      options[CONSIDER_ELEMENT_KEY] = options.delete(CONSIDER_ELEMENT_ALT_KEY) if options.key?(CONSIDER_ELEMENT_ALT_KEY)
-
-      ignore_region_elements = options.fetch(IGNORE_ELEMENT_KEY, []).map(&:id)
-      consider_region_elements = options.fetch(CONSIDER_ELEMENT_KEY, []).map(&:id)
-      options.delete(IGNORE_ELEMENT_KEY)
-      options.delete(CONSIDER_ELEMENT_KEY)
-
-      additional_options = {
-        'ignore_region_elements' => ignore_region_elements,
-        'consider_region_elements' => consider_region_elements
-      }
-
-      CLIWrapper.new.post_poa_screenshots(
-        name,
-        metadata.session_id,
-        metadata.command_executor_url,
-        metadata.capabilities,
-        metadata.session_capabilities,
-        options.merge(additional_options)
-      )
-    rescue StandardError => e
-      log("Could not take Screenshot '#{name}'")
-      log(e.message, on_debug: true)
+    def screenshot(name, **options)
+      return nil unless @percy_options.enabled
+      raise TypeError, 'Argument name should be a string' unless name.is_a?(String)
+      raise KeyError, 'Please pass the last parameter as "options" key' unless options.key?(:options)
+
+      metadata = Percy::DriverMetadata.new(@driver)
+      options = options[:options] || {}
+
+      begin
+        options[IGNORE_ELEMENT_KEY] = options.delete(IGNORE_ELEMENT_ALT_KEY) if options.key?(IGNORE_ELEMENT_ALT_KEY)
+        options[CONSIDER_ELEMENT_KEY] = options.delete(CONSIDER_ELEMENT_ALT_KEY) if options.key?(CONSIDER_ELEMENT_ALT_KEY)
+
+        ignore_region_elements = options.fetch(IGNORE_ELEMENT_KEY, []).map(&:id)
+        consider_region_elements = options.fetch(CONSIDER_ELEMENT_KEY, []).map(&:id)
+        options.delete(IGNORE_ELEMENT_KEY)
+        options.delete(CONSIDER_ELEMENT_KEY)
+
+        additional_options = {
+          'ignore_region_elements' => ignore_region_elements,
+          'consider_region_elements' => consider_region_elements
+        }
+
+        Percy::CLIWrapper.new.post_poa_screenshots(
+          name,
+          metadata.session_id,
+          metadata.command_executor_url,
+          metadata.capabilities,
+          metadata.session_capabilities,
+          options.merge(additional_options)
+        )
+      rescue StandardError => e
+        log("Could not take Screenshot '#{name}'")
+        log(e.message, on_debug: true)
+      end
+      nil
     end
-    nil
   end
 end

data/percy/lib/percy_options.rb

@@ -1,37 +1,39 @@
 # frozen_string_literal: true
 
-class PercyOptions
-  IGNORE_ERRORS = 'ignoreErrors'
-  ENABLED = 'enabled'
-  PERCY_OPTIONS = ['percy:options', 'percyOptions'].freeze
+module Percy
+  class PercyOptions
+    IGNORE_ERRORS = 'ignoreErrors'
+    ENABLED = 'enabled'
+    PERCY_OPTIONS = ['percy:options', 'percyOptions'].freeze
 
-  def initialize(capabilities)
-    @capabilities = capabilities
-    @capabilities = @capabilities.as_json unless @capabilities.is_a?(Hash)
-    @percy_options = _parse_percy_options || {}
-  end
+    def initialize(capabilities)
+      @capabilities = capabilities
+      @capabilities = @capabilities.as_json unless @capabilities.is_a?(Hash)
+      @percy_options = _parse_percy_options || {}
+    end
 
-  def _parse_percy_options
-    options = PERCY_OPTIONS.map { |key| @capabilities.fetch(key, nil) }
-    options = if options.any? { |element| !element.nil? }
-                options[0] || options[1]
-              else
-                {}
-              end
+    def _parse_percy_options
+      options = PERCY_OPTIONS.map { |key| @capabilities.fetch(key, nil) }
+      options = if options.any? { |element| !element.nil? }
+                  options[0] || options[1]
+                else
+                  {}
+                end
 
-    if options
-      options[IGNORE_ERRORS] = @capabilities.fetch("percy.#{IGNORE_ERRORS}", true) unless options.key?(IGNORE_ERRORS)
-      options[ENABLED] = @capabilities.fetch("percy.#{ENABLED}", true) unless options.key?(ENABLED)
-    end
+      if options
+        options[IGNORE_ERRORS] = @capabilities.fetch("percy.#{IGNORE_ERRORS}", true) unless options.key?(IGNORE_ERRORS)
+        options[ENABLED] = @capabilities.fetch("percy.#{ENABLED}", true) unless options.key?(ENABLED)
+      end
 
-    options
-  end
+      options
+    end
 
-  def ignore_errors
-    @percy_options.fetch(IGNORE_ERRORS, true)
-  end
+    def ignore_errors
+      @percy_options.fetch(IGNORE_ERRORS, true)
+    end
 
-  def enabled
-    @percy_options.fetch(ENABLED, true)
+    def enabled
+      @percy_options.fetch(ENABLED, true)
+    end
   end
-end
+end

data/percy/lib/region.rb

@@ -1,22 +1,24 @@
 # frozen_string_literal: true
 
 # lib/region.rb
-class Region
-  attr_accessor :top, :bottom, :left, :right
+module Percy
+  class Region
+    attr_accessor :top, :bottom, :left, :right
 
-  def initialize(top, bottom, left, right)
-    raise ArgumentError, 'Only Positive integer is allowed!' if [top, bottom, left, right].any?(&:negative?)
-    raise ArgumentError, 'Invalid ignore region parameters!' if top >= bottom || left >= right
+    def initialize(top, bottom, left, right)
+      raise ArgumentError, 'Only Positive integer is allowed!' if [top, bottom, left, right].any?(&:negative?)
+      raise ArgumentError, 'Invalid ignore region parameters!' if top >= bottom || left >= right
 
-    @top = top
-    @bottom = bottom
-    @left = left
-    @right = right
-  end
+      @top = top
+      @bottom = bottom
+      @left = left
+      @right = right
+    end
 
-  def valid?(screen_height, screen_width)
-    return false if @top >= screen_height || @bottom > screen_height || @left >= screen_width || @right > screen_width
+    def valid?(screen_height, screen_width)
+      return false if @top >= screen_height || @bottom > screen_height || @left >= screen_width || @right > screen_width
 
-    true
+      true
+    end
   end
 end

data/percy/lib/tile.rb

@@ -1,28 +1,30 @@
 # frozen_string_literal: true
 
-class Tile
-  attr_reader :filepath, :status_bar_height, :nav_bar_height, :header_height, :footer_height, :fullscreen, :sha
+module Percy
+  class Tile
+    attr_reader :filepath, :status_bar_height, :nav_bar_height, :header_height, :footer_height, :fullscreen, :sha
 
-  def initialize(status_bar_height, nav_bar_height, header_height, footer_height, filepath: nil, sha: nil,
-                 fullscreen: false)
-    @filepath = filepath
-    @status_bar_height = status_bar_height
-    @nav_bar_height = nav_bar_height
-    @header_height = header_height
-    @footer_height = footer_height
-    @fullscreen = fullscreen
-    @sha = sha
-  end
+    def initialize(status_bar_height, nav_bar_height, header_height, footer_height, filepath: nil, sha: nil,
+                  fullscreen: false)
+      @filepath = filepath
+      @status_bar_height = status_bar_height
+      @nav_bar_height = nav_bar_height
+      @header_height = header_height
+      @footer_height = footer_height
+      @fullscreen = fullscreen
+      @sha = sha
+    end
 
-  def to_h
-    {
-      'filepath' => @filepath,
-      'status_bar_height' => @status_bar_height,
-      'nav_bar_height' => @nav_bar_height,
-      'header_height' => @header_height,
-      'footer_height' => @footer_height,
-      'fullscreen' => @fullscreen,
-      'sha' => @sha
-    }
+    def to_h
+      {
+        'filepath' => @filepath,
+        'status_bar_height' => @status_bar_height,
+        'nav_bar_height' => @nav_bar_height,
+        'header_height' => @header_height,
+        'footer_height' => @footer_height,
+        'fullscreen' => @fullscreen,
+        'sha' => @sha
+      }
+    end
   end
 end

data/percy/metadata/android_metadata.rb

@@ -4,76 +4,78 @@ require 'json'
 require_relative 'metadata'
 require_relative '../lib/cache'
 
-class AndroidMetadata < Metadata
-  def initialize(driver)
-    super(driver)
-    @_bars = nil
-    @_viewport_rect = capabilities.to_json['viewportRect']
-  end
+module Percy
+  class AndroidMetadata < Percy::Metadata
+    def initialize(driver)
+      super(driver)
+      @_bars = nil
+      @_viewport_rect = capabilities.to_json['viewportRect']
+    end
 
-  def device_screen_size
-    caps = capabilities
-    caps = caps.as_json unless caps.is_a?(Hash)
-    width, height = caps['deviceScreenSize'].split('x')
-    { 'width' => width.to_i, 'height' => height.to_i }
-  end
+    def device_screen_size
+      caps = capabilities
+      caps = caps.as_json unless caps.is_a?(Hash)
+      width, height = caps['deviceScreenSize'].split('x')
+      { 'width' => width.to_i, 'height' => height.to_i }
+    end
 
-  def get_system_bars
-    @_bars = Cache.get_cache(session_id, Cache::SYSTEM_BARS)
-    if @_viewport_rect
-      begin
-        @_bars = {
-          'statusBar' => { 'height' => @_viewport_rect['top'] },
-          'navigationBar' => {
-            'height' => device_screen_size['height'] - @_viewport_rect['height'] - @_viewport_rect['top']
+    def get_system_bars
+      @_bars = Percy::Cache.get_cache(session_id, Percy::Cache::SYSTEM_BARS)
+      if @_viewport_rect
+        begin
+          @_bars = {
+            'statusBar' => { 'height' => @_viewport_rect['top'] },
+            'navigationBar' => {
+              'height' => device_screen_size['height'] - @_viewport_rect['height'] - @_viewport_rect['top']
+            }
           }
-        }
-      rescue StandardError
-        @_bars = nil
+        rescue StandardError
+          @_bars = nil
+        end
       end
+      if @_bars.nil?
+        @_bars = driver.get_system_bars
+        Percy::Cache.set_cache(session_id, Percy::Cache::SYSTEM_BARS, @_bars)
+      end
+      @_bars
     end
-    if @_bars.nil?
-      @_bars = driver.get_system_bars
-      Cache.set_cache(session_id, Cache::SYSTEM_BARS, @_bars)
-    end
-    @_bars
-  end
 
-  def status_bar
-    status_bar = get_system_bars['statusBar']
-    if status_bar['height'] == 1
-      response = value_from_devices_info('status_bar', _device_name.upcase, os_version)
-      return { 'height' => response }
+    def status_bar
+      status_bar = get_system_bars['statusBar']
+      if status_bar['height'] == 1
+        response = value_from_devices_info('status_bar', _device_name.upcase, os_version)
+        return { 'height' => response }
+      end
+      status_bar
     end
-    status_bar
-  end
 
-  def navigation_bar
-    navigation_bar = get_system_bars['navigationBar']
-    if navigation_bar['height'] == 1
-      response = { 'height' => value_from_devices_info('nav_bar', _device_name.upcase, os_version) }
-      return response
+    def navigation_bar
+      navigation_bar = get_system_bars['navigationBar']
+      if navigation_bar['height'] == 1
+        response = { 'height' => value_from_devices_info('nav_bar', _device_name.upcase, os_version) }
+        return response
+      end
+      navigation_bar
     end
-    navigation_bar
-  end
 
-  def viewport
-    capabilities.to_json['viewportRect']
-  end
+    def viewport
+      capabilities.to_json['viewportRect']
+    end
 
-  def scale_factor
-    1
-  end
+    def scale_factor
+      1
+    end
 
-  def _device_name
-    if @device_name.nil?
-      desired_caps = capabilities.to_json['desired'] || {}
-      device_name = desired_caps['deviceName']
-      device = desired_caps['device']
-      device_name ||= device
-      device_model = capabilities.to_json['deviceModel']
-      @device_name = device_name || device_model
+    def _device_name
+      if @device_name.nil?
+        desired_caps = capabilities.to_json['desired'] || {}
+        device_name = desired_caps['deviceName']
+        device = desired_caps['device']
+        device_name ||= device
+        device_model = capabilities.to_json['deviceModel']
+        @device_name = device_name || device_model
+      end
+      @device_name
     end
-    @device_name
   end
 end

data/percy/metadata/driver_metadata.rb

@@ -2,39 +2,41 @@
 
 require_relative '../lib/cache'
 
-class DriverMetadata
-  def initialize(driver)
-    @driver = driver
-  end
+module Percy
+  class DriverMetadata
+    def initialize(driver)
+      @driver = driver
+    end
 
-  def session_id
-    @driver.session_id
-  end
+    def session_id
+      @driver.session_id
+    end
 
-  def command_executor_url
-    url = Cache.get_cache(session_id, Cache::COMMAND_EXECUTOR_URL)
-    if url.nil?
-      url = @driver.instance_variable_get(:@bridge).instance_variable_get(:@http).instance_variable_get(:@server_url).to_s
-      Cache.set_cache(session_id, Cache::COMMAND_EXECUTOR_URL, url)
+    def command_executor_url
+      url = Percy::Cache.get_cache(session_id, Percy::Cache::COMMAND_EXECUTOR_URL)
+      if url.nil?
+        url = @driver.instance_variable_get(:@bridge).instance_variable_get(:@http).instance_variable_get(:@server_url).to_s
+        Percy::Cache.set_cache(session_id, Percy::Cache::COMMAND_EXECUTOR_URL, url)
+      end
+      url
     end
-    url
-  end
 
-  def capabilities
-    caps = Cache.get_cache(session_id, Cache::SESSION_CAPABILITIES)
-    if caps.nil?
-      caps = @driver.capabilities.dup # In Ruby, use dup to create a shallow copy of the hash
-      Cache.set_cache(session_id, Cache::SESSION_CAPABILITIES, caps)
+    def capabilities
+      caps = Percy::Cache.get_cache(session_id, Percy::Cache::SESSION_CAPABILITIES)
+      if caps.nil?
+        caps = @driver.capabilities.dup # In Ruby, use dup to create a shallow copy of the hash
+        Percy::Cache.set_cache(session_id, Percy::Cache::SESSION_CAPABILITIES, caps)
+      end
+      caps
     end
-    caps
-  end
 
-  def session_capabilities
-    session_caps = Cache.get_cache(session_id, Cache::SESSION_CAPABILITIES)
-    if session_caps.nil?
-      session_caps = @driver.desired_capabilities.dup # Assuming there is a desired_capabilities method
-      Cache.set_cache(session_id, Cache::SESSION_CAPABILITIES, session_caps)
+    def session_capabilities
+      session_caps = Percy::Cache.get_cache(session_id, Percy::Cache::SESSION_CAPABILITIES)
+      if session_caps.nil?
+        session_caps = @driver.desired_capabilities.dup # Assuming there is a desired_capabilities method
+        Percy::Cache.set_cache(session_id, Percy::Cache::SESSION_CAPABILITIES, session_caps)
+      end
+      session_caps
     end
-    session_caps
   end
 end

data/percy/metadata/ios_metadata.rb

@@ -3,81 +3,83 @@
 require_relative 'metadata'
 require_relative '../lib/cache'
 
-class IOSMetadata < Metadata
-  attr_reader :_window_size
+module Percy
+  class IOSMetadata < Percy::Metadata
+    attr_reader :_window_size
 
-  def initialize(driver)
-    super(driver)
-    @_viewport = {}
-    @_window_size = {}
-  end
+    def initialize(driver)
+      super(driver)
+      @_viewport = {}
+      @_window_size = {}
+    end
 
-  def device_screen_size
-    vp = viewport
-    height = vp.fetch('top', 0) + vp.fetch('height', 0)
-    width = vp.fetch('width', 0)
-    if  height.zero? && width.zero?
-      scale_factor = value_from_devices_info('scale_factor', device_name)
-      height = get_window_size['height'] * scale_factor
-      width = get_window_size['width'] * scale_factor
+    def device_screen_size
+      vp = viewport
+      height = vp.fetch('top', 0) + vp.fetch('height', 0)
+      width = vp.fetch('width', 0)
+      if  height.zero? && width.zero?
+        scale_factor = value_from_devices_info('scale_factor', device_name)
+        height = get_window_size['height'] * scale_factor
+        width = get_window_size['width'] * scale_factor
+      end
+      { 'width' => width, 'height' => height }
     end
-    { 'width' => width, 'height' => height }
-  end
 
-  def status_bar
-    height = 0
-    view_port = viewport
-    if view_port.fetch('top', 0) != 0
-      height = view_port['top']
-    else
-      scale_factor = value_from_devices_info('scale_factor', device_name)
-      status_bar_height = value_from_devices_info('status_bar', device_name)
-      height = status_bar_height.to_i * scale_factor.to_i
+    def status_bar
+      height = 0
+      view_port = viewport
+      if view_port.fetch('top', 0) != 0
+        height = view_port['top']
+      else
+        scale_factor = value_from_devices_info('scale_factor', device_name)
+        status_bar_height = value_from_devices_info('status_bar', device_name)
+        height = status_bar_height.to_i * scale_factor.to_i
+      end
+      { 'height' => height }
     end
-    { 'height' => height }
-  end
 
-  def navigation_bar
-    { 'height' => 0 }
-  end
+    def navigation_bar
+      { 'height' => 0 }
+    end
 
-  def get_window_size
-    @_window_size = Cache.get_cache(session_id, Cache::WINDOW_SIZE)
-    unless @_window_size
-      @_window_size = driver.get_window_size
-      Cache.set_cache(session_id, Cache::WINDOW_SIZE, @_window_size)
+    def get_window_size
+      @_window_size = Percy::Cache.get_cache(session_id, Percy::Cache::WINDOW_SIZE)
+      unless @_window_size
+        @_window_size = driver.get_window_size
+        Percy::Cache.set_cache(session_id, Percy::Cache::WINDOW_SIZE, @_window_size)
+      end
+      @_window_size
     end
-    @_window_size
-  end
 
-  def viewport
-    @_viewport = Cache.get_cache(session_id, Cache::VIEWPORT)
-    if @_viewport.nil? || (@_viewport.is_a?(Hash) && @_viewport.empty?)
-      begin
-        @_viewport = execute_script('mobile: viewportRect')
-        Cache.set_cache(session_id, Cache::VIEWPORT, @_viewport)
-      rescue StandardError
-        log('Could not use viewportRect; using static config', on_debug: true)
-        # setting `viewport` as empty hash so that it's not nil anymore
-        Cache.set_cache(session_id, Cache::VIEWPORT, {})
+    def viewport
+      @_viewport = Percy::Cache.get_cache(session_id, Percy::Cache::VIEWPORT)
+      if @_viewport.nil? || (@_viewport.is_a?(Hash) && @_viewport.empty?)
+        begin
+          @_viewport = execute_script('mobile: viewportRect')
+          Percy::Cache.set_cache(session_id, Percy::Cache::VIEWPORT, @_viewport)
+        rescue StandardError
+          log('Could not use viewportRect; using static config', on_debug: true)
+          # setting `viewport` as empty hash so that it's not nil anymore
+          Percy::Cache.set_cache(session_id, Percy::Cache::VIEWPORT, {})
+        end
       end
+      @_viewport || { 'top' => 0, 'height' => 0, 'width' => 0 }
     end
-    @_viewport || { 'top' => 0, 'height' => 0, 'width' => 0 }
-  end
 
-  def device_name
-    if @device_name.nil?
-      caps = capabilities
-      caps = caps.as_json unless caps.is_a?(Hash)
-      @device_name = caps['deviceName']
+    def device_name
+      if @device_name.nil?
+        caps = capabilities
+        caps = caps.as_json unless caps.is_a?(Hash)
+        @device_name = caps['deviceName']
+      end
+      @device_name
     end
-    @device_name
-  end
 
-  def scale_factor
-    scale_factor = value_from_devices_info('scale_factor', device_name)
-    return viewport['width'] / get_window_size['width'] if scale_factor.zero?
+    def scale_factor
+      scale_factor = value_from_devices_info('scale_factor', device_name)
+      return viewport['width'] / get_window_size['width'] if scale_factor.zero?
 
-    scale_factor
+      scale_factor
+    end
   end
-end
+end