RubyGems - appium_failure_helper - Versions diffs - 0.6.8 → 1.1.0 - Mend

appium_failure_helper 0.6.8 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

checksums.yaml +4 -4
data/lib/appium_failure_helper/analyzer.rb +49 -10
data/lib/appium_failure_helper/code_searcher.rb +44 -0
data/lib/appium_failure_helper/element_repository.rb +0 -4
data/lib/appium_failure_helper/handler.rb +63 -27
data/lib/appium_failure_helper/page_analyzer.rb +15 -9
data/lib/appium_failure_helper/report_generator.rb +248 -88
data/lib/appium_failure_helper/source_code_analyzer.rb +48 -0
data/lib/appium_failure_helper/version.rb +1 -3
data/lib/appium_failure_helper/xpath_factory.rb +89 -0
data/lib/appium_failure_helper.rb +3 -3
metadata +5 -2

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a599f36b97e9ca76cfe763ad26526ea1b80e829128e95667b1020bf29cb9cb41
-  data.tar.gz: 58f249a54a0410b9927bbb14b4551375cd77de49eb35db282cad16a9e0b7817d
+  metadata.gz: 0fbacdea5fe5540838204bcabcc355e38b455afbfe49f65d4628955d8f84f226
+  data.tar.gz: 526f397b33ea3cdd87831c35275dfbd313e9d81dd60d6c363ad717972d63f096
 SHA512:
-  metadata.gz: b9c4ab54799677d260fa7939705fc074a2e9233026b696d2d4548da344b0464f8dcbbda5016a735939819e04c2b06e700ed14d23cde1c8ac55cbfb844cae9b10
-  data.tar.gz: d076e206ca68bd47560a95162428b1dc090df4890934f535de0c68f98b17206adb7229980175c1773dd542e65ac01dd9accbf4da83104cbb68ad893c0df773e0
+  metadata.gz: 0274b45b6d5a796525574666e82c6bf60b8c99eb9ac269c0ae31f11c08c411f798b893cc33f4ff86d9fa493db951bd9947d7d19ef62691b29226952f9b78abde
+  data.tar.gz: 6fa2f563edab7b2e5b6da5de909b8e39c89438773d40e32a767191ef6423009e71797899a0393d2db0b51f5688c165d221ddd2df6c458d611913a15cdf40c241

data/lib/appium_failure_helper/analyzer.rb CHANGED Viewed

@@ -1,5 +1,29 @@
+# lib/appium_failure_helper/analyzer.rb
 module AppiumFailureHelper
   module Analyzer
+    def self.triage_error(exception)
+      case exception
+      when Selenium::WebDriver::Error::NoSuchElementError, Selenium::WebDriver::Error::TimeoutError
+        :locator_issue # O elemento não foi encontrado a tempo.
+      when Selenium::WebDriver::Error::ElementNotInteractableError
+        :visibility_issue # Encontrado, mas não clicável/visível.
+      when Selenium::WebDriver::Error::StaleElementReferenceError
+        :stale_element_issue # A página mudou, o elemento "envelheceu".
+      when RSpec::Expectations::ExpectationNotMetError
+        :assertion_failure # É um bug funcional, a asserção falhou.
+      when NoMethodError, NameError, ArgumentError, TypeError
+        :ruby_code_issue # Erro de sintaxe ou lógica no código de teste.
+      when Selenium::WebDriver::Error::SessionNotCreatedError, Errno::ECONNREFUSED
+        :session_startup_issue # Problema na conexão/inicialização com o Appium.
+      when Selenium::WebDriver::Error::WebDriverError
+        return :app_crash_issue if exception.message.include?('session deleted because of page crash')
+        :unknown_appium_issue
+      else
+        :unknown_issue
+      end
+    end
     def self.extract_failure_details(exception)
       message = exception.message
       info = {}
@@ -19,14 +43,30 @@ module AppiumFailureHelper
       end
       info
     end
     def self.find_de_para_match(failed_info, element_map)
-      logical_name_key = failed_info[:selector_value].to_s.gsub(/^#/, '')
+      failed_value = failed_info[:selector_value].to_s
+      return nil if failed_value.empty?
+      logical_name_key = failed_value.gsub(/^#/, '')
       if element_map.key?(logical_name_key)
-        return {
-          logical_name: logical_name_key,
-          correct_locator: element_map[logical_name_key]
-        }
+        return { logical_name: logical_name_key, correct_locator: element_map[logical_name_key] }
+      end
+      cleaned_failed_locator = failed_value.gsub(/[:\-\/@=\[\]'"()]/, ' ').gsub(/\s+/, ' ').downcase.strip
+      element_map.each do |name, locator_info|
+        mapped_locator = locator_info['valor'].to_s
+        cleaned_mapped_locator = mapped_locator.gsub(/[:\-\/@=\[\]'"()]/, ' ').gsub(/\s+/, ' ').downcase.strip
+        distance = DidYouMean::Levenshtein.distance(cleaned_failed_locator, cleaned_mapped_locator)
+        max_len = [cleaned_failed_locator.length, cleaned_mapped_locator.length].max
+        next if max_len.zero?
+        similarity_score = 1.0 - (distance.to_f / max_len)
+        if similarity_score > 0.85
+          return { logical_name: name, correct_locator: locator_info }
+        end
       end
       nil
     end
@@ -36,8 +76,7 @@ module AppiumFailureHelper
       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
+      normalized_failed_type = failed_locator_type.to_s.downcase.include?('id') ? 'id' : failed_locator_type.to_s
       cleaned_failed_locator = failed_locator_value.to_s.gsub(/[:\-\/@=\[\]'"()]/, ' ').gsub(/\s+/, ' ').downcase.strip
       similarities = []
@@ -51,8 +90,8 @@ module AppiumFailureHelper
         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 }
+        if similarity_score > 0.85
+          similarities << { name: suggestion[:name], locators: suggestion[:locators], score: similarity_score, attributes: suggestion[:attributes] }
         end
       end
       similarities.sort_by { |s| -s[:score] }.first(5)

data/lib/appium_failure_helper/code_searcher.rb ADDED Viewed

@@ -0,0 +1,44 @@
+module AppiumFailureHelper
+  module CodeSearcher
+    def self.find_similar_locators(failed_info)
+      failed_locator_value = failed_info[:selector_value]
+      return [] if failed_locator_value.nil? || failed_locator_value.empty?
+      cleaned_failed_locator = failed_locator_value.gsub(/[:\-\/@=\[\]'"()]/, ' ').gsub(/\s+/, ' ').downcase.strip
+      best_matches = []
+      Dir.glob(File.join('features', '**', '*.rb')).each do |file_path|
+        next if file_path.include?('gems')
+        begin
+          File.foreach(file_path).with_index do |line, line_num|
+            line.scan(/['"]([^'"]+)['"]/).flatten.each do |found_locator|
+              cleaned_found_locator = found_locator.gsub(/[:\-\/@=\[\]'"()]/, ' ').gsub(/\s+/, ' ').downcase.strip
+              next if cleaned_found_locator.length < 5
+              distance = DidYouMean::Levenshtein.distance(cleaned_failed_locator, cleaned_found_locator)
+              max_len = [cleaned_failed_locator.length, cleaned_found_locator.length].max
+              next if max_len.zero?
+              similarity_score = 1.0 - (distance.to_f / max_len)
+              if similarity_score > 0.85
+                best_matches << {
+                  score: similarity_score,
+                  file: file_path,
+                  line_number: line_num + 1,
+                  code: line.strip,
+                  found_locator: found_locator
+                }
+              end
+            end
+          end
+        rescue ArgumentError
+          next
+        end
+      end
+      best_matches.sort_by { |m| -m[:score] }.first(3)
+    end
+  end
+end

data/lib/appium_failure_helper/element_repository.rb CHANGED Viewed

@@ -11,13 +11,11 @@ module AppiumFailureHelper
     def self.load_from_ruby_file
       map = {}
-      # ALTERADO: Lê os caminhos a partir da configuração central.
       config = AppiumFailureHelper.configuration
       file_path = File.join(Dir.pwd, config.elements_path, config.elements_ruby_file)
       return map unless File.exist?(file_path)
-      # ... (o resto do método continua igual)
       begin
         require file_path
         instance = OnboardingElementLists.new
@@ -37,12 +35,10 @@ module AppiumFailureHelper
     def self.load_all_from_yaml
       elements_map = {}
-      # ALTERADO: Lê o caminho base da configuração central.
       config = AppiumFailureHelper.configuration
       glob_path = File.join(Dir.pwd, config.elements_path, '**', '*.yaml')
       Dir.glob(glob_path).each do |file|
-        # ... (o resto do método continua igual) ...
         next if file.include?('reports_failure')
         begin
           data = YAML.load_file(file)

data/lib/appium_failure_helper/handler.rb CHANGED Viewed

@@ -1,3 +1,4 @@
+# lib/appium_failure_helper/handler.rb
 module AppiumFailureHelper
   class Handler
     def self.call(driver, exception)
@@ -12,33 +13,68 @@ module AppiumFailureHelper
     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)
-      unified_element_map = ElementRepository.load_all
-      de_para_result = Analyzer.find_de_para_match(failed_info, unified_element_map)
-      page_analyzer = PageAnalyzer.new(page_source, platform)
-      all_page_elements = page_analyzer.analyze
-      similar_elements = Analyzer.find_similar_elements(failed_info, all_page_elements)
-      report_data = {
-        failed_element: failed_info,
-        similar_elements: similar_elements,
-        de_para_analysis: de_para_result,
-        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")}")
+      begin
+        unless @driver && @driver.session_id
+          Utils.logger.error("Helper não executado: driver nulo ou sessão encerrada.")
+          return
+        end
+        FileUtils.mkdir_p(@output_folder)
+        triage_result = Analyzer.triage_error(@exception)
+        report_data = {
+          exception: @exception,
+          triage_result: triage_result,
+          timestamp: @timestamp,
+          platform: @driver.capabilities['platformName'] || @driver.capabilities[:platformName] || 'unknown',
+          screenshot_base64: @driver.screenshot_as(:base64)
+        }
+        if triage_result == :locator_issue
+          page_source = @driver.page_source
+          doc = Nokogiri::XML(page_source)
+          failed_info = Analyzer.extract_failure_details(@exception) || {}
+          if failed_info.empty?
+            failed_info = SourceCodeAnalyzer.extract_from_exception(@exception) || {}
+          end
+          page_analyzer = PageAnalyzer.new(page_source, report_data[:platform].to_s)
+          all_page_elements = page_analyzer.analyze || []
+          similar_elements = Analyzer.find_similar_elements(failed_info, all_page_elements) || []
+          alternative_xpaths = []
+          if !similar_elements.empty?
+            target_suggestion = similar_elements.first
+            if target_suggestion[:attributes] && (target_path = target_suggestion[:attributes][:path])
+              target_node = doc.at_xpath(target_path)
+              alternative_xpaths = XPathFactory.generate_for_node(target_node) if target_node
+            end
+          end
+          unified_element_map = ElementRepository.load_all
+          de_para_result = Analyzer.find_de_para_match(failed_info, unified_element_map)
+          code_search_results = CodeSearcher.find_similar_locators(failed_info) || []
+          report_data.merge!({
+            page_source: page_source,
+            failed_element: failed_info,
+            similar_elements: similar_elements,
+            alternative_xpaths: alternative_xpaths,
+            de_para_analysis: de_para_result,
+            code_search_results: code_search_results,
+            all_page_elements: all_page_elements
+          })
+        end
+        # A chamada correta, passando apenas 2 argumentos
+        ReportGenerator.new(@output_folder, report_data).generate_all
+        Utils.logger.info("Relatórios gerados com sucesso em: #{@output_folder}")
+      rescue => e
+        Utils.logger.error("Erro fatal na GEM de diagnóstico: #{e.message}\n#{e.backtrace.join("\n")}")
+      end
     end
   end
 end

data/lib/appium_failure_helper/page_analyzer.rb CHANGED Viewed

@@ -1,4 +1,3 @@
-# lib/appium_failure_helper/page_analyzer.rb
 module AppiumFailureHelper
   class PageAnalyzer
     PREFIX = {
@@ -21,19 +20,26 @@ module AppiumFailureHelper
       @platform = platform
     end
-    def analyze
+     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
+          unique_key = node.path
+          next if seen_elements[unique_key]
+          name = suggest_name(node.name, attrs)
+          locators = XPathFactory.generate_for_node(node)
+         all_elements_suggestions << {
+            name: name,
+            locators: locators,
+            attributes: attrs.merge(tag: node.name, path: node.path)
+          }
+          seen_elements[unique_key] = true
       end
       all_elements_suggestions
     end

data/lib/appium_failure_helper/report_generator.rb CHANGED Viewed

@@ -1,13 +1,13 @@
 module AppiumFailureHelper
   class ReportGenerator
-    def initialize(output_folder, page_source, report_data)
+    def initialize(output_folder, report_data)
       @output_folder = output_folder
-      @page_source = page_source
       @data = report_data
+      @page_source = report_data[:page_source] # Pega o page_source de dentro do hash
     end
     def generate_all
-      generate_xml_report
+      generate_xml_report if @page_source
       generate_yaml_reports
       generate_html_report
     end
@@ -19,152 +19,312 @@ module AppiumFailureHelper
     end
     def generate_yaml_reports
+      # Gera um YAML simplificado se não for um problema de seletor
       analysis_report = {
+        triage_result: @data[:triage_result],
+        exception_class: @data[:exception].class.to_s,
+        exception_message: @data[:exception].message,
         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]
+        de_para_analysis: @data[:de_para_analysis],
+        code_search_results: @data[:code_search_results]
       }
       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])) }
+      # Só gera o dump de elementos se a análise completa tiver sido feita
+      if @data[:all_page_elements]
+        File.open("#{@output_folder}/all_elements_dump_#{@data[:timestamp]}.yaml", 'w') { |f| f.write(YAML.dump(@data[:all_page_elements])) }
+      end
+    end
+       def generate_html_report
+      html_content = case @data[:triage_result]
+                     when :locator_issue
+                       build_full_report
+                     when :assertion_failure
+                       build_simple_diagnosis_report(
+                         title: "Falha de Asserção (Bug Funcional)",
+                         message: "A automação executou os passos corretamente, mas o resultado final verificado na tela não foi o esperado. Isso geralmente indica um bug funcional na aplicação, e não um problema com o seletor."
+                       )
+                     when :visibility_issue
+                       build_simple_diagnosis_report(
+                         title: "Elemento Oculto ou Não-Interagível",
+                         message: "O seletor encontrou o elemento no XML da página, mas ele não está visível ou habilitado para interação. Verifique se há outros elementos sobrepondo-o, se ele está desabilitado (disabled/enabled='false'), ou se é necessário aguardar uma animação."
+                       )
+                     when :stale_element_issue
+                       build_simple_diagnosis_report(
+                         title: "Referência de Elemento Antiga (Stale)",
+                         message: "O elemento foi encontrado, mas a página foi atualizada antes que a interação pudesse ocorrer. Isso é um problema de timing. A solução é encontrar o elemento novamente logo antes de interagir com ele."
+                       )
+                     when :session_startup_issue
+                       build_simple_diagnosis_report(
+                         title: "Falha na Conexão com o Servidor Appium",
+                         message: "Não foi possível criar uma sessão com o servidor. Verifique se o servidor Appium está rodando, se as 'capabilities' (incluindo prefixos 'appium:') e a URL de conexão estão corretas."
+                       )
+                     when :app_crash_issue
+                       build_simple_diagnosis_report(
+                         title: "Crash do Aplicativo",
+                         message: "A sessão foi encerrada inesperadamente, o que indica que o aplicativo travou. A causa raiz deve ser investigada nos logs do dispositivo (Logcat para Android, Console para iOS)."
+                       )
+                     else # :ruby_code_issue, :unknown_issue
+                       build_simple_diagnosis_report(
+                         title: "Erro no Código de Teste",
+                         message: "A falha foi causada por um erro de sintaxe ou lógica no próprio código de automação (ex: método não definido, variável nula). O problema não é no Appium ou no seletor, mas sim no script. Verifique o stack trace para encontrar o arquivo e a linha exatos."
+                       )
+                     end
+      File.write("#{@output_folder}/report_#{@data[:timestamp]}.html", html_content)
     end
-    # --- MÉTODO CORRIGIDO COM A LÓGICA COMPLETA ---
-    def generate_html_report
-      # Prepara as variáveis a partir do hash de dados
-      failed_info = @data[:failed_element]
-      similar_elements = @data[:similar_elements]
-      all_suggestions = @data[:all_page_elements]
-      de_para_yaml = @data[:de_para_yaml_analysis]
-      de_para_rb = @data[:de_para_rb_analysis]
+    def build_full_report
+      failed_info = @data[:failed_element] || {}
+      similar_elements = @data[:similar_elements] || []
+      all_suggestions = @data[:all_page_elements] || []
+      de_para_analysis = @data[:de_para_analysis]
+      code_search_results = @data[:code_search_results] || []
+      alternative_xpaths = @data[:alternative_xpaths] || []
       timestamp = @data[:timestamp]
       platform = @data[:platform]
       screenshot_base64 = @data[:screenshot_base64]
-      # CORREÇÃO: Funções (lambdas) para gerar HTML restauradas na íntegra
       locators_html = lambda do |locators|
-        locators.map { |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'>#{CGI.escapeHTML(loc[:strategy].upcase.gsub('_', ' '))}:</span><span class='text-gray-700 ml-2 overflow-auto max-w-[70%]'>#{CGI.escapeHTML(loc[:locator])}</span></li>" }.join
+        (locators || []).map { |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'>#{CGI.escapeHTML(loc[:strategy].to_s.upcase.gsub('_', ' '))}:</span><span class='text-gray-700 ml-2 overflow-auto max-w-[70%]'>#{CGI.escapeHTML(loc[:locator])}</span></li>" }.join
       end
       all_elements_html = lambda do |elements|
-        elements.map { |el| "<details class='border-b border-gray-200 py-3'><summary class='font-semibold text-sm text-gray-800 cursor-pointer'>#{CGI.escapeHTML(el[:name])}</summary><ul class='text-xs space-y-1 mt-2'>#{locators_html.call(el[:locators])}</ul></details>" }.join
+        (elements || []).map { |el| "<details class='border-b border-gray-200 py-3'><summary class='font-semibold text-sm text-gray-800 cursor-pointer'>#{CGI.escapeHTML(el[:name])}</summary><ul class='text-xs space-y-1 mt-2'>#{locators_html.call(el[:locators])}</ul></details>" }.join
       end
+      de_para_html = "" # (Sua lógica de_para_html)
+      code_search_html = "" # (Sua lógica code_search_html)
+      failed_info_content = if failed_info && !failed_info.empty?; # ... (Sua lógica failed_info_content)
+      else "<p class='text-sm text-gray-500'>O localizador exato não pôde ser extraído.</p>"; end
-      # 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
+     repair_strategies_content = if alternative_xpaths.empty?
+        "<p class='text-gray-500'>Nenhuma estratégia de XPath alternativa pôde ser gerada para o elemento alvo.</p>"
+      else
+        pages = alternative_xpaths.each_slice(6).to_a
+        carousel_items = pages.map do |page_strategies|
+          strategy_list_html = page_strategies.map do |strategy|
+            reliability_color = case strategy[:reliability]
+                                when :alta then 'bg-green-100 text-green-800'
+                                when :media then 'bg-yellow-100 text-yellow-800'
+                                else 'bg-red-100 text-red-800'
+                                end
+            <<~STRATEGY_ITEM
+              <div class='border border-gray-200 rounded-lg p-3 bg-white'>
+                <div class='flex justify-between items-center mb-2'>
+                  <p class='font-semibold text-indigo-800 text-sm'>#{CGI.escapeHTML(strategy[:name])}</p>
+                  <span class='text-xs font-medium px-2 py-0.5 rounded-full #{reliability_color}'>#{CGI.escapeHTML(strategy[:reliability].to_s.capitalize)}</span>
+                </div>
+                <pre class='bg-gray-800 text-white p-2 rounded text-xs whitespace-pre-wrap break-words'><code>#{CGI.escapeHTML(strategy[:locator])}</code></pre>
+              </div>
+            STRATEGY_ITEM
+          end.join
+          "<div class='carousel-item w-full flex-shrink-0'><div class='space-y-3'>#{strategy_list_html}</div></div>"
+        end.join
-      # 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>
+        <<~CAROUSEL
+          <div id="xpath-carousel" class="relative">
+            <div class="overflow-hidden">
+              <div class="carousel-track flex transition-transform duration-300 ease-in-out">
+                #{carousel_items}
+              </div>
             </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 class="flex items-center justify-center space-x-4 mt-4">
+              <button class="carousel-prev-footer bg-gray-200 hover:bg-gray-300 text-gray-800 font-bold py-2 px-4 rounded-lg disabled:opacity-50 disabled:cursor-not-allowed transition-colors">
+                &lt; Anterior
+              </button>
+              <div class="carousel-counter text-center text-sm text-gray-600 font-medium"></div>
+              <button class="carousel-next-footer bg-gray-200 hover:bg-gray-300 text-gray-800 font-bold py-2 px-4 rounded-lg disabled:opacity-50 disabled:cursor-not-allowed transition-colors">
+                Próximo &gt;
+              </button>
             </div>
-          HTML
-        end
+          </div>
+        CAROUSEL
       end
-      # Geração do conteúdo das seções que estavam faltando
-      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>"
+      similar_elements_content = if similar_elements.empty?
+        "<p class='text-gray-500'>Nenhuma alternativa semelhante foi encontrada na tela atual.</p>"
       else
-        "<p class='text-sm text-gray-500'>O localizador exato não pôde ser extraído da mensagem de erro.</p>"
+        carousel_items = similar_elements.map do |el|
+          score_percent = (el[:score] * 100).round(1)
+          <<~ITEM
+            <div class="carousel-item w-full flex-shrink-0">
+              <div class='border border-indigo-100 p-4 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 ml-2'>Similaridade: #{score_percent}%</span></p>
+                <ul>#{locators_html.call(el[:locators])}</ul>
+              </div>
+            </div>
+          ITEM
+        end.join
+        <<~CAROUSEL
+          <div id="similar-elements-carousel" class="relative">
+            <div class="overflow-hidden rounded-lg bg-white"><div class="carousel-track flex transition-transform duration-300 ease-in-out">#{carousel_items}</div></div>
+            <div class="flex items-center justify-center space-x-4 mt-4">
+              <button class="carousel-prev-footer bg-gray-200 hover:bg-gray-300 text-gray-800 font-bold py-2 px-4 rounded-lg disabled:opacity-50"> &lt; Anterior </button>
+              <div class="carousel-counter text-center text-sm text-gray-600 font-medium"></div>
+              <button class="carousel-next-footer bg-gray-200 hover:bg-gray-300 text-gray-800 font-bold py-2 px-4 rounded-lg disabled:opacity-50"> Próximo &gt; </button>
+            </div>
+          </div>
+        CAROUSEL
       end
-      # Template HTML completo
-      html_content = <<~HTML_REPORT
+      <<~HTML_REPORT
         <!DOCTYPE html>
         <html lang="pt-BR">
         <head>
-          <meta charset="UTF-8">
-          <meta name="viewport" content="width=device-width, initial-scale=1.0">
+          <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; } .tab-content { display: none; } .tab-content.active { display: block; } .tab-button.active { background-color: #4f46e5; color: white; } </style>
+          <style> .tab-button.active { border-bottom: 2px solid #4f46e5; color: #4f46e5; font-weight: 600; } .tab-content { display: none; } .tab-content.active { display: block; } </style>
         </head>
-        <body class="bg-gray-50 p-8">
+        <body class="bg-gray-100 p-4 sm: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>
+              <p class="text-sm text-gray-500">Relatório gerado em: #{timestamp} | Plataforma: #{platform.to_s.upcase}</p>
             </header>
             <div class="grid grid-cols-1 lg:grid-cols-3 gap-8">
-              <div class="lg:col-span-1">
-                #{de_para_yaml_html}
-                #{de_para_rb_html}
-                <div class="bg-white p-4 rounded-lg shadow-xl mb-6 border border-red-200">
+              <div class="lg:col-span-1 space-y-6">
+                <div class="bg-white p-4 rounded-lg shadow-md 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">
+                #{code_search_html}
+                <div class="bg-white p-4 rounded-lg shadow-md">
                   <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>
               <div class="lg:col-span-2">
-                <div class="bg-white rounded-lg shadow-xl">
+                <div class="bg-white rounded-lg shadow-md">
                   <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>
+                    <button class="tab-button active px-4 py-3 text-sm" data-tab="strategies">Estratégias de Reparo (#{alternative_xpaths.size})</button>
+                    <button class="tab-button px-4 py-3 text-sm text-gray-600" data-tab="all">Dump Completo (#{all_suggestions.size})</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 id="strategies" class="tab-content active">
+                      <h3 class="text-lg font-semibold text-indigo-700 mb-4">Estratégias de Localização Alternativas</h3>
+                      #{repair_strategies_content}
+                    </div>
+                    <div id="similar" class="tab-content">
+                      <div class="space-y-3 max-h-[700px] overflow-y-auto">#{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>
+                      <h3 class="text-lg font-semibold text-gray-700 mb-4">Dump de Todos os Elementos da Tela</h3>
+                      <div class="max-h-[800px] 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>
+            document.addEventListener('DOMContentLoaded', () => {
+              const tabs = document.querySelectorAll('.tab-button');
+              tabs.forEach(tab => {
+                tab.addEventListener('click', (e) => {
+                  e.preventDefault();
+                  const target = tab.getAttribute('data-tab');
+                  tabs.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');
+                });
               });
+              const carousel = document.getElementById('xpath-carousel');
+              if (carousel) {
+                const track = carousel.querySelector('.carousel-track');
+                const items = carousel.querySelectorAll('.carousel-item');
+                const prevButton = carousel.querySelector('.carousel-prev-footer');
+                const nextButton = carousel.querySelector('.carousel-next-footer');
+                const counter = carousel.querySelector('.carousel-counter');
+                const totalItems = items.length;
+                let currentIndex = 0;
+                function updateCarousel() {
+                  if (totalItems === 0) {
+                    if(counter) counter.textContent = "";
+                    return;
+                  };
+                  track.style.transform = `translateX(-${currentIndex * 100}%)`;
+                  if (counter) { counter.textContent = `Página ${currentIndex + 1} de ${totalItems}`; }
+                  if (prevButton) { prevButton.disabled = currentIndex === 0; }
+                  if (nextButton) { nextButton.disabled = currentIndex === totalItems - 1; }
+                }
+                if (nextButton) {
+                  nextButton.addEventListener('click', () => {
+                    if (currentIndex < totalItems - 1) { currentIndex++; updateCarousel(); }
+                  });
+                }
+                if (prevButton) {
+                  prevButton.addEventListener('click', () => {
+                    if (currentIndex > 0) { currentIndex--; updateCarousel(); }
+                  });
+                }
+                if (totalItems > 0) { updateCarousel(); }
+              }
             });
           </script>
         </body>
         </html>
       HTML_REPORT
+    end
-      File.write("#{@output_folder}/report_#{timestamp}.html", html_content)
+    def build_simple_diagnosis_report(title:, message:)
+      exception = @data[:exception]
+      error_message_html = CGI.escapeHTML(exception.message.to_s)
+      backtrace_html = CGI.escapeHTML(exception.backtrace.join("\n"))
+      <<~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>Diagnóstico de Falha - #{title}</title>
+          <script src="https://cdn.tailwindcss.com"></script>
+        </head>
+        <body class="bg-gray-100 p-4 sm:p-8">
+          <div class="max-w-4xl mx-auto">
+            <header class="mb-8 pb-4 border-b border-gray-200">
+              <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].to_s.upcase}</p>
+            </header>
+            <div class="grid grid-cols-1 md:grid-cols-3 gap-6">
+              <div class="md:col-span-1">
+                <div class="bg-white p-4 rounded-lg shadow-md">
+                  <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="md:col-span-2 space-y-6">
+                <div class="bg-white p-6 rounded-lg shadow-md">
+                  <h2 class="text-xl font-bold text-red-600 mb-4">Diagnóstico: #{title}</h2>
+                  <div class="bg-red-50 border-l-4 border-red-500 text-red-800 p-4 rounded-r-lg">
+                    <p class="font-semibold">Causa Provável:</p>
+                    <p>#{message}</p>
+                  </div>
+                </div>
+                <div class="bg-white p-6 rounded-lg shadow-md">
+                  <h3 class="text-lg font-semibold text-gray-700 mb-2">Mensagem de Erro Original</h3>
+                  <pre class="bg-gray-800 text-white p-4 rounded text-xs whitespace-pre-wrap break-words max-h-48 overflow-y-auto"><code>#{error_message_html}</code></pre>
+                </div>
+                <div class="bg-white p-6 rounded-lg shadow-md">
+                  <h3 class="text-lg font-semibold text-gray-700 mb-2">Stack Trace</h3>
+                  <pre class="bg-gray-800 text-white p-4 rounded text-xs whitespace-pre-wrap break-words max-h-72 overflow-y-auto"><code>#{backtrace_html}</code></pre>
+                </div>
+              </div>
+            </div>
+          </div>
+        </body>
+        </html>
+      HTML_REPORT
     end
   end
 end

data/lib/appium_failure_helper/source_code_analyzer.rb ADDED Viewed

@@ -0,0 +1,48 @@
+# lib/appium_failure_helper/source_code_analyzer.rb
+module AppiumFailureHelper
+  module SourceCodeAnalyzer
+    # VERSÃO 3.0: Padrões de Regex mais flexíveis que aceitam um "receptor" opcional (como $driver).
+    PATTERNS = [
+      { type: 'id',               regex: /(?:\$driver\.)?find_element\((?:id:|:id\s*=>)\s*['"]([^'"]+)['"]\)/ },
+      { type: 'xpath',            regex: /(?:\$driver\.)?find_element\((?:xpath:|:xpath\s*=>)\s*['"]([^'"]+)['"]\)/ },
+      { type: 'accessibility_id', regex: /(?:\$driver\.)?find_element\((?:accessibility_id:|:accessibility_id\s*=>)\s*['"]([^'"]+)['"]\)/ },
+      { type: 'class_name',       regex: /(?:\$driver\.)?find_element\((?:class_name:|:class_name\s*=>)\s*['"]([^'"]+)['"]\)/ },
+      { type: 'xpath',            regex: /(?:\$driver\.)?find_element\(:xpath,\s*['"]([^'"]+)['"]\)/ },
+      { type: 'id',               regex: /(?:\$driver\.)?\s*id\s*\(?['"]([^'"]+)['"]\)?/ },
+      { type: 'xpath',            regex: /(?:\$driver\.)?\s*xpath\s*\(?['"]([^'"]+)['"]\)?/ }
+    ].freeze
+    def self.extract_from_exception(exception)
+      # Busca a primeira linha do backtrace que seja um arquivo .rb do projeto
+      location = exception.backtrace.find { |line| line.include?('.rb') && !line.include?('gems') }
+      return {} unless location
+      path_match = location.match(/^(.*?):(\d+)(?::in.*)?$/)
+      return {} unless path_match
+      file_path, line_number = path_match.captures
+      return {} unless File.exist?(file_path)
+      begin
+        error_line = File.readlines(file_path)[line_number.to_i - 1]
+        return parse_line_for_locator(error_line)
+      rescue
+        return {}
+      end
+    end
+    def self.parse_line_for_locator(line)
+      PATTERNS.each do |pattern_info|
+        match = line.match(pattern_info[:regex])
+        if match
+          return {
+            selector_type: pattern_info[:type].to_s,
+            selector_value: match[1],
+            analysis_method: "Análise de Código-Fonte"
+          }
+        end
+      end
+      {}
+    end
+  end
+end

data/lib/appium_failure_helper/version.rb CHANGED Viewed

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
 module AppiumFailureHelper
-  VERSION = "0.6.8"
+  VERSION = "1.1.0"
 end

data/lib/appium_failure_helper/xpath_factory.rb ADDED Viewed

@@ -0,0 +1,89 @@
+module AppiumFailureHelper
+  module XPathFactory
+    MAX_STRATEGIES = 20
+    def self.generate_for_node(node)
+      return [] unless node
+      tag = node.name
+      attrs = node.attributes.transform_values(&:value) || {}
+      strategies = []
+      add_direct_attribute_strategies(strategies, tag, attrs)
+      add_combinatorial_strategies(strategies, tag, attrs)
+      add_parent_based_strategies(strategies, tag, node)
+      add_relational_strategies(strategies, node)
+      add_partial_text_strategies(strategies, tag, attrs)
+      add_boolean_strategies(strategies, tag, attrs)
+      add_positional_strategies(strategies, node)
+      strategies.uniq { |s| s[:locator] }.first(MAX_STRATEGIES)
+    end
+    private
+    def self.add_direct_attribute_strategies(strategies, tag, attrs)
+      if (id = attrs['resource-id']) && !id.empty?
+        strategies << { name: "ID Único (Recomendado)", strategy: 'id', locator: id, reliability: :alta }
+      end
+      if (text = attrs['text']) && !text.empty?
+        strategies << { name: "Texto Exato", strategy: 'xpath', locator: "//#{tag}[@text='#{text}']", reliability: :alta }
+      end
+      if (desc = attrs['content-desc']) && !desc.empty?
+        strategies << { name: "Content Description", strategy: 'xpath', locator: "//#{tag}[@content-desc='#{desc}']", reliability: :alta }
+      end
+    end
+    def self.add_combinatorial_strategies(strategies, tag, attrs)
+      valid_attrs = attrs.select { |k, v| %w[text content-desc class package].include?(k) && v && !v.empty? }
+      return if valid_attrs.keys.size < 2
+      valid_attrs.keys.combination(2).each do |comb|
+        locator_parts = comb.map { |k| "@#{k}='#{attrs[k]}'" }.join(' and ')
+        attr_names = comb.map(&:capitalize).join(' + ')
+        strategies << { name: "Combinação: #{attr_names}", strategy: 'xpath', locator: "//#{tag}[#{locator_parts}]", reliability: :alta }
+      end
+    end
+    def self.add_parent_based_strategies(strategies, tag, node)
+      parent = node.parent
+      return unless parent && parent.name != 'hierarchy'
+      parent_attrs = parent.attributes.transform_values(&:value) || {}
+      if (id = parent_attrs['resource-id']) && !id.empty?
+        strategies << { name: "Filho de Pai com ID", strategy: 'xpath', locator: "//*[@resource-id='#{id}']//#{tag}", reliability: :alta }
+      else
+        parent_attrs.each do |k, v|
+          next if v.empty?
+          strategies << { name: "Filho de Pai com #{k}", strategy: 'xpath', locator: "//*[@#{k}='#{v}']//#{tag}", reliability: :media }
+        end
+      end
+    end
+    def self.add_relational_strategies(strategies, node)
+      if (prev_sibling = node.previous_sibling) && (text = prev_sibling['text']) && !text.empty?
+        strategies << { name: "Relativo ao Irmão Anterior", strategy: 'xpath', locator: "//#{prev_sibling.name}[@text='#{text}']/following-sibling::#{node.name}[1]", reliability: :media }
+      end
+    end
+    def self.add_partial_text_strategies(strategies, tag, attrs)
+      if (text = attrs['text']) && !text.empty? && text.split.size > 1
+        strategies << { name: "Texto Parcial (contains)", strategy: 'xpath', locator: "//#{tag}[contains(@text, '#{text.split.first}')]", reliability: :media }
+      end
+    end
+    def self.add_boolean_strategies(strategies, tag, attrs)
+      %w[enabled checked selected].each do |attr|
+        if attrs[attr] == 'true'
+          strategies << { name: "#{attr.capitalize} é Verdadeiro", strategy: 'xpath', locator: "//#{tag}[@#{attr}='true']", reliability: :media }
+        end
+      end
+    end
+    def self.add_positional_strategies(strategies, node)
+      index = node.xpath('preceding-sibling::' + node.name).count + 1
+      strategies << { name: "Índice na Tela (Frágil)", strategy: 'xpath', locator: "(//#{node.name})[#{index}]", reliability: :baixa }
+      strategies << { name: "Caminho Absoluto (Não Recomendado)", strategy: 'xpath', locator: node.path, reliability: :baixa }
+    end
+  end
+end

data/lib/appium_failure_helper.rb CHANGED Viewed

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
 require 'nokogiri'
 require 'fileutils'
 require 'base64'
@@ -8,11 +6,13 @@ 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/source_code_analyzer'
+require_relative 'appium_failure_helper/code_searcher'
 require_relative 'appium_failure_helper/element_repository'
 require_relative 'appium_failure_helper/page_analyzer'
+require_relative 'appium_failure_helper/xpath_factory'
 require_relative 'appium_failure_helper/report_generator'
 require_relative 'appium_failure_helper/handler'
 require_relative 'appium_failure_helper/configuration'

metadata CHANGED Viewed

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appium_failure_helper
 version: !ruby/object:Gem::Version
-  version: 0.6.8
+  version: 1.1.0
 platform: ruby
 authors:
 - David Nascimento
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-25 00:00:00.000000000 Z
+date: 2025-09-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -95,13 +95,16 @@ files:
 - Rakefile
 - lib/appium_failure_helper.rb
 - lib/appium_failure_helper/analyzer.rb
+- lib/appium_failure_helper/code_searcher.rb
 - lib/appium_failure_helper/configuration.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/source_code_analyzer.rb
 - lib/appium_failure_helper/utils.rb
 - lib/appium_failure_helper/version.rb
+- lib/appium_failure_helper/xpath_factory.rb
 - sig/appium_failure_helper.rbs
 homepage: https://github.com/David-Nascimento/Appium_failure_helper
 licenses: