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

appium_failure_helper 0.6.8 → 1.0.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 +26 -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 +41 -8
data/lib/appium_failure_helper/page_analyzer.rb +15 -9
data/lib/appium_failure_helper/report_generator.rb +166 -76
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: fcada9d17369c2f0afdc27bab51a796c6abd060557783155fd49863bec12f10a
+  data.tar.gz: 0f3cd2fbc47011c5c943ac8e9e573f62c5c15cd7727ef1b9ff1837f9db8050c3
 SHA512:
-  metadata.gz: b9c4ab54799677d260fa7939705fc074a2e9233026b696d2d4548da344b0464f8dcbbda5016a735939819e04c2b06e700ed14d23cde1c8ac55cbfb844cae9b10
-  data.tar.gz: d076e206ca68bd47560a95162428b1dc090df4890934f535de0c68f98b17206adb7229980175c1773dd542e65ac01dd9accbf4da83104cbb68ad893c0df773e0
+  metadata.gz: f93b8cb2b8acf629cad21a7de037d793f0a6a9415a674a110e407c13a56914570b5ddb59e457adaf79869b0903ce5d102cc56c97094207e5c476086b20241b71
+  data.tar.gz: b7f6b505d3864fb3079bd6a7985ed0dd02756861d743abde308c6e78928c86de10a80341f17379fdab10a5bb57d31db0375860636b83470cb91147f0ed8791ab

data/lib/appium_failure_helper/analyzer.rb CHANGED Viewed

@@ -1,3 +1,4 @@
+# lib/appium_failure_helper/analyzer.rb
 module AppiumFailureHelper
   module Analyzer
     def self.extract_failure_details(exception)
@@ -19,14 +20,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 +53,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 +67,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

@@ -12,22 +12,51 @@ module AppiumFailureHelper
     end
     def call
+      unless @driver && @driver.session_id
+        Utils.logger.error("Helper não executado: driver nulo ou sessão encerrada.")
+        Utils.logger.error("Exceção original: #{@exception.message}")
+        return
+      end
       FileUtils.mkdir_p(@output_folder)
       page_source = @driver.page_source
-      platform = @driver.capabilities['platformName']&.downcase || 'unknown'
+      platform_value = @driver.capabilities['platformName'] || @driver.capabilities[:platformName]
+      platform = platform_value&.downcase || 'unknown'
+      @doc = Nokogiri::XML(page_source)
+      failed_info = Analyzer.extract_failure_details(@exception) || {}
+      if failed_info.empty?
+        Utils.logger.info("Análise da mensagem de erro falhou. Tentando analisar código-fonte...")
+        failed_info = SourceCodeAnalyzer.extract_from_exception(@exception) || {}
+      end
+      page_analyzer = PageAnalyzer.new(page_source, platform)
+      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
-      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)
+      code_search_results = CodeSearcher.find_similar_locators(failed_info) || []
       report_data = {
         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,
         screenshot_base64: @driver.screenshot_as(:base64),
         platform: platform,
@@ -35,10 +64,14 @@ module AppiumFailureHelper
       }
       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")}")
+        puts "--- ERRO FATAL NA GEM (DIAGNÓSTICO) ---"
+        puts "CLASSE DO ERRO: #{e.class}"
+        puts "MENSAGEM: #{e.message}"
+        puts "BACKTRACE:\n#{e.backtrace.join("\n")}"
+        puts "----------------------------------------"
     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

@@ -22,127 +22,177 @@ module AppiumFailureHelper
       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]
+        de_para_analysis: @data[:de_para_analysis],
+        code_search_results: @data[:code_search_results],
+        alternative_xpaths: @data[:alternative_xpaths]
       }
       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
-    # --- 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]
+      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 do |loc|
+          strategy_text = loc[:strategy].to_s.upcase.gsub('_', ' ')
+          "<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(strategy_text)}:</span><span class='text-gray-700 ml-2 overflow-auto max-w-[70%]'>#{CGI.escapeHTML(loc[:locator])}</span></li>"
+        end.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 = ""
+      failed_info_content = ""
-      # 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>
+      code_search_html = ""
+      unless code_search_results.empty?
+        suggestions_list = code_search_results.map do |match|
+          score_percent = (match[:score] * 100).round(1)
+          <<~SUGGESTION
+            <div class='border border-sky-200 bg-sky-50 p-3 rounded-lg mb-2'>
+              <p class='text-sm text-gray-600'>Encontrado em: <strong class='font-mono'>#{match[:file]}:#{match[:line_number]}</strong></p>
+              <pre class='bg-gray-800 text-white p-2 rounded mt-2 text-xs overflow-auto'><code>#{CGI.escapeHTML(match[:code])}</code></pre>
+              <p class='text-xs text-green-600 mt-1'>Similaridade: #{score_percent}%</p>
             </div>
+          SUGGESTION
+        end.join
+        code_search_html = <<~HTML
+          <div class="bg-white p-4 rounded-lg shadow-md">
+            <h2 class="text-xl font-bold text-sky-700 mb-4">Sugestões Encontradas no Código</h2>
+            #{suggestions_list}
           </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>
+      failed_info_content = if failed_info && !failed_info.empty?
+         "<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.</p>"
+      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
+        <<~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
         <!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="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>
@@ -150,21 +200,61 @@ module AppiumFailureHelper
             </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');
+            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
-      File.write("#{@output_folder}/report_#{timestamp}.html", html_content)
+      File.write("#{@output_folder}/report_#{@data[:timestamp]}.html", html_content)
     end
   end
 end

data/lib/appium_failure_helper/source_code_analyzer.rb ADDED Viewed

@@ -0,0 +1,48 @@
+module AppiumFailureHelper
+  module SourceCodeAnalyzer
+    PATTERNS = [
+      { type: 'id',               regex: /find_element\((?:id:|:id\s*=>)\s*['"]([^'"]+)['"]\)/ },
+      { type: 'xpath',            regex: /find_element\((?:xpath:|:xpath\s*=>)\s*['"]([^'"]+)['"]\)/ },
+      { type: 'accessibility_id', regex: /find_element\((?:accessibility_id:|:accessibility_id\s*=>)\s*['"]([^'"]+)['"]\)/ },
+      { type: 'class_name',       regex: /find_element\((?:class_name:|:class_name\s*=>)\s*['"]([^'"]+)['"]\)/ },
+      { type: 'xpath',            regex: /find_element\(:xpath,\s*['"]([^'"]+)['"]\)/ },
+      { type: 'id',               regex: /\s(?:id)\s*\(?['"]([^'"]+)['"]\)?/ },
+      { type: 'xpath',            regex: /\s(?:xpath)\s*\(?['"]([^'"]+)['"]\)?/ },
+      { type: 'accessibility_id', regex: /\s(?:accessibility_id)\s*\(?['"]([^'"]+)['"]\)?/ }
+    ].freeze
+    def self.extract_from_exception(exception)
+      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 = path_match[1]
+      line_number = path_match[2]
+      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.0.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.0.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: