Submódulo 1: Sintaxe básica e ambiente de desenvolvimento em Python

🧭 Organização do código: nomes, imports e como ler erros

Antes de escrever muito código, combinamos algumas regras para que seu código fique legível e profissional. A PEP 8 é o guia oficial de estilo: recomenda snake_case para nomes de variáveis e funções, imports no topo do arquivo e grupos de imports (biblioteca padrão, terceiros, locais) separados por linhas em branco (1). Seguir essas práticas evita confusões em entrevistas e revisões de código.

Exemplo prático: usar uma biblioteca padrão com alias — explico antes do código: queremos calcular a raiz quadrada e deixar claro que usamos o módulo math. Para legibilidade, usaremos um alias curto.

# exemplo_import.py
# Importamos a biblioteca padrão math e usamos o alias 'm'
import math as m  # imports devem ficar no topo do arquivo (PEP 8)

def calcula_distancia(hypotenuse_squared):
    # função em snake_case; entrada é um número
    return m.sqrt(hypotenuse_squared)  # usamos m.sqrt para indicar origem

# Teste rápido (mini-assert)
if __name__ == "__main__":
    resultado = calcula_distancia(9)
    assert resultado == 3.0, "Teste simples deve resultar em 3.0"
    print("OK — cálculo:", resultado)

Erros comuns e como interpretá-los:

• NameError: nome de variável ou função não definido — verifique ortografia e escopo.
• Indentati>: indentação inconsistente — Python usa espaços/indent para estruturar blocos; escolha 4 espaços e não misture com tabs (PEP 8 recomenda 4 espaços). (1)
• ModuleNotFoundError: ao importar, o Python não achou o módulo — verifique nome do módulo, ambiente virtual e caminho (2).