bddgenx 2.4.3 → 2.4.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 27017e2957f3a9710eb63407c7f6d15e35e756a45890d3dc43b281b357d7d509
-  data.tar.gz: e50c8a8b925a0f941229ea8c79215e7671584b288cc29aab3dda78ad05db9e13
+  metadata.gz: 35e8e21b724442b0cb35cda26d862a4aa3a1eccbfd1bdb050dba306c1606600e
+  data.tar.gz: 540d3c814c5621fb7184261c4f070b4f30fa7c0ea351028b6205739556864bc9
 SHA512:
-  metadata.gz: 73d8b6d056d42b958814229d6d03384338199e6fbbb36da8110923ea955410b0b4de9a36d8f8df71343974178bebfc948a488303fe1e60d9a94bb410968f9e84
-  data.tar.gz: a8da8ca236ae14891de29ba9f22807581348258fb711922cc614dec74453ccb6fa6073b04cf6f74cdff24d304ff958e425d71762daaee59dc15df8bb93b3e163
+  metadata.gz: 6942cf6d50f8f4f4a1ddd69f05a294f066907798f3b3dcfaac0cbc4bb04844267488bad866c65eef47c1bc9596efca105b366102d6eff3305025afbb70b8565e
+  data.tar.gz: ed96a04fa5b37f17f768f3f015eaed93e5a944ae9d041425743610b97b3dc1bbf58caef555c692d6cf732b1229d373a3f3b0fae6ebe02c719514eaa6f253b839

data/README.md

@@ -1,81 +1,40 @@
 # Gerador Automático de BDD em Ruby
+
 [![Gem Version](https://badge.fury.io/rb/bddgenx.svg)](https://badge.fury.io/rb/bddgenx)
 
 ## 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). Também suporta geração via IA (OpenAI / Gemini) e configuração por ambiente.
-
----
+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).
 
 ## 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
-│   └── ...
+├── bin/
+├── features/                    # Gherkin gerados automaticamente
+│   └── steps/                   # Steps correspondentes
+├── input/                       # Histórias de entrada
 ├── 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
-
+│   │   ├── generators/          # Geração de features e steps
+│   │   ├── ia/                  # Integração com APIs de IA
+│   │   ├── reports/             # Exportação PDF, backup, rastreio
+│   │   ├── support/             # Validação e utilitários
+│   │   ├── configuration.rb     # Configuração global
+│   │   ├── setup.rb             # Cria estrutura inicial do projeto
+│   │   └── version.rb           # Versão da gem
+│   ├── bddgenx.rb
+│   └── parser.rb
+├── reports/
+│   ├── backup/
+│   ├── pdf/
+│   └── rastreabilidade/
+├── .env                         # Variáveis de ambiente
+├── bddgenx.gemspec
+├── Rakefile
+└── README.md
 ```
 
----
-
 ## Instalação
 
 Adicione ao seu `Gemfile`:
@@ -84,71 +43,76 @@ Adicione ao seu `Gemfile`:
 gem 'bddgenx'
 ```
 
-Ou instale diretamente:
+Instale com:
 
 ```bash
-gem install bddgenx
+bundle install
 ```
 
----
-
-## 🔧 Configuração
-
-### 1. Instale dependências
+Ou diretamente:
 
 ```bash
-bundle install
+gem install bddgenx
 ```
 
-### 2. Configure seu `.env`
+## Inicialização do Projeto (`Setup.run`)
 
-```bash
-cp .env.example .env
-```
+Antes de usar a gem, é recomendado executar o setup para criar:
 
-Edite o `.env`:
+* Pastas obrigatórias (`input/`, `features/steps/`, `reports/`...)
+* Arquivo `historia.txt` com conteúdo exemplo
+* Feature `.feature` e steps `_steps.rb`
+* Arquivo `.env` com variáveis de ambiente
 
-```env
-OPENAI_API_KEY=sk-...
-GEMINI_API_KEY=ya29-...
-BDDGENX_MODE=chatgpt   # static | chatgpt | gemini
-```
+### Via Ruby
 
-> 🔐 Dica: nunca versionar o `.env` — ele já está no `.gitignore`
+```bash
+bundle exec ruby -e "require 'bddgenx'; Bddgenx::Setup.run"
+```
 
----
+### Via Rakefile
 
-## 🚀 Uso com Rake
+```ruby
+require 'bddgenx'
 
-Com os arquivos `.txt` dentro da pasta `input/`, execute:
+namespace :bddgenx do
+  desc 'Inicializa estrutura do projeto'
+  task :setup do
+    Bddgenx::Setup.run
+  end
+end
+```
 
 ```bash
-rake bddgenx:static     # geração sem IA
-rake bddgenx:chatgpt    # usando ChatGPT
-rake bddgenx:gemini     # usando Gemini
+rake bddgenx:setup
 ```
 
-> O modo pode ser sobrescrito via ENV ou `Bddgenx.configure`
+## Configuração do `.env`
 
----
+```dotenv
+# OPENAI e GEMINI só são usados se modo for IA\OPENAI_API_KEY=xxx
+GEMINI_API_KEY=xxx
 
-## 📦 Geração manual via Ruby
+BDDGENX_MODE=static    # static, chatgpt, gemini, deepseek
+BDDGENX_LANG=pt        # pt ou en
+```
+
+## Uso via Código Ruby
 
 ```ruby
 require 'bddgenx'
 
 Bddgenx.configure do |config|
-  config.mode = :chatgpt
-  config.openai_api_key_env = 'OPENAI_API_KEY'
+  config.mode = :gemini
+  config.gemini_api_key_env = 'GEMINI_API_KEY'
 end
 
 Bddgenx::Runner.execute
 ```
 
----
+## Uso via Rake
 
-## 📦 Geração manual via Rake
-```Ruby
+```ruby
 require 'rake'
 require 'bddgenx'
 
@@ -187,86 +151,39 @@ namespace :bddgenx do
 end
 ```
 
-## 📝 Formato do Arquivo de Entrada (`.txt`)
+Execute com:
+
+```bash
+rake bddgenx:generate[static]     # ou chatgpt, gemini, deepseek
+```
+
+## Formato do Arquivo de Entrada
 
 ```txt
 # language: pt
 Como um usuário do sistema
-Quero fazer login corretamente
-Para acessar minha conta com segurança
+Quero acessar minha conta
+Para realizar tarefas
 
 [CONTEXT]
 Dado que estou na tela de login
 
 [SUCCESS]
-Quando preencho email e senha válidos
+Quando preencho email e senha
 Então vejo a tela inicial
 
-[SUCCESS]
-Quando tento logar com "<email>" e "<senha>"
-Então recebo "<mensagem>"
-
 [EXAMPLES]
-| email            | senha   | mensagem                  |
-| user@site.com    | 123456  | login realizado           |
-| errado@site.com  | senha   | credenciais inválidas     |
-|                  | senha   | email é obrigatório       |
-| user@site.com    |         | senha é obrigatória       |
-
-[SUCCESS]
-Quando deixo o campo "<campo>" vazio
-Então recebo a mensagem "<mensagem>"
-
-[EXAMPLES]
-| campo  | mensagem                  |
-|        | login realizado           |
-|        | credenciais inválidas     |
-| email  | email é obrigatório       |
-| senha  | senha é obrigatória       |
+| email         | senha  | resultado          |
+| user@site.com | 123456 | login realizado    |
+| errado@site   | 000000 | credenciais inválidas |
 ```
 
----
-
-## 🧪 Setup Rápido para Novos Usuários
-
-```bash
-ruby bin/setup.rb
-```
-
-Esse comando:
-
-- Cria `.env` a partir de `.env.example`
-- Garante que `input/` existe
-
----
-
-## 🧾 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:
-  gerar_bdd:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: '3.1'
-      - run: bundle install
-      - run: bundle exec rake bddgenx:chatgpt
-        env:
-          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-```
+## Geração de Artefatos
 
----
+* Arquivos `.feature` na pasta `features/`
+* Arquivos `*_steps.rb` na pasta `features/steps/`
+* Arquivos PDF em `reports/pdf/`
+* Backups de features anteriores em `reports/backup/`
 
 ## Licença
 

data/VERSION

@@ -1 +1 @@
-2.4.3
+2.4.5

data/bin/bddgenx

@@ -1,4 +1,13 @@
 #!/usr/bin/env ruby
-require_relative "../lib/bddgenx/generators/runner"
+# bin/bddgenx
+
+require_relative '../lib/bddgenx'
+
+# Permite usar: `bddgenx --init`
+if ARGV.include?('--init')
+  Bddgenx::Setup.run
+  exit 0
+end
+
+puts I18n.t('cli.init_hint')
 
-Bddgenx::Runner.execute

data/lib/bddgenx/ia/chatgtp_cliente.rb

@@ -7,7 +7,7 @@ module Bddgenx
     # cenários BDD no formato Gherkin, com suporte a fallback para Gemini.
     #
     class ChatGptCliente
-      CHATGPT_API_URL = 'https://api.openai.com/v1/chat/completions'.freeze
+      CHATGPT_API_URL = ENV['CHATGPT_API_URL']
       MODEL = 'gpt-4o'
 
       ##
@@ -24,7 +24,7 @@ module Bddgenx
         api_key = Bddgenx.configuration.openai_api_key  # para ChatGPT
 
         unless api_key
-          warn "❌ API Key do ChatGPT não encontrada no .env (OPENAI_API_KEY)"
+          warn I18n.t('errors.chatgpt_key_missing')
           return fallback_com_gemini(historia, idioma)
         end
 
@@ -112,14 +112,14 @@ module Bddgenx
             texto_limpo.prepend("# language: #{idioma}\n") unless texto_limpo.start_with?("# language:")
             return texto_limpo
           else
-            warn "❌ Resposta da IA sem conteúdo de texto"
+            warn I18n.t('errors.ia_no_content')
             warn JSON.pretty_generate(json)
             return fallback_com_gemini(historia, idioma)
           end
         else
           if response.code.to_i == 429
-            warn "❌ Limite de uso da API OpenAI excedido."
-            warn "🔗 Verifique sua conta: https://platform.openai.com/account/usage"
+            warn I18n.t('errors.openai_quota')
+            warn I18n.t('errors.openai_check_usage')
           end
           return fallback_com_gemini(historia, idioma)
         end
@@ -134,7 +134,7 @@ module Bddgenx
       # @return [String] Cenários gerados pelo GeminiCliente.
       #
       def self.fallback_com_gemini(historia, idioma)
-        warn "🔁 Tentando gerar com Gemini como fallback..."
+        warn I18n.t('messages.fallback_gemini')
         GeminiCliente.gerar_cenarios(historia, idioma)
       end
 

data/lib/bddgenx/ia/gemini_cliente.rb

@@ -7,7 +7,7 @@ module Bddgenx
     # de conteúdo, aqui usado para criar cenários BDD no formato Gherkin.
     #
     class GeminiCliente
-      GEMINI_API_URL = 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent'.freeze
+      GEMINI_API_URL = ENV['GEMINI_API_URL']
 
       ##
       # Gera cenários BDD baseados em uma história, solicitando à API Gemini
@@ -120,12 +120,12 @@ module Bddgenx
 
             return texto_limpo
           else
-            warn "❌ Resposta da IA sem conteúdo de texto"
+            warn I18n.t('errors.ia_no_content')
             warn JSON.pretty_generate(json)
             return nil
           end
         else
-          warn "❌ Erro ao chamar Gemini: #{response.code} - #{response.body}"
+          warn I18n.t('errors.gemini_error', code: response.code, body: response.body)
           return nil
         end
       end

data/lib/bddgenx/locales/en.yml

@@ -11,6 +11,7 @@ en:
     features_generated: "Generated features"
     steps_generated: "Generated steps"
     feature_created: "✅ .feature file generated: %{caminho}"
+    fallback_gemini: "🔁 Trying to generate with Gemini as fallback..."
   gherkin:
     feature: "Feature"
     context: "Background"
@@ -24,5 +25,29 @@ en:
     generated: "✅ Steps generated: %{path}"
   errors:
     invalid_path: "Expected path as String, got %{path}"
-  messages2:
-    processing_done: "✅ Processing complete"
+    ia_no_content: "❌ No content returned from AI"
+    gemini_error: "❌ Error calling Gemini: %{code} - %{body}"
+    chatgpt_key_missing: "❌ ChatGPT API key not found in .env (OPENAI_API_KEY)"
+    openai_quota: "❌ OpenAI API quota exceeded."
+    openai_check_usage: "🔗 Check your usage: https://platform.openai.com/account/usage"
+    feature_not_found: "⚠️ Feature not found: %{feature}"
+    pdf_generation_failed: "❌ Failed to generate PDF for %{file}: %{error}"
+    font_fallback: "⚠️ DejaVuSansMono fonts missing or corrupted in %{font}. Falling back to Courier."
+  backup:
+    created: "📦 Backup created: %{path}"
+  validator:
+    missing_header: "❌ Missing header (Como, Quero, Para are required)"
+    no_blocks: "❌ No step groups detected"
+    empty_group: "❌ Group %{index} of type [%{type}] is empty"
+    invalid_examples: "❌ EXAMPLES group in block %{index} does not contain a valid table"
+    found_errors: "⚠️  Errors found in the file:"
+  setup:
+    init: "🔧 Initializing structure with Bddgenx::Setup.run"
+    spinner_checking: "Checking structure..."
+    dir_created: "📁 Directory created: %{path} ✔️"
+    dir_exists: "📁 Directory already exists: %{path} ✔️"
+    file_created: "📄 File created: %{path} ✔️"
+    file_exists: "📄 File already exists: %{path} ✔️"
+    success: "✅ Structure successfully completed!"
+  cli:
+    init_hint: "ℹ️  Use 'bddgenx --init' to initialize the project."

data/lib/bddgenx/locales/pt.yml

@@ -11,6 +11,7 @@ pt:
     features_generated: "Features geradas"
     steps_generated: "Steps gerados"
     feature_created: "✅ Arquivo .feature gerado: %{caminho}"
+    fallback_gemini: "🔁 Tentando gerar com Gemini como fallback..."
   gherkin:
     feature: "Funcionalidade"
     context: "Contexto"
@@ -24,4 +25,30 @@ pt:
     generated: "✅ Steps gerados: %{path}"
   errors:
     invalid_path: "Caminho esperado como String, recebeu %{path}"
+    ia_no_content: "❌ Resposta da IA sem conteúdo de texto"
+    gemini_error: "❌ Erro ao chamar Gemini: %{code} - %{body}"
+    chatgpt_key_missing: "❌ API Key do ChatGPT não encontrada no .env (OPENAI_API_KEY)"
+    openai_quota: "❌ Limite de uso da API OpenAI excedido."
+    openai_check_usage: "🔗 Verifique sua conta: https://platform.openai.com/account/usage"
+    feature_not_found: "⚠️ Feature não encontrada: %{feature}"
+    pdf_generation_failed: "❌ Erro ao gerar PDF de %{file}: %{error}"
+    font_fallback: "⚠️ Fontes DejaVuSansMono ausentes ou corrompidas em %{font}. Usando fallback Courier."
+  backup:
+    created: "📦 Backup criado: %{path}"
+  validator:
+    missing_header: "❌ Cabeçalho incompleto (Como, Quero, Para obrigatórios)"
+    no_blocks: "❌ Nenhum grupo de blocos detectado"
+    empty_group: "❌ Grupo %{index} do tipo [%{type}] está vazio"
+    invalid_examples: "❌ Grupo de EXAMPLES no bloco %{index} não contém tabela válida"
+    found_errors: "⚠️  Erros encontrados no arquivo:"
+  setup:
+    init: "🔧 Iniciando estrutura com Bddgenx::Setup.run"
+    spinner_checking: "Verificando estrutura..."
+    dir_created: "📁 Diretório criado: %{path} ✔️"
+    dir_exists: "📁 Diretório já existe: %{path} ✔️"
+    file_created: "📄 Arquivo criado: %{path} ✔️"
+    file_exists: "📄 Arquivo já existe: %{path} ✔️"
+    success: "✅ Estrutura finalizada com sucesso!"
+  cli:
+    init_hint: "ℹ️  Use 'bddgenx --init' para iniciar o projeto."
 

data/lib/bddgenx/reports/backup.rb

@@ -16,15 +16,15 @@ module Bddgenx
     def self.salvar_versao_antiga(caminho)
       return unless File.exist?(caminho)
 
-      pasta     = 'reports/backup'
+      pasta = 'reports/backup'
       FileUtils.mkdir_p(pasta)
 
-      base      = File.basename(caminho, '.feature')
+      base = File.basename(caminho, '.feature')
       timestamp = Time.now.strftime('%Y%m%d_%H%M%S')
-      destino   = "reports/backup/#{base}_#{timestamp}.feature"
+      destino = File.join(pasta, "#{base}_#{timestamp}.feature")
 
       FileUtils.cp(caminho, destino)
-      puts "📦 Backup criado: #{destino}"
+      puts I18n.t('backup.created', path: destino)
     end
   end
 end

data/lib/bddgenx/reports/pdf_exporter.rb

@@ -37,7 +37,7 @@ module Bddgenx
 
       features_list.each do |feature|
         unless File.file?(feature)
-          warn "⚠️ Feature não encontrada: #{feature}"
+          warn I18n.t('errors.feature_not_found', feature: feature)
           next
         end
 
@@ -151,7 +151,7 @@ module Bddgenx
         pdf.number_pages 'Página <page> de <total>', align: :right, size: 8
       end
     rescue => e
-      warn "❌ Erro ao gerar PDF de #{origem}: #{e.message}"
+      warn I18n.t('errors.pdf_generation_failed', file: origem, error: e.message)
     end
   end
 end

data/lib/bddgenx/setup.rb

@@ -1,26 +1,179 @@
-#!/usr/bin/env ruby
+# lib/bddgenx/setup.rb
+
 module Bddgenx
   class Setup
-    def self.inicializar_projeto
-      puts "🔧 Configurando ambiente do projeto BddGenX..."
+    SPINNER_FRAMES = %w[⠋ ⠙ ⠹ ⠸ ⠼ ⠴ ⠦ ⠧ ⠇ ⠏].freeze
+    SPINNER_DELAY = 0.1
+    def self.run
+      thread, stop = start_spinner(I18n.t('setup.spinner_checking'))
+
+      resultados = []
+      resultados << verificar("input") do
+        File.write('input/historia.txt', exemplo_txt) unless File.exist?('input/historia.txt')
+      end
+
+      resultados << verificar("features/steps") do
+        File.write('features/exemplo_login.feature', exemplo_feature) unless File.exist?('features/exemplo_login.feature')
+        File.write('features/steps/exemplo_login_steps.rb', exemplo_step) unless File.exist?('features/steps/exemplo_login_steps.rb')
+      end
+
+      resultados << verificar("reports/pdf")
+      resultados << verificar("reports/backup")
+
+      resultados << verificar(".env", is_file: true) do
+        File.write('.env', exemplo_env)
+      end
+
+      stop_spinner(thread, stop)
 
-      # Cria .env a partir do exemplo
-      if File.exist?(".env")
-        puts "✅ .env já existe. Nada a fazer."
+      resultados.each { |mensagem| puts mensagem }
+      puts "\n#{I18n.t('setup.success')}"
+    end
+
+    def self.verificar(path, is_file: false)
+      if is_file
+        if File.exist?(path)
+          I18n.t('setup.file_exists', path: path)
+        else
+          yield if block_given?
+          I18n.t('setup.file_created', path: path)
+        end
       else
-        if File.exist?(".env.example")
-          FileUtils.cp(".env.example", ".env")
-          puts "✅ .env criado a partir de .env.example"
+        if Dir.exist?(path)
+          I18n.t('setup.dir_exists', path: path)
         else
-          puts "⚠️ Arquivo .env.example não encontrado. Crie manualmente o .env"
+          FileUtils.mkdir_p(path)
+          yield if block_given?
+          I18n.t('setup.dir_created', path: path)
         end
       end
+    end
+
+    def self.start_spinner(mensagem)
+      done_flag = false
 
-      # Garante existência do diretório de input
-      FileUtils.mkdir_p("input")
-      puts "📂 Pasta input criada (se necessário)."
+      thread = Thread.new do
+        i = 0
+        until done_flag
+          print "\r#{SPINNER_FRAMES[i % SPINNER_FRAMES.size]} #{mensagem}"
+          sleep(SPINNER_DELAY)
+          i += 1
+        end
+      end
+
+      [thread, -> { done_flag = true }]
+    end
+
+    def self.stop_spinner(thread, stop_proc)
+      stop_proc.call
+      thread.join
+      print "\r"
+    end
+
+    def self.exemplo_txt
+      <<~TXT
+        # language: pt
+        Como um gerente
+        Quero que meus clientes efetue login
+        Para acompanhar o progresso da equipe
+        
+        [SUCCESS]
+        Quando preencho email e senha válidos
+        Então sou redirecionado para o dashboard
+        
+        [FAILURE]
+        Quando informo uma senha incorreta
+        Então recebo a mensagem "Credenciais inválidas"
+        
+        [SUCCESS]
+        Quando tento logar com "<email>" e "<senha>"
+        Então recebo "<resultado>"
+        
+        [EXAMPLES]
+        | email              | senha            | resultado                 |
+        | teste@site.com     | 123456           | acesso permitido          |
+        | errado@site.com    | senhaincorreta   | acesso negado             |
+      TXT
+    end
+
+    def self.exemplo_feature
+      <<~FEATURE
+      # language: pt
+      Funcionalidade: que meus clientes efetue login
+        # Como um gerente
+        # Quero que meus clientes efetue login
+        # Para acompanhar o progresso da equipe
+          @success
+          Cenário: Success
+            Quando preencho email e senha válidos
+            Então sou redirecionado para o dashboard
+             
+      
+          @failure
+          Cenário: Failure
+            Quando informo uma senha incorreta
+            Então recebo a mensagem "Credenciais inválidas"
+      
+          @success
+          Esquema do Cenário: Exemplo 1
+            Quando tento logar com "<email>" e "<senha>"
+            Então recebo "<resultado>"
+      
+            Exemplos:
+              | email              | senha            | resultado                 |
+              | teste@site.com     | 123456           | acesso permitido          |
+              | errado@site.com    | senhaincorreta   | acesso negado             |
+    FEATURE
+    end
+
+    def self.exemplo_step
+      <<~STEP
+        Quando("preencho email e senha válidos") do
+          pending 'Implementar passo: preencho email e senha válidos'
+        end
+        
+        Então("sou redirecionado para o dashboard") do
+          pending 'Implementar passo: sou redirecionado para o dashboard'
+        end
+        
+        Quando("informo uma senha incorreta") do
+          pending 'Implementar passo: informo uma senha incorreta'
+        end
+        
+        Então("recebo a mensagem {string}") do |arg1|
+          pending 'Implementar passo: recebo a mensagem "Credenciais inválidas"'
+        end
+        
+        Quando("tento logar com {string} e {string}") do |arg1, arg2|
+          pending 'Implementar passo: tento logar com "<email>" e "<senha>"'
+        end
+        
+        Então("recebo {string}") do |arg1|
+          pending 'Implementar passo: recebo "<resultado>"'
+        end
+      STEP
+    end
 
-      puts "\n✅ Setup completo! Agora edite o arquivo `.env` e adicione suas chaves de API."
+    def self.exemplo_env
+      <<~ENV
+          ############################################
+          # CONFIGURAÇÃO DE CHAVES DE ACESSO À IA   #
+          ############################################
+          OPENAI_API_KEY={{SUA_CHAVE_OPENAI}}
+          CHATGPT_API_URL={{CHATGPT_API_URL}}
+      
+          ############################################
+          # CONFIGURAÇÃO DE CHAVES DE URI À IA   #
+          ############################################
+          OPENAI_API_KEY={{SUA_CHAVE_OPENAI}}
+          GEMINI_API_URL={{GEMINI_API_URL}}
+      
+          ############################################
+          # MODO DE GERAÇÃO DE CENÁRIOS BDD         #
+          ############################################
+          BDDGENX_MODE=static
+          BDDGENX_LANG=pt
+        ENV
     end
   end
-end
+end

data/lib/bddgenx/support/font_loader.rb

@@ -38,7 +38,7 @@ module Bddgenx
       if arquivos.values.all? { |path| File.file?(path) && File.size(path) > 12 }
         { 'DejaVuSansMono' => arquivos }
       else
-        warn "⚠️ Fontes DejaVuSansMono ausentes ou corrompidas em #{base}. Usando fallback Courier."
+        warn I18n.t('errors.font_fallback', font: base)
         {}
       end
     end

data/lib/bddgenx/support/validator.rb

@@ -22,31 +22,31 @@ module Bddgenx
 
       # Verificação do cabeçalho obrigatório
       unless historia[:como] && historia[:quero] && historia[:para]
-        erros << "❌ Cabeçalho incompleto (Como, Quero, Para obrigatórios)"
+        erros << I18n.t('validator.missing_header')
       end
 
       # Verificação de grupos de passos
       if historia[:grupos].nil? || historia[:grupos].empty?
-        erros << "❌ Nenhum grupo de blocos detectado"
+        erros << I18n.t('validator.no_blocks')
       else
         historia[:grupos].each_with_index do |grupo, idx|
           # Cada grupo deve conter passos ou exemplos
           if (grupo[:passos].nil? || grupo[:passos].empty?) &&
              (grupo[:exemplos].nil? || grupo[:exemplos].empty?)
-            erros << "❌ Grupo #{idx + 1} do tipo [#{grupo[:tipo]}] está vazio"
+            erros << I18n.t('validator.empty_group', index: idx + 1, type: grupo[:tipo])
           end
 
           # Validação específica para blocos de exemplos
           if grupo[:tipo].casecmp('EXAMPLES').zero? &&
              grupo[:exemplos].none? { |l| l.strip.start_with?('|') }
-            erros << "❌ Grupo de EXAMPLES no bloco #{idx + 1} não contém tabela válida"
+            erros << I18n.t('validator.invalid_examples', index: idx + 1)
           end
         end
       end
 
       # Exibe erros e retorna false se houver falhas
       if erros.any?
-        puts "⚠️  Erros encontrados no arquivo:"
+        puts I18n.t('validator.found_errors')
         erros.each { |e| puts "   - #{e}" }
         return false
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bddgenx
 version: !ruby/object:Gem::Version
-  version: 2.4.3
+  version: 2.4.5
 platform: ruby
 authors:
 - David Nascimento
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-17 00:00:00.000000000 Z
+date: 2025-05-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: prawn