Para começar a contribuir, você precisará configurar um ambiente de desenvolvimento - um local onde você possa trabalhar no código e onde ele possa se comportar da mesma forma que o ambiente de todos os outros.

Muitas partes do BeeWare usam as mesmas ferramentas: uma versão específica do Python, e controles de ambiente virtual.

Python

Python é uma linguagem de script que está disponível em vários sistemas operacionais diferentes. Entretanto, dependendo do sistema que você estiver estiver usando, sua versão do Python será diferente. Por esse motivo razão, especificamos exatamente com qual versão do Python esperamos que o código funcione. funcione.

Para as instruções a seguir, vamos supor que você saiba exatamente qual versão do Python você precisa instalar. Normalmente, isso está listada no arquivo README.md ou nas informações do tutorial. Nosso CI precisam ser informados exatamente qual versão do Python é necessária também. Portanto, se você estiver realmente preso, tente consultar o arquivo .github/workflows/ci.yml para obter a versão específica de que você precisa. versão específica de que você precisa.

Para contribuir com o BeeWare, você precisará ter um interpretador Python instalado em seu computador. No macOS e no Windows, recomendamos recomendamos usar os [instaladores oficiais do Python.org installers] (https://www.python.org/downloads/); no Linux, recomendamos usar a versão do Python fornecida pelo gerenciador de pacotes de sua distribuição.

Ambientes virtuais

Quando o Python é instalado, ele fornece um único ambiente global. Por padrão, se você instalar um pacote, ele será instalado nesse ambiente global. global.

No entanto, se você estiver trabalhando em mais de um projeto Python, é é muito provável que esses vários projetos tenham requisitos diferentes e, em alguns em alguns casos, conflitantes. O que você precisa é de uma maneira de isolar cada projeto de modo que a instalação de um pacote para um projeto não forçar a instalação do mesmo pacote no segundo projeto.

Isso é feito usando Ambientes virtuais. Um ambiente virtual, ou ou venv, é um ambiente isolado que pode ser facilmente criado, destruído ou recriado. Qualquer pacote instalado no ambiente virtual só pode ser acessado acessível dentro desse ambiente virtual. Os ambientes virtuais são às vezes chamados de "sandbox", um lugar seguro para brincar, onde, se você cometer um se você cometer um erro, poderá derrubar tudo o que construiu e começar novamente.

O Python fornece o módulo venv para criar novos ambientes virtuais. Cada ambiente virtual tem um nome que pode ser usado para identificar o ambiente ambiente. Para criar um novo ambiente virtual chamado "my-venv", execute:

$ python -m venv my-venv

A versão do Python que você usa para criar o ambiente virtual será a versão usada por padrão dentro do ambiente virtual. virtual. Se você tiver várias versões do Python instaladas ou estiver estiver usando uma ferramenta como o pyenv para gerenciar as versões do Python, certifique-se de que a versão do versão do Python que está ativa no momento (ou a versão que você referencia ao invocar o comando -m venv) é a versão que você pretende. Depois que um ambiente ambiente virtual tiver sido criado, você não poderá alterar a versão do Python que ele está usando. Para alterar a versão do Python, você precisa criar um novo ambiente virtual.

Invocar -m venv irá criar o ambiente virtual, mas o ambiente ambiente ainda não está ativo. O ambiente virtual é uma coleção de arquivos no disco, armazenados em um diretório que corresponde ao nome do ambiente. Para ativar o ambiente virtual, você executa um dos arquivos arquivos gerados como parte do ambiente:

$ source my-venv/bin/activate

Isso fará com que um prefixo seja adicionado ao prompt da linha de comando informando que você está em um ambiente virtual:

(my-venv) $

Enquanto o ambiente virtual estiver ativo, qualquer comando pip install afetará *afetará somente o ambiente virtual. Não importa se você alterar os diretórios diretórios - se seu prompt tiver um prefixo, esse ambiente virtual está ativo.

Se você abrir uma segunda janela de terminal, o ambiente não estará ativo. ativo - você precisará reativar o ambiente em cada sessão de terminal sessão de terminal em que você deseja usar o ambiente. Se você receber erros sobre bibliotecas não disponíveis que você tem certeza de que instalou verifique se o ambiente virtual está ativo.

Para desativar o ambiente virtual, execute:

(my-venv) $ desativar

Depois de desativado, o prefixo será removido do prompt.