appium_failure_helper 0.6.1 → 0.6.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0e272f2150ce88e42b3b414d0afeb9d4e2309311bd271d77bf912ac3967ad03
-  data.tar.gz: 982e97ea6c9a43da40ea9315f554bc734b076b20aaf68b61f1cef83bf3455349
+  metadata.gz: 8dfc8ecc63d0e6f70e9ae388b3f5be698586248af80feec88a531e6333273d82
+  data.tar.gz: c2a98c1a05885d7ea36b13a3e3366c7b848e76a055dd95f831f6272d6832a880
 SHA512:
-  metadata.gz: 8d431703babb06ffde65176ec6b16233738790261efbee46376f2b6bb90f1fd42717505d4ab6c78b454bf61bc3e656c2f8e9e1ef3936ea8841b585ec152e51f3
-  data.tar.gz: d7df2cb2f3757ae8298ce7b8057e11ea66b0112ba38fb15e01e6e8bcb73b3dad26035bcfdeba8dc97e823bf608de787b2b47c3dceb28d0b988525812b4730ebd
+  metadata.gz: bb9efe4166951dff46f7f8fbed2753ab825eded0216172f9cb62c385cf74bc63c44aa1f1ea3288a7dccd511d29a712733ec96aebeb01095c687227cfd6e5726d
+  data.tar.gz: eb2f4561139100b968b778545cf12ce537e4a3e28468e731214f6f24a748dd86158afc0c8b8d81221eb0a5c03459dc3aa988747430bd8cac24ac9fa723755742

data/lib/appium_failure_helper/analyzer.rb

@@ -0,0 +1,61 @@
+module AppiumFailureHelper
+  module Analyzer
+    def self.extract_failure_details(exception)
+      message = exception.message
+      info = {}
+      patterns = [
+        /element with locator ['"]?(#?\w+)['"]?/i,
+        /(?:could not be found|cannot find element) using (.+?)=['"]?([^'"]+)['"]?/i,
+        /no such element: Unable to locate element: {"method":"([^"]+)","selector":"([^"]+)"}/i,
+        /(?:with the resource-id|with the accessibility-id) ['"]?(.+?)['"]?/i
+      ]
+      patterns.each do |pattern|
+          match = message.match(pattern)
+          if match
+              info[:selector_value] = match.captures.last.strip.gsub(/['"]/, '')
+              info[:selector_type] = match.captures.size > 1 ? match.captures[0].strip.gsub(/['"]/, '') : 'id'
+              return info
+          end
+      end
+      info
+    end
+
+    def self.find_de_para_match(failed_info, element_map)
+      logical_name_key = failed_info[:selector_value].to_s.gsub(/^#/, '')
+      if element_map.key?(logical_name_key)
+        return {
+          logical_name: logical_name_key,
+          correct_locator: element_map[logical_name_key]
+        }
+      end
+      nil
+    end
+
+    def self.find_similar_elements(failed_info, all_page_suggestions)
+      failed_locator_value = failed_info[:selector_value]
+      failed_locator_type = failed_info[:selector_type]
+      return [] unless failed_locator_value && failed_locator_type
+
+      normalized_failed_type = failed_locator_type.downcase.include?('id') ? 'id' : failed_locator_type
+
+      cleaned_failed_locator = failed_locator_value.to_s.gsub(/[:\-\/@=\[\]'"()]/, ' ').gsub(/\s+/, ' ').downcase.strip
+      similarities = []
+
+      all_page_suggestions.each do |suggestion|
+        candidate_locator = suggestion[:locators].find { |loc| loc[:strategy] == normalized_failed_type }
+        next unless candidate_locator
+        
+        cleaned_candidate_locator = candidate_locator[:locator].gsub(/[:\-\/@=\[\]'"()]/, ' ').gsub(/\s+/, ' ').downcase.strip
+        distance = DidYouMean::Levenshtein.distance(cleaned_failed_locator, cleaned_candidate_locator)
+        max_len = [cleaned_failed_locator.length, cleaned_candidate_locator.length].max
+        next if max_len.zero?
+        
+        similarity_score = 1.0 - (distance.to_f / max_len)
+        if similarity_score > 0.8
+          similarities << { name: suggestion[:name], locators: suggestion[:locators], score: similarity_score }
+        end
+      end
+      similarities.sort_by { |s| -s[:score] }.first(5)
+    end
+  end
+end

data/lib/appium_failure_helper/element_repository.rb

@@ -0,0 +1,49 @@
+module AppiumFailureHelper
+  module ElementRepository
+    def self.load_all_from_yaml
+      elements_map = {}
+      # Procura em todo o diretório de trabalho atual por arquivos .yaml
+      glob_path = File.join(Dir.pwd, '**', '*.yaml')
+      
+      Dir.glob(glob_path).each do |file|
+        # Evita ler os próprios relatórios gerados
+        next if file.include?('reports_failure')
+        
+        begin
+          data = YAML.load_file(file)
+          if data.is_a?(Hash)
+            data.each do |key, value|
+              if value.is_a?(Hash) && value['tipoBusca'] && value['value']
+                elements_map[key] = value
+              end
+            end
+          end
+        rescue => e
+          Utils.logger.warn("Aviso: Erro ao carregar o arquivo YAML #{file}: #{e.message}")
+        end
+      end
+      elements_map
+    end
+
+    # NOVO: Método para verificar a existência de um elemento em um arquivo .rb
+    def self.find_in_ruby_file(element_name, path = 'elements/elements.rb')
+      return { found: false, path: path, reason: "Arquivo não encontrado" } unless File.exist?(path)
+
+      begin
+        content = File.read(path)
+        # Regex flexível para encontrar definições como:
+        # def nome_do_elemento
+        # element :nome_do_elemento
+        # element('nome_do_elemento')
+        if content.match?(/def #{element_name}|element[ |\(]['|:]#{element_name}/)
+          return { found: true, path: path }
+        else
+          return { found: false, path: path, reason: "Definição não encontrada" }
+        end
+      rescue => e
+        Utils.logger.warn("Aviso: Erro ao ler o arquivo Ruby #{path}: #{e.message}")
+        return { found: false, path: path, reason: "Erro de leitura" }
+      end
+    end
+  end
+end

data/lib/appium_failure_helper/handler.rb

@@ -0,0 +1,55 @@
+module AppiumFailureHelper
+  class Handler
+    def self.call(driver, exception)
+      new(driver, exception).call
+    end
+
+    def initialize(driver, exception)
+      @driver = driver
+      @exception = exception
+      @timestamp = Time.now.strftime('%Y%m%d_%H%M%S')
+      @output_folder = "reports_failure/failure_#{@timestamp}"
+    end
+
+    def call
+      FileUtils.mkdir_p(@output_folder)
+      page_source = @driver.page_source
+      platform = @driver.capabilities['platformName']&.downcase || 'unknown'
+
+      failed_info = Analyzer.extract_failure_details(@exception)
+      
+      # ALTERADO: Agora busca em todas as fontes de dados
+      logical_name_key = failed_info[:selector_value].to_s.gsub(/^#/, '')
+      
+      # 1. Busca nos arquivos YAML dinâmicos
+      element_map_yaml = ElementRepository.load_all_from_yaml
+      de_para_yaml_result = Analyzer.find_de_para_match(failed_info, element_map_yaml)
+
+      # 2. Busca no arquivo Ruby
+      de_para_rb_result = ElementRepository.find_in_ruby_file(logical_name_key)
+
+      # 3. Analisa a tela atual
+      page_analyzer = PageAnalyzer.new(page_source, platform)
+      all_page_elements = page_analyzer.analyze
+      similar_elements = Analyzer.find_similar_elements(failed_info, all_page_elements)
+
+      # Organiza TODOS os resultados para o relatório
+      report_data = {
+        failed_element: failed_info,
+        similar_elements: similar_elements,
+        de_para_yaml_analysis: de_para_yaml_result, # Resultado da análise YAML
+        de_para_rb_analysis: de_para_rb_result,   # Resultado da análise Ruby
+        all_page_elements: all_page_elements,
+        screenshot_base64: @driver.screenshot_as(:base64),
+        platform: platform,
+        timestamp: @timestamp
+      }
+
+      ReportGenerator.new(@output_folder, page_source, report_data).generate_all
+      
+      Utils.logger.info("Relatórios gerados com sucesso em: #{@output_folder}")
+    rescue => e
+      Utils.logger.error("Erro ao capturar detalhes da falha: #{e.message}\n#{e.backtrace.join("\n")}")
+    end
+  end
+end

data/lib/appium_failure_helper/page_analyzer.rb

@@ -0,0 +1,109 @@
+# lib/appium_failure_helper/page_analyzer.rb
+module AppiumFailureHelper
+  class PageAnalyzer
+    PREFIX = {
+      'android.widget.Button' => 'btn', 'android.widget.TextView' => 'txt',
+      'android.widget.ImageView' => 'img', 'android.widget.EditText' => 'input',
+      'android.widget.CheckBox' => 'chk', 'android.widget.RadioButton' => 'radio',
+      'android.widget.Switch' => 'switch', 'android.widget.ViewGroup' => 'group',
+      'android.widget.View' => 'view', 'android.widget.FrameLayout' => 'frame',
+      'android.widget.LinearLayout' => 'linear', 'android.widget.RelativeLayout' => 'relative',
+      'android.widget.ScrollView' => 'scroll', 'android.webkit.WebView' => 'web',
+      'android.widget.Spinner' => 'spin', 'XCUIElementTypeButton' => 'btn',
+      'XCUIElementTypeStaticText' => 'txt', 'XCUIElementTypeTextField' => 'input',
+      'XCUIElementTypeImage' => 'img', 'XCUIElementTypeSwitch' => 'switch',
+      'XCUIElementTypeScrollView' => 'scroll', 'XCUIElementTypeOther' => 'elm',
+      'XCUIElementTypeCell' => 'cell'
+    }.freeze
+
+    def initialize(page_source, platform)
+      @doc = Nokogiri::XML(page_source)
+      @platform = platform
+    end
+
+    def analyze
+      seen_elements = {}
+      all_elements_suggestions = []
+      @doc.xpath('//*').each do |node|
+          next if ['hierarchy', 'AppiumAUT'].include?(node.name)
+          attrs = node.attributes.transform_values(&:value)
+          unique_key = "#{node.name}|#{attrs['resource-id']}|#{attrs['content-desc']}|#{attrs['text']}"
+          unless seen_elements[unique_key]
+              name = suggest_name(node.name, attrs)
+              locators = xpath_generator(node.name, attrs)
+              all_elements_suggestions << { name: name, locators: locators }
+              seen_elements[unique_key] = true
+          end
+      end
+      all_elements_suggestions
+    end
+
+    private
+
+    def suggest_name(tag, attrs)
+      type = tag.split('.').last
+      pfx = PREFIX[tag] || PREFIX[type] || 'elm'
+      name_base = nil
+      
+      priority_attrs = if tag.start_with?('XCUIElementType')
+                         ['name', 'label', 'value']
+                       else
+                         ['content-desc', 'text', 'resource-id']
+                       end
+
+      priority_attrs.each do |attr_key|
+        value = attrs[attr_key]
+        if value.is_a?(String) && !value.empty?
+          name_base = value
+          break
+        end
+      end
+      
+      name_base ||= type.gsub('XCUIElementType', '')
+      
+      truncated_name = Utils.truncate(name_base)
+      sanitized_name = truncated_name.gsub(/[^a-zA-Z0-9\s]/, ' ').split.map(&:capitalize).join
+      
+      "#{pfx}#{sanitized_name}"
+    end
+
+    def xpath_generator(tag, attrs)
+      case @platform
+      when 'android' then generate_android_xpaths(tag, attrs)
+      when 'ios' then generate_ios_xpaths(tag, attrs)
+      else generate_unknown_xpaths(tag, attrs)
+      end
+    end
+
+    def generate_android_xpaths(tag, attrs)
+      locators = []
+      if attrs['resource-id'] && !attrs['resource-id'].empty?
+        locators << { strategy: 'id', locator: attrs['resource-id'] }
+      end
+      if attrs['text'] && !attrs['text'].empty?
+        locators << { strategy: 'xpath', locator: "//#{tag}[@text=\"#{Utils.truncate(attrs['text'])}\"]" }
+      end
+      if attrs['content-desc'] && !attrs['content-desc'].empty?
+        locators << { strategy: 'xpath_desc', locator: "//#{tag}[@content-desc=\"#{Utils.truncate(attrs['content-desc'])}\"]" }
+      end
+      locators
+    end
+
+    def generate_ios_xpaths(tag, attrs)
+      locators = []
+      if attrs['name'] && !attrs['name'].empty?
+        locators << { strategy: 'name', locator: attrs['name'] }
+      end
+      if attrs['label'] && !attrs['label'].empty?
+        locators << { strategy: 'xpath', locator: "//#{tag}[@label=\"#{Utils.truncate(attrs['label'])}\"]" }
+      end
+      locators
+    end
+    
+    def generate_unknown_xpaths(tag, attrs)
+      locators = []
+      attrs.each { |key, value| locators << { strategy: key.to_s, locator: "//#{tag}[@#{key}=\"#{Utils.truncate(value)}\"]" } if value.is_a?(String) && !value.empty? }
+      locators
+    end
+  end
+end

data/lib/appium_failure_helper/report_generator.rb

@@ -0,0 +1,160 @@
+module AppiumFailureHelper
+  class ReportGenerator
+    def initialize(output_folder, page_source, report_data)
+      @output_folder = output_folder
+      @page_source = page_source
+      @data = report_data
+    end
+
+    def generate_all
+      generate_xml_report
+      generate_yaml_reports
+      generate_html_report
+    end
+
+    private
+
+    def generate_xml_report
+      File.write("#{@output_folder}/page_source_#{@data[:timestamp]}.xml", @page_source)
+    end
+
+    def generate_yaml_reports
+      analysis_report = {
+        failed_element: @data[:failed_element],
+        similar_elements: @data[:similar_elements],
+        de_para_yaml_analysis: @data[:de_para_yaml_analysis],
+        de_para_rb_analysis: @data[:de_para_rb_analysis]
+      }
+      File.open("#{@output_folder}/failure_analysis_#{@data[:timestamp]}.yaml", 'w') { |f| f.write(YAML.dump(analysis_report)) }
+      File.open("#{@output_folder}/all_elements_dump_#{@data[:timestamp]}.yaml", 'w') { |f| f.write(YAML.dump(@data[:all_page_elements])) }
+    end
+
+    def generate_html_report
+      # ... (Lambdas locators_html e all_elements_html permanecem iguais) ...
+      locators_html = ->(locators) { locators.map { |loc| "..." }.join }
+      all_elements_html = ->(elements) { elements.map { |el| "..." }.join }
+
+      # Prepara o conteúdo dinâmico
+      failed_info = @data[:failed_element]
+      similar_elements = @data[:similar_elements]
+      de_para_yaml = @data[:de_para_yaml_analysis]
+      de_para_rb = @data[:de_para_rb_analysis]
+      all_suggestions = @data[:all_page_elements]
+      
+      # NOVO: Gera dois blocos de HTML, um para cada análise
+      
+      # Bloco de análise YAML
+      de_para_yaml_html = ""
+      if de_para_yaml
+        de_para_yaml_html = <<~HTML
+          <div class="bg-green-50 border border-green-200 p-4 rounded-lg shadow-md mb-6">
+            <h3 class="text-lg font-bold text-green-800 mb-2">Análise de Mapeamento YAML (.yaml)</h3>
+            <p class="text-sm text-gray-700 mb-1">O nome lógico <strong class="font-mono bg-gray-200 px-1 rounded">#{CGI.escapeHTML(de_para_yaml[:logical_name])}</strong> foi encontrado nos arquivos .yaml do projeto!</p>
+            <p class="text-sm text-gray-700">O localizador correto definido é:</p>
+            <div class="font-mono text-xs bg-green-100 p-2 mt-2 rounded">
+              <span class="font-bold">#{CGI.escapeHTML(de_para_yaml[:correct_locator]['tipoBusca'].upcase)}:</span>
+              <span class="break-all">#{CGI.escapeHTML(de_para_yaml[:correct_locator]['valor'])}</span>
+            </div>
+          </div>
+        HTML
+      end
+      
+      # Bloco de análise Ruby
+      de_para_rb_html = ""
+      if de_para_rb
+        if de_para_rb[:found]
+          de_para_rb_html = <<~HTML
+            <div class="bg-green-50 border border-green-200 p-4 rounded-lg shadow-md mb-6">
+              <h3 class="text-lg font-bold text-green-800 mb-2">Análise de Mapeamento Ruby (.rb)</h3>
+              <p class="text-sm text-gray-700">A definição do elemento foi encontrada com sucesso no arquivo <strong class="font-mono bg-gray-200 px-1 rounded">#{de_para_rb[:path]}</strong>.</p>
+            </div>
+          HTML
+        else
+          de_para_rb_html = <<~HTML
+            <div class="bg-yellow-50 border border-yellow-200 p-4 rounded-lg shadow-md mb-6">
+              <h3 class="text-lg font-bold text-yellow-800 mb-2">Análise de Mapeamento Ruby (.rb)</h3>
+              <p class="text-sm text-gray-700">O elemento <strong class="font-mono bg-gray-200 px-1 rounded">#{CGI.escapeHTML(failed_info[:selector_value].to_s)}</strong> NÃO foi encontrado no arquivo <strong class="font-mono bg-gray-200 px-1 rounded">#{de_para_rb[:path]}</strong>.</p>
+              <p class="text-xs text-gray-500 mt-1">Motivo: #{de_para_rb[:reason]}</p>
+            </div>
+          HTML
+        end
+      end
+
+      similar_elements_content = similar_elements.empty? ? "<p class='text-gray-500'>Nenhuma alternativa semelhante foi encontrada na tela atual.</p>" : similar_elements.map { |el|
+        score_percent = (el[:score] * 100).round(1)
+        "<div class='border border-indigo-100 p-3 rounded-lg bg-indigo-50'><p class='font-bold text-indigo-800 mb-2'>#{CGI.escapeHTML(el[:name])} <span class='text-xs font-normal text-green-600 bg-green-100 rounded-full px-2 py-1'>Similaridade: #{score_percent}%</span></p><ul>#{locators_html.call(el[:locators])}</ul></div>"
+      }.join
+
+      failed_info_content = if failed_info && failed_info[:selector_value]
+        "<p class='text-sm text-gray-700 font-medium mb-2'>Tipo de Seletor: <span class='font-mono text-xs bg-red-100 p-1 rounded'>#{CGI.escapeHTML(failed_info[:selector_type].to_s)}</span></p><p class='text-sm text-gray-700 font-medium'>Valor Buscado: <span class='font-mono text-xs bg-red-100 p-1 rounded break-all'>#{CGI.escapeHTML(failed_info[:selector_value].to_s)}</span></p>"
+      else
+        "<p class='text-sm text-gray-500'>O localizador exato não pôde ser extraído da mensagem de erro.</p>"
+      end
+
+      html_content = <<~HTML_REPORT
+        <!DOCTYPE html>
+        <html lang="pt-BR">
+        <head>
+          <meta charset="UTF-8">
+          <meta name="viewport" content="width=device-width, initial-scale=1.0">
+          <title>Relatório de Falha Appium - #{@data[:timestamp]}</title>
+          <script src="https://cdn.tailwindcss.com"></script>
+          <style> body { font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto; } .tab-content { display: none; } .tab-content.active { display: block; } .tab-button.active { background-color: #4f46e5; color: white; } </style>
+        </head>
+        <body class="bg-gray-50 p-8">
+          <div class="max-w-7xl mx-auto">
+            <header class="mb-8 pb-4 border-b border-gray-300">
+              <h1 class="text-3xl font-bold text-gray-800">Diagnóstico de Falha Automatizada</h1>
+              <p class="text-sm text-gray-500">Relatório gerado em: #{@data[:timestamp]} | Plataforma: #{@data[:platform].upcase}</p>
+            </header>
+            <div class="grid grid-cols-1 lg:grid-cols-3 gap-8">
+              <div class="lg:col-span-1">
+                #{de_para_html}
+                <div class="bg-white p-4 rounded-lg shadow-xl mb-6 border border-red-200">
+                  <h2 class="text-xl font-bold text-red-600 mb-4">Elemento com Falha</h2>
+                  #{failed_info_content}
+                </div>
+                <div class="bg-white p-4 rounded-lg shadow-xl">
+                  <h2 class="text-xl font-bold text-gray-800 mb-4">Screenshot da Falha</h2>
+                  <img src="data:image/png;base64,#{@data[:screenshot_base64]}" alt="Screenshot da Falha" class="w-full rounded-md shadow-lg border border-gray-200">
+                </div>
+              </div>
+              <div class="lg:col-span-2">
+                <div class="bg-white rounded-lg shadow-xl">
+                  <div class="flex border-b border-gray-200">
+                    <button class="tab-button active px-4 py-3 text-sm font-medium rounded-tl-lg" data-tab="similar">Sugestões de Reparo (#{similar_elements.size})</button>
+                    <button class="tab-button px-4 py-3 text-sm font-medium text-gray-600" data-tab="all">Dump Completo da Página (#{all_suggestions.size} Elementos)</button>
+                  </div>
+                  <div class="p-6">
+                    <div id="similar" class="tab-content active">
+                      <h3 class="text-lg font-semibold text-indigo-700 mb-4">Elementos Semelhantes (Alternativas para o Localizador Falho)</h3>
+                      <div class="space-y-4">#{similar_elements_content}</div>
+                    </div>
+                    <div id="all" class="tab-content">
+                      <h3 class="text-lg font-semibold text-indigo-700 mb-4">Dump de Todos os Elementos da Tela</h3>
+                      <div class="max-h-[600px] overflow-y-auto space-y-2">#{all_elements_html.call(all_suggestions)}</div>
+                    </div>
+                  </div>
+                </div>
+              </div>
+            </div>
+          </div>
+          <script>
+            document.querySelectorAll('.tab-button').forEach(tab => {
+              tab.addEventListener('click', () => {
+                const target = tab.getAttribute('data-tab');
+                document.querySelectorAll('.tab-button').forEach(t => t.classList.remove('active'));
+                document.querySelectorAll('.tab-content').forEach(c => c.classList.remove('active'));
+                tab.classList.add('active');
+                document.getElementById(target).classList.add('active');
+              });
+            });
+          </script>
+        </body>
+        </html>
+      HTML_REPORT
+
+      File.write("#{@output_folder}/report_#{@data[:timestamp]}.html", html_content)
+    end
+  end
+end

data/lib/appium_failure_helper/utils.rb

@@ -0,0 +1,17 @@
+module AppiumFailureHelper
+  module Utils
+    def self.logger
+      @logger ||= begin
+        logger = Logger.new(STDOUT)
+        logger.level = Logger::INFO
+        logger.formatter = proc { |severity, datetime, progname, msg| "#{datetime.strftime('%Y-%m-%d %H:%M:%S')} [#{severity}] #{msg}\n" }
+        logger
+      end
+    end
+    
+    def self.truncate(value, max_length = 100)
+      return value unless value.is_a?(String)
+      value.size > max_length ? "#{value[0...max_length]}..." : value
+    end
+  end
+end

data/lib/appium_failure_helper/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AppiumFailureHelper
-  VERSION = "0.6.1"
+  VERSION = "0.6.3"
 end

data/lib/appium_failure_helper.rb

@@ -1,8 +1,23 @@
 # frozen_string_literal: true
 
-require_relative "appium_failure_helper/version"
-require_relative "appium_failure_helper/capture"
+require 'nokogiri'
+require 'fileutils'
+require 'base64'
+require 'yaml'
+require 'logger'
+require 'did_you_mean'
+require 'cgi'
+
+# Carrega todos os nossos novos módulos
+require_relative 'appium_failure_helper/utils'
+require_relative 'appium_failure_helper/analyzer'
+require_relative 'appium_failure_helper/element_repository'
+require_relative 'appium_failure_helper/page_analyzer'
+require_relative 'appium_failure_helper/report_generator'
+require_relative 'appium_failure_helper/handler'
 module AppiumFailureHelper
   class Error < StandardError; end
-  # Your code goes here...
+  def self.handler_failure(driver, exception)
+    Handler.call(driver, exception)
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: appium_failure_helper
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.6.3
 platform: ruby
 authors:
 - David Nascimento
@@ -94,7 +94,12 @@ files:
 - README.md
 - Rakefile
 - lib/appium_failure_helper.rb
-- lib/appium_failure_helper/capture.rb
+- lib/appium_failure_helper/analyzer.rb
+- lib/appium_failure_helper/element_repository.rb
+- lib/appium_failure_helper/handler.rb
+- lib/appium_failure_helper/page_analyzer.rb
+- lib/appium_failure_helper/report_generator.rb
+- lib/appium_failure_helper/utils.rb
 - lib/appium_failure_helper/version.rb
 - sig/appium_failure_helper.rbs
 homepage: https://github.com/David-Nascimento/Appium_failure_helper

data/lib/appium_failure_helper/capture.rb

@@ -1,466 +0,0 @@
-require 'nokogiri'
-require 'fileutils'
-require 'base64'
-require 'yaml'
-require 'logger'
-
-module AppiumFailureHelper
-  class Capture
-    PREFIX = {
-      'android.widget.Button' => 'btn',
-      'android.widget.TextView' => 'txt',
-      'android.widget.ImageView' => 'img',
-      'android.widget.EditText' => 'input',
-      'android.widget.CheckBox' => 'chk',
-      'android.widget.RadioButton' => 'radio',
-      'android.widget.Switch' => 'switch',
-      'android.widget.ViewGroup' => 'group',
-      'android.widget.View' => 'view',
-      'android.widget.FrameLayout' => 'frame',
-      'android.widget.LinearLayout' => 'linear',
-      'android.widget.RelativeLayout' => 'relative',
-      'android.widget.ScrollView' => 'scroll',
-      'android.webkit.WebView' => 'web',
-      'android.widget.Spinner' => 'spin',
-      'XCUIElementTypeButton' => 'btn',
-      'XCUIElementTypeStaticText' => 'txt',
-      'XCUIElementTypeTextField' => 'input',
-      'XCUIElementTypeImage' => 'img',
-      'XCUIElementTypeSwitch' => 'switch',
-      'XCUIElementTypeScrollView' => 'scroll',
-      'XCUIElementTypeOther' => 'elm',
-      'XCUIElementTypeCell' => 'cell',
-    }.freeze
-    
-    MAX_VALUE_LENGTH = 100
-    @@logger = nil
-
-    def self.handler_failure(driver, exception)
-      begin
-        self.setup_logger unless @@logger
-        
-        FileUtils.rm_rf("reports_failure")
-        @@logger.info("Pasta 'reports_failure' removida para uma nova execução.")
-        
-        timestamp = Time.now.strftime('%Y%m%d_%H%M%S')
-        output_folder = "reports_failure/failure_#{timestamp}"
-        
-        FileUtils.mkdir_p(output_folder)
-        @@logger.info("Pasta de saída criada: #{output_folder}")
-        
-        screenshot_base64 = driver.screenshot_as(:base64)
-        screenshot_path = "#{output_folder}/screenshot_#{timestamp}.png"
-        File.open(screenshot_path, 'wb') do |f|
-          f.write(Base64.decode64(screenshot_base64))
-        end
-        @@logger.info("Screenshot salvo em #{screenshot_path}")
-
-        page_source = driver.page_source
-        xml_path = "#{output_folder}/page_source_#{timestamp}.xml"
-        File.write(xml_path, page_source)
-        @@logger.info("Page source salvo em #{xml_path}")
-
-        doc = Nokogiri::XML(page_source)
-        platform = driver.capabilities['platformName']&.downcase || 'unknown'
-
-        failed_element_info = self.extract_info_from_exception(exception)
-
-        seen_elements = {}
-        all_elements_suggestions = []
-        doc.xpath('//*').each do |node|
-          next if node.name == 'hierarchy'
-          attrs = node.attributes.transform_values(&:value)
-          
-          unique_key = "#{node.name}|#{attrs['resource-id'].to_s}|#{attrs['content-desc'].to_s}|#{attrs['text'].to_s}"
-          
-          unless seen_elements[unique_key]
-            name = self.suggest_name(node.name, attrs)
-            locators = self.xpath_generator(node.name, attrs, platform)
-            
-            all_elements_suggestions << { name: name, locators: locators }
-            seen_elements[unique_key] = true
-          end
-        end
-
-        targeted_report = {
-          failed_element: failed_element_info,
-          similar_elements: [],
-        }
-
-        if failed_element_info && failed_element_info[:selector_value]
-          targeted_report[:similar_elements] = self.find_similar_elements(doc, failed_element_info, platform)
-        end
-        
-        targeted_yaml_path = "#{output_folder}/failure_analysis_#{timestamp}.yaml"
-        File.open(targeted_yaml_path, 'w') do |f|
-          f.write(YAML.dump(targeted_report))
-        end
-        @@logger.info("Análise direcionada salva em #{targeted_yaml_path}")
-
-        full_dump_yaml_path = "#{output_folder}/all_elements_dump_#{timestamp}.yaml"
-        File.open(full_dump_yaml_path, 'w') do |f|
-          f.write(YAML.dump(all_elements_suggestions))
-        end
-        @@logger.info("Dump completo da página salvo em #{full_dump_yaml_path}")
-
-        html_report_path = "#{output_folder}/report_#{timestamp}.html"
-        html_content = self.generate_html_report(targeted_report, all_elements_suggestions, screenshot_base64, platform, timestamp)
-        File.write(html_report_path, html_content)
-        @@logger.info("Relatório HTML completo salvo em #{html_report_path}")
-
-      rescue => e
-        @@logger.error("Erro ao capturar detalhes da falha: #{e.message}\n#{e.backtrace.join("\n")}")
-      end
-    end
-
-    private
-    
-    def self.setup_logger
-      @@logger ||= Logger.new(STDOUT)
-      @@logger.level = Logger::INFO
-      @@logger.formatter = proc do |severity, datetime, progname, msg|
-        "#{datetime.strftime('%Y-%m-%d %H:%M:%S')} [#{severity}] #{msg}\n"
-      end
-    end
-    
-  def self.extract_info_from_exception(exception)
-  message = exception.to_s
-  info = {}
-
-  # normaliza tipos capturados para nomes previsíveis
-  normalize_type = lambda do |t|
-    return 'unknown' unless t
-    t = t.to_s.downcase.strip
-    t = t.gsub(/["']/, '')
-    case t
-    when 'cssselector', 'css selector' then 'css'
-    when 'classname', 'class name' then 'class name'
-    when 'accessibilityid', 'accessibility-id', 'accessibility id' then 'accessibility-id'
-    when 'resourceid', 'resource-id', 'resource id', 'id' then 'resource-id'
-    when 'contentdesc', 'content-desc', 'content desc' then 'content-desc'
-    else
-      t.gsub(/\s+/, '_').gsub(/[^a-z0-9_\-]/, '')
-    end
-  end
-
-  patterns = [
-    # ChromeDriver/Selenium JSON style:
-    # no such element: Unable to locate element: {"method":"xpath","selector":"//..."}
-    /no such element: Unable to locate element:\s*\{\s*["']?method["']?\s*:\s*["']?([^"'\}]+)["']?\s*,\s*["']?selector["']?\s*:\s*["']?([^"']+)["']?\s*\}/i,
-
-    # By.xpath: //..., By.id: "foo"
-    /By\.(xpath|id|css selector|cssSelector|name|class name|className):\s*['"]?(.+?)['"]?(?:\s|$)/i,
-
-    # Generic "using <type>=<value>" or using <type>: '<value>'
-    /using\s+([a-zA-Z0-9_\-:]+)\s*[=:]\s*['"]?(.+?)['"]?(?:\s|$)/i,
-
-    # "An element with the selector '...' was not found"
-    /An element with (?:the )?selector ['"](.+?)['"] (?:could not be found|was not found|not found|not be located)/i,
-
-    # "with the resource-id 'xyz'" or "with the accessibility-id 'abc'"
-    /with the (resource-id|accessibility[- ]?id|content-?desc|label|name)\s*[:=]?\s*['"](.+?)['"]/i,
-
-    # "Unable to find element by: id 'xyz'"
-    /Unable to find element by:\s*([a-zA-Z0-9_\- ]+)\s*[:=]?\s*['"]?(.+?)['"]?(?:\s|$)/i,
-
-    # Fallback to any "selector: '...'" occurence
-    /selector['"]?\s*[:=]?\s*['"](.+?)['"]/i
-  ]
-
-  patterns.each do |pattern|
-      if (m = message.match(pattern))
-        caps = m.captures.compact
-        if caps.length >= 2
-          raw_type  = caps[0].to_s.strip
-          raw_value = caps[1].to_s.strip
-          info[:selector_type]  = normalize_type.call(raw_type)
-          info[:selector_value] = raw_value.gsub(/\A['"]|['"]\z/, '')
-        else
-          info[:selector_type]  = 'unknown'
-          info[:selector_value] = caps[0].to_s.strip.gsub(/\A['"]|['"]\z/, '')
-        end
-        info[:raw_message] = message[0, 1000]
-        return info
-      end
-    end
-
-    # tentativa extra: By.<tipo>:<valor> em qualquer lugar da mensagem
-    if (m = message.match(/By\.([a-zA-Z0-9_\- ]+):\s*['"]?(.+?)['"]?/i))
-      info[:selector_type]  = normalize_type.call(m[1])
-      info[:selector_value] = m[2].to_s.strip
-      info[:raw_message] = message[0,1000]
-      return info
-    end
-
-    # fallback final: retorna a mensagem inteira recortada (útil para debug)
-    info[:selector_type]  = 'unknown'
-    info[:selector_value] = message.strip[0, 500]
-    info[:raw_message]    = message[0,1000]
-    info
-  end
-
-
-    def self.find_similar_elements(doc, failed_info, platform)
-      similar_elements = []
-      doc.xpath('//*').each do |node|
-        next if node.name == 'hierarchy'
-        attrs = node.attributes.transform_values(&:value)
-        
-        selector_value = failed_info[:selector_value].to_s.downcase.strip
-        
-        is_similar = case platform
-        when 'android'
-          (attrs['resource-id']&.downcase&.include?(selector_value) ||
-           attrs['text']&.downcase&.include?(selector_value) ||
-           attrs['content-desc']&.downcase&.include?(selector_value))
-        when 'ios'
-          (attrs['accessibility-id']&.downcase&.include?(selector_value) ||
-           attrs['label']&.downcase&.include?(selector_value) ||
-           attrs['name']&.downcase&.include?(selector_value))
-        else
-          false
-        end
-
-        if is_similar
-          name = self.suggest_name(node.name, attrs)
-          locators = self.xpath_generator(node.name, attrs, platform)
-          similar_elements << { name: name, locators: locators }
-        end
-      end
-      similar_elements
-    end
-    
-    def self.truncate(value)
-      return value unless value.is_a?(String)
-      value.size > MAX_VALUE_LENGTH ? "#{value[0...MAX_VALUE_LENGTH]}..." : value
-    end
-
-    def self.suggest_name(tag, attrs)
-      type = tag.split('.').last
-      pfx = PREFIX[tag] || PREFIX[type] || 'elm'
-      name_base = nil
-      
-      ['content-desc', 'text', 'resource-id', 'label', 'name'].each do |attr_key|
-        value = attrs[attr_key]
-        if value.is_a?(String) && !value.empty?
-          name_base = value
-          break
-        end
-      end
-      
-      name_base ||= type
-      
-      truncated_name = truncate(name_base)
-      sanitized_name = truncated_name.gsub(/[^a-zA-Z0-9\s]/, ' ').split.map(&:capitalize).join
-      
-      "#{pfx}#{sanitized_name}"
-    end
-
-    def self.xpath_generator(tag, attrs, platform)
-      case platform
-      when 'android'
-        self.generate_android_xpaths(tag, attrs)
-      when 'ios'
-        self.generate_ios_xpaths(tag, attrs)
-      else
-        self.generate_unknown_xpaths(tag, attrs)
-      end
-    end
-
-    def self.generate_android_xpaths(tag, attrs)
-      locators = []
-      
-      if attrs['resource-id'] && !attrs['resource-id'].empty? && attrs['text'] && !attrs['text'].empty?
-        locators << { strategy: 'resource_id_and_text', locator: "//#{tag}[@resource-id=\"#{attrs['resource-id']}\" and @text=\"#{self.truncate(attrs['text'])}\"]" }
-      elsif attrs['resource-id'] && !attrs['resource-id'].empty? && attrs['content-desc'] && !attrs['content-desc'].empty?
-        locators << { strategy: 'resource_id_and_content_desc', locator: "//#{tag}[@resource-id=\"#{attrs['resource-id']}\" and @content-desc=\"#{self.truncate(attrs['content-desc'])}\"]" }
-      end
-
-      if attrs['resource-id'] && !attrs['resource-id'].empty?
-        locators << { strategy: 'resource_id', locator: "//#{tag}[@resource-id=\"#{attrs['resource-id']}\"]" }
-      end
-
-      if attrs['resource-id'] && attrs['resource-id'].include?(':id/')
-        id_part = attrs['resource-id'].split(':id/').last
-        locators << { strategy: 'starts_with_resource_id', locator: "//#{tag}[starts-with(@resource-id, \"#{id_part}\")]" }
-      end
-
-      if attrs['text'] && !attrs['text'].empty?
-        locators << { strategy: 'text', locator: "//#{tag}[@text=\"#{self.truncate(attrs['text'])}\"]" }
-      end
-      if attrs['content-desc'] && !attrs['content-desc'].empty?
-        locators << { strategy: 'content_desc', locator: "//#{tag}[@content-desc=\"#{self.truncate(attrs['content-desc'])}\"]" }
-      end
-
-      locators << { strategy: 'generic_tag', locator: "//#{tag}" }
-
-      locators
-    end
-
-    def self.generate_ios_xpaths(tag, attrs)
-      locators = []
-
-      if attrs['accessibility-id'] && !attrs['accessibility-id'].empty? && attrs['label'] && !attrs['label'].empty?
-        locators << { strategy: 'accessibility_id_and_label', locator: "//#{tag}[@accessibility-id=\"#{attrs['accessibility-id']}\" and @label=\"#{self.truncate(attrs['label'])}\"]" }
-      end
-
-      if attrs['accessibility-id'] && !attrs['accessibility-id'].empty?
-        locators << { strategy: 'accessibility_id', locator: "//#{tag}[@accessibility-id=\"#{attrs['accessibility-id']}\"]" }
-      end
-
-      if attrs['label'] && !attrs['label'].empty?
-        locators << { strategy: 'label', locator: "//#{tag}[@label=\"#{self.truncate(attrs['label'])}\"]" }
-      end
-      if attrs['name'] && !attrs['name'].empty?
-        locators << { strategy: 'name', locator: "//#{tag}[@name=\"#{self.truncate(attrs['name'])}\"]" }
-      end
-
-      locators << { strategy: 'generic_tag', locator: "//#{tag}" }
-
-      locators
-    end
-
-    def self.generate_unknown_xpaths(tag, attrs)
-      locators = []
-      if attrs['resource-id'] && !attrs['resource-id'].empty?
-        locators << { strategy: 'resource_id', locator: "//#{tag}[@resource-id=\"#{attrs['resource-id']}\"]" }
-      end
-      if attrs['content-desc'] && !attrs['content-desc'].empty?
-        locators << { strategy: 'content_desc', locator: "//#{tag}[@content-desc=\"#{self.truncate(attrs['content-desc'])}\"]" }
-      end
-      if attrs['text'] && !attrs['text'].empty?
-        locators << { strategy: 'text', locator: "//#{tag}[@text=\"#{self.truncate(attrs['text'])}\"]" }
-      end
-
-      locators << { strategy: 'generic_tag', locator: "//#{tag}" }
-      
-      locators
-    end
-    
-    def self.generate_html_report(targeted_report, all_suggestions, screenshot_base64, platform, timestamp)
-      
-      locators_html = lambda do |locators|
-        locators.map do |loc|
-          "<li class='flex justify-between items-center bg-gray-50 p-2 rounded-md mb-1 text-xs font-mono'><span class='font-bold text-indigo-600'>#{loc[:strategy].upcase.gsub('_', ' ')}:</span><span class='text-gray-700 ml-2 overflow-auto max-w-[70%]'>#{loc[:locator]}</span></li>"
-        end.join
-      end
-
-      all_elements_html = lambda do |elements|
-        elements.map do |el|
-          "<details class='border-b border-gray-200 py-3'><summary class='font-semibold text-sm text-gray-800 cursor-pointer'>#{el[:name]}</summary><ul class='text-xs space-y-1 mt-2'>#{locators_html.call(el[:locators])}</ul></details>"
-        end.join
-      end
-
-      failed_info = targeted_report[:failed_element]
-      similar_elements = targeted_report[:similar_elements]
-      
-      similar_elements_content = similar_elements.empty? ? "<p class='text-gray-500'>Nenhuma alternativa semelhante foi encontrada. O elemento pode ter sido removido.</p>" : similar_elements.map { |el| "<div class='border border-indigo-100 p-3 rounded-lg bg-indigo-50'><p class='font-bold text-indigo-800 mb-2'>#{el[:name]}</p><ul>#{locators_html.call(el[:locators])}</ul></div>" }.join
-      
-      failed_info_content = if failed_info && failed_info[:selector_value]
-        "<p class='text-sm text-gray-700 font-medium mb-2'>Tipo de Seletor: <span class='font-mono text-xs bg-red-100 p-1 rounded'>#{failed_info[:selector_type]}</span></p><p class='text-sm text-gray-700 font-medium'>Valor Buscado: <span class='font-mono text-xs bg-red-100 p-1 rounded break-all'>#{failed_info[:selector_value]}</span></p>"
-      else
-        "<p class='text-sm text-gray-500'>O localizador exato não pôde ser extraído da mensagem de erro.</p>"
-      end
-
-      # Template HTML usando um heredoc
-      <<~HTML_REPORT
-        <!DOCTYPE html>
-        <html lang="pt-BR">
-        <head>
-            <meta charset="UTF-8">
-            <meta name="viewport" content="width=device-width, initial-scale=1.0">
-            <title>Relatório de Falha Appium - #{timestamp}</title>
-            <script src="https://cdn.tailwindcss.com"></script>
-            <style>
-                body { font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif; }
-                .tab-content { display: none; }
-                .tab-content.active { display: block; }
-                .tab-button.active { background-color: #4f46e5; color: white; }
-                .tab-button:not(.active):hover { background-color: #e0e7ff; }
-            </style>
-        </head>
-        <body class="bg-gray-50 p-8">
-            <div class="max-w-7xl mx-auto">
-                <header class="mb-8 pb-4 border-b border-gray-300">
-                    <h1 class="text-3xl font-bold text-gray-800">Diagnóstico de Falha Automatizada</h1>
-                    <p class="text-sm text-gray-500">Relatório gerado em: #{timestamp} | Plataforma: #{platform.upcase}</p>
-                </header>
-
-                <div class="grid grid-cols-1 lg:grid-cols-3 gap-8">
-                    <!-- Coluna de Screenshots e Falha -->
-                    <div class="lg:col-span-1">
-                        <div class="bg-white p-4 rounded-lg shadow-xl mb-6 border border-red-200">
-                            <h2 class="text-xl font-bold text-red-600 mb-4">Elemento com Falha</h2>
-                            #{failed_info_content}
-                        </div>
-
-                        <div class="bg-white p-4 rounded-lg shadow-xl">
-                            <h2 class="text-xl font-bold text-gray-800 mb-4">Screenshot da Falha</h2>
-                            <img src="data:image/png;base64,#{screenshot_base64}" alt="Screenshot da Falha" class="w-full rounded-md shadow-lg border border-gray-200">
-                        </div>
-                    </div>
-
-                    <!-- Coluna de Relatórios e Sugestões -->
-                    <div class="lg:col-span-2">
-                        <div class="bg-white rounded-lg shadow-xl">
-                            <!-- Abas de Navegação -->
-                            <div class="flex border-b border-gray-200">
-                                <button class="tab-button active px-4 py-3 text-sm font-medium rounded-tl-lg" data-tab="similar">Sugestões de Reparo (#{similar_elements.size})</button>
-                                <button class="tab-button px-4 py-3 text-sm font-medium text-gray-600" data-tab="all">Dump Completo da Página (#{all_suggestions.size} Elementos)</button>
-                            </div>
-
-                            <!-- Conteúdo das Abas -->
-                            <div class="p-6">
-                                <!-- Aba Sugestões de Reparo -->
-                                <div id="similar" class="tab-content active">
-                                    <h3 class="text-lg font-semibold text-indigo-700 mb-4">Elementos Semelhantes (Alternativas para o Localizador Falho)</h3>
-                                    <div class="space-y-4">
-                                        #{similar_elements_content}
-                                    </div>
-                                </div>
-
-                                <!-- Aba Dump Completo -->
-                                <div id="all" class="tab-content">
-                                    <h3 class="text-lg font-semibold text-indigo-700 mb-4">Dump Completo de Todos os Elementos da Tela</h3>
-                                    <div class="max-h-[600px] overflow-y-auto space-y-2">
-                                        #{all_elements_html.call(all_suggestions)}
-                                    </div>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </div>
-            </div>
-
-            <script>
-                document.addEventListener('DOMContentLoaded', () => {
-                    const tabs = document.querySelectorAll('.tab-button');
-                    const contents = document.querySelectorAll('.tab-content');
-
-                    tabs.forEach(tab => {
-                        tab.addEventListener('click', () => {
-                            const target = tab.getAttribute('data-tab');
-
-                            tabs.forEach(t => {
-                                t.classList.remove('active', 'text-white', 'bg-indigo-600');
-                                t.classList.add('text-gray-600');
-                            });
-                            contents.forEach(c => c.classList.remove('active'));
-
-                            tab.classList.add('active', 'text-white', 'bg-indigo-600');
-                            tab.classList.remove('text-gray-600');
-                            document.getElementById(target).classList.add('active');
-                        });
-                    });
-
-                    // Set initial active state for styling consistency
-                    const activeTab = document.querySelector('.tab-button[data-tab="similar"]');
-                    activeTab.classList.add('active', 'text-white', 'bg-indigo-600');
-                });
-            </script>
-        </body>
-        </html>
-      HTML_REPORT
-    end
-  end
-end