Class: Applitools::Images::Eyes

Inherits:
EyesBase
  • Object
show all
Defined in:
lib/applitools/images/eyes.rb

Overview

A class to perform visual validation on images. Allows to handle user data like Mouse trigger and Text trigger

Examples:

eyes = Applitools::Images::Eyes.new
eyes.open(app_name: 'App name', test_name: 'Test name')
eyes.check_image(eyes.check_image(image_path: '~/test/some_screenshot.png', tag: 'My Test')
eyes.close(true)

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(server_url = Applitools::Connectivity::ServerConnector::DEFAULT_SERVER_URL) ⇒ Eyes

Creates a new eyes object

Examples:

eyes = Applitools::Images::Eyes.new

Parameters:

  • server_url (defaults to: Applitools::Connectivity::ServerConnector::DEFAULT_SERVER_URL) —

    The Eyes Server URL



22
23
24
25
26
 
# File 'lib/applitools/images/eyes.rb', line 22

def initialize(server_url = Applitools::Connectivity::ServerConnector::DEFAULT_SERVER_URL)
  super
  self.base_agent_id = "eyes.images.ruby/#{Applitools::VERSION}".freeze
  self.runner = Applitools::ClassicRunner.new
end

Class Method Details

.environment_sdk ⇒ Object 



33
34
35
36
37
38
 
# File 'lib/applitools/images/eyes.rb', line 33

def self.environment_sdk
  {
    name: :eyes_images,
    currentVersion: Applitools::EyesImages::VERSION
  }
end

Instance Method Details

#add_mouse_trigger(action, control, cursor) ⇒ Object

Adds a mouse trigger

Parameters:

  • action (Symbol) —

    A mouse action. Can be one of :click, :right_click, :double_click, :move, :down, :up

  • control (Applitools::Region) —

    The control on which the trigger is activated (context relative coordinates).

  • cursor (Applitools::Location) —

    The cursor’s position relative to the control.



163
164
165
 
# File 'lib/applitools/images/eyes.rb', line 163

def add_mouse_trigger(action, control, cursor)
  add_mouse_trigger_base action, control, cursor
end

#add_text_trigger(control, text) ⇒ Object

Adds a keyboard trigger

Parameters:

  • control (Applitools::Region) —

    the control’s context-relative region.

  • text —

    The trigger’s text.



170
171
172
 
# File 'lib/applitools/images/eyes.rb', line 170

def add_text_trigger(control, text)
  add_text_trigger_base control, text
end

#check(*args) ⇒ Object 



72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
 
# File 'lib/applitools/images/eyes.rb', line 72

def check(*args)
  args.compact!
  case (first_arg = args.shift)
  when String
    name = first_arg
    target = args.shift
  when Applitools::Selenium::Target
    target = first_arg
  when Hash
    target = first_arg[:target]
    name = first_arg[:name] || first_arg[:tag]
  end

  result = check_it(name, target, Applitools::MatchWindowData.new(default_match_settings))
  result.nil? ? result : result.as_expected? # from v4 nil
end

#check_image(options) ⇒ Object

Matches the input image with the next expected image. Takes a hash as an argument. Returns boolean as result of matching.

Examples:

Image is a file

eyes.check_image(image_path: '~/test/some_screenshot.png', tag: 'My Test')

Image is a Applitools::Screenshot instance

eyes.check_image(image: my_image, tag: 'My Test')

Image is a String

eyes.check_image(image_bytes: string_represents_image, tag: 'My Test')

Ignore mismatch

eyes.check_image(image: my_image, tag: 'My Test', ignore_mismatch: true)

Parameters:

  • options (Hash)

Options Hash (options):

  • :image (Applitools::Screenshot)
  • :image_bytes (String) —

    image in PNG format. Can be obtained as ChunkyPNG::Image.to_blob()

  • :image_path (String)
  • :tag (String) —

    An optional tag to be associated with the validation checkpoint.

  • :ignore_mismatch (Boolean) —

    If set to true the server should ignore a negative result for the visual validation. (false by default)



125
126
127
128
129
130
 
# File 'lib/applitools/images/eyes.rb', line 125

def check_image(options)
  options = { tag: '', ignore_mismatch: false }.merge options
  # image = get_image_from_options(options)
  target = Applitools::Images::Target.any(options).ignore_mismatch(options[:ignore_mismatch])
  check(options[:tag], target)
end

#check_it(name, target, match_window_data) ⇒ Object 



103
104
105
106
 
# File 'lib/applitools/images/eyes.rb', line 103

def check_it(name, target, match_window_data)
  Applitools::ArgumentGuard.not_nil(name, 'name')
  universal_check(name, target)
end

#check_region(options) ⇒ Object

Performs visual validation for the current image.

Examples:

Image is a file

eyes.check_region(image_path: '~/test/some_screenshot.png', region: my_region, tag: 'My Test')

Image is a Applitools::Screenshot instance

eyes.check_region(image: my_image, tag: 'My Test', region: my_region)

Image is a String

eyes.check_region(image_bytes: string_represents_image, tag: 'My Test', region: my_region)

Parameters:

  • options (Hash)

Options Hash (options):

  • :region (Applitools::Region) —

    A region to validate within the image

  • :image (Applitools::Screenshot) —

    Image to validate

  • :image_bytes (String) —

    Image in PNG format. Can be obtained as ChunkyPNG::Image.to_blob()

  • :image_path (String) —

    Path to image file

  • :tag (String) —

    An optional tag to be associated with the validation checkpoint.

  • :ignore_mismatch (Boolean) —

    If set to true the server would ignore a negative result for the visual validation



147
148
149
150
151
152
153
154
155
 
# File 'lib/applitools/images/eyes.rb', line 147

def check_region(options)
  options = { tag: '', ignore_mismatch: false }.merge options
  Applitools::ArgumentGuard.not_nil options[:region], 'options[:region] can\'t be nil!'
  # image = get_image_from_options options
  target = Applitools::Images::Target.any(options).ignore_mismatch(options[:ignore_mismatch])
  target.region(options[:region])
  logger.info "check_region(image, #{options[:region]}, #{options[:tag]}, #{options[:ignore_mismatch]})"
  check(options[:tag], target)
end

#check_single(name, target, options = {}) ⇒ Object 



89
90
91
92
93
 
# File 'lib/applitools/images/eyes.rb', line 89

def check_single(name, target, options = {})
  open_and_close(name, target, options) do |n, t|
    check_it(n, t, Applitools::MatchSingleCheckData.new)
  end
end

#configure {|config| ... } ⇒ Object

Yields:

  • (config) 


28
29
30
31
 
# File 'lib/applitools/images/eyes.rb', line 28

def configure
  return unless block_given?
  yield(config)
end

#open(options = {}) ⇒ Object

Starts a test.

Examples:

eyes.open app_name: 'my app', test_name: 'my test'

Parameters:

  • options (Hash) (defaults to: {})

Options Hash (options):

  • :app_name (String) —

    the name of the application under trest. Required.

  • :test_name (String) —

    the test name. Required

  • :viewport_size (String | Hash) —

    viewport size for the baseline, may be passed as a string ('800x600') or as a hash ({width: 800, height: 600}). If ommited, the viewport size will be grabbed from the actual image size



49
50
51
52
53
54
 
# File 'lib/applitools/images/eyes.rb', line 49

def open(options = {})
  Applitools::ArgumentGuard.hash options, 'open(options)', [:app_name, :test_name]
  options[:viewport_size] = Applitools::RectangleSize.from_any_argument options[:viewport_size]
  # options = Applitools::Utils.extract_options!(args)
  universal_open(options)
end

#open_and_close(*args) ⇒ Object 



95
96
97
98
99
100
101
 
# File 'lib/applitools/images/eyes.rb', line 95

def open_and_close(*args)
  options_for_open = Applitools::Utils.extract_options!(args)
  open(options_for_open)
  result = yield(*args)
  close(true, true)
  result
end

#test(options = {}, &_block) ⇒ Object

Opens eyes using passed options, yields the block and then closes eyes session. Use Applitools::Images::Eyes method inside the block to perform the test. If the block throws an exception, eyes session will be closed correctly.

Examples:

eyes.test(app_name: 'Eyes.Java', test_name: 'home2') do
  eyes.check_image(image_path: './images/viber-home.png')
  eyes.check_image(image_path: './images/viber-bada.png')
end


64
65
66
67
68
69
70
 
# File 'lib/applitools/images/eyes.rb', line 64

def test(options = {}, &_block)
  open(options)
  yield
  close
ensure
  abort_if_not_closed
end