bddgenx 2.3.1 → 2.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f6fc74668686947a758772af02a322b5b4cc80ca6f992ac79f53c256746fc60
-  data.tar.gz: 331ec1c98945e65bf99081662f7393789922381a9ae684fa5aa256e8a7aa6c11
+  metadata.gz: b5f895b922c947b8d97296d56a17cfbdc9c31e5bbf6bbfc383c01ebc3e4cfe9d
+  data.tar.gz: 001d68f9b89e12e52e446bc02db6ee249392c864ad1955172dff31203a1a6a6c
 SHA512:
-  metadata.gz: d37b9a635ee34de1f39eab561f48f714423907b30e01531c46af5e5805d6357190d4a5f100c1e4bd8231c79086383fd54487d190c25893df8290c911b6492c5a
-  data.tar.gz: c315c467125e9b4cd9c72cd4c7f72aee8b39430e4209f4ef1117802209bbb25fcd50aa8b96de3bf903719697d6bf0758e92a2fdb8f959d417e493d01ac6efe94
+  metadata.gz: ce291e292b64946fcc493e9a590ef335fc652d321bee8637fdd7b5c30a7d411f34d7a26baf26c2a8f6ea1208fb2c943c11219b07695aa6e87fd7a932677a25a3
+  data.tar.gz: 52710f0f98ba329340956d8e657c09fd802f7f51a34b6437fd692f1e20924db8354a0ed3adcaa29d297461bf566e31fd9dfff54efa9945bbbd719f3f619c4c57

data/README.md

@@ -147,22 +147,82 @@ Bddgenx::Runner.execute
 
 ---
 
+## 📦 Geração manual via Rake
+```Ruby
+require 'rake'
+require 'bddgenx'
+
+namespace :bddgenx do
+  desc 'Executa geração interativa: escolha entre static, chatgpt, gemini ou deepseek'
+  task :generate do
+    puts "=== Qual modo deseja usar para gerar os cenários? ==="
+    puts "1. static (sem IA)"
+    puts "2. chatgpt (via OpenAI)"
+    puts "3. gemini (via Google)"
+    print "Digite o número (1-3): "
+
+    escolha = STDIN.gets.chomp.to_i
+
+    modo = case escolha
+           when 1 then :static
+           when 2 then :chatgpt
+           when 3 then :gemini
+           else
+             puts "❌ Opção inválida. Saindo."; exit 1
+           end
+
+    Bddgenx.configure do |config|
+      config.mode = modo
+      config.openai_api_key_env = 'OPENAI_API_KEY'
+      config.gemini_api_key_env = 'GEMINI_API_KEY'
+    end
+
+    # ⚠️ Limpa o ARGV antes de executar para evitar que [static] seja interpretado como nome de arquivo
+    ARGV.clear
+
+    ENV['BDDGENX_MODE'] = modo.to_s
+    puts "\n⚙️  Modo selecionado: #{modo}\n\n"
+    Bddgenx::Runner.execute
+  end
+end
+```
+
 ## 📝 Formato do Arquivo de Entrada (`.txt`)
 
 ```txt
 # language: pt
 Como um usuário do sistema
-Quero fazer login
-Para acessar minha conta
+Quero fazer login corretamente
+Para acessar minha conta com segurança
+
+[CONTEXT]
+Dado que estou na tela de login
 
 [SUCCESS]
-Quando preencho <email> e <senha>
+Quando preencho email e senha válidos
 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]
-| email            | senha   |
-| user@site.com    | 123456  |
-| errado@site.com  | senha   |
+| campo  | mensagem                  |
+|        | login realizado           |
+|        | credenciais inválidas     |
+| email  | email é obrigatório       |
+| senha  | senha é obrigatória       |
 ```
 
 ---

data/Rakefile

@@ -1,49 +1,36 @@
-# Rakefile
-require_relative 'lib/env'
 require 'rake'
+require 'bddgenx'
 
 namespace :bddgenx do
-  desc 'Inicializar projeto'
-  task :setup do
-    Bddgenx::Setup.inicializar_projeto
-  end
-
-  desc 'Executa a geração BDD usando o modo atual (static, chatgpt, gemini)'
+  desc 'Executa geração interativa: escolha entre static, chatgpt, gemini ou deepseek'
   task :generate do
-    puts "⚙️  Modo de geração: #{Bddgenx.configuration.mode}"
+    puts "=== Qual modo deseja usar para gerar os cenários? ==="
+    puts "1. static (sem IA)"
+    puts "2. chatgpt (via OpenAI)"
+    puts "3. gemini (via Google)"
+    print "Digite o número (1-3): "
 
-    # Evita que ARGV contenha o nome da task (como "bddgenx:static")
-    ARGV.clear
+    escolha = STDIN.gets.chomp.to_i
 
-    Bddgenx::Runner.execute
-  end
-
-  desc 'Gera features no modo estático (sem IA)'
-  task :static do
-    Bddgenx.configure do |config|
-      config.mode = :static
-    end
-    ENV['BDDGENX_MODE'] = 'static'
-    Rake::Task['bddgenx:generate'].invoke
-  end
+    modo = case escolha
+           when 1 then :static
+           when 2 then :chatgpt
+           when 3 then :gemini
+           else
+             puts "❌ Opção inválida. Saindo."; exit 1
+           end
 
-  desc 'Gera features usando ChatGPT'
-  task :chatgpt do
     Bddgenx.configure do |config|
-      config.mode = :chatgpt
+      config.mode = modo
       config.openai_api_key_env = 'OPENAI_API_KEY'
-    end
-    ENV['BDDGENX_MODE'] = 'chatgpt'
-    Rake::Task['bddgenx:generate'].invoke
-  end
-
-  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
+
+    # ⚠️ Limpa o ARGV antes de executar para evitar que [static] seja interpretado como nome de arquivo
+    ARGV.clear
+
+    ENV['BDDGENX_MODE'] = modo.to_s
+    puts "\n⚙️  Modo selecionado: #{modo}\n\n"
+    Bddgenx::Runner.execute
   end
 end

data/VERSION

@@ -1 +1 @@
-2.3.1
+2.3.3

data/lib/bddgenx/generators/runner.rb

@@ -101,15 +101,18 @@ module Bddgenx
         end
 
         # Geração de feature
-        if modo == 'gemini' || modo == 'chatgpt'
+        if %w[gemini chatgpt].include?(modo)
           puts "🤖 Gerando cenários com IA (#{modo.capitalize})..."
           idioma = IA::GeminiCliente.detecta_idioma_arquivo(arquivo)
-          feature_text =
+
+          feature_text = Bddgenx::Support::Loader.run("⏳ Aguardando resposta da IA...") do
             if modo == 'gemini'
               IA::GeminiCliente.gerar_cenarios(historia, idioma)
             else
               IA::ChatGptCliente.gerar_cenarios(historia, idioma)
             end
+          end
+
           if feature_text
             feature_path = Generator.path_para_feature(arquivo)
             feature_content = Bddgenx::GherkinCleaner.limpar(feature_text)
@@ -119,7 +122,9 @@ module Bddgenx
             next
           end
         else
-          feature_path, feature_content = Generator.gerar_feature(historia)
+          feature_path, feature_content = Bddgenx::Support::Loader.run("⛏️  Gerando feature estática...", :dots) do
+            Generator.gerar_feature(historia)
+          end
         end
 
         Backup.salvar_versao_antiga(feature_path)

data/lib/bddgenx/ia/chatgtp_cliente.rb

@@ -55,21 +55,31 @@ module Bddgenx
 
         # Prompt base enviado ao ChatGPT, instruindo a saída no formato correto
         prompt_base = <<~PROMPT
-          Gere cenários BDD no formato Gherkin, usando as palavras-chave de estrutura no idioma \"#{idioma}\":
-            Feature: #{keywords[:feature]}
-            Scenario: #{keywords[:scenario]}
-            Scenario Outline: #{keywords[:scenario_outline]}
-            Examples: #{keywords[:examples]}
-            Given: #{keywords[:given]}
-            When: #{keywords[:when]}
-            Then: #{keywords[:then]}
-            And: #{keywords[:and]}
-
-          Atenção: Os textos e descrições dos cenários e passos devem ser escritos em português, mesmo que as palavras-chave estejam em inglês.
-
-          História:
-          #{historia}
-        PROMPT
+                        Gere cenários BDD no formato Gherkin, utilizando as palavras-chave estruturais no idioma "#{idioma}":
+                          Feature: #{keywords[:feature]}
+                          Scenario: #{keywords[:scenario]}
+                          Scenario Outline: #{keywords[:scenario_outline]}
+                          Examples: #{keywords[:examples]}
+                          Given: #{keywords[:given]}
+                          When: #{keywords[:when]}
+                          Then: #{keywords[:then]}
+                          And: #{keywords[:and]}
+                      
+                        Instruções:
+                        - Todos os textos dos passos devem ser escritos em **português**.
+                        - Use as palavras-chave Gherkin no idioma especificado ("#{idioma}").
+                        - Gere **vários cenários**, incluindo positivos e negativos.
+                        - Use `Scenario Outline` e `Examples` sempre que houver valores variáveis.
+                        - Mantenha os parâmetros como `<email>`, `<senha>` e outros entre colchetes angulares, exatamente como aparecem.
+                        - Se a história fornecer contexto (ex: `[CONTEXT]` ou "Dado que..."), utilize-o como base para os cenários.
+                        - Se não houver contexto explícito, **crie um coerente** baseado na história.
+                        - A primeira linha do resultado deve conter obrigatoriamente `# language: #{idioma}`.
+                        - Evite passos vagos ou genéricos. Use ações claras e específicas.
+                        - Gere apenas o conteúdo da feature, sem explicações adicionais.
+                      
+                        História fornecida:
+                        #{historia}
+                      PROMPT
 
         uri = URI(CHATGPT_API_URL)
         request_body = {
@@ -107,7 +117,10 @@ module Bddgenx
             return fallback_com_gemini(historia, idioma)
           end
         else
-          warn "❌ Erro ao chamar ChatGPT: #{response.code} - #{response.body}"
+          if response.code.to_i == 429
+            warn "❌ Limite de uso da API OpenAI excedido."
+            warn "🔗 Verifique sua conta: https://platform.openai.com/account/usage"
+          end
           return fallback_com_gemini(historia, idioma)
         end
       end

data/lib/bddgenx/ia/gemini_cliente.rb

@@ -46,21 +46,33 @@ module Bddgenx
 
         # Prompt base que instrui a IA a gerar cenários Gherkin no idioma indicado
         prompt_base = <<~PROMPT
-          Gere cenários BDD no formato Gherkin, usando as palavras-chave de estrutura no idioma "#{idioma}":
-            Feature: #{keywords[:feature]}
-            Scenario: #{keywords[:scenario]}
-            Scenario Outline: #{keywords[:scenario_outline]}
-            Examples: #{keywords[:examples]}
-            Given: #{keywords[:given]}
-            When: #{keywords[:when]}
-            Then: #{keywords[:then]}
-            And: #{keywords[:and]}
-
-          Atenção: Os textos e descrições dos cenários e passos devem ser escritos em português, mesmo que as palavras-chave estejam em inglês.
-
-          História:
-          #{historia}
-        PROMPT
+                        Gere cenários BDD no formato Gherkin, utilizando as palavras-chave estruturais no idioma "#{idioma}":
+                          Feature: #{keywords[:feature]}
+                          Scenario: #{keywords[:scenario]}
+                          Scenario Outline: #{keywords[:scenario_outline]}
+                          Examples: #{keywords[:examples]}
+                          Given: #{keywords[:given]}
+                          When: #{keywords[:when]}
+                          Then: #{keywords[:then]}
+                          And: #{keywords[:and]}
+                      
+                        Instruções:
+                        - Todos os textos dos passos devem ser escritos em **português**.
+                        - Use as palavras-chave Gherkin no idioma especificado ("#{idioma}").
+                        - Gere **vários cenários**, incluindo positivos e negativos.
+                        - Use `Scenario Outline` e `Examples` sempre que houver valores variáveis.
+                        - Mantenha os parâmetros como `<email>`, `<senha>` e outros entre colchetes angulares, exatamente como aparecem.
+                        - Se a história fornecer contexto (ex: `[CONTEXT]` ou "Dado que..."), utilize-o como base para os cenários.
+                        - Se não houver contexto explícito, **crie um coerente** baseado na história.
+                        - A primeira linha do resultado deve conter obrigatoriamente `# language: #{idioma}`.
+                        - Evite passos vagos ou genéricos. Use ações claras e específicas.
+                        - Gere apenas o conteúdo da feature, sem explicações adicionais.
+                      
+                        História fornecida:
+                        #{historia}
+                      PROMPT
+
+
 
         unless api_key
           warn "❌ API Key do Gemini não encontrada no .env (GEMINI_API_KEY)"
@@ -101,6 +113,11 @@ module Bddgenx
             texto_limpo.sub!(/^# language: .*/, "# language: #{idioma}")
             texto_limpo.prepend("# language: #{idioma}\n") unless texto_limpo.start_with?("# language:")
 
+            # Garante diretiva de idioma
+            feature_text = Bddgenx::GherkinCleaner.limpar(texto_ia)
+            feature_text.sub!(/^# language: .*/, "") # remove qualquer # language: existente
+            feature_text.prepend("# language: #{idioma}\n") # insere a correta
+
             return texto_limpo
           else
             warn "❌ Resposta da IA sem conteúdo de texto"

data/lib/bddgenx/setup.rb

@@ -0,0 +1,26 @@
+#!/usr/bin/env ruby
+module Bddgenx
+  class Setup
+    def self.inicializar_projeto
+      puts "🔧 Configurando ambiente do projeto BddGenX..."
+
+      # Cria .env a partir do exemplo
+      if File.exist?(".env")
+        puts "✅ .env já existe. Nada a fazer."
+      else
+        if File.exist?(".env.example")
+          FileUtils.cp(".env.example", ".env")
+          puts "✅ .env criado a partir de .env.example"
+        else
+          puts "⚠️ Arquivo .env.example não encontrado. Crie manualmente o .env"
+        end
+      end
+
+      # Garante existência do diretório de input
+      FileUtils.mkdir_p("input")
+      puts "📂 Pasta input criada (se necessário)."
+
+      puts "\n✅ Setup completo! Agora edite o arquivo `.env` e adicione suas chaves de API."
+    end
+  end
+end

data/lib/bddgenx/support/loader.rb

@@ -0,0 +1,31 @@
+module Bddgenx
+  module Support
+    class Loader
+      SPINNERS = {
+        default: %w[| / - \\],
+        dots: %w[⠋ ⠙ ⠹ ⠸ ⠼ ⠴ ⠦ ⠧ ⠇ ⠏]
+      }
+
+      def self.run(mensagem = "⏳ Processando...", tipo = :default)
+        spinner = SPINNERS[tipo] || SPINNERS[:default]
+        done = false
+
+        thread = Thread.new do
+          i = 0
+          print "\n"
+          until done
+            print "\r#{mensagem} #{spinner[i % spinner.length]}"
+            sleep(0.1)
+            i += 1
+          end
+        end
+
+        result = yield
+        done = true
+        thread.join
+        print "\r#{mensagem} ✅\n"
+        result
+      end
+    end
+  end
+end

data/lib/env.rb

@@ -45,7 +45,8 @@ require_relative  'bddgenx/reports/backup'                    # Mecanismo de bac
 require_relative  'bddgenx/reports/tracer'                    # Rastreabilidade dos processos
 
 require_relative 'bddgenx/configuration'                      # Configuração das variaveis de IA
-require_relative '../bin/setup'                               # Verifica estrutura do projeto, caso nao exista cria a nova.
+require_relative 'bddgenx/setup'                               # Verifica estrutura do projeto, caso nao exista cria a nova.
+require_relative 'bddgenx/support/loader'
 
 # Define variável de ambiente global para indicar que o ambiente BDDGENX está em modo desenvolvimento
 ENV['BDDGENX_ENV'] = 'development'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bddgenx
 version: !ruby/object:Gem::Version
-  version: 2.3.1
+  version: 2.3.3
 platform: ruby
 authors:
 - David Nascimento
@@ -135,8 +135,10 @@ files:
 - lib/bddgenx/reports/backup.rb
 - lib/bddgenx/reports/pdf_exporter.rb
 - lib/bddgenx/reports/tracer.rb
+- lib/bddgenx/setup.rb
 - lib/bddgenx/support/font_loader.rb
 - lib/bddgenx/support/gherkin_cleaner.rb
+- lib/bddgenx/support/loader.rb
 - lib/bddgenx/support/remover_steps_duplicados.rb
 - lib/bddgenx/support/validator.rb
 - lib/bddgenx/version.rb