🚀 Playwright Test Reviewer - Extensão para VSCode

🔍 Automatize a revisão de código Playwright com inteligência artificial!

📌 Recursos Principais

✅ Análise Inteligente de Código – Identifica boas práticas e melhorias em arquivos Playwright.
✅ Personalização de Prompt – Permite ajustar o prompt para a IA conforme sua necessidade.
✅ Integração com Hugging Face – Suporte a modelos como CodeT5 e CodeLlama.
✅ Interface Intuitiva – Selecione diretórios e arquivos diretamente no VSCode.

🚀 Como Usar?

1️⃣ Defina sua chave API do Hugging Face ou OpenAI
2️⃣ Escolha um diretório de testes e um arquivo Playwright
3️⃣ Clique no botão de revisão para a IA analisar o código
4️⃣ Veja a análise formatada em HTML diretamente no VSCode!

🔑 Gerando um Token de API no Hugging Face

Para usar a IA, você precisa gerar um token de API no Hugging Face.

📌 Passo a Passo

1️⃣ Acesse o site da Hugging Face:
👉 https://huggingface.co/settings/tokens

2️⃣ Clique no botão "New token"

• Escolha um nome para o token (ex: playwright-test-reviewer).
• No campo Scope, selecione "Write" para permitir chamadas à API.
• Clique em "Generate" para criar o token.

3️⃣ Copie o token gerado e salve-o em um local seguro.
⚠️ O token só será mostrado uma vez!

4️⃣ Adicione o token na extensão:

• No VSCode, vá até a extensão e clique em "Atualizar Token".
• Cole o token e pressione Enter.

Agora sua extensão está configurada para usar a IA do Hugging Face! 🎉

🤖 Integração com OpenAI (GPT-4, GPT-3.5, etc.)

Além do Hugging Face, a extensão também suporta modelos da OpenAI, como o GPT-4 ou GPT-3.5-turbo. Isso permite uma análise ainda mais poderosa e precisa dos seus testes Playwright.

📌 Como Integrar com a OpenAI?

1️⃣ Acesse o site da OpenAI:
👉 https://platform.openai.com/account/api-keys

2️⃣ Clique em “Create new secret key”

• Dê um nome para o token (ex: playwright-reviewer)
• Copie o token gerado e salve em um local seguro
  ⚠️ O token só será exibido uma vez!

3️⃣ Na extensão do VSCode:

• Clique em "AI Provider" e selecione OpenAI
• Clique em "Atualizar Token"
• Cole o token gerado e pressione Enter

⚠️ Importante: Para que a API da OpenAI funcione corretamente, você precisa adicionar um método de pagamento válido na sua conta, mesmo que esteja usando a camada gratuita.

Agora sua extensão está pronta para usar os modelos da OpenAI! 🚀

🔧 Personalizando o Prompt da IA

A extensão permite que você modifique o prompt da IA para personalizar a análise do código.

📌 Como Alterar o Prompt?

1️⃣ Acesse as Opções Avançadas na interface da extensão.
2️⃣ Edite o campo "Personalizar Prompt da IA" com seu próprio prompt.
3️⃣ Utilize as variáveis dinâmicas para garantir que a IA sempre receba o conteúdo correto.

📌 Variáveis Disponíveis no Prompt

Você pode usar estas variáveis dentro do seu prompt personalizado:

📌 Exemplo de Prompt Personalizado

Hoje é {timestamp}. Como especialista em testes Playwright, analise o seguinte arquivo de teste e forneça sugestões detalhadas para melhorias.

Código do teste:
{fileContent}

Responda em HTML, estruturando a resposta com:
<h2> para títulos, <p> para parágrafos, <ul> e <li> para listas, e <strong> para destacar pontos importantes.
Não utilize Markdown, apenas HTML válido.

⚠️ Importante sobre Hugging Face: Os modelos disponíveis no Hugging Face, especialmente os de código aberto, funcionam muito melhor com prompts escritos em inglês. Prompts em português podem gerar respostas inconsistentes ou erros inesperados, dependendo do modelo utilizado.