Exercício – Configurar um ambiente de desenvolvimento
Para começar a escrever a nossa aplicação Flask com o Python, vamos precisar de configurar o nosso ambiente de programação, o que vai exigir a instalação de alguns itens. Felizmente, as ferramentas que vamos utilizar são relativamente comuns e vão ser-lhe úteis para além deste módulo. Até as pode instalar! Vamos utilizar estas ferramentas para programar e testar a aplicação localmente.
Nesta unidade, ficará a saber como instalar ferramentas Python e criar um ambiente Python virtual. Vai instalar o Flask, que é a arquitetura que vamos utilizar para criar o site.
Importante
Neste módulo, vai instalar e configurar uma variedade de pacotes de software e criar um ambiente virtual do Python. Após a ativação do ambiente virtual na janela da Linha de Comandos ou terminal, mantenha a janela ou o terminal aberto. Se fechar a janela ou o terminal, confirme que reinicia o mesmo ambiente virtual do Python na nova janela ou terminal. É importante fazer todo o trabalho no mesmo ambiente virtual do Python que criou no início deste módulo.
Num nível mais elevado, vamos seguir os passos seguintes:
- Instalar o Visual Studio Code (se ainda não estiver instalado)
- Instalar o Python (se ainda não estiver instalado)
- Criar um diretório para o código
- Criar um ambiente virtual
- Instalar o Flask e outras bibliotecas
Instalar o Visual Studio Code
O Visual Studio Code é um editor de código open-source que lhe permite criar praticamente qualquer tipo de aplicação. Conta com um marketplace de extensões robusto, onde pode encontrar suplementos para o ajudar a tornar a sua vida como programador mais fácil.
Instalar o Python
Para concluir esta unidade, deve ter o Python 3.6 ou posterior instalado no computador. Existe uma hipótese de já ter o Python instalado, especialmente se já o tiver utilizado. Pode confirmar se já está instalado ao executar um dos seguintes comandos:
python --version
Se o Python estiver instalado, será apresentado o número da versão. Se você precisar instalar o Python, siga as etapas na documentação Instalar um interpretador Python para Visual Studio Code. Você também precisará instalar a extensão Python do Visual Studio Code.
Importante
Se você estiver usando o Windows, certifique-se de que o local da pasta onde você instalou o Python seja adicionado à sua variável de ambiente PATH. Se ignorar este passo, receberá a mensagem de erro “Python não encontrado”, mesmo após executar a instalação. Para corrigir isso, você precisaria seguir estas etapas para adicionar python à sua variável de ambiente PATH:
- Encontre o diretório com seu arquivo python.exe. Você pode digitar python onde no terminal de prompt de comando para localizar o arquivo python.exe
- Copie o valor do caminho "C:\<python path>", você o adicionará à variável Path na etapa 6
- Clique no menu Iniciar e digite Editar as variáveis de ambiente do sistema, o que abre uma janela Propriedades do sistema.
- Na guia Avançado, clique no botão Variáveis de ambiente.
- Sob as variáveis de usuário, clique duas vezes na variável chamada Path, que aparecerá uma janela com uma lista de caminhos
- Clique em Novo e cole no caminho copiado.
- Uma vez inserido, clique em Ok e Python agora deve ser acessível a partir de qualquer local no seu computador
Nota
Para verificar se a configuração do caminho foi bem-sucedida, abra um novo terminal de prompt de comando e digite python para ver as informações da versão do python. Caso ainda não consiga executar um comando python, reinicie o computador para que as alterações sejam efetuadas.
Criar o diretório de projeto
Crie um diretório na localização que preferir. Este diretório será o diretório do projeto e conterá todo o código que vamos criar. Pode criar um diretório a partir de um comando ou de uma janela do terminal com um dos seguintes comandos:
# Windows, macOS or Linux
mkdir contoso
cd contoso
Importante
Mantenha aberto o comando ou a janela do terminal durante todo o módulo.
Criar um ambiente virtual do Python
Um ambiente virtual do Python não é necessariamente tão complexo quanto parece. Em vez de criar uma máquina virtual ou um contentor, um ambiente virtual é uma pasta que contém todas as bibliotecas necessárias para executar a aplicação, incluindo o runtime do Python em si. Ao utilizar um ambiente virtual, tornamos as aplicações modulares, o que nos permite mantê-las separadas uma da outra e evitar problemas de versão. Como melhor prática, deve sempre utilizar ambientes virtuais ao trabalhar com o Python.
Para utilizar um ambiente virtual, vamos criá-lo e ativá-lo. Vamos criá-lo com o módulo venv
, que instalou anteriormente como parte das instruções de instalação do Python. Quando o ativarmos, indicamos ao nosso sistema que deve utilizar a pasta que criámos para todas as necessidades do Python.
# Windows, macOS or Linux
# Create the environment
python -m venv venv
O processo de criação de um ambiente virtual pode levar alguns segundos. Aguarde até que o prompt do terminal apareça novamente antes de ativar o ambiente.
# Windows
# Activate the environment
./venv/scripts/activate
# macOS or Linux
# Activate the environment
source ./venv/bin/activate
Instalar o Flask e outras bibliotecas
Com o ambiente virtual criado e ativado, podemos agora instalar o Flask, a biblioteca necessária para o nosso site. Vamos instalar o Flask ao seguir uma convenção comum, que é criar um ficheiro requisitos.txt. O ficheiro requisitos.txt não é especial por si só; é um ficheiro de texto onde listamos as bibliotecas necessárias para a nossa aplicação. Mas faz parte da convenção normalmente utilizada pelos programadores e facilita a gestão de aplicações onde numerosas bibliotecas possuem dependências.
Durante os exercícios posteriores, vamos utilizar algumas bibliotecas, incluindo pedidos (para chamar o Serviço de tradução) e Python-dotenv (para gerir as nossas chaves). Embora ainda não sejam necessárias, vamos tornar a nossa vida um pouco mais fácil ao instalá-las agora.
No comando ou na janela do terminal, execute o seguinte comando para abrir o diretório no Visual Studio Code:
code .
No Visual Studio Code, na janela do Explorer, selecione Novo arquivo ao lado do diretório contoso
Nomeie os requisitos de arquivo .txt e adicione o seguinte texto:
flask python-dotenv requests
Guarde o ficheiro ao clicar em Ctrl-S ou Cmd-S no Mac
Regresse ao comando ou à janela do terminal e execute a instalação com o pip para executar o seguinte comando:
pip install -r requirements.txt
O comando transfere as bibliotecas e dependências necessárias.
Nota
Se a versão do pip não for a mais recente, poderá receber uma mensagem de erro. Siga as instruções na mensagem de erro para realizar a atualização. A atualização não é necessária para este módulo.
Parabéns! Configurou o ambiente de programação!