appium_failure_helper 0.6.2 → 0.6.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87d48b6025e058dfc945cc71675a8389ffd7c219a8bedccf8994327b10d02760
-  data.tar.gz: 700ae3934bd4413d7ea30ac589493dca717e199dd0a69374156ec2f4bda966b3
+  metadata.gz: fc097199adcadcecb8d7492ab6e2c6f577b0cdf9acfa28cb9486195b9342c1f6
+  data.tar.gz: 5e92c1e6cba8685d9254ff550c1eee4a553afaffc1c4b1e726f410f9ed3fa7e1
 SHA512:
-  metadata.gz: 83321c33adbc356d531abe28f2f792b635e5e2658676c7510afabd263e4c7f99b4d4c5dcbaaf0d20bba569a62841b812f50015b5901f3e860ebe0b6f44bbbcc2
-  data.tar.gz: 35935a71ebd0ff920cfeee986d0918337f706146b680c7a5f85bba334dcc790d0ca4c01bb8bcf1b3aec2efaa95a5d758fc6b416ece69bd2504b3c9b59ac45a91
+  metadata.gz: 7fd06c93b630f5f70163f2b3396fb0b078d902393f73b7729f94564dbc17f3e90c0aaf42da166728b183a306ee4d12671226a8ac8a45de75f1981d74f04905f8
+  data.tar.gz: 8629aa0822ef81b2ea24c8048ee31445d92e195a5404d830b7db7aae19c2606e261fc941aa9d5ca920087ad975af342de489bdc32f355226bfa66d4c97772ec9

data/lib/appium_failure_helper/analyzer.rb

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

data/lib/appium_failure_helper/element_repository.rb

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

data/lib/appium_failure_helper/handler.rb

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

data/lib/appium_failure_helper/page_analyzer.rb

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

data/lib/appium_failure_helper/report_generator.rb

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

data/lib/appium_failure_helper/utils.rb

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

data/lib/appium_failure_helper/version.rb

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

data/lib/appium_failure_helper.rb

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

metadata

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

data/lib/appium_failure_helper/capture.rb

@@ -1,346 +0,0 @@
-require 'nokogiri'
-require 'fileutils'
-require 'base64'
-require 'yaml'
-require 'logger'
-require 'did_you_mean'
-require 'cgi' # Adicionado para garantir o escape de HTML
-
-module AppiumFailureHelper
-  class Capture
-    # ... (Constantes PREFIX, MAX_VALUE_LENGTH, @@logger permanecem iguais) ...
-    PREFIX = {
-      'android.widget.Button' => 'btn', 'android.widget.TextView' => 'txt',
-      'android.widget.ImageView' => 'img', 'android.widget.EditText' => 'input',
-      'android.widget.CheckBox' => 'chk', 'android.widget.RadioButton' => 'radio',
-      'android.widget.Switch' => 'switch', 'android.widget.ViewGroup' => 'group',
-      'android.widget.View' => 'view', 'android.widget.FrameLayout' => 'frame',
-      'android.widget.LinearLayout' => 'linear', 'android.widget.RelativeLayout' => 'relative',
-      'android.widget.ScrollView' => 'scroll', 'android.webkit.WebView' => 'web',
-      'android.widget.Spinner' => 'spin', 'XCUIElementTypeButton' => 'btn',
-      'XCUIElementTypeStaticText' => 'txt', 'XCUIElementTypeTextField' => 'input',
-      'XCUIElementTypeImage' => 'img', 'XCUIElementTypeSwitch' => 'switch',
-      'XCUIElementTypeScrollView' => 'scroll', 'XCUIElementTypeOther' => 'elm',
-      'XCUIElementTypeCell' => 'cell'
-    }.freeze
-    MAX_VALUE_LENGTH = 100
-    @@logger = nil
-
-    # --- MÉTODO PRINCIPAL (SEM ALTERAÇÕES) ---
-    def self.handler_failure(driver, exception)
-      begin
-        self.setup_logger unless @@logger
-        timestamp = Time.now.strftime('%Y%m%d_%H%M%S')
-        output_folder = "reports_failure/failure_#{timestamp}"
-        FileUtils.mkdir_p(output_folder)
-        @@logger.info("Pasta de saída criada: #{output_folder}")
-        screenshot_base64 = driver.screenshot_as(:base64)
-        page_source = driver.page_source
-        File.write("#{output_folder}/page_source_#{timestamp}.xml", page_source)
-        doc = Nokogiri::XML(page_source)
-        platform = driver.capabilities['platformName']&.downcase || 'unknown'
-        failed_element_info = self.extract_info_from_exception(exception)
-        local_element_map = self.load_local_element_map
-        de_para_result = nil
-        logical_name_key = failed_element_info[:selector_value].to_s.gsub(/^#/, '')
-        if local_element_map.key?(logical_name_key)
-          de_para_result = {
-            logical_name: logical_name_key,
-            correct_locator: local_element_map[logical_name_key]
-          }
-        end
-        all_elements_suggestions = self.get_all_elements_from_screen(doc, platform)
-        similar_elements = self.find_similar_elements(failed_element_info, all_elements_suggestions)
-        targeted_report = {
-          failed_element: failed_element_info,
-          similar_elements: similar_elements,
-          de_para_analysis: de_para_result
-        }
-        File.open("#{output_folder}/failure_analysis_#{timestamp}.yaml", 'w') { |f| f.write(YAML.dump(targeted_report)) }
-        File.open("#{output_folder}/all_elements_dump_#{timestamp}.yaml", 'w') { |f| f.write(YAML.dump(all_elements_suggestions)) }
-        html_content = self.generate_html_report(targeted_report, all_elements_suggestions, screenshot_base64, platform, timestamp)
-        File.write("#{output_folder}/report_#{timestamp}.html", html_content)
-        @@logger.info("Relatórios gerados com sucesso em: #{output_folder}")
-      rescue => e
-        @@logger.error("Erro ao capturar detalhes da falha: #{e.message}\n#{e.backtrace.join("\n")}")
-      end
-    end
-
-    private
-
-    def self.load_local_element_map
-      elements_map = {}
-      glob_path = File.join(Dir.pwd, 'features', 'elements', '**', '*.yaml')
-      Dir.glob(glob_path).each do |file|
-        begin
-          data = YAML.load_file(file)
-          if data.is_a?(Hash)
-            data.each do |key, value|
-              if value.is_a?(Hash) && value['tipoBusca'] && value['valor']
-                elements_map[key] = value
-              end
-            end
-          end
-        rescue => e
-          @@logger.warn("Aviso: Erro ao carregar o arquivo de elementos #{file}: #{e.message}") if @@logger
-        end
-      end
-      elements_map
-    end
-
-    def self.setup_logger
-        @@logger = Logger.new(STDOUT)
-        @@logger.level = Logger::INFO
-        @@logger.formatter = proc { |severity, datetime, progname, msg| "#{datetime.strftime('%Y-%m-%d %H:%M:%S')} [#{severity}] #{msg}\n" }
-    end
-
-    def self.extract_info_from_exception(exception)
-        message = exception.message
-        info = {}
-        patterns = [
-          /element with locator ['"]?(#?\w+)['"]?/i,
-          /(?:could not be found|cannot find element) using (.+?)=['"]?([^'"]+)['"]?/i,
-          /no such element: Unable to locate element: {"method":"([^"]+)","selector":"([^"]+)"}/i,
-          /(?:with the resource-id|with the accessibility-id) ['"]?(.+?)['"]?/i
-        ]
-        patterns.each do |pattern|
-            match = message.match(pattern)
-            if match
-                info[:selector_value] = match.captures.last.strip.gsub(/['"]/, '')
-                info[:selector_type] = match.captures.size > 1 ? match.captures[0].strip.gsub(/['"]/, '') : 'id' # Padroniza para 'id'
-                return info
-            end
-        end
-        info
-    end
-    
-   
-    def self.find_similar_elements(failed_element_info, all_page_suggestions)
-      failed_locator_value = failed_element_info[:selector_value]
-      failed_locator_type = failed_element_info[:selector_type]
-      return [] unless failed_locator_value && failed_locator_type
-
-      # Padroniza os tipos de localizador (ex: 'resource-id' vira 'id')
-      normalized_failed_type = failed_locator_type.downcase.include?('id') ? 'id' : failed_locator_type
-
-      cleaned_failed_locator = failed_locator_value.to_s.gsub(/[:\-\/@=\[\]'"()]/, ' ').gsub(/\s+/, ' ').downcase.strip
-      similarities = []
-
-      all_page_suggestions.each do |suggestion|
-        # Procura por um localizador na sugestão que tenha a MESMA ESTRATÉGIA do localizador que falhou
-        candidate_locator = suggestion[:locators].find { |loc| loc[:strategy] == normalized_failed_type }
-        next unless candidate_locator
-        
-        cleaned_candidate_locator = candidate_locator[:locator].gsub(/[:\-\/@=\[\]'"()]/, ' ').gsub(/\s+/, ' ').downcase.strip
-        distance = DidYouMean::Levenshtein.distance(cleaned_failed_locator, cleaned_candidate_locator)
-        max_len = [cleaned_failed_locator.length, cleaned_candidate_locator.length].max
-        next if max_len.zero?
-        
-        similarity_score = 1.0 - (distance.to_f / max_len)
-        if similarity_score > 0.8 # Aumenta o limiar para maior precisão
-          similarities << { name: suggestion[:name], locators: suggestion[:locators], score: similarity_score }
-        end
-      end
-      similarities.sort_by { |s| -s[:score] }.first(5)
-    end
-    
-    # ... (get_all_elements_from_screen, truncate, suggest_name permanecem iguais) ...
-    def self.get_all_elements_from_screen(doc, platform)
-        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 = self.suggest_name(node.name, attrs)
-                locators = self.xpath_generator(node.name, attrs, platform)
-                all_elements_suggestions << { name: name, locators: locators }
-                seen_elements[unique_key] = true
-            end
-        end
-        all_elements_suggestions
-    end
-
-    def self.truncate(value)
-      return value unless value.is_a?(String)
-      value.size > MAX_VALUE_LENGTH ? "#{value[0...MAX_VALUE_LENGTH]}..." : value
-    end
-
-    def self.suggest_name(tag, attrs)
-      type = tag.split('.').last
-      pfx = PREFIX[tag] || PREFIX[type] || 'elm'
-      name_base = nil
-      
-      priority_attrs = if tag.start_with?('XCUIElementType')
-                        ['name', 'label', 'value']
-                      else
-                        ['content-desc', 'text', 'resource-id']
-                      end
-
-      priority_attrs.each do |attr_key|
-        value = attrs[attr_key]
-        if value.is_a?(String) && !value.empty?
-          name_base = value
-          break
-        end
-      end
-      
-      # Se nenhum atributo de prioridade for encontrado, usa o nome da classe.
-      name_base ||= type.gsub('XCUIElementType', '') # Remove o prefixo longo do iOS
-      
-      truncated_name = truncate(name_base)
-      sanitized_name = truncated_name.gsub(/[^a-zA-Z0-9\s]/, ' ').split.map(&:capitalize).join
-      
-      "#{pfx}#{sanitized_name}"
-    end
-
-    def self.xpath_generator(tag, attrs, platform)
-      case platform
-      when 'android' then self.generate_android_xpaths(tag, attrs)
-      when 'ios' then self.generate_ios_xpaths(tag, attrs)
-      else self.generate_unknown_xpaths(tag, attrs)
-      end
-    end
-
-    def self.generate_android_xpaths(tag, attrs)
-      locators = []
-      if attrs['resource-id'] && !attrs['resource-id'].empty?
-        # CORREÇÃO: A estratégia para resource-id é 'id', e o valor é o próprio ID.
-        locators << { strategy: 'id', locator: attrs['resource-id'] }
-      end
-      if attrs['text'] && !attrs['text'].empty?
-        locators << { strategy: 'xpath', locator: "//#{tag}[@text=\"#{truncate(attrs['text'])}\"]" }
-      end
-      if attrs['content-desc'] && !attrs['content-desc'].empty?
-        locators << { strategy: 'xpath_desc', locator: "//#{tag}[@content-desc=\"#{truncate(attrs['content-desc'])}\"]" }
-      end
-      locators
-    end
-
-    def self.generate_ios_xpaths(tag, attrs)
-      locators = []
-      if attrs['name'] && !attrs['name'].empty?
-        # CORREÇÃO: A estratégia para 'name' no iOS é 'name', e o valor é o próprio nome.
-        locators << { strategy: 'name', locator: attrs['name'] }
-      end
-      if attrs['label'] && !attrs['label'].empty?
-        locators << { strategy: 'xpath', locator: "//#{tag}[@label=\"#{truncate(attrs['label'])}\"]" }
-      end
-      locators
-    end
-    
-    def self.generate_unknown_xpaths(tag, attrs)
-        locators = []
-        attrs.each { |key, value| locators << { strategy: key.to_s, locator: "//#{tag}[@#{key}=\"#{truncate(value)}\"]" } if value.is_a?(String) && !value.empty? }
-        locators
-    end
-    
-    def self.generate_html_report(targeted_report, all_suggestions, screenshot_base64, platform, timestamp)
-      # Lambdas para gerar partes do HTML
-      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
-      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
-      end
-
-      # Prepara o conteúdo dinâmico
-      failed_info = targeted_report[:failed_element]
-      similar_elements = targeted_report[:similar_elements]
-      de_para_analysis = targeted_report[:de_para_analysis]
-
-      # Bloco de HTML para a análise "De/Para"
-      de_para_html = ""
-      if de_para_analysis
-        de_para_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 (De/Para)</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_analysis[:logical_name])}</strong> foi encontrado nos seus arquivos locais!</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_analysis[:correct_locator]['tipoBusca'].upcase)}:</span>
-              <span class="break-all">#{CGI.escapeHTML(de_para_analysis[:correct_locator]['valor'])}</span>
-            </div>
-          </div>
-        HTML
-      end
-
-      similar_elements_content = similar_elements.empty? ? "<p class='text-gray-500'>Nenhuma alternativa semelhante foi encontrada na tela atual.</p>" : similar_elements.map { |el|
-        score_percent = (el[:score] * 100).round(1)
-        "<div class='border border-indigo-100 p-3 rounded-lg bg-indigo-50'><p class='font-bold text-indigo-800 mb-2'>#{CGI.escapeHTML(el[:name])} <span class='text-xs font-normal text-green-600 bg-green-100 rounded-full px-2 py-1'>Similaridade: #{score_percent}%</span></p><ul>#{locators_html.call(el[:locators])}</ul></div>"
-      }.join
-
-      failed_info_content = if failed_info && failed_info[:selector_value]
-        "<p class='text-sm text-gray-700 font-medium mb-2'>Tipo de Seletor: <span class='font-mono text-xs bg-red-100 p-1 rounded'>#{CGI.escapeHTML(failed_info[:selector_type].to_s)}</span></p><p class='text-sm text-gray-700 font-medium'>Valor Buscado: <span class='font-mono text-xs bg-red-100 p-1 rounded break-all'>#{CGI.escapeHTML(failed_info[:selector_value].to_s)}</span></p>"
-      else
-        "<p class='text-sm text-gray-500'>O localizador exato não pôde ser extraído da mensagem de erro.</p>"
-      end
-
-      # Template HTML completo
-      <<~HTML_REPORT
-        <!DOCTYPE html>
-        <html lang="pt-BR">
-        <head>
-          <meta charset="UTF-8">
-          <meta name="viewport" content="width=device-width, initial-scale=1.0">
-          <title>Relatório de Falha Appium - #{timestamp}</title>
-          <script src="https://cdn.tailwindcss.com"></script>
-          <style> body { font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto; } .tab-content { display: none; } .tab-content.active { display: block; } .tab-button.active { background-color: #4f46e5; color: white; } </style>
-        </head>
-        <body class="bg-gray-50 p-8">
-          <div class="max-w-7xl mx-auto">
-            <header class="mb-8 pb-4 border-b border-gray-300">
-              <h1 class="text-3xl font-bold text-gray-800">Diagnóstico de Falha Automatizada</h1>
-              <p class="text-sm text-gray-500">Relatório gerado em: #{timestamp} | Plataforma: #{platform.upcase}</p>
-            </header>
-            <div class="grid grid-cols-1 lg:grid-cols-3 gap-8">
-              <div class="lg:col-span-1">
-                #{de_para_html}
-                <div class="bg-white p-4 rounded-lg shadow-xl mb-6 border border-red-200">
-                  <h2 class="text-xl font-bold text-red-600 mb-4">Elemento com Falha</h2>
-                  #{failed_info_content}
-                </div>
-                <div class="bg-white p-4 rounded-lg shadow-xl">
-                  <h2 class="text-xl font-bold text-gray-800 mb-4">Screenshot da Falha</h2>
-                  <img src="data:image/png;base64,#{screenshot_base64}" alt="Screenshot da Falha" class="w-full rounded-md shadow-lg border border-gray-200">
-                </div>
-              </div>
-              <div class="lg:col-span-2">
-                <div class="bg-white rounded-lg shadow-xl">
-                  <div class="flex border-b border-gray-200">
-                    <button class="tab-button active px-4 py-3 text-sm font-medium rounded-tl-lg" data-tab="similar">Sugestões de Reparo (#{similar_elements.size})</button>
-                    <button class="tab-button px-4 py-3 text-sm font-medium text-gray-600" data-tab="all">Dump Completo da Página (#{all_suggestions.size} Elementos)</button>
-                  </div>
-                  <div class="p-6">
-                    <div id="similar" class="tab-content active">
-                      <h3 class="text-lg font-semibold text-indigo-700 mb-4">Elementos Semelhantes (Alternativas para o Localizador Falho)</h3>
-                      <div class="space-y-4">#{similar_elements_content}</div>
-                    </div>
-                    <div id="all" class="tab-content">
-                      <h3 class="text-lg font-semibold text-indigo-700 mb-4">Dump de Todos os Elementos da Tela</h3>
-                      <div class="max-h-[600px] overflow-y-auto space-y-2">#{all_elements_html.call(all_suggestions)}</div>
-                    </div>
-                  </div>
-                </div>
-              </div>
-            </div>
-          </div>
-          <script>
-            document.querySelectorAll('.tab-button').forEach(tab => {
-              tab.addEventListener('click', () => {
-                const target = tab.getAttribute('data-tab');
-                document.querySelectorAll('.tab-button').forEach(t => t.classList.remove('active'));
-                document.querySelectorAll('.tab-content').forEach(c => c.classList.remove('active'));
-                tab.classList.add('active');
-                document.getElementById(target).classList.add('active');
-              });
-            });
-          </script>
-        </body>
-        </html>
-      HTML_REPORT
-    end
-  end
-end