Tutorial 0 - Vamos nos preparar!

Antes de criarmos nosso primeiro aplicativo BeeWare, precisamos garantir que tenhamos todos os pré-requisitos para executar o BeeWare.

Instalando o Python

A primeira coisa que precisaremos é de um interpretador Python instalado e funcionando.

Se você estiver usando o macOS, uma versão recente do Python já está incluída no Xcode ou nas ferramentas de linha de comando. Para verificar se você já o possui, execute o seguinte comando:

$ python3 --version

Se o Python estiver instalado, você verá o número da versão. Caso contrário, será solicitado que instale as ferramentas de linha de comando para desenvolvedores.

Se estiver usando o Windows, você pode baixar o instalador oficial no site do Python. Recomendamos usar qualquer versão estável do Python a partir da 3.8. Evite versões alpha, beta e candidatas a lançamento, a menos que você esteja realmente familiarizado com essas versões de desenvolvimento.

Distribuições Alternativas do Python

Existem várias maneiras diferentes de instalar o Python. Você pode instalar o Python através do homebrew. Pode usar o pyenv para gerenciar várias instalações do Python na mesma máquina. Usuários do Windows podem instalar o Python pela Windows App Store. Usuários com foco em ciência de dados podem preferir utilizar o Anaconda ou o Miniconda.

Se você estiver usando macOS ou Windows, não importa a forma que usou ao instalar o Python. o importante é ter um interpretador Python operando ao executar o comando python3 no prompt de comando/terminal do seu sistema operacional.

Caso esteja no Linux, é recomendado utilizar o Python fornecido pelo seu sistema operacional. Embora seja possível concluir a maior parte deste tutorial utilizando uma versão não integrada ao sistema, você não conseguirá empacotar sua aplicação para distribuição a outros.

Instale as dependências

Em seguida, instale as dependências adicionais necessárias para o seu sistema operacional:

Para criar aplicativos BeeWare no macOS, é necessário:

  • Git, um sistema de controle de versão. Ele está incluso no Xcode ou nas ferramentas de linha de comando, que você instalou acima.

Configurar um ambiente virtual

Agora vamos criar um ambiente virtual - uma «sandbox» que podemos usar para isolar nosso trabalho neste tutorial de nossa instalação principal do Python. Se instalarmos pacotes no ambiente virtual, nossa instalação principal do Python (e qualquer outro projeto Python em nosso computador) não será afetada. Se bagunçarmos completamente nosso ambiente virtual, podemos simplesmente excluí-lo e começar novamente, sem afetar nenhum outro projeto Python em nosso computador e sem a necessidade de reinstalar o Python.

$ mkdir beeware-tutorial
$ cd beeware-tutorial
$ python3 -m venv beeware-venv
$ source beeware-venv/bin/activate

Se isso funcionou, seu prompt deve estar diferente agora - ele deve ter um prefixo (beeware-venv). Isso indica que você está atualmente no seu ambiente virtual BeeWare. Sempre que estiver trabalhando neste tutorial, certifique-se de que seu ambiente virtual esteja ativado. Se não estiver, execute novamente o último comando (o comando activate) para reativar seu ambiente.

Ambientes virtuais alternativos

Caso esteja usando o Anaconda ou Miniconda, você pode estar mais familiarizado com o uso de ambientes conda. Você também deve ter ouvido falar do virtualenv, um antecessor do módulo venv integrado ao Python. Da mesma forma que as instalações do Python - se você estiver no macOS ou Windows, não importa como você cria seu ambiente virtual, desde que tenha um. Se estiver no Linux, é recomendado usar o venv e o Python do sistema.

Próximos passos

Agora que configuramos nosso ambiente, estamos prontos para criar nossa primeira aplicação BeeWare.