3. Configurar um ambiente de desenvolvimento

Aqui mostramos o ambiente de desenvolvimento utilizado para testar os scripts Python gerados pela IA. Esta secção destina-se a principiantes em Python. Se já tiver um ambiente de desenvolvimento Python, ignore esta secção na totalidade e avance para a seguinte.

3.1. Python 3.13.7

Os exemplos neste documento foram testados com o interpretador Python 3.13.7 disponível em |https://www.python.org/downloads/| (agosto de 2025) numa máquina com Windows 10:

Em [1-2], descarregue o executável do instalador do Python e execute-o.

A instalação do Python cria a seguinte estrutura de ficheiros [1]:

Para executar o Python no modo interativo, clique duas vezes em [2]. Aqui está um exemplo de código Python para executar:

O prompt >>> permite-lhe introduzir uma instrução Python que é executada imediatamente. O código digitado acima tem o seguinte significado:

>>> nom="tintin"
>>> print("nom=%s" % nom)
nom=tintin
>>> print("type=%s" % type(nom))
type=<class 'str'>
>>>

Linhas:

1: Inicialização de uma variável. Em Python, não se declara o tipo das variáveis. Estas assumem automaticamente o tipo do valor que lhes é atribuído. Este tipo pode mudar ao longo do tempo;
2: exibição do nome. «name=%s» é um formato de exibição em que %s é um parâmetro formal que denota uma cadeia de caracteres. name é o parâmetro real que será exibido no lugar de %s;
3: o resultado da exibição;
4: exibição do tipo da variável name;
5: A variável name é do tipo class aqui. No Python 2.7, teria o valor <type 'str'>;

Agora, vamos abrir uma consola do Windows:

O facto de termos conseguido digitar [python] em [1] e de o executável [python.exe] ter sido encontrado mostra que ele está no PATH da máquina Windows. Isto é importante porque significa que as ferramentas de desenvolvimento Python serão capazes de encontrar o interpretador Python. Podemos verificar isto da seguinte forma:

Em [1], saímos do interpretador Python;
Em [2], o comando que exibe o PATH para executáveis na máquina Windows;
Em [3], vemos que a pasta do interpretador Python 3.13 faz parte do PATH;

3.2. O IDE PyCharm Community

Para compilar e executar os scripts deste documento, utilizámos o editor [PyCharm] Community Edition, disponível (em agosto de 2025) no URL |https://www.jetbrains.com/fr-fr/pycharm/download/#section=windows|:

Descarregue o IDE PyCharm Community (aqui para Windows) [1-4] e instale-o.

Vamos iniciar o IDE PyCharm. Aparece um painel de configuração:

Clique em [1] para criar um ícone do PyCharm no ambiente de trabalho;
Clique em [2] para abrir qualquer pasta no sistema de ficheiros como um projeto Python;
Em [3], os ficheiros Python terão a extensão .py;
Clique em [4] para avançar para o próximo passo;

A janela seguinte apresenta novamente as opções de configuração [1]:

Em [2], selecione o tema [Light]. O utilizador pode escolher o tema de sua preferência;
Em [3], mantenha o IDE em inglês;
Em [4], mantenha os atalhos do Windows;

Vamos criar o nosso primeiro projeto Python [1-2]:

Isto abre a seguinte janela:

Em [2], introduza o nome da pasta a criar para o projeto;
Em [3], especifique que as diferentes versões do código que serão guardadas serão geridas pelo sistema de controlo de versões Git. O PyCharm permite-lhe utilizar outros;
Em [4-6], especifique que o seu projeto utilizará um ambiente virtual. O ambiente virtual criará uma pasta [.venv] na raiz do projeto. Todos os plugins (pacotes) utilizados pelo seu projeto serão colocados nesta pasta. Isto garante o isolamento entre projetos durante a pesquisa de plugins. O projeto procura os seus plugins apenas dentro do seu próprio ambiente virtual [.venv] e em nenhum outro local, onde poderia encontrar plugins com os mesmos nomes, mas com versões potencialmente diferentes que, por vezes, são parcialmente incompatíveis entre si;

O IDE PyCharm apresenta o projeto criado da seguinte forma:

Em [1-2], a estrutura de diretórios do projeto;
Em [3], a pasta do projeto;
Em [4], a pasta do ambiente virtual do projeto. É aqui que serão instalados os plugins que utilizaremos para o projeto;

Antes de começarmos a programar, vamos aprofundar a configuração do IDE:

Clique em [1] para exibir o menu principal;

Em [1-2], configure o IDE;

Em [1-4], especifique que pretende ver o menu principal acima da barra de ferramentas principal. Não é obrigatório fazer isto. Estamos a fazê-lo aqui para esclarecer as capturas de ecrã incluídas neste documento. Confirme a sua alteração;

A partir de agora, o menu principal é sempre exibido [1]:

Vamos continuar a configurar o IDE:

No canto superior direito da janela do PyCharm, é-lhe oferecida a oportunidade de experimentar a versão Pro do PyCharm. Dependendo da forma como instalou o PyCharm, a versão Pro pode até ter sido instalada automaticamente (2025). Isto adiciona opções de menu adicionais.

Se instalou a versão de avaliação Pro para um período de um mês, verá a mensagem [2] no canto superior direito.

Para garantir a consistência com as capturas de ecrã que se seguem, vou mostrar-lhe como cancelar a versão de avaliação Pro do IDE (pode voltar a ativá-la a qualquer momento):

Em [1-2], gere as suas subscrições do IDE;

Em [1], desative a versão Pro. O IDE irá reiniciar;

Agora vamos configurar o interpretador Python que irá executar o nosso projeto. Lembramos-nos de ter descarregado um numa etapa anterior:

Em [1-3], configure o interpretador Python do projeto;
Em [4], o caminho do interpretador;
Em [5], os pacotes (plug-ins) associados a este interpretador;

Em [4], vamos encontrar o caminho completo para o interpretador que está a ser utilizado:

Em [3], vemos que o interpretador Python utilizado está localizado na pasta do ambiente virtual do projeto [.venv];

É possível alterar o interpretador Python, o que pode alterar os plugins disponíveis para o projeto:

Em [4], adicione um interpretador Python;

Em [5], adicione um interpretador local. O PyCharm irá então procurar o binário [python.exe] no PATH do computador;

Em [1], especifique que o novo interpretador deve utilizar o ambiente virtual existente do projeto [.venv];
Em [2], o IDE sugere a aplicação Python instalada numa etapa anterior como interpretador;
Confirme esta seleção;

Em [4], o novo interpretador;
Em [5], os pacotes aos quais o projeto terá acesso. Esta é a principal diferença resultante da mudança de interpretador. Se gerir vários projetos que utilizam pacotes diferentes, é preferível utilizar os pacotes do ambiente virtual de cada projeto. Desta forma, tem controlo sobre as versões dos plugins que utiliza. Por este motivo, manteremos o interpretador do ambiente virtual:

Vamos aprofundar um pouco mais a configuração:

Em [1-2], entre no modo de configuração da IDE;
Em [3-4], configure as opções do sistema;
Em [5], não solicite confirmação antes de sair do IDE;
Em [6], ao sair do IDE e se houver um processo em execução iniciado pelo código executado, interrompa-o;
Em [7], quando o IDE é iniciado, o último projeto utilizado não é reaberto automaticamente. O utilizador pode escolher o seu projeto;
Em [8], quando o utilizador gere vários projetos ao mesmo tempo, cada projeto tem a sua própria janela;
Em [9], especificámos a pasta predefinida para o nosso projeto;

Agora podemos começar a programar. Vamos começar por criar uma pasta onde colocaremos o nosso primeiro script Python:

Clique com o botão direito do rato no projeto e, em seguida, em [1-3] para criar uma pasta;
Em [4], digite o nome da pasta: ela será criada na pasta do projeto;

A seguir, vamos criar um script Python:

Clique com o botão direito do rato na pasta [bases] e, em seguida, em [1-4]:

Lembre-se de que incluímos o sistema de controlo de versões Git no nosso projeto. Isto foi feito quando criámos o projeto, ao selecionarmos a opção Git. O Git pode criar instantâneos do projeto em diferentes fases do seu desenvolvimento. Aqui, em [1-3], o IDE pergunta-nos se queremos incluir o ficheiro [bases.py] que estamos a criar neste momento no instantâneo. Respondemos que sim [3]. Além disso, marcamos [2] para que isto seja feito automaticamente sempre que um ficheiro for criado. Voltaremos brevemente ao Git um pouco mais tarde;
Em [4-5], o script [bases_01] foi criado e está pronto para ser editado;

Vamos escrever o nosso primeiro script:

Linhas 1, 3: os comentários começam com o símbolo #;
Linha 2: inicialização de uma variável. O Python não declara o tipo das suas variáveis;
Linha 4: saída no ecrã. A sintaxe utilizada aqui é [formato % dados] com:
- formato: nome=%s, em que %s representa o espaço reservado para uma cadeia de caracteres. Esta cadeia de caracteres será encontrada na parte [dados] da expressão;
- dados: o valor da variável [nome] substituirá o espaço reservado %s na string de formato;
Com [1-2], pode reformatar o código de acordo com as recomendações do órgão regulador do Python. Também pode premir Ctrl-Alt-L no teclado;

Na captura de ecrã, pode ver que algum texto está sublinhado. O PyCharm assinala erros ortográficos em comentários e cadeias de caracteres. Refere-se a eles como erros ortográficos. Por predefinição, está configurado para texto em inglês. Para evitar que assinale erros ortográficos em francês, proceda da seguinte forma:

Em [1-2], configure o IDE;
Em [3-6], desative a opção [Revisão] no editor;

Em [7], o realce dos erros ortográficos desapareceu. O script é executado clicando no ícone [8] na barra de ferramentas principal. O resultado é o seguinte:

Em [1-2], abriu-se uma janela de resultados;
Em [3], podemos ver que o código em [bases_01.py] foi executado pelo interpretador Python no ambiente virtual do projeto;
Em [4], o resultado da execução;

Para executar os scripts deste documento, descarregue o código a partir do URL |Gerar um script Python com ferramentas de IA| (nuvem OneDrive) e, em seguida, no PyCharm, proceda da seguinte forma: