Este repositório contém o projeto desenvolvido durante o curso Testes contínuos em Robot Framework no Github Actions, ministrado por Fernando Papito na plataforma Udemy.
O objetivo é demonstrar a integração de testes automatizados com Robot Framework em um pipeline de CI/CD utilizando o GitHub Actions, incluindo relatórios, métricas e evidências visuais.
Com este setup, é possível garantir que os testes de regressão sejam executados automaticamente a cada alteração no código, proporcionando uma detecção precoce de bugs e um aumento na confiabilidade do sistema.
Clique aqui para expandir as informações sobre o curso
O principal objetivo deste projeto é construir um fluxo de trabalho (workflow) de testes contínuos que:
- 🔄 Automatize a execução dos testes de regressão do Robot Framework.
- ⚙️ Utilize o GitHub Actions para orquestrar o pipeline de testes.
- 📊 Gere relatórios, screenshots e métricas para evidenciar a execução dos testes.
Durante este treinamento, você aprenderá a construir e otimizar um fluxo de trabalho de testes contínuos no GitHub Actions, criando um histórico robusto de testes de regressão, acompanhado de relatórios detalhados e evidências visuais essenciais.
O curso aborda os seguintes conceitos:
- Boas práticas de Testes Contínuos.
- Habilidades de DevOps.
- Boas práticas para a implementação de testes automatizados com Robot Framework.
- Como executar testes de regressão no GitHub Actions.
A execução dos testes com Robot Framework gera relatórios completos e evidências que podem ser acompanhados para garantir a rastreabilidade, análise detalhada e colaboração da equipe.
-
Relatórios Nativos do Robot Framework:
- report.html: Um resumo executivo da execução de testes.
- log.html: O log detalhado da execução, incluindo todos os passos e evidências.
-
Relatórios Automatizados no GitHub:
- Uma ação de relatório de terceiros robotframework-reporter-action, é usada para postar um resumo dos resultados de teste diretamente em cada commit e pull request.
-
Evidências Visuais:
- Captura automática de screenshots na pasta resultados/browser/screenshot em caso de falhas.
Os fluxos de trabalho (workflows) estão configurados no diretório .github/workflows/. Cada arquivo YAML define um pipeline de CI/CD que é ativado automaticamente em eventos de push e pull request nas branches main e develop, além de poder ser executado manualmente.
tests_CI.yml: Workflow principal para integração contínua (CI) com as seguintes funcionalidades:- ✅ Execução em múltiplos navegadores (Chromium, Firefox, WebKit)
- ✅ Execução manual com seleção de navegador específico
- ✅ Geração de relatórios HTML aprimorados
- ✅ Publicação automática de relatórios no GitHub Pages
O workflow pode ser executado manualmente com as seguintes opções:
- Todos os navegadores (padrão)
- Chromium apenas
- Firefox apenas
- WebKit apenas
Os relatórios de teste são automaticamente publicados no GitHub Pages, proporcionando:
- 📈 Visão consolidada de todas as execuções
- 🔗 Links diretos para relatórios HTML de cada navegador
- 📅 Histórico de execuções com informações de commit e branch
- 📱 Acesso mobile-friendly aos relatórios
- Python 3.12+ instalado
- Node.js 22+ instalado
- Dependências Python instaladas:
pip install -r requirements.txt
- Browser Library inicializada:
rfbrowser init
O projeto segue a estrutura padrão do Robot Framework e inclui arquivos de configuração para a integração contínua.
Clique aqui para expandir a estrutura de arquivos
📦 robot-actions/
┣ 📂 .github/
┃ └── workflows/
┃ └── 📜 tests_CI.yml # Workflow principal para execução de testes e GitHub Pages
┣ 📂 resources/
┃ ├── 📜 actions.resource # Palavras-chave de ações e interações
┃ └── 📜 base.resource # Palavras-chave de configuração e utilidades
┣ 📂 resultados/
┃ ├── 📂 browser/screenshot # Screenshots de falhas
┃ ├── 📜 log.html # Log detalhado da execução
┃ ├── 📜 output.xml # Saída em XML para relatórios
┃ └── 📜 report.html # Resumo da execução
┣ 📂 tests/
┃ └── 📜 login.robot # Arquivos de casos de teste
┣ 📜 .gitignore # Arquivos e pastas a serem ignorados pelo Git
┣ 📜 README.md # Documentação principal do repositório
┣ 📜 requirements.txt # Dependências do Python
┣ 📜 robot_config.yml # Configurações centralizadas do Robot Framework
┣ 📜 run_tests.sh # Script Bash para execução local dos testes
┣ 📜 run_tests.py # Script Python para execução local dos testes
┗ 📜 config_parser.py # Parser para configurações YAML
Este projeto foi desenvolvido com as seguintes ferramentas e tecnologias. Certifique-se de que sua máquina atende aos requisitos abaixo para executar os testes.
Clique aqui para expandir as informações
- Python → Linguagem de programação utilizada como base para o Robot Framework.
- Robot Framework → Framework de automação de testes e RPA.
- Node.js → Dependência necessária para utilização da biblioteca Browser Library (Playwright).
- Browser Library (Playwright) → Biblioteca para automação de testes web.
- GitHub Actions → Plataforma de CI/CD para automatizar fluxos de trabalho.
Clique aqui para expandir as informações
- Visual Studio Code → IDE utilizada para desenvolvimento e manutenção dos testes.
- Git → Controle de versão.
- GitHub → Repositório remoto para versionamento e compartilhamento do código.
- Windows Terminal e Prompt de Comando → São as ferramentas de linha de comando (CLI) padrão no Windows.
- Ao instrutor Fernando Papito pelo curso e compartilhamento de conhecimento.
- À comunidade de automação de testes por todo o suporte e inspiração.
- Observações:
- Este repositório é destinado a fins educacionais para demonstrar conceitos da execução de testes automatizados com Robot Framework e o Github Actions.
- Sinta-se à vontade para clonar, modificar e utilizar este código como base para seus próprios projetos.
Feito com ❤️ por Sthefany A. Ricardo.
- Este
README.mdfoi gerado com a assistência de modelos de linguagem como o Google Gemini e o ChatGPT, para garantir clareza, formatação e um conteúdo completo.