- Módulos: Arquivos
.py
individuais que agrupam funcionalidades relacionadas.
- Pacotes: Diretórios que organizam coleções de módulos relacionados (e subpacotes) em uma estrutura hierárquica.
__init__.py
: Arquivo especial dentro de um diretório que o identifica como um pacote. (Boa prática, mesmo não sendo estritamente necessário em Python 3.3+). Pode conter código de inicialização do pacote e controlar o que é exportado.
__all__
: Lista em __init__.py
que define explicitamente os nomes a serem importados com from pacote import *
.
- Importações: A instrução
import
é a forma fundamental de trazer código de módulos e pacotes para o escopo do seu script.
- Boas Práticas:
- Estrutura lógica e responsabilidades claras para módulos e pacotes.
- Nomenclatura consistente (PEP 8).
- Gerenciamento cuidadoso das importações (evitar
import *
, ordem e agrupamento).
- Uso consciente de
__init__.py
e __all__
.
- Documentação clara (docstrings e comentários).