Executando um script

O Python é um linguagem interpretada, que executa um arquivo linha por linha. Dessa forma, não é necessário compilar o código antes de executá-lo. Basta chamar o interpretador Python e passar o arquivo como argumento.

Eu gosto de organizar meus projetos em uma pasta chamada dev na raiz da minha pasta de usuário. A criação dessa pasta foi tratada no capítulo Windows Subsystem for Linux.

Olá, Mundo

Para os sistemas Linux, basta executar o seguinte comando para criar a pasta dev. O argumento -p é usado para não gerar um conflito. Caso essa pasta já exista, o comando simplesmente não faz nada.

1
mkdir -p ~/dev
2
cd ~/dev

Então, vamos criar dentro dela uma pasta chamada python.

1
cd ~/dev
2
mkdir -p ~/dev/python
3
cd python

Por fim, criemos o arquivo hello.py dentro da pasta python. Seu conteúdo é uma simples chamada da função print, do Python.

1
echo "print('Hello, World!')" > hello.py

Para executar o arquivo, basta chamar o interpretador Python e passar o arquivo como argumento.

1
python3 hello.py
2
# Hello, World!

Terminal com o Zsh, em que se executa o comando para imprimir "Hello, World!" — Execução do script "hello".

Visual Studio Code

Vamos criar um projeto para editar no Visual Studio Code.

Crie uma pasta dentro do diretório python recém-criado chamada hello_person.

1
cd ~/dev/python
2
mkdir -p hello_person

Então, abra o Visual Studio Code nessa pasta.

1
cd ~/dev/python/hello_person
2
code .

Por dentro do VSCode, crie um arquivo chamado main.py e adicione o seguinte código.

1
name = input('Qual é o seu nome? ')
2
print(f'Olá, {name}!')

Abra o terminal do Visual Studio Code e execute o script a seguir. Em teclados de padrão en-US, o atalho para abrir o terminal é Control + Backtick Control + Backtick . Em teclados pt-BR, provavelmente não há um atalho definido. Você pode abrir o terminal pelo menu Terminal > New Terminal.

1
python3 main.py

Visual Studio Code aberto com o script "main" do projeto "hello_person". No terminal integrado, se executa o script. — Execução do script "main" do projeto "hello_person" por dentro do Visual Studio Code.

Nós podemos melhorar a experiência de desenvolvimento no Visual Studio Code instalando algumas extensões.

Perfis

Para não misturar definições de linguagens diferentes, vamos utilizar o recurso de Perfis do Visual Studio Code.

Antes de começarmos, garanta que você definiu que as extensões do perfil Default sejam aplicadas para todos os perfis, como mostrado no capítulo Visual Studio Code. Para fazer isso, selecione cada entrada da lista de extensões e clique no botão Apply Extensions to all Profiles.

Abra o menu de configurações no canto inferior esquerdo da tela. Seu ícone padrão é o de uma engrenagem. Então, selecione a entrada Profiles.

Menu de configuração do Visual Studio Code, em que se seleciona a opção "Profiles". — Abrindo a tela de configuração de perfis do Visual Studio Code.

Clique no botão New Profile, na parte superior esquerda da janela que se abrir. Dê o nome de Python para o perfil. Selecione o ícone de cobra. Então, clique em Create.

Tela de criação de perfil no Visual Studio Code, em que se define o nome "Python" e o ícone de cobra. — Criando perfil para a linguagem Python no Visual Studio Code.

Na imagem acima, ignore o espaço em branco na lista de perfis. Nele, estavam definidos alguns perfis que eu já criei. A fim de não confundir, apaguei-os na edição. Para você, a lista terá apenas o perfil Default.

Agora, abra novamente a lista de perfis e selecione o ícone de check na opção Python. Isso aplicará o perfil criado à pasta atualmente aberta no Visual Studio Code.

Parte do menu de perfis do Visual Studio Code, em que se seleciona o perfil "Python". — Selecionando o perfil "Python" no Visual Studio Code.

Extensões e Configurações padrão

Se abrir o arquivo de configuração do Visual Studio Code pela paleta de comandos, verá que o arquivo estará vazio. Você pode fazer isso executando Control + Shift + P Control + Shift + P e pesquisando por Preferences: Open User Settings (JSON) no menu que se abrir.

Isso ocorre porque o Visual Studio Code cria um arquivo de configuração para cada perfil. Dessa forma, as extensões instaladas e as configurações definidas para um perfil não interferem nos outros.

Arquivo de configurações do perfil "Python" aberto no Visual Studio Code. O conteúdo é vazio. — Arquivo de configurações do perfil "Python" no Visual Studio Code.

Mas e se eu quiser que certas configurações sejam aplicadas a todos os perfis? É para isso que definimos, nas configurações do perfil Default, o atributo "workbench.settings.applyToAllProfiles".

Ele lista as definições que serão aplicadas a todos os perfis. Sempre que você definir uma nova configuração no perfil Default, lembre-se de adicionar o nome dela nessa lista.

Extensões específicas para Python

Agora que entendemos como funcionam os perfis, vamos instalar algumas extensões específicas para a linguagem Python. Garanta que você selecionou o perfil criado para o Python. Se estiver correto, o ícone de configurações no canto inferior esquerdo do VSCode agora será, na verdade, o ícone de cobra que selecionamos.

Recomendo instalar as seguintes extensões:

Configurações específicas para Python

Agora, vamos definir algumas configurações específicas para a linguagem Python.

Copie o conteúdo abaixo e cole no arquivo de configuração do perfil Python. Para abri-lo, execute Control + Shift + P Control + Shift + P e pesquise por Preferences: Open User Settings (JSON).

1
{
2
  "[json]": {
3
    "editor.defaultFormatter": "esbenp.prettier-vscode",
4
    "editor.tabSize": 2
5
  },
6
  "[jsonc]": {
7
    "editor.defaultFormatter": "esbenp.prettier-vscode",
8
    "editor.tabSize": 2
9
  },
10
  "[markdown]": {
11
    "editor.defaultFormatter": "esbenp.prettier-vscode",
12
    "editor.formatOnPaste": true,
13
    "editor.formatOnSave": true,
14
    "editor.tabSize": 2,
15
    "prettier.tabWidth": 2
16
  },
17
  "[python]": {
18
    "editor.formatOnSave": true
19
  },
20
  "cSpell.words": [
21
    "ipynb",
22
    "mealpy",
23
    "minmax",
24
    "mypy",
25
    "ndarray",
26
    "pycache",
27
    "pylance",
28
    "pylint",
29
    "pytest",
30
    "termcolor",
31
    "venv"
32
  ],
33
  "files.exclude": {
34
    "**/__init__.py": true,
35
    "**/__pycache__": true,
36
    "**/.DS_Store": true,
37
    "**/.git": true,
38
    "**/.ipynb_checkpoints": true,
39
    "**/.mypy_cache": true,
40
    "**/.pytest_cache": true,
41
    "**/.venv": true
42
  },
43
  "python.analysis.extraPaths": ["./src"]
44
}

Lembre-se de salvar o arquivo após a edição.

Agora, o Visual Studio Code apresenta uma série de ferramentas para facilitar o desenvolvimento de aplicações em Python.

Script "main" aberto no Visual Studio Code. Ferramentas das extensões estão disponíveis na interface. — Visual Studio Code com funcionalidades para o Python.

Executando e depurando

Para executar ou depurar um arquivo pela interface do Visual Studio Code, basta selecionar o botão Run na barra lateral. Ele apresenta um ícone de play junto ao de um bug. Sua aba também pode ser aberta pelo atalho Control + Shift + D Control + Shift + D .

Então, clique no botão Run and Debug. O VSCode pedirá para selecionar o depurador a ser utilizado. Da lista de opções, escolha Python Debugger.

Menu de seleção de depurador no Visual Studio Code, em que se escolhe o "Python Debugger". — Selecionando o depurador "Python Debugger" no Visual Studio Code.

Então, o Visual Studio Code abrirá uma lista de opções para especificar como executar o programa. Nessa etapa, escolha Python File.

Menu de seleção de como executar o código no Visual Studio Code, em que se escolhe "Python File". — Selecionando como executar o código no Visual Studio Code.

Por fim, o Visual Studio Code abrirá uma janela de depuração, onde você poderá acompanhar a execução do programa linha por linha. Para interagir com o programa, utilize o terminal integrado do Visual Studio Code.

Interface de depuração do Visual Studio Code, em que está aberto o script "main". — Depurando o programa pela interface do Visual Studio Code.