Para poder contribuir, você precisara configurar um ambiente de desenvolvimento - um lugar onde você pode codificar tendo o mesmo comportamento no ambiente de outras pessoas.

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

Python

Python é uma linguagem interpretada, que está disponível em diversos sistemas operacionais. No entanto, dependendo de qual sistema você estiver usando, sua versão do Python será diferente. Por essa razão, nós especificamos exatamente em qual versão do Python esperamos que o código funcione.

Para as próximas instruções, nós vamos presumir que você sabe exatamente qual versão do Python você precisa instalar. Normalmente isso está listado no arquivo README.md ou no tutorial de informação. Nosso sistema CI deve falar exatamente qual versão do Python é necessária também. Então se você estiver perdido, tente procurar no arquivo .travis.yml ou circle.yml para a versão específica que você precisa.

pyenv

pyenv é uma forma de ter múltiplas versões do Python funcionando na mesma máquina ao mesmo tempo. Ele te permite escolher qualquer versão que você precisa para um projeto em particular.

Uma vez que pyenv esteja instalado, você precisa instalar a versão especifica do Python. Essa informação está guardada em um arquivo .python-version, o que significa que você pode usar diferentes versões do Python em diferentes projetos no seu computador.

Para instalar e configurar uma versão do Python:

$ cd /path/to/your/project
$ pyenv install 3.5.1
$ pyenv local 3.5.1

Mais informações sobre o pyenv estão disponíveis em seu website

virtualenv

Uma vez que Python esteja instalado, você vai querer instalar diferentes pacotes do Python. Já que você pode estar trabalhando em mais de um projeto, e mais de uma versão do Python, ter uma forma de garantir que somente determinados pacotes do Python estejam disponíveis por vez é de grande ajuda.

Uma forma de fazer isso é via virtualenv.

Usando pip, nós podemos instalar o virtualenv.

$ pip install virtualenv

Agora nós queremos configurar uma virtualenv para depois ativa-la. Ter mais de uma virtualenv é ok, mas somente uma pode ser ativada por vez. Tenha certeza que você tenha selecionado seu Python com pyenv, assim nós saberemos qual versão do Python usar.

$ virtualenv -p $(pyenv which python) env

Agora nós podemos ativar o ambiente virtual.

$ source env/bin/activate

Isso vai gerar uma pequena notificação na sua linha de comando para você saber que está em um ambiente virtual.

(env) $

Para desabilitar seu virtualenv.

$ deactivate