Class: Applitools::EyesBase
- Inherits:
-
Object
- Object
- Applitools::EyesBase
- Extended by:
- Helpers, Forwardable
- Includes:
- MatchLevelSetter
- Defined in:
- lib/applitools/core/eyes_base.rb
Direct Known Subclasses
Defined Under Namespace
Classes: UserInputArray
Constant Summary collapse
- DEFAULT_MATCH_TIMEOUT =
seconds
2
- USE_DEFAULT_TIMEOUT =
-1
- SCREENSHOT_AS_IS =
Applitools::EyesScreenshot::COORDINATE_TYPES[:screenshot_as_is].freeze
- CONTEXT_RELATIVE =
Applitools::EyesScreenshot::COORDINATE_TYPES[:context_relative].freeze
Instance Attribute Summary collapse
-
#allow_empty_screenshot ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#batch ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#compare_with_parent_branch ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#config ⇒ Object
writeonly
Sets the attribute config.
-
#cut_provider ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#default_match_settings ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#exact ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#failure_reports ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#inferred_environment ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#match_timeout ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#position_provider ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#remove_session_if_matching ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#results ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#runner ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#save_failed_tests ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#save_new_tests ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#scale_ratio ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#screenshot_url ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#server_remainder ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#server_scale ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#verbose_results ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
-
#viewport_size ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,.
Instance Method Summary collapse
- #abort_if_not_closed ⇒ Object (also: #abort)
- #check_single_base(region_provider, retry_timeout, match_window_data) ⇒ Object
- #check_window_base(region_provider, retry_timeout, match_window_data) ⇒ Object
-
#close(throw_exception = true, be_silent = false) ⇒ Object
Closes eyes otherwise the test will pass.
- #configuration ⇒ Object (also: #get_configuration)
- #configuration=(value) ⇒ Object (also: #set_configuration)
- #disabled=(value) ⇒ Object
- #disabled? ⇒ Boolean
- #ensure_config ⇒ Object
- #ensure_running_session ⇒ Object
-
#initialize(*args) ⇒ EyesBase
constructor
A new instance of EyesBase.
- #merge_config(other_config) ⇒ Object
- #new_session? ⇒ Boolean
- #open? ⇒ Boolean
- #open_base(options = {}) ⇒ Object
- #running_session? ⇒ Boolean
- #server_connector ⇒ Object
- #update_config_from_options(options) ⇒ Object
Methods included from Helpers
abstract_attr_accessor, abstract_method, env_variable, environment_attribute, environment_variables
Methods included from MatchLevelSetter
Constructor Details
#initialize(*args) ⇒ EyesBase
Returns a new instance of EyesBase.
64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 |
# File 'lib/applitools/core/eyes_base.rb', line 64 def initialize(*args) = Applitools::Utils.(args) self.runner = [:runner] server_url = args.first @server_connector = Applitools::Connectivity::ServerConnector.new(server_url) @server_connector.obtain_agent_id do full_agent_id end ensure_config self.server_url = server_url if server_url self.disabled = false @viewport_size = nil self.match_timeout = DEFAULT_MATCH_TIMEOUT self.running_session = nil self.save_new_tests = true self.save_failed_tests = false self.remove_session_if_matching = false # self.agent_id = nil self.last_screenshot = nil @user_inputs = UserInputArray.new self.app_output_provider = Object.new self.verbose_results = false self.failed = false self.results = [] self.allow_empty_screenshot = true @inferred_environment = nil @server_scale = 0 @server_remainder = 0 get_app_output_method = ->(r, s) { get_app_output_with_screenshot r, s } app_output_provider.instance_eval do define_singleton_method :app_output do |r, s| get_app_output_method.call(r, s) end end # self.exact = nil self.match_level = Applitools::MatchLevel::STRICT self.server_scale = 0 self.server_remainder = 0 self.compare_with_parent_branch = false end |
Instance Attribute Details
#allow_empty_screenshot ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def allow_empty_screenshot @allow_empty_screenshot end |
#batch ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def batch @batch end |
#compare_with_parent_branch ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def compare_with_parent_branch @compare_with_parent_branch end |
#config=(value) ⇒ Object
Sets the attribute config
32 33 34 |
# File 'lib/applitools/core/eyes_base.rb', line 32 def config=(value) @config = value end |
#cut_provider ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def cut_provider @cut_provider end |
#default_match_settings ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def default_match_settings @default_match_settings end |
#exact ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def exact @exact end |
#failure_reports ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def failure_reports @failure_reports end |
#inferred_environment ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def inferred_environment @inferred_environment end |
#match_timeout ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def match_timeout @match_timeout end |
#position_provider ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def position_provider @position_provider end |
#remove_session_if_matching ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def remove_session_if_matching @remove_session_if_matching end |
#results ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def results @results end |
#runner ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def runner @runner end |
#save_failed_tests ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def save_failed_tests @save_failed_tests end |
#save_new_tests ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def save_new_tests @save_new_tests end |
#scale_ratio ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def scale_ratio @scale_ratio end |
#screenshot_url ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def screenshot_url @screenshot_url end |
#server_remainder ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def server_remainder @server_remainder end |
#server_scale ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def server_scale @server_scale end |
#verbose_results ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
|
# File 'lib/applitools/core/eyes_base.rb', line 39
|
#viewport_size ⇒ Object
attr_accessor :agent_id, :session_type, :app_name, :test_name,
46 47 48 |
# File 'lib/applitools/core/eyes_base.rb', line 46 def @viewport_size end |
Instance Method Details
#abort_if_not_closed ⇒ Object Also known as: abort
153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 |
# File 'lib/applitools/core/eyes_base.rb', line 153 def abort_if_not_closed if disabled? logger.info "#{__method__} Ignored" return false end self.open = false self.last_screenshot = nil clear_user_inputs if running_session.nil? logger.info 'Closed' return false end logger.info 'Aborting server session...' server_connector.stop_session(running_session, true, false) logger.info '---Test aborted' rescue Applitools::EyesError => e logger.error e. ensure self.running_session = nil end |
#check_single_base(region_provider, retry_timeout, match_window_data) ⇒ Object
299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 |
# File 'lib/applitools/core/eyes_base.rb', line 299 def check_single_base(region_provider, retry_timeout, match_window_data) if disabled? logger.info "#{__method__} Ignored" result = Applitools::MatchResults.new result.as_expected = true return result end raise Applitools::EyesError.new 'Eyes not open' unless open? Applitools::ArgumentGuard.not_nil region_provider, 'region_provider' logger.info( "check_single_base(#{region_provider}, #{match_window_data.tag}, #{match_window_data.ignore_mismatch}," \ " #{retry_timeout})" ) tag = '' if tag.nil? self.session_start_info = SessionStartInfo.new agent_id: base_agent_id, app_id_or_name: app_name, scenario_id_or_name: test_name, batch_info: batch, baseline_env_name: baseline_env_name, environment: app_env, default_match_settings: default_match_settings, environment_name: environment_name, session_type: session_type, branch_name: branch_name, parent_branch_name: parent_branch_name, baseline_branch_name: baseline_branch_name, save_diffs: save_diffs, properties: properties match_window_data.start_info = session_start_info match_window_data.update_baseline_if_new = save_new_tests match_window_data.update_baseline_if_different = save_failed_tests match_window_data.remove_session_if_matching = remove_session_if_matching match_window_data.scale = server_scale match_window_data.remainder = server_remainder match_window_task = Applitools::MatchSingleTask.new( logger, match_timeout, app_output_provider, server_connector ) logger.info 'Calling match_window...' result = match_window_task.match_window( match_window_data, last_screenshot: last_screenshot, region_provider: region_provider, should_match_window_run_once_on_timeout: should_match_window_run_once_on_timeout, retry_timeout: retry_timeout ) do |match_results| results = match_results.original_results not_aborted = !results['isAborted'] new_and_saved = results['isNew'] && save_new_tests different_and_saved = results['isDifferent'] && save_failed_tests not_a_mismatch = !results['isDifferent'] && !results['isNew'] not_aborted && (new_and_saved || different_and_saved || not_a_mismatch) end logger.info 'match_window done!' if result.as_expected? clear_user_inputs self.last_screenshot = result.screenshot else unless match_window_data.ignore_mismatch clear_user_inputs self.last_screenshot = result.screenshot end self.should_match_window_run_once_on_timeout = true logger.info "Mistmatch! #{tag}" if failure_reports == :immediate raise Applitools::TestFailedException.new "Mistmatch found in #{session_start_info.scenario_id_or_name}" \ " of #{session_start_info.app_id_or_name}" end end logger.info 'Done!' result.original_results end |
#check_window_base(region_provider, retry_timeout, match_window_data) ⇒ Object
244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 |
# File 'lib/applitools/core/eyes_base.rb', line 244 def check_window_base(region_provider, retry_timeout, match_window_data) if disabled? logger.info "#{__method__} Ignored" result = Applitools::MatchResults.new result.as_expected = true return result end raise Applitools::EyesError.new 'Eyes not open' unless open? Applitools::ArgumentGuard.not_nil region_provider, 'region_provider' logger.info( "check_window_base(#{region_provider}, #{match_window_data.tag}, #{match_window_data.ignore_mismatch}," \ " #{retry_timeout})" ) tag = '' if tag.nil? ensure_running_session match_window_data.user_inputs = user_inputs logger.info 'Calling match_window...' result = @match_window_task.match_window( match_window_data, last_screenshot: last_screenshot, region_provider: region_provider, should_match_window_run_once_on_timeout: should_match_window_run_once_on_timeout, retry_timeout: retry_timeout ) logger.info 'match_window done!' if result.as_expected? clear_user_inputs self.last_screenshot = result.screenshot else unless match_window_data.ignore_mismatch clear_user_inputs self.last_screenshot = result.screenshot end self.should_match_window_run_once_on_timeout = true self.failed = true logger.info "Mistmatch! #{tag}" unless running_session.new_session? if failure_reports == :immediate raise Applitools::TestFailedException.new "Mistmatch found in #{session_start_info.scenario_id_or_name}" \ " of #{session_start_info.app_id_or_name}" end end logger.info 'Done!' result end |
#close(throw_exception = true, be_silent = false) ⇒ Object
Closes eyes otherwise the test will pass. Default is true
385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 |
# File 'lib/applitools/core/eyes_base.rb', line 385 def close(throw_exception = true, be_silent = false) if disabled? logger.info "#{__method__} Ignored" return false end logger.info "close(#{throw_exception})" raise Applitools::EyesError.new 'Eyes not open' unless open? self.open = false self.last_screenshot = nil clear_user_inputs unless running_session be_silent || logger.info('Server session was not started') be_silent || logger.info('--- Empty test ended') return Applitools::TestResults.new end is_new_session = running_session.new_session? session_results_url = running_session.url logger.info 'Ending server session...' save = is_new_session && save_new_tests || !is_new_session && failed && save_failed_tests logger.info "Automatically save test? #{save}" results = server_connector.stop_session running_session, false, save runner.aggregate_result(results) if runner results.is_new = is_new_session results.url = session_results_url logger.info results.to_s(verbose_results) if results.unresolved? if results.new? logger.error "--- New test ended. see details at #{session_results_url}" = "New test '#{session_start_info.scenario_id_or_name}' " \ "of '#{session_start_info.app_id_or_name}' " \ "Please approve the baseline at #{session_results_url} " raise Applitools::NewTestError.new , results if throw_exception else logger.error "--- Differences are found. see details at #{session_results_url}" = "Test '#{session_start_info.scenario_id_or_name}' " \ "of '#{session_start_info.app_id_or_name}' " \ "detected differences! See details at #{session_results_url}" raise Applitools::DiffsFoundError.new , results if throw_exception end return results end if results.failed? logger.error "--- Failed test ended. see details at #{session_results_url}" = "Test '#{session_start_info.scenario_id_or_name}' of '#{session_start_info.app_id_or_name}' " \ "is failed! See details at #{session_results_url}" raise Applitools::TestFailedError.new , results if throw_exception return results end logger.info '--- Test passed' self.results.push results return results ensure self.running_session = nil self.app_name = '' end |
#configuration ⇒ Object Also known as: get_configuration
459 460 461 |
# File 'lib/applitools/core/eyes_base.rb', line 459 def configuration config.deep_dup end |
#configuration=(value) ⇒ Object Also known as: set_configuration
465 466 467 468 |
# File 'lib/applitools/core/eyes_base.rb', line 465 def configuration=(value) Applitools::ArgumentGuard.is_a?(value, :configuration, Applitools::EyesBaseConfiguration) self.config = value.deep_dup end |
#disabled=(value) ⇒ Object
133 134 135 |
# File 'lib/applitools/core/eyes_base.rb', line 133 def disabled=(value) @disabled = Applitools::Utils.boolean_value value end |
#disabled? ⇒ Boolean
137 138 139 |
# File 'lib/applitools/core/eyes_base.rb', line 137 def disabled? @disabled end |
#ensure_config ⇒ Object
107 108 109 |
# File 'lib/applitools/core/eyes_base.rb', line 107 def ensure_config self.config = Applitools::EyesBaseConfiguration.new end |
#ensure_running_session ⇒ Object
229 230 231 232 233 234 235 236 237 238 239 240 241 242 |
# File 'lib/applitools/core/eyes_base.rb', line 229 def ensure_running_session return if running_session logger.info 'No running session, calling start session..' start_session logger.info 'Done!' @match_window_task = Applitools::MatchWindowTask.new( logger, running_session, match_timeout, app_output_provider, server_connector ) end |
#merge_config(other_config) ⇒ Object
225 226 227 |
# File 'lib/applitools/core/eyes_base.rb', line 225 def merge_config(other_config) config.merge(other_config) end |
#new_session? ⇒ Boolean
149 150 151 |
# File 'lib/applitools/core/eyes_base.rb', line 149 def new_session? running_session && running_session.new_session? end |
#open? ⇒ Boolean
141 142 143 |
# File 'lib/applitools/core/eyes_base.rb', line 141 def open? @open end |
#open_base(options = {}) ⇒ Object
181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 |
# File 'lib/applitools/core/eyes_base.rb', line 181 def open_base( = {}) self.results = [] if disabled? logger.info "#{__method__} Ignored" return false end if open? abort_if_not_closed raise Applitools::EyesError.new 'A test is already running' end () raise Applitools::EyesIllegalArgument, config.validation_errors.values.join('/n') unless config.valid? logger.info "Agent = #{full_agent_id}" logger.info "openBase(app_name: #{app_name}, test_name: #{test_name}," \ " viewport_size: #{})" raise Applitools::EyesError.new 'API key is missing! Please set it using api_key=' if api_key.nil? || (api_key && api_key.empty?) yield if block_given? self.open = true rescue Applitools::EyesError => e logger.error e. raise e end |
#running_session? ⇒ Boolean
145 146 147 |
# File 'lib/applitools/core/eyes_base.rb', line 145 def running_session? running_session.nil? ? false : true end |
#server_connector ⇒ Object
118 119 120 121 122 123 |
# File 'lib/applitools/core/eyes_base.rb', line 118 def server_connector @server_connector.server_url = config.server_url @server_connector.api_key = config.api_key @server_connector.proxy = config.proxy if config.proxy @server_connector end |
#update_config_from_options(options) ⇒ Object
212 213 214 215 216 217 218 219 220 221 222 223 |
# File 'lib/applitools/core/eyes_base.rb', line 212 def () # Applitools::ArgumentGuard.hash options, 'open_base parameter', [:test_name] = { session_type: 'SEQUENTIAL' } = .merge self.app_name = [:app_name] if [:app_name] # Applitools::ArgumentGuard.not_nil options[:test_name], 'options[:test_name]' self.test_name = [:test_name] if [:test_name] self. = [:viewport_size] if [:viewport_size] self.session_type = [:session_type] if [:session_type] end |