appium_failure_helper 1.1.0 → 1.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0fbacdea5fe5540838204bcabcc355e38b455afbfe49f65d4628955d8f84f226
-  data.tar.gz: 526f397b33ea3cdd87831c35275dfbd313e9d81dd60d6c363ad717972d63f096
+  metadata.gz: 7f9f15e7fe28816df34926c685e9f4f43e27f63c8d3830ea12bd6f52c53b2fcb
+  data.tar.gz: a60300e97555f6883711177488f6547dc126ccbf84e5d43f9ca44476db64c961
 SHA512:
-  metadata.gz: 0274b45b6d5a796525574666e82c6bf60b8c99eb9ac269c0ae31f11c08c411f798b893cc33f4ff86d9fa493db951bd9947d7d19ef62691b29226952f9b78abde
-  data.tar.gz: 6fa2f563edab7b2e5b6da5de909b8e39c89438773d40e32a767191ef6423009e71797899a0393d2db0b51f5688c165d221ddd2df6c458d611913a15cdf40c241
+  metadata.gz: 51cabd40ef2755c67d3258f7ee0994147d3a586a531fa05570b4f1f5d4338edfc95c880ff4cdb8b44c5639a7a4a545c5e1a003b9d6f50f61371c85ad0529f647
+  data.tar.gz: 3ddd32df0a5db118f603715249963fffa93e0616a6a27a8718de6da8751d5654abb1f0595b09cc2ae1c5c4c6116fb2b1bea3cc12200e264cb5fbf966b73e2be8

data/lib/appium_failure_helper/analyzer.rb

@@ -1,21 +1,19 @@
-# lib/appium_failure_helper/analyzer.rb
 module AppiumFailureHelper
   module Analyzer
-    
-    def self.triage_error(exception)
+        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.
+        :locator_issue
       when Selenium::WebDriver::Error::ElementNotInteractableError
-        :visibility_issue # Encontrado, mas não clicável/visível.
+        :visibility_issue
       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.
+        :stale_element_issue
+      when defined?(RSpec::Expectations::ExpectationNotMetError) ? RSpec::Expectations::ExpectationNotMetError : Class.new
+        :assertion_failure
       when NoMethodError, NameError, ArgumentError, TypeError
-        :ruby_code_issue # Erro de sintaxe ou lógica no código de teste.
+        :ruby_code_issue
       when Selenium::WebDriver::Error::SessionNotCreatedError, Errno::ECONNREFUSED
-        :session_startup_issue # Problema na conexão/inicialização com o Appium.
+        :session_startup_issue
       when Selenium::WebDriver::Error::WebDriverError
         return :app_crash_issue if exception.message.include?('session deleted because of page crash')
         :unknown_appium_issue
@@ -34,36 +32,31 @@ module AppiumFailureHelper
         /(?: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
+        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)
       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] }
       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
+        mapped_locator = locator_info['valor'].to_s || locator_info['value'].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
@@ -75,20 +68,16 @@ module AppiumFailureHelper
       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.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 = []
-
       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.85
           similarities << { name: suggestion[:name], locators: suggestion[:locators], score: similarity_score, attributes: suggestion[:attributes] }

data/lib/appium_failure_helper/element_repository.rb

@@ -24,7 +24,13 @@ module AppiumFailureHelper
           return map
         end
         instance.elements.each do |key, value|
-          map[key.to_s] = { 'tipoBusca' => value[0], 'valor' => value[1] }
+          valor = value[1]
+          if valor.is_a?(Hash)
+            valor_final = valor['valor'] || valor['value'] || valor
+          else
+            valor_final = valor
+          end
+          map[key.to_s] = { 'tipoBusca' => value[0], 'valor' => valor_final }
         end
       rescue => e
         Utils.logger.warn("AVISO: Erro ao processar o arquivo #{file_path}: #{e.message}")

data/lib/appium_failure_helper/handler.rb

@@ -1,4 +1,3 @@
-# lib/appium_failure_helper/handler.rb
 module AppiumFailureHelper
   class Handler
     def self.call(driver, exception)
@@ -8,7 +7,7 @@ module AppiumFailureHelper
     def initialize(driver, exception)
       @driver = driver
       @exception = exception
-      @timestamp = Time.now.strftime('%Y%m%d_%H%M%S')
+      @timestamp = Time.now.strftime('%Ym%d_%H%M%S')
       @output_folder = "reports_failure/failure_#{@timestamp}"
     end
 
@@ -31,10 +30,12 @@ module AppiumFailureHelper
           screenshot_base64: @driver.screenshot_as(:base64)
         }
 
+        # A análise profunda agora é executada para QUALQUER :locator_issue.
         if triage_result == :locator_issue
           page_source = @driver.page_source
           doc = Nokogiri::XML(page_source)
 
+          # Tenta Plano A e Plano B sem reclassificar o erro.
           failed_info = Analyzer.extract_failure_details(@exception) || {}
           if failed_info.empty?
             failed_info = SourceCodeAnalyzer.extract_from_exception(@exception) || {}
@@ -57,6 +58,7 @@ module AppiumFailureHelper
           de_para_result = Analyzer.find_de_para_match(failed_info, unified_element_map)
           code_search_results = CodeSearcher.find_similar_locators(failed_info) || []
 
+          # Adiciona os dados (mesmo que vazios) ao pacote.
           report_data.merge!({
             page_source: page_source,
             failed_element: failed_info,
@@ -68,7 +70,6 @@ module AppiumFailureHelper
           })
         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}")
         

data/lib/appium_failure_helper/report_generator.rb

@@ -37,41 +37,52 @@ module AppiumFailureHelper
       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
+    def generate_html_report
+      if @data[:triage_result] == :locator_issue && @data[:failed_element].empty?
+        html_content = build_simple_diagnosis_report(
+          title: "Falha na Análise do Seletor",
+          message: "A GEM identificou um erro de 'elemento não encontrado', mas não conseguiu extrair o seletor da mensagem de erro ou do código-fonte. Isso pode ocorrer com métodos de busca customizados ou seletores dinâmicos. Verifique o stack trace para encontrar a linha exata do erro e o método responsável."
+        )
+      else
+    html_content = case @data[:triage_result]
+                    when :locator_issue
+                      build_full_report
+                    when :unidentified_locator_issue, :unidentified_timeout_issue
+                      build_simple_diagnosis_report(
+                        title: "Seletor Não Identificado",
+                        message: "A falha ocorreu porque um elemento não foi encontrado, mas a GEM não conseguiu extrair o seletor exato da mensagem de erro ou do código-fonte. Isso geralmente acontece quando o seletor é construído dinamicamente ou está dentro de um método helper complexo. Verifique o stack trace para encontrar o método responsável (ex: 'tap_by_text')."
+                      )
+                    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 Inesperado",
+                           message: "Ocorreu um erro não catalogado. Verifique o stack trace para mais detalhes."
+                         )
+                    end
       
       File.write("#{@output_folder}/report_#{@data[:timestamp]}.html", html_content)
     end
@@ -99,6 +110,32 @@ module AppiumFailureHelper
       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
+      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
+
+      # --- LÓGICA RESTAURADA: ELEMENTO COM FALHA ---
+      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>"
@@ -209,9 +246,6 @@ module AppiumFailureHelper
                       <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-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>

data/lib/appium_failure_helper/version.rb

@@ -1,3 +1,3 @@
 module AppiumFailureHelper
-  VERSION = "1.1.0"
+  VERSION = "1.1.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: appium_failure_helper
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.2
 platform: ruby
 authors:
 - David Nascimento