Pré-Requisitos
Python
Para utilizar o Robot Framework e o Poetry (subtópico abaixo), é necessário ter instalado no mínimo a versão 3.6 do Python em sua máquina. No Guia, será utilizado a versão 3.10.5. Para realizar a instalação ou atualização, siga os passos abaixo, de acordo com o seu sistema operacional.
- Windows\Mac
- Acesse https://www.python.org/downloads/release/python-3105/
- Role a tela até o final, até encontrar a seção da imagem abaixo
- Para Windows:
- Faça o Download do Windows Installer (32 bits ou 64 bits)
- Após o Download, execute o instalador e marque a opção "Add Python to Path", para que o instalador adicione automaticamente o diretório onde o Python está instalado ao PATH do sistema operacional.
- Para Mac:
- Faça o Download do macOS 64-bit universal2 installer
- Siga até o final do instalador.
- Após o final da instalação, execute o comando abaixo.
- Para Windows:
python --version
- Para Mac:
python3.10 --version
- O resultado deverá ser igual ao abaixo;
Python 3.10.5
- Linux\WSL
- Abra o terminal
- Caso não tenha, adicione o repositório PPA
sudo add-apt-repository ppa:deadsnakes/ppa
- Atualize o gerenciador de pacotes
sudo apt-get update
- Faça a instalação do Python 3.10.5
sudo apt-get install python3.10.5
- Após o final da instalação, execute o comando abaixo.
python3.10 --version
- O resultado deverá ser igual ao abaixo;
Python 3.10.5
Poetry
Iremos usar o Poetry para ser o nosso gerenciador de dependências e de ambientes virtuais Python. Aqui no RobotCourse, existe um post no blog que fala exatamente sobre "o que é Poetry", além do passo a passo para a instalação. Clique aqui para acessar a postagem.
Intellij
Como dito no tópico anterior, esse Guia usará o IntelliJ IDEA Community Edition como IDE para guiar vocês durante todo o conteúdo prático. Então, caso ainda não tenha essa IDE instalada e também queira utilizar ela, clique aqui.
Iniciando Projeto
Criando projeto com Poetry:
Agora que temos todas as ferramentas necessárias instaladas, podemos iniciar a criação do nosso projeto. Abra o seu terminal no diretório onde deseja criar o novo projeto, e execute os seguintes comandos:
poetry new robot-courses
/
cd robot-corses
Ainda no terminal, dentro da pasta do projeto, execute o comando abaixo para instalarmos a versão 6 do Robot Framework:
poetry add robotframework==6.0.2
Instalando plugins no Intellij
Primeiramente, vamos abrir o Intellij. Ainda no terminal, execute o seguinte comando.
idea .
Agora, precisaremos de dois plugins no Intellij, são eles:
- Python Community Edition
- Esse plugin fará com que o Intellij receba as mesmas funcionalidades do PyCharm.
- Robot Framework Language Server
- Adiciona suporte ao Robot Framework ao Intellij
Para realizar a instalação dos dois plugin, acesse o ícone de engrenagem no lado superior direto da janela e clique em "plugins". Na aba Marketplace, pesquise e instale os dois plugins, como no exemplo abaixo:
Configurando SDK Python
O plugin do Python para Intellij já possui integração nativa com o Poetry, porém ele não identifica o Poetry sozinho, então precisamos configurá-lo. Siga os passos abaixo para realizar a configuração correta do SDK.
Configurando Robot Framework Language Server
Como ultima etapa da nossa configuração, precisamos configurar o Plugin do Robot Framework Language Serve, para que ele passe a conhecer também o Pynthon no ambiente Poetry.
O Robot Framework Language Server, por padrão, busca o interpretador Python que está no seu ambiente local, então, caso você não fala essa etapa, o plugin passará a não reconhecer de forma adequada o código e nem mesmo as bibliotecas instaladas.
Mas para fazer essa configuração é bem simples;
Mas para fazer essa configuração é bem simples;
- Execute o comando abaixo para descobrir o caminho do interpretador Python que está no ambiente virtual isolado do Poetry
- Para Windows
poetry run where python
- Para Linux e Mac
poetry run wich python
Ao executar o comando, você receberá alguns retornos. Abaixo um exemplo com Windows:
(robot-courses-py3.10) PS C:\curso\robot-courses> poetry run where python C:\Users\vinic\AppData\Local\pypoetry\Cache\virtualenvs\robot-courses-x-J0IR0D-py3.10\Scripts\python.exe C:\Users\vinic\AppData\Local\Programs\Python\Python310\python.exe C:\Users\vinic\AppData\Local\Microsoft\WindowsApps\python.exe
No exemplo assim, cada linha representa um interpretador Python localizado em um ambiente diferente. Porém, no contexto do Poetry, o que interessa é o "C:\Users\vinic\AppData\Local\pypoetry\Cache\virtualenvs\robot-courses-x-J0IR0D-py3.10\Scripts\python.exe", onde "x-J0IR0D" é o identificador do ambiente Poetry gerado para o projeto.
Com o interpretador Python gerador pelo Poetry em mãos, precisaremos agora configurar o plugin Robot Framework Language Server, para isso, siga o passo a passo abaixo:
Agora com tudo configurado, já podemos usar o Robot Framework. Para testar se está tudo funcionando como deveria, crie um arquivo de teste na raiz do projeto chamado "hello_world.robot".
Cole esse código dentro do arquivo criado.
*** Test Cases ***
Hello World
Log To Console Hello World!!Abra o terminal e execute o seguinte comando
robot .
O resultado deverá ser igual ao exibido abaixo:
---
Você deve ter se perguntando "NOSSA QUE COMPLICADO", mas não é. Na verdade, ficou um pouco mais extenso do que o convencional usando apenas o PIP para instalar as dependências e já iniciar o desenvolvimento. O problema é que levar convencional para dentro do âmbito coorporativo, geralmente gera problemas, já citados no Post do Poetry.
Aqui você aprendeu a criar um projeto dentro de um ambiente seguro, e principalmente seguindo as diretrizes atuais do Robot Framework Foundation.
Com isso, podemos começar a colocar a mão na massa e ir adiante nos guias práticos.
Se teve alguma dificuldade durante a configuração, deixa aqui nos comentários, que irei te ajudar!
Clique na imagem abaixo para ir para o tópico "Variáveis"
0 Comentários