Tutorial definitivo para configurar o ambiente de desenvolvimento Python no Windows

Imagem de Gerd Altmann por Pixabay

Fala pessoas, tudo bem! Estou fazendo esse tutorial de título gigante como um lembrete para o meu eu do futuro. Caso vá usar outro PC ou formate o atual, esse tutorial vai ser útil pra não ter que garimpar todo material na net novamente. Então achei que seria interessante divulgar isso para outras pessoas também. Agora chega de enrolação e vamos colocar a mão na massa!

Parte 1 — Instale programas com Chocolatey

Se você já tem um editor de texto ou IDE instalado pode pular essa parte e ir direto para a Parte 2. Agora se você está configurando sua máquina do zero acompanhe essa parte, você não vai se arrepender.

Um belo dia em um grupo de Python conversa vai conversa vem, o Eduardo Mendes (@dunossauro) — que faz um conteúdo absurdamente ótimo sobre Python — citou uma forma de instalar programas no Windows chamada Chocolatey.

Mas afinal o que é o Chocolatey? Citando o próprio site deles:

Chocolatey is a package manager for Windows (like apt-get or yum but for Windows). It was designed to be a decentralized framework for quickly installing applications and tools that you need.

Em tradução livre: Chocolatey é um gerenciados de pacotes para Windows (como apt-get ou yum mas para Windows). Foi projetado para ser um framework descentralizado para instalar rapidamente as aplicações e ferramentas que você precisa.

Assim, o Chocolatey facilita bastante o processo de instalar programas no Windows. Com ele você não precisa ir no site de cada software, baixar cada um e instalar separadamente. Com apenas uma linha de comando você pode fazer isso! Para maiores informações você pode basta acessar: https://chocolatey.org

Acabada as introduções, vamos ao que interesse. Como instalar o Chocolatey?

Isso é muito simples, basta abrir o prompt de comando como administrador e digitar o seguinte código:

@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"

Para saber se a instalação ocorreu corretamente basta digitar choco no cmd, assim deve aparecer a versão do Chocolatey que foi instalada.

É possível instalar usando o powershell tbm se você preferir: https://chocolatey.org/install

E agora para instalar os programas?

Isso também é bastante simples, acesse o site do Chocolatey e no campo de busca digite o nome do programa que você quer instalar. Entrando na página do programa vai ter a instrução, mas é bastante direto. Por exemplo, para instalar o VsCode, basta digitar no cmd (como administrador):

choco install vscode -y

Inserindo -y antes de instalar o programa ele não vai fazer nenhuma pergunta e prosseguir diretamente com a instalação.

Caso queira instalar vários programas é bem simples também, basta colocar o nome deles com espaço. Abaixo tem um exemplo da instalação do VsCode (melhor editor de texto para programação), Brave (melhor browser) e o Keypirinha (melhor maneira de pesquisar por programas no Windows).

choco install vscode brave keypirinha -y

Para ver os programas instalados é só digitar choco list --local-only no cmd. Uma lista de comandos disponíveis pode ser vista nesse link: https://chocolatey.org/docs/commands-reference

Muito mais simples instalar programas assim, né?

Mas para a parte de desenvolvimento basta instalar o VsCode.

Parte 2 — Habilitando o Windows Subsystem Linux (WLS)

Para quem não sabe, atualmente é possível usar sistemas Linux diretamente dentro do Windows, sem dual boot ou virtual machine. Não você não leu errado. É isso mesmo que eu disse. Noto que desenvolvedores tem uma preferência por Linux ou MacOs, mas alguns gostam dos programas que rodam somente no Windows como Office, então o WLS une o útil ao agradável.

Antes de habilitar o WLS é necessário ativar o modo de desenvolvedor:

Ativar o Modo de desenvolvedor

Após isso, para habilitar o WLS basta seguir o tutorial disponível no site da Microsoft: https://docs.microsoft.com/pt-br/windows/wsl/install-win10

Mas resumidamente, você deve abrir o powershell como administrador e digitar o código:

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

E então é necessário reiniciar o computador.

Agora, é só instalar uma das diversas versões do Linux disponíveis na Microsoft Store. Basta pesquisar por Linux na loja, ou diretamente pelo nome da distro que você quer instalar. No meu caso, vou instalar o Ubuntu mesmo.

Baixar versão do Linux

Após a instalação é só digitar Ubuntu na caixa de pesquisa do windows e abrir o terminal. Na primeira inicialização ele vai pedir um usuário e senha.

Após isso é bom atualizar o Ubuntu digitando no terminal bash:

sudo apt update && sudo apt upgrade

Antes de prosseguir eu vou mudar o estilo do WLS para ficou um pouco parecido com o terminal do Ubuntu, mas não vou entrar em detalhes aqui. Caso queira fazer isso também acesse o ótimo tutorial do @jgarijogarde, disponível em: Make Bash on Ubuntu on Windows 10 Look Like the Ubuntu Terminal.

Mais detalhes sobre o WLS podem ser encontrados também em: Learn About Windows Console & Windows Subsystem For Linux (WSL).

Parte 3 — Configurando WLS

Vou mostrar agora algumas configurações interessantes e importantes que acho necessário realizar no WLS.

A primeira coisa é fazer uma pasta no seu HD para salvar os seus projetos Python. Algo que vi na internet enquanto pesquisava sobre isso é que em hipótese alguma você deve alterar os arquivos linux, mas pode usar o bash para manipular os arquivos Windows. E você vai notar que pelo bash você consegue acessar o drive C:. Para verificar isso digite em sequência o código a seguir:

cd /
cd mnt/
cd c/

Assim, você pode acessar a sua recém pasta de projetos criada da seguinte maneira:

/mnt/c/Users/gabri/Projetos

Observação: veja que o Ubuntu usa barras invertidas.

Para que não seja necessário digitar sempre o o comando para entrar na pasta de projetos, vou adicionar um alias no arquivo .bash_profile. Portanto, digite no terminal o código a seguir.

nano ~/.bash_profile

Quando o arquivo abrir, deve-se colocar o código.

alias ´projetos='cd "/mnt/c/Users/gabri/Projetos"'
projetos

Após editar o arquivo digite ctrl + o e enter para salvar o arquivo e ctrl + x para sair. Além disso, tem que digitar o comando abaixo para ativar o arquivo:

source ~/.bash_profile

Observação: Para ativar as cores da fonte novamente deve editar o arquivo ~/.bash_profile e adicionar linha PS1='\[\033[1;36m\]\u\[\033[1;31m\]@\[\033[1;32m\]\h:\[\033[1;35m\]\w\[\033[1;31m\]\$\[\033[0m\] '.

O bash está pronto para uso e se você digitar python3 no terminal vai ver que ele já vem com o Python instalado que é usado pelo sistema. Mas nunca é uma boa ideia usar o Python do sistema, e é por isso que vou utilizar o pyenv.

Parte 4— Configurando Python no Ubuntu com pyenv

Para configurar o pyenv é bem simples também. Para isso tem um ótimo tutorial no Real Python: Managing Multiple Python Versions With pyenv. Mas vou dar um resumida nas principais partes.

Para instalar o pyenv inicialmente é necessário instalar algumas dependências. Para isso, basta digitar o comando abaixo no bash.

sudo apt-get install -y make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev libffi-dev liblzma-dev python-openssl

Após instalada as dependências o pyenv pode ser instalado com o comando:

curl https://pyenv.run | bash

Isso vai instalar pyenv com alguns plugins uteis:

1. pyenv: A aplicação pyenv propriamente dita
2. pyenv-virtualenv: Plugin parapyenv e ambientes virtuais
3. pyenv-update: Plugin para atualizar o pyenv
4. pyenv-doctor: Plugin para verificar que pyenve dependências estão instaladas.
5. pyenv-which-ext: Plugin para buscar automaticamente comandos do sistema.

Após a instalação, é necessário adicionar o código abaixo no .bash_profile:

export PATH="$HOME/.pyenv/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

Observação: colocar o código acima também no arquivo ~/.bashrc.

Para instalar um aversão do Python usando o pyenv basta digitar o código abaixo no terminal:

pyenv install -v 3.7.4

Você pode ver as versões do Python disponíveis digitando: pyenv install --list.

Após a instalação é possível ver as versões instaladas com o comando pyenv version. O que resulta em:

* system (set by /home/gabriel/.pyenv/version)
  3.7.4

O * indica que a versão do Python ativada atualmente é a do sistema. Então, por padrão está sendo utilizado ainda a versão Python do sistema. Para alterar para a a versão recém instalada basta entrar com o comando: pyenv global 3.7.4.

Para criar um novo ambiente virtual basta entrar na pasta do projeto pelo terminal e entrar com o código abaixo, substituindo pela versão do Python que queira usar e o nome do ambiente (geralmente coloco o mesmo nome da pasta do projeto).

pyenv virtualenv <python_version> <environment_name>

Para ativar e desativar o ambiente são usados os seguintes comandos:

pyenv activate <environment_name>
pyenv deactivate

Para deletar algum ambiente basta entrar com o código a seguir no terminal:

pyenv uninstall <environment_name>

Cansou de tudo isso? Desanima não que estamos quase acabando, agora vamos configurar o VsCode.

Parte 5— Configurando o VsCode

A primeira etapa para trabalhar com o WLS no VsCode é instalar a extensão Remote — WLS. Após instalá-la você pode entrar na pasta do projeto pelo terminal e digitar code . para abrir essa pasta no VsCode. No canto inferior direito você deve ver WLS escrito. Caso contrário, clique nessa região e escolha a opção de abrir pasta com WLS. Pode ser necessário também adicionar uma exceção no firewall para poder acessar o WLS remotamente.

Agora você pode proceder com a instalação das demais extensões que desejar. Só é importante ficar atento ao fato de que elas devem ser instaladas no WLS e não localmente apenas. Observe na figura abaixo que quando as extensões são instaladas no WLS elas aparecem em uma região separada.

As extensões que eu mais gosto e uso são: editor config, git history, indent-rainbow, polacode, project manager, python, rainbow brackets, intellicode e vscode-icons.

Bem, é basicamente isso, quando você inserir um arquivo python nessa pasta, e tiver a extensão python instalada, vai aparecer um opção para selecionar a versão do python e você pode selecionar o seu ambiente virtual (no exemplo abaixo, o meu virtual env chama “teste”).

Bonus — Git

Como bonus ia falar do Git e GitHub, mas pelo o que tudo indica ele já vem instalado no WLS. Porque não precisei instalar e ao digitar git apareceram os comandos. Basta então adicionar uma nova chave ssh. Perfect!

É isso pessoal, sei que o tutorial ficou meio longo, mas tentei ser o mais explicativo possível, até porque futuramente é provável que eu tenha que consultar novamente. Agora a minha máquina está pronta, e posso começar a programar!

Gostou do tutorial? Quer tirar dúvidas e trocar uma ideia? Me chama nas redes sociais:

Twitter: https://twitter.com/gabriel1991

Instagram: https://www.instagram.com/gabrielfonseca1991/

Linkedin: https://www.linkedin.com/in/gabrielfonseca91/

GitHub: https://github.com/gabriel19913