13. Apêndices
13.1. Instalação do Python
O [Python] pode ser baixado em python.org/downloads. Os exemplos e o estudo de caso exigem a versão 3.12 ou superior; eles foram testados com a versão 3.13.
No [Windows], o instalador exibe, na primeira tela, a caixa de seleção “Add python.exe to PATH”: é preciso marcá-la. O comando [python] fica então disponível em todos os terminais. O instalador também instala o launcher [py], que permite escolher uma versão quando há várias instaladas ([py -3.13]). Você também pode usar o gerenciador de pacotes [winget]:
Para o [macOS], use o instalador [.pkg] da mesma página ou o gerenciador de pacotes [Homebrew] ([brew install python@3.13]). No [Linux], o [Python] geralmente já está instalado; verifique a versão e, se necessário, instale o módulo [venv], que cria os ambientes virtuais (no [Ubuntu]: [sudo apt install python3-venv]). No [macOS] e no [Linux], o comando costuma se chamar [python3] (e [pip3]): é ele que se usa para criar o ambiente virtual. Depois que o ambiente é ativado, [python] e [pip] remetem aos do ambiente.
Verifique a instalação em um novo console ([PowerShell], prompt de comando ou terminal):
que deve exibir um número de versão igual ou superior a 3.12 (por exemplo, [Python 3.13.7]). Com uma versão mais antiga, o estudo de caso é interrompido na inicialização por um erro de sintaxe (veja “Problemas comuns”).
13.2. Ambientes virtuais e pip
Um ambiente virtual é uma pasta (no caso, [.venv]) que contém uma cópia do interpretador [Python] e as bibliotecas de um projeto. Cada projeto tem, assim, o seu próprio, nas versões que lhe convêm. A pasta [examples] tem seu próprio ambiente, compartilhado pelos 28 exemplos; o estudo de caso tem o seu.
Comandos úteis, no [Windows] (no [Linux] e no [macOS], [source .venv/bin/activate] para a ativação):
O [pip] baixa as bibliotecas do repositório [PyPI] (pypi.org): é necessária uma conexão com a Internet durante a instalação. Se você estiver atrás de um proxy corporativo, especifique o proxy com a opção [--proxy] do [pip]. O ambiente virtual não pode ser copiado de uma máquina para outra (ele contém caminhos absolutos): é preciso recriá-lo a partir do arquivo [requirements.txt]. É por isso que a pasta [.venv] não está incluída nos materiais do curso.
13.3. Instalação do Visual Studio Code
Baixe o [Visual Studio Code] em code.visualstudio.com. Adicione a extensão Python da Microsoft (menu View / Extensions e, em seguida, pesquise “Python”): ela também instala o [Pylance] (autocompletar, verificação de tipos, relatório de erros) e o Python Debugger. Uma extensão como Better Jinja adiciona realce de sintaxe às views [Jinja2] (arquivos HTML contendo as tags {{ }} e {% %}).
Abra a pasta [examples] ou a pasta do estudo de caso (menu File / Open Folder). A extensão detecta o ambiente virtual [.venv] e pergunta se você quer usá-lo: aceite (também é possível selecioná-lo com o comando Python: Select Interpreter, teclas [Ctrl-Shift-P]). O terminal integrado (menu Terminal / New Terminal) então ativa o ambiente automaticamente, permitindo executar as aplicações sem sair do editor. A tecla [F5], no arquivo [app.py], executa a aplicação sob o controle do depurador (veja “Modo de desenvolvimento”).
13.4. Instalação do MySQL com o Laragon
O [Laragon] (laragon.org) instala um servidor [MySQL] (ou [MariaDB]) pronto para uso, junto com a ferramenta de administração [HeidiSQL]. Após a instalação:
- o botão "Start All" inicia o servidor [MySQL] na porta 3306;
- o usuário [root] não tem senha: esses são os valores padrão do Exemplo 28 ([DATABASE_URL]) e do estudo de caso ([DB_USER], [DB_PASSWORD]);
- o botão Database abre o [HeidiSQL], onde o menu File / Run File SQL executa os scripts [dbpersons.sql] (Exemplo 28) e [dbrdvmedecins2.sql] (estudo de caso).
No [Linux] ou no [macOS], instale o [MySQL] ou o [MariaDB] usando o gerenciador de pacotes do sistema e execute os scripts com o cliente de linha de comando [mysql]. O driver [PyMySQL] funciona com ambos sem nenhuma configuração. No [Linux], a conta [root] do [MariaDB] costuma ser configurada para entrar apenas pela conta de sistema [root] ([sudo mysql]): nesse caso, cria-se um usuário para as aplicações e especifica-se esse usuário na configuração delas:
13.5. Instalação do curl
O [curl] já vem incluído no [Windows] 10 e 11, no [macOS] e na maioria das distribuições [Linux]. No [PowerShell], é preciso digitar [curl.exe], e não [curl]: nas versões mais antigas do [PowerShell], o [curl] é um alias de outro comando ([Invoke-WebRequest]), que tem opções diferentes. No prompt de comando do [Windows] ([cmd]), as aspas de uma string JSON são escritas como [\"] (exemplo 11), e uma URL que contém [&] deve ser colocada entre aspas duplas.