BDD_PyTech

Acelere automações E2E! Grave no navegador e exporte projetos prontos em Playwright, Python/Behave ou Roteiros Excel.

Análise do Sistema: Extensão Geradora de Testes BDD Visão Geral O sistema é uma Extensão para Google Chrome (Manifest V3) projetada para facilitar a criação de testes automatizados E2E (End-to-End). Seu objetivo principal é capturar as interações de um usuário enquanto ele navega por uma aplicação web e converter essas ações automaticamente em código de teste estruturado seguindo o padrão BDD (Behavior Driven Development). O projeto exporta um pacote completo em Python, utilizando as bibliotecas Selenium WebDriver para automação e Behave para a execução dos cenários Gherkin. Arquitetura Técnica 1. Estrutura da Extensão O projeto segue uma arquitetura modular baseada em ES6 Modules, sem o uso de frameworks pesados (como React ou Vue) no runtime da extensão, o que garante leveza e performance. Manifest V3: Utiliza a versão mais recente da API de extensões do Chrome. Content Script ( src/content.js ): O coração da extensão. É injetado em todas as páginas visitadas (<all_urls>). Ele é responsável por: Inicializar a aplicação. Gerenciar o ciclo de vida da gravação. Injetar o painel flutuante de controle na página (DOM Shadow ou direto no body). Monitorar eventos de usuário (cliques, inputs, navegação). Background Script ( src/background.js ): Gerencia eventos de nível de navegador, comunicações entre abas e o estado persistente quando necessário. State Management ( src/state/store.js ): Implementa um padrão de gerenciamento de estado centralizado (similar ao Redux, mas simplificado), garantindo que todos os componentes (painel, capturadores de eventos) reajam às mudanças de estado (ex: isRecording, isPaused). 2. Componentes Principais Captura de Eventos ( src/events/capture.js ) O sistema utiliza Event Listeners globais (click, change, blur, keydown) para interceptar ações do usuário. Identificação de Elementos: Utiliza algoritmos robustos em src/utils/dom.js para gerar seletores CSS e XPath confiáveis para cada elemento interagido. Navegação: Monitora mudanças de URL (History API e eventos de hash) para gerar passos de navegação nos testes. Inspeção de Elementos Possui um modo de "Inspeção" ( toggleElementInspection em content.js ) que permite ao usuário passar o mouse sobre elementos da página para visualizá-los destacados e capturar seus seletores manualmente, sem necessariamente estar gravando um cenário completo. Motor de Exportação (src/export/) A lógica de geração de código é desacoplada da captura. export-manager.js e exporter.js: Orquestram a criação da estrutura de arquivos do projeto Python. Geração de Arquivos: O sistema gera dinamicamente: Arquivos .feature (Gherkin). Arquivos .py (Page Objects e Step Definitions). Arquivos de configuração (environment.py, requirements.txt). Compressão: Utiliza uma biblioteca (provavelmente JSZip, encapsulada em compressor.js) para empacotar tudo em um arquivo .zip para o usuário. Funcionalidades Chave Gravação de Cenários: O usuário define Feature e Cenário e inicia a gravação. A extensão traduz ações em passos Gherkin (Given, When, Then). Page Object Model (POM): O código gerado segue estritamente o padrão POM, separando os locators (seletores) da lógica de interação, facilitando a manutenção dos testes. Geração Automática de Código: Features: Descrições legíveis em português/inglês. Steps: Código Python que liga o Gherkin ao Selenium. Pages: Classes Python que encapsulam os elementos da tela. UI Interativa: Um painel flutuante na página permite controlar a gravação, visualizar os passos gerados em tempo real e exportar o projeto. Qualidade e Boas Práticas O projeto demonstra preocupação com qualidade de código e experiência do usuário: Modularização: O código é bem dividido em pastas (components, events, utils, state). Documentação: Possui um README extenso e documentação técnica na pasta docs/. Tratamento de Erros: O código de exportação possui proteções e fallbacks (ex: export-manager.backup.js sugere mecanismos de segurança). Conclusão O sistema é uma ferramenta madura para QA Engineers e Desenvolvedores que desejam acelerar a criação de testes automatizados. Ele abstrai a complexidade inicial de configurar um projeto Selenium/Behave, entregando uma base sólida e funcional pronta para execução.