Módulos e Pacotes em Linguagem Python

Por Ricardo Costa Val do Rosario e ChatGPT 4.0

Quando iniciamos nossos estudos em Python, geralmente todo o código está em um único arquivo. 

Isso funciona em projetos pequenos, mas se torna inviável conforme o projeto cresce. 

É aí que entram os módulos e pacotes, que ajudam a manter o código organizado, limpo e escalável.

O que são Módulos e Pacotes?

Módulo

• É um arquivo Python (.py) que contém funções, classes e instruções.

• O nome do módulo corresponde ao nome do arquivo (sem o .py).

• Vantagens: permite reutilizar código, evitar repetições e manter a lógica separada.

Exemplo de módulo:

Um arquivo chamado calculadora.py com funções como soma() e subtrai():

Python Copy

# calculadora.py
def soma(a, b):
    return a + b

def subtrai(a, b):
    return a - b

Esse módulo pode ser importado em outros arquivos:

Python Copy

from calculadora import soma
print(soma(3, 5))  # Saída: 8

Pacote

• É um diretório que agrupa módulos relacionados.

• Para ser reconhecido como pacote, o diretório deve conter um arquivo __init__.py (pode estar vazio).

• Permite criar uma estrutura hierárquica no projeto.

Exemplo de pacote:

Estrutura:

makdown Copy

utils/
 ├── __init__.py
 ├── math_utils.py
 └── string_utils.py

Conteúdo do math_utils.py:

Python Copy

def quadrado(x):
    return x * x

Uso no projeto:

Python Copy

from utils.math_utils import quadrado
print(quadrado(4))  # Saída: 16

Por que organizar em módulos e pacotes?

Facilita a manutenção e leitura do código

Torna a colaboração mais simples

Aumenta a reutilização e escalabilidade do projeto

Dicas finais

Comece organizando seu código em módulos mesmo em projetos menores;

Use pacotes para agrupar funcionalidades similares;

Nomes claros e diretos para seus módulos e pacotes ajudam toda a equipe.