Prepare o ambiente prático de Python
Resumo do laboratório
Ilustração conceitual original (SVG)
| Em resumo | Sua rota |
|---|---|
| Nível e tempo | 100; 20 minutos (estimativa de facilitação) |
| Ação inicial | Localize a raiz de importação da biblioteca antes de escolher um framework de teste. |
| Materiais do aluno | Baixe 02-python.zip |
| Workspace | Abra a raiz do kit extraído; execute a baseline de library relativa a essa raiz |
| Verificação inicial esperada | Os testes unittest existentes são descobertos e passam. |
| Ajuda de configuração | Baixe, extraia, Git local e GitHub opcional |
[!NOTE] Um teste que não consegue importar a aplicação não testou o comportamento dela.
Conceitos · Primeira tarefa · Lista de evidências · Redefinir
Objetivos de aprendizagem
- Selecione o mesmo interpretador no VS Code e no terminal.
- Entenda a raiz de importação e o executor de testes da fixture.
- Mantenha ambientes virtuais e caches na unidade de trabalho selecionada.
Antes de começar
Leia configuração do ambiente. Use um interpretador Python com suporte
e a extensão Python do VS Code. Os testes da biblioteca fornecida usam unittest.TestCase;
o pytest pode executá-los no laboratório de pytest. Não instale pacotes para a linha de base
da biblioteca padrão, a menos que um comando realmente os exija.
Conceitos e casos de uso
| Item | Finalidade |
|---|---|
| Interpretador | Executa o código; sua seleção determina os pacotes disponíveis |
| Ambiente virtual | Mantém separadas as dependências desta fixture |
| Diretório de trabalho | Determina as importações de nível superior e os arquivos relativos |
| Descoberta de testes | Localiza os casos; é diferente de executá-los |
Cenário do exercício
A biblioteca fica em AccelerateDevGHCopilot/library. Suas importações esperam
application_core, console e infrastructure abaixo da raiz de importação atual.
Tarefa 1 - Prepare a cópia isolada
node scripts/prepare-hands-on.js --lab 02-python --destination /Volumes/T9/Dev/oss/workshop-runs/02-python
Abra somente a cópia impressa, selecione o interpretador Python e entre em
library no terminal dela. Registre o interpretador e o diretório de trabalho.
Tarefa 2 - Descubra e execute os testes existentes
python -m unittest discover -s tests -p "test_*.py" -v
- Confirme que nomes reais de testes aparecem.
- Registre os resultados das asserções e o status de saída.
- No editor, use Python: Configure Tests e selecione unittest com
testscomo diretório para esta linha de base. - Se o laboratório posterior de pytest for selecionado, crie
.venvna cópia descartável, instale ali o requisito declarado de pytest e selecione esse interpretador. - Evite a descoberta automática em todo o currículo; ele contém cópias independentes com raízes de importação diferentes.
Verifique seu trabalho
- Terminal e editor usam o interpretador pretendido.
- Os testes são descobertos a partir de
library, não de um diretório sem relação. - Nenhum resultado com zero testes é considerado uma linha de base aprovada.
- Nenhum pacote, ambiente ou cache foi criado no disco do sistema operacional para este workshop.
Solução de problemas
ModuleNotFoundError: application_core geralmente indica uma raiz de trabalho/importação
incorreta. Não espalhe alterações de sys.path pelos testes. Um pacote pytest ausente em uma
linha de base unittest não é motivo para instalar pytest globalmente.
Prática independente
Compare a descoberta do unittest com a coleta do pytest nas mesmas classes TestCase.
Explique por que selecionar ambos os frameworks no VS Code não significa que ambos foram executados.
Restauração
Feche o workspace copiado e restaure somente as preferências alteradas para ele. Mantenha os interpretadores compartilhados e os ambientes virtuais de outros projetos intactos.