bddgenx 1.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 691d4d259476c68894a8859cc74ab4d926fdfe3b7304f5a020f05843442f33d2
-  data.tar.gz: 0aeff404aee94ac4d8419dec2772379a0816fdb5ce69a1e8cf967d47499e2f48
+  metadata.gz: bc08ad6528e8d4134da51f3f5b1adb28f58f23b0774f75c5b909532a89ffcf94
+  data.tar.gz: 93e5e417b5a8ccdda7f1b9e32be61079fcd4d42bf56fd0f17a2cf7d7cdbe30ea
 SHA512:
-  metadata.gz: c08188d0e944723b8e109063d2c2e682e335be6c05ff731f51962daba3a3dccac072201107fb23dda9f0d0b3901f75b97a10e1bcb289cf3305ad6deab8ccc198
-  data.tar.gz: fd8bf60a0b13bb05e63486daa3b4ccead3ddfdc4653046e5f48b252eede5cb8af35498d0d259a23870c203a5912a63a1c70cfc01fdd9b1e5141e58bc56d4c986
+  metadata.gz: f89ff60aa9af4fc6fe1b81b95420b7a2c434aa1c746125f62ef4a164e8207352352ad398904541af5906750c01fd50f3f811c66eb35f684004b9ce1764fb37f2
+  data.tar.gz: d4ff2d93180bbde669cf4f9cb6bba2ace91b65d46d9a19c7cfb8c901074df5c592d6b7b2c3704c69d6ad610c847e13fb5dfb52034c0f3cccb778a582cdb8858a

data/README.md

@@ -3,7 +3,78 @@
 
 ## Visão Geral
 
-Ferramenta Ruby para gerar automaticamente arquivos Gherkin (`.feature`) e definições de passos (`steps.rb`) a partir de histórias em texto. Atende aos padrões ISTQB, suporta parametrização com blocos de exemplos e fornece relatórios de QA (rastreabilidade, backups e PDF).
+Ferramenta Ruby para gerar automaticamente arquivos Gherkin (`.feature`) e definições de passos (`steps.rb`) a partir de histórias em texto. Atende aos padrões ISTQB, suporta parametrização com blocos de exemplos e fornece relatórios de QA (rastreabilidade, backups e PDF). Também suporta geração via IA (OpenAI / Gemini) e configuração por ambiente.
+
+---
+
+## Estrutura do Projeto
+
+```
+bdd-generation/
+├── .github/                       # Workflows de CI/CD
+│   └── workflows/
+│       └── main.yml               # Workflow de build/test
+├── bin/                           # Scripts CLI e de configuração
+│   ├── bddgenx                    # Executável CLI para gerar BDD (static/chatgpt/gemini)
+│   └── setup.rb                   # Script para preparar o ambiente local (gera .env, input/)
+├── features/                      # Gherkin gerados automaticamente
+│   └── steps/                     # Steps correspondentes aos cenários
+├── input/                         # Arquivos de entrada (.txt com histórias)
+│   ├── historia.txt
+│   ├── historia_en.txt
+│   └── ...
+├── lib/
+│   ├── bddgenx/
+│   │   ├── generators/            # Lógica de geração de features e execução geral
+│   │   │   ├── generator.rb
+│   │   │   ├── steps_generator.rb
+│   │   │   └── runner.rb
+│   │   │
+│   │   ├── ia/                    # Integração com APIs de IA
+│   │   │   ├── chatgpt_cliente.rb
+│   │   │   └── gemini_cliente.rb
+│   │   │
+│   │   ├── reports/               # Exportação de artefatos QA
+│   │   │   ├── backup.rb
+│   │   │   ├── pdf_exporter.rb
+│   │   │   └── tracer.rb
+│   │   │
+│   │   ├── support/               # Utilitários auxiliares e validadores
+│   │   │   ├── font_loader.rb
+│   │   │   ├── gherkin_cleaner.rb
+│   │   │   ├── remover_steps_duplicados.rb
+│   │   │   └── validator.rb
+│   │   │
+│   │   ├── configuration.rb       # Configuração global da gem (modo, ENV keys)
+│   │   └── version.rb             # Leitura da versão a partir do arquivo VERSION
+│   │
+│   ├── bddgenx.rb                 # Entrada principal da gem (require env)
+│   └── parser.rb                  # Parser de arquivos de entrada
+├── reports/                       # Artefatos gerados
+│   ├── pdf/                       # Features exportadas em PDF
+│   ├── backup/                    # Versões antigas de features
+│   └── rastreabilidade/           # Arquivos de rastreabilidade (se implementado)
+├── spec/                          # Testes unitários RSpec
+│   ├── support/
+│   ├── utils/
+│   ├── ia/
+│   ├── spec_helper.rb
+│   └── version_spec.rb
+├── .env                           # Arquivo com chaves reais (não versionado)
+├── .env.example                   # Modelo para configurar variáveis de ambiente
+├── .gitignore                     # Arquivos/pastas ignoradas pelo Git
+├── bddgenx.gemspec                # Especificação da gem
+├── bump_version.sh               # Script de versionamento automático (semântico)
+├── Gemfile
+├── Gemfile.lock
+├── LICENSE
+├── Rakefile                       # Tarefas automatizadas (static, chatgpt, gemini)
+├── README.md                      # Documentação principal do projeto
+└── VERSION                        # Arquivo contendo a versão atual da gem
+
+```
+
+---
 
 ## Instalação
 
@@ -13,44 +84,70 @@ Adicione ao seu `Gemfile`:
 gem 'bddgenx'
 ```
 
-Execute:
+Ou instale diretamente:
+
+```bash
+gem install bddgenx
+```
+
+---
+
+## 🔧 Configuração
+
+### 1. Instale dependências
 
 ```bash
 bundle install
 ```
 
-Ou instale diretamente:
+### 2. Configure seu `.env`
 
 ```bash
-gem install bddgenx
+cp .env.example .env
 ```
 
-## Uso no Código
+Edite o `.env`:
 
-```ruby
-require 'bddgenx'
+```env
+OPENAI_API_KEY=sk-...
+GEMINI_API_KEY=ya29-...
+BDDGENX_MODE=chatgpt   # static | chatgpt | gemini
+```
 
-# Gera todas as features e steps a partir dos .txt em input/
-Bddgenx::Runner.execute
+> 🔐 Dica: nunca versionar o `.env` — ele já está no `.gitignore`
+
+---
+
+## 🚀 Uso com Rake
+
+Com os arquivos `.txt` dentro da pasta `input/`, execute:
+
+```bash
+rake bddgenx:static     # geração sem IA
+rake bddgenx:chatgpt    # usando ChatGPT
+rake bddgenx:gemini     # usando Gemini
 ```
 
-## Tarefa Rake (opcional)
+> O modo pode ser sobrescrito via ENV ou `Bddgenx.configure`
+
+---
 
-Em um projeto Rails ou Ruby com Rake, adicione ao `Rakefile`:
+## 📦 Geração manual via Ruby
 
 ```ruby
 require 'bddgenx'
-require 'rake'
 
-namespace :bddgenx do
-  desc 'Gera .feature e steps a partir de histórias em input/'
-  task :gerar do
-    Bddgenx::Runner.execute
-  end
+Bddgenx.configure do |config|
+  config.mode = :chatgpt
+  config.openai_api_key_env = 'OPENAI_API_KEY'
 end
+
+Bddgenx::Runner.execute
 ```
 
-## Formato do Arquivo de Entrada (`.txt`)
+---
+
+## 📝 Formato do Arquivo de Entrada (`.txt`)
 
 ```txt
 # language: pt
@@ -63,19 +160,36 @@ Quando preencho <email> e <senha>
 Então vejo a tela inicial
 
 [EXAMPLES]
-| email            | senha   | resultado               |
-| user@site.com    | 123456  | login realizado         |
-| errado@site.com  | senha   | credenciais inválidas   |
+| email            | senha   |
+| user@site.com    | 123456  |
+| errado@site.com  | senha   |
 ```
 
-## Artefatos de QA
+---
 
-* **Backup**: versões antigas de `.feature` em `reports/backup` com timestamp
-* **PDF**: exporta features em P/B para `reports/pdf` via `PDFExporter`
+## 🧪 Setup Rápido para Novos Usuários
 
-## Integração CI/CD
+```bash
+ruby bin/setup.rb
+```
+
+Esse comando:
+
+- Cria `.env` a partir de `.env.example`
+- Garante que `input/` existe
+
+---
 
-Exemplo de GitHub Actions:
+## 🧾 Artefatos Gerados
+
+- ✅ `.feature` → dentro de `features/`
+- ✅ `steps.rb` → dentro de `features/steps/`
+- 🗂️ Backup automático → `reports/backup/`
+- 📄 PDF das features → `reports/pdf/`
+
+---
+
+## ⚙️ CI/CD Exemplo com GitHub Actions
 
 ```yaml
 jobs:
@@ -85,11 +199,15 @@ jobs:
       - uses: actions/checkout@v3
       - uses: ruby/setup-ruby@v1
         with:
-          ruby-version: '3.x'
+          ruby-version: '3.1'
       - run: bundle install
-      - run: bundle exec ruby -e "require 'bddgenx'; Bddgenx::Runner.execute(only_new: true)"
+      - run: bundle exec rake bddgenx:chatgpt
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
 ```
 
+---
+
 ## Licença
 
 MIT © 2025 David Nascimento

data/Rakefile

@@ -1,55 +1,49 @@
 # Rakefile
-# Tarefas para geração automática de BDD e relatórios com bddgenx
-
+require_relative 'lib/env'
 require 'rake'
-require 'fileutils'
-require 'bddgenx'
 
 namespace :bddgenx do
-  desc 'Gerar arquivos .feature, steps, rastreabilidade e backups'
-  task :gerar, [:only_new, :input_dir] do |t, args|
-    # Parâmetros: only_new (true/false), input_dir (pasta com .txt)
-    args.with_defaults(only_new: 'false', input_dir: 'input')
-    only_new = args.only_new == 'true'
-    input_dir = args.input_dir
-
-    files = FileList["#{input_dir}/*.txt"]
-    if files.empty?
-      puts "❌ Nenhum arquivo encontrado em \#{input_dir}"
-      next
-    end
+  desc 'Inicializar projeto'
+  task :setup do
+    Bddgenx::Setup.inicializar_projeto
+  end
 
-    files.each do |file|
-      puts "🔄 Processando história: \#{file}"
-      historia = Bddgenx::Parser.ler_historia(file)
-      next unless Bddgenx::Validator.validar(historia)
+  desc 'Executa a geração BDD usando o modo atual (static, chatgpt, gemini)'
+  task :generate do
+    puts "⚙️  Modo de geração: #{Bddgenx.configuration.mode}"
 
-      feature_path, conteudo = Bddgenx::Generator.gerar_feature(historia)
+    # Evita que ARGV contenha o nome da task (como "bddgenx:static")
+    ARGV.clear
 
-      Bddgenx::Backup.salvar_versao_antiga(feature_path)
-      Bddgenx::Generator.salvar_feature(feature_path, conteudo)
+    Bddgenx::Runner.execute
+  end
 
-      Bddgenx::StepsGenerator.gerar_passos(feature_path)
-      Bddgenx::Tracer.adicionar_entrada(historia, feature_path)
+  desc 'Gera features no modo estático (sem IA)'
+  task :static do
+    Bddgenx.configure do |config|
+      config.mode = :static
     end
-
-    puts "✅ Geração concluída#{' (apenas novos)' if only_new}!"
+    ENV['BDDGENX_MODE'] = 'static'
+    Rake::Task['bddgenx:generate'].invoke
   end
 
-  desc 'Exportar todos os arquivos .feature para PDF'
-  task :pdf do
-    puts '📦 Exportando features para PDF...'
-    result = Bddgenx::PDFExporter.exportar_todos
-    puts "   Gerados: \#{result[:generated].size}, Pulados: \#{result[:skipped].size}"
+  desc 'Gera features usando ChatGPT'
+  task :chatgpt do
+    Bddgenx.configure do |config|
+      config.mode = :chatgpt
+      config.openai_api_key_env = 'OPENAI_API_KEY'
+    end
+    ENV['BDDGENX_MODE'] = 'chatgpt'
+    Rake::Task['bddgenx:generate'].invoke
   end
 
-  desc 'Remover diretórios gerados (reports/ e features/)'
-  task :clean do
-    %w[reports features].each do |dir|
-      FileUtils.rm_rf(dir)
-      puts "🗑️  Diretório removido: \#{dir}"
+  desc 'Gera features usando Gemini'
+  task :gemini do
+    Bddgenx.configure do |config|
+      config.mode = :gemini
+      config.gemini_api_key_env = 'GEMINI_API_KEY'
     end
+    ENV['BDDGENX_MODE'] = 'gemini'
+    Rake::Task['bddgenx:generate'].invoke
   end
 end
-
-task default: 'bddgenx:gerar'

data/VERSION

@@ -1 +1 @@
-1.0.0
+2.1.0

data/bin/bddgenx

@@ -1,4 +1,4 @@
 #!/usr/bin/env ruby
-require_relative "../lib/bddgenx/runner"
+require_relative "../lib/bddgenx/generators/runner"
 
 Bddgenx::Runner.execute

data/lib/bddgenx/configuration.rb

@@ -0,0 +1,35 @@
+# lib/bddgenx/configuration.rb
+module Bddgenx
+  class Configuration
+    # :static, :chatgpt ou :gemini
+    attr_accessor :mode
+
+    # Nomes das ENV vars para as chaves
+    attr_accessor :openai_api_key_env, :gemini_api_key_env
+
+    def initialize
+      @mode = :static
+      @openai_api_key_env = 'OPENAI_API_KEY'
+      @gemini_api_key_env = 'GEMINI_API_KEY'
+    end
+
+    # Retorna a chave real, carregada do ENV
+    def openai_api_key
+      ENV[@openai_api_key_env]
+    end
+
+    def gemini_api_key
+      ENV[@gemini_api_key_env]
+    end
+  end
+
+  # Singleton de configuração
+  def self.configuration
+    @configuration ||= Configuration.new
+  end
+
+  # DSL para configurar
+  def self.configure
+    yield(configuration)
+  end
+end

data/lib/bddgenx/{generator.rb → generators/generator.rb}

@@ -6,30 +6,45 @@
 # Suporta Gherkin em Português e Inglês, inclusão de tags, cenários simples
 # e esquemas de cenário com exemplos.
 
-require 'fileutils'
-require 'set'
-require_relative 'utils/gherkin_cleaner'
-require_relative 'ia/gemini_cliente'
-require_relative 'utils/remover_steps_duplicados'
-# require_relative 'clients/chatgpt_cliente'
-
 module Bddgenx
   class Generator
+    # Palavras-chave do Gherkin em Português
     GHERKIN_KEYS_PT = %w[Dado Quando Então E Mas].freeze
+
+    # Palavras-chave do Gherkin em Inglês
     GHERKIN_KEYS_EN = %w[Given When Then And But].freeze
+
+    # Mapeamento de PT → EN
     GHERKIN_MAP_PT_EN = GHERKIN_KEYS_PT.zip(GHERKIN_KEYS_EN).to_h
+
+    # Mapeamento de EN → PT
     GHERKIN_MAP_EN_PT = GHERKIN_KEYS_EN.zip(GHERKIN_KEYS_PT).to_h
+
+    # Todas as palavras-chave reconhecidas
     ALL_KEYS = GHERKIN_KEYS_PT + GHERKIN_KEYS_EN
 
+    ##
+    # Extrai todas as linhas de exemplo de um array de strings.
+    #
+    # @param raw [Array<String>] um array contendo linhas de texto
+    # @return [Array<String>] apenas as linhas que começam com '|', ou seja, exemplos
     def self.dividir_examples(raw)
       raw.select { |l| l.strip.start_with?('|') }
     end
 
+    ##
+    # Gera o conteúdo de um arquivo `.feature` a partir de uma história.
+    # Pode operar em três modos: estático (hash ou arquivo estruturado),
+    # IA com Gemini, ou IA com ChatGPT.
+    #
+    # @param input [String, Hash] caminho para um arquivo .txt ou um hash estruturado
+    # @param override_path [String, nil] caminho alternativo para salvar o arquivo gerado
+    # @return [Array(String, String)] caminho do arquivo gerado e conteúdo do .feature
     def self.gerar_feature(input, override_path = nil)
       modo = ENV['BDD_MODE']&.to_sym || :static
 
-      # IA: Lê o arquivo txt e passa para IA → aplica limpeza
       if input.is_a?(String) && input.end_with?('.txt') && [:gemini, :chatgpt].include?(modo)
+        # Modo com IA: gera cenários automaticamente com base no texto da história
         raw_txt = File.read(input)
         historia = {
           idioma: 'pt',
@@ -50,15 +65,15 @@ module Bddgenx
           tag: 'ia',
           passos: GherkinCleaner.limpar(texto_gerado).lines.map(&:strip).reject(&:empty?)
         }
-
       else
-        # Caminho tradicional (hash de entrada ou parser de arquivo)
+        # Modo estático: utiliza estrutura vinda do Parser ou de um hash diretamente
         historia = input.is_a?(String) ? Parser.ler_historia(input) : input
       end
 
       idioma = historia[:idioma] || 'pt'
       cont = 1
 
+      # Normaliza o nome base do arquivo
       nome_base = historia[:quero]
                     .gsub(/[^a-z0-9]/i, '_')
                     .downcase
@@ -69,6 +84,7 @@ module Bddgenx
 
       caminho = override_path || "features/#{nome_base}.feature"
 
+      # Define palavras-chave com base no idioma
       palavras = {
         feature:  idioma == 'en' ? 'Feature'          : 'Funcionalidade',
         contexto: idioma == 'en' ? 'Background'       : 'Contexto',
@@ -79,15 +95,13 @@ module Bddgenx
       }
 
       conteudo = <<~GHK
-  # language: #{idioma}
-  #{palavras[:feature]}: #{historia[:quero].sub(/^Quero\s*/i,'')}
-    # #{historia[:como]}
-    # #{historia[:quero]}
-    # #{historia[:para]}
-
+        # language: #{idioma}
+        #{palavras[:feature]}: #{historia[:quero].sub(/^Quero\s*/i,'')}
+          # #{historia[:como]}
+          # #{historia[:quero]}
+          # #{historia[:para]}
       GHK
 
-      # Set para rastrear steps únicos
       passos_unicos = Set.new
       pt_map = GHERKIN_MAP_PT_EN
       en_map = GHERKIN_MAP_EN_PT
@@ -100,7 +114,6 @@ module Bddgenx
         next if passos.empty?
 
         tag_line = ["@#{grupo[:tipo].downcase}", ("@#{grupo[:tag]}" if grupo[:tag])].compact.join(' ')
-
         conteudo << "    #{tag_line}\n"
 
         if exemplos.any?
@@ -137,11 +150,22 @@ module Bddgenx
       [caminho, conteudo]
     end
 
+    ##
+    # Gera o caminho padrão de saída para um arquivo `.feature` com base no nome do `.txt`.
+    #
+    # @param arquivo_txt [String] caminho do arquivo .txt de entrada
+    # @return [String] caminho completo do arquivo .feature correspondente
     def self.path_para_feature(arquivo_txt)
       nome = File.basename(arquivo_txt, '.txt')
       File.join('features', "#{nome}.feature")
     end
 
+    ##
+    # Salva o conteúdo gerado no disco, criando diretórios se necessário.
+    #
+    # @param caminho [String] caminho completo para salvar o arquivo
+    # @param conteudo [String] conteúdo do arquivo .feature
+    # @return [void]
     def self.salvar_feature(caminho, conteudo)
       FileUtils.mkdir_p(File.dirname(caminho))
       File.write(caminho, conteudo)

data/lib/bddgenx/{runner.rb → generators/runner.rb}

@@ -4,16 +4,7 @@
 # Este arquivo define a classe Runner (CLI) da gem bddgenx,
 # responsável por orquestrar o fluxo de leitura de histórias,
 # validação, geração de features, steps, backups e exportação de PDFs.
-require 'dotenv/load'
-require 'fileutils'
-require_relative 'utils/parser'
-require_relative 'generator'
-require_relative 'utils/pdf_exporter'
-require_relative 'steps_generator'
-require_relative 'utils/validator'
-require_relative 'utils/backup'
-require_relative 'ia/gemini_cliente'
-require_relative 'utils/gherkin_cleaner'
+require_relative '../../bddgenx'
 
 module Bddgenx
   # Ponto de entrada da gem: coordena todo o processo de geração BDD.
@@ -110,26 +101,15 @@ module Bddgenx
         end
 
         # Geração de feature
-        if modo == 'gemini'
-          puts "🤖 Gerando cenários com IA (Gemini)..."
-          idioma = IA::GeminiCliente.detecta_idioma_arquivo(arquivo)  # Seu método que detecta o idioma no .txt (ex: 'pt' ou 'en')
-          spinner = Thread.new do
-            loop do
-              print "\r⏳ Aguardando resposta da IA "
-              3.times do |i|
-                print "." * (i + 1)
-                sleep(0.4)
-                print "\r⏳ Aguardando resposta da IA#{'.' * (i + 1)}   "
-              end
+        if modo == 'gemini' || modo == 'chatgpt'
+          puts "🤖 Gerando cenários com IA (#{modo.capitalize})..."
+          idioma = IA::GeminiCliente.detecta_idioma_arquivo(arquivo)
+          feature_text =
+            if modo == 'gemini'
+              IA::GeminiCliente.gerar_cenarios(historia, idioma)
+            else
+              IA::ChatGptCliente.gerar_cenarios(historia, idioma)
             end
-          end
-          begin
-            feature_text = IA::GeminiCliente.gerar_cenarios(historia, idioma)
-          ensure
-            Thread.kill(spinner)
-            print "\r✅ Resposta da IA recebida!        \n"
-          end
-          # feature_text = IA::GeminiCliente.gerar_cenarios(historia, idioma)
           if feature_text
             feature_path = Generator.path_para_feature(arquivo)
             feature_content = Bddgenx::GherkinCleaner.limpar(feature_text)

data/lib/bddgenx/{steps_generator.rb → generators/steps_generator.rb}

@@ -6,26 +6,45 @@
 # Suporta palavras-chave Gherkin em Português e Inglês e parametriza
 # strings e números conforme necessário.
 
-require 'fileutils'
-require 'strscan'  # Para uso de StringScanner
-require 'set'
-
 module Bddgenx
   class StepsGenerator
+    # Palavras-chave Gherkin em Português
     GHERKIN_KEYS_PT = %w[Dado Quando Então E Mas].freeze
+
+    # Palavras-chave Gherkin em Inglês
     GHERKIN_KEYS_EN = %w[Given When Then And But].freeze
+
+    # Conjunto de todas as palavras-chave suportadas
     ALL_KEYS = GHERKIN_KEYS_PT + GHERKIN_KEYS_EN
 
+    ##
+    # Transforma uma string em estilo camelCase.
+    #
+    # @param str [String] A string a ser transformada.
+    # @return [String] A string convertida para camelCase.
+    #
     def self.camelize(str)
       partes = str.strip.split(/[^a-zA-Z0-9]+/)
       partes.map.with_index { |palavra, i| i.zero? ? palavra.downcase : palavra.capitalize }.join
     end
 
+    ##
+    # Gera arquivos de passos do Cucumber a partir de um arquivo .feature.
+    #
+    # O método lê o arquivo, detecta o idioma, extrai os passos,
+    # parametriza as variáveis (números e strings), e escreve os métodos
+    # em um novo arquivo no diretório `steps/`.
+    #
+    # @param feature_path [String] Caminho para o arquivo .feature.
+    # @return [Boolean] Retorna true se os passos forem gerados com sucesso, false se não houver passos.
+    # @raise [ArgumentError] Se o caminho fornecido não for uma String.
+    #
     def self.gerar_passos(feature_path)
       raise ArgumentError, "Caminho esperado como String, recebeu #{feature_path.class}" unless feature_path.is_a?(String)
 
       linhas = File.readlines(feature_path)
 
+      # Detecta o idioma com base na diretiva "# language:"
       lang = if (m = linhas.find { |l| l =~ /^#\s*language:\s*(\w+)/i })
                m[/^#\s*language:\s*(\w+)/i, 1].downcase
              else
@@ -35,6 +54,7 @@ module Bddgenx
       pt_para_en = GHERKIN_KEYS_PT.zip(GHERKIN_KEYS_EN).to_h
       en_para_pt = GHERKIN_KEYS_EN.zip(GHERKIN_KEYS_PT).to_h
 
+      # Seleciona apenas linhas que começam com palavras-chave Gherkin
       linhas_passos = linhas.map(&:strip).select do |linha|
         ALL_KEYS.any? { |chave| linha.start_with?(chave + ' ') }
       end
@@ -53,6 +73,7 @@ module Bddgenx
       linhas_passos.each do |linha|
         palavra_original, restante = linha.split(' ', 2)
 
+        # Tradução de palavras-chave se necessário
         chave = case lang
                 when 'en' then pt_para_en[palavra_original] || palavra_original
                 else           en_para_pt[palavra_original] || palavra_original
@@ -63,6 +84,7 @@ module Bddgenx
         padrao = ''
         tokens = []
 
+        # Analisa e parametriza o conteúdo dos passos
         until scanner.eos?
           if scanner.check(/"<([^>]+)>"/)
             scanner.scan(/"<([^>]+)>"/)
@@ -87,7 +109,7 @@ module Bddgenx
 
         padrao_seguro = padrao.gsub('"', '\\"')
 
-        # Impede duplicatas
+        # Impede criação de métodos duplicados
         next if passos_unicos.include?(padrao_seguro)
 
         passos_unicos << padrao_seguro