Sobre o projeto

Este projeto é para automação de testes da API ServeRest utilizando Robot Framework.

Sumário

• Infra
  • Keywords
  • Libraries
  • Suporte
  • Tests Case
• Mapa Mental das Rotas
  • Mapa PNG
  • Mapa .xmind
• Pré-requisitos
• Execução do Projeto
  • Online
  • Localmente com NPM
  • Executando os testes
  • Executando Libraries personalizadas
• Autor
• Agradecimentos
• Referências

Pré-requisitos

É preciso ter as seguintes tecnologias instaladas:

• Python 3.9.2 🐍
• Robot 5.0.1 🤖

Instalação via pip

É preciso ter o seguinte framework e libraries:

pip install -U robotframework \
robotframework-faker \
robotframework-browser \
robotframework-requests \
pandas \

Execução do Projeto

Os testes podem ser realizados usando diretamente a versão online da ServeRest, via npm ou ainda via docker.

No ambiente online os dados cadastrados são removidos diariamente, enquanto que no local basta reiniciar o ServeRest.

Prefira a opção de ambiente local caso precise que os dados não sejam alterados por outro usuário.

Online

Acesse https://serverest.dev para visualizar a documentação e as rotas disponíveis.

Essa é a melhor opção para quem não possui NPM e Docker na máquina ou não quer preocupar em gerenciar ambiente.

O ServeRest online possui monitoramento constante do status e tempo de atividade para garantir que esteja sempre disponível.

Nesta opção a variável ${BASE_URI} deverá ser:

${BASE_URI}     https://serverest.dev/

Localmente com NPM

Nesta opção a variável ${BASE_URI} deverá ser:

${BASE_URI}     http://localhost:3000

Também deverá ter instalado o node.js

Execute o seguinte comando no terminal:

npx serverest@latest

Executando os testes

Para executar teste abrangendo todas as suites utilize o comando:

robot -d ./reports ./tests

Para executar teste somente de uma suite utilize o comando, escolhendo o nome do arquivo da suite desejada:

robot -d ./reports ./tests/SUITE_DESEJADA.robot

Para executar teste somente de uma tag utilize o comando, escolhendo o nome do arquivo da tag desejada:

robot -d ./reports -i TAG_DESEJADA ./tests/SUITE_DESEJADA.robot

Executando Libraries personalizadas

Para criptograr uma string com sha256, adicione a keyword no Test Case desejado, observando a ${variavel} desejada e rode os testes:

Converter string "${response.content}" para sha256

Para criptograr um dicionario com sha256, adicione a keyword no Test Case desejado, observando a ${variavel} desejada e rode os testes:

Converter dict "${response.content}" para sha256

Para gerar um JSON de uma response, adicione a keyword no Test Case desejado, observando a ${variavel} desejada e rode os testes:

Gerar Json "${response.content}"

Para gerar um CSV de uma response, adicione a keyword no Test Case desejado, observando a ${variavel} desejada e rode os testes:

Gerar CSV "${response.content}"

Autor

Paulo Henrique Conte

Agradecimentos

Agradeço a Compass UOL pela trilha, ensinamentos durante todo o programa e aos evangelistas Larissa Campos, Gabriela A. dos Santos, Matheus Locatelli e Demétrio Webber.

Agradecimento especial aos colegas de squad Laura Gehrke, Manoella Souza, Mari de Oliveira e Pedro Favoreto Gaya.

Referências

• Trilha RoboTron da Compass UOL
• Cursos Robot básico e avançado da Mayara Fernandes