Como Criar Pacotes e Módulos no Python

Aprender a organizar o código é um passo essencial para qualquer pessoa que programe em Python. Quando o programa começa a crescer, fica difícil manter tudo em um único arquivo. É aí que entram os módulos e os pacotes. Eles ajudam a dividir o código em partes menores, organizadas e fáceis de reutilizar. Neste artigo, você vai entender do zero como criar, usar e organizar módulos e pacotes em Python.

Confira também abaixo um vídeo do canal Curso em Vídeo que ensina muito bem sobre o assunto:

O que são módulos em Python?

Um módulo em Python é, basicamente, um arquivo com extensão .py que contém código. Esse código pode ter funções, classes, variáveis ou até mesmo código executável. O objetivo de um módulo é organizar e reutilizar o código.

Por exemplo, imagine que você escreveu várias funções matemáticas. Em vez de copiar e colar essas funções em cada projeto, você pode colocá-las em um módulo e importá-las quando precisar.

Exemplo de módulo simples

Crie um arquivo chamado matematica.py com o seguinte conteúdo:

def somar(a, b):
    return a + b

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

def somar(a, b):
    return a + b

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

Agora, em outro arquivo, você pode usar esse módulo:

import matematica

print(matematica.somar(5, 3))
print(matematica.subtrair(10, 4))

import matematica

print(matematica.somar(5, 3))
print(matematica.subtrair(10, 4))

Resultado:

8
6

Perceba que o arquivo matematica.py virou um módulo reutilizável.

Como funcionam os pacotes em Python?

Um pacote é um conjunto de módulos organizados em pastas. Ele permite agrupar vários módulos relacionados em uma estrutura mais organizada.

Para criar um pacote, basta criar uma pasta com um arquivo especial chamado __init__.py. Esse arquivo indica ao Python que a pasta é um pacote. Mesmo vazio, ele é necessário.

Estrutura de um pacote simples

meu_pacote/
    __init__.py
    matematica.py
    geometria.py

• matematica.py: contém funções matemáticas básicas.
• geometria.py: contém funções relacionadas a formas geométricas.
• __init__.py: indica que essa pasta é um pacote.

Exemplo de código dentro do pacote

Arquivo matematica.py:

def somar(a, b):
    return a + b

def somar(a, b):
    return a + b

Arquivo geometria.py:

def area_quadrado(lado):
    return lado * lado

def area_quadrado(lado):
    return lado * lado

Arquivo __init__.py:

# Pode estar vazio ou importar funções principais

# Pode estar vazio ou importar funções principais

Usando o pacote

Crie um arquivo main.py fora da pasta:

from meu_pacote import matematica, geometria

print(matematica.somar(2, 3))
print(geometria.area_quadrado(4))

from meu_pacote import matematica, geometria

print(matematica.somar(2, 3))
print(geometria.area_quadrado(4))

Resultado:

5
16

Assim, seu código fica muito mais organizado.

Diferença entre módulo e pacote

Um módulo é como uma peça única. Já o pacote é como uma caixa cheia de peças relacionadas.

Como importar módulos e pacotes

Existem várias formas de importar módulos em Python. Vamos ver as principais.

1. Importação simples

import matematica
print(matematica.somar(2, 2))

import matematica
print(matematica.somar(2, 2))

2. Importando apenas uma função específica

from matematica import somar
print(somar(5, 7))

from matematica import somar
print(somar(5, 7))

3. Importando com apelido

import matematica as m
print(m.somar(10, 5))

import matematica as m
print(m.somar(10, 5))

4. Importando todas as funções (não é recomendado)

from matematica import *
print(somar(3, 4))

from matematica import *
print(somar(3, 4))

Criando um pacote com subpacotes

Pacotes podem conter outros pacotes. Isso é útil em projetos grandes.

Estrutura com subpacotes

meu_pacote/
    __init__.py
    matematica/
        __init__.py
        basica.py
        avancada.py

• basica.py: funções simples de soma e subtração.
• avancada.py: funções como potência e raiz quadrada.

Exemplo

Arquivo basica.py:

def somar(a, b):
    return a + b

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

def somar(a, b):
    return a + b

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

Arquivo avancada.py:

import math

def potencia(a, b):
    return a ** b

def raiz_quadrada(a):
    return math.sqrt(a)

import math

def potencia(a, b):
    return a ** b

def raiz_quadrada(a):
    return math.sqrt(a)

Arquivo main.py:

from meu_pacote.matematica import basica, avancada

print(basica.somar(1, 2))
print(avancada.raiz_quadrada(16))

from meu_pacote.matematica import basica, avancada

print(basica.somar(1, 2))
print(avancada.raiz_quadrada(16))

Resultado:

3
4.0

Vantagens de usar pacotes e módulos

• Organização: o código fica dividido em partes claras.
• Reutilização: você pode usar o mesmo módulo em vários projetos.
• Manutenção: é mais fácil corrigir erros em arquivos separados.
• Escalabilidade: projetos grandes exigem pacotes bem estruturados.

Boas práticas na criação de pacotes e módulos

1. Nomes claros: use nomes curtos e descritivos para arquivos e funções.
2. Evite duplicação: não repita código em módulos diferentes.
3. Documente: adicione comentários explicando funções importantes.
4. Teste o código: crie exemplos de uso para garantir que tudo funciona.
5. Estrutura lógica: organize funções relacionadas no mesmo módulo.

Exemplo prático: Criando um pacote de utilidades

Vamos criar um pacote chamado utilidades com funções úteis do dia a dia.

Estrutura

utilidades/
    __init__.py
    texto.py
    numeros.py

Arquivo texto.py:

def contar_palavras(frase):
    return len(frase.split())

def contar_palavras(frase):
    return len(frase.split())

Arquivo numeros.py:

def eh_par(numero):
    return numero % 2 == 0

def eh_par(numero):
    return numero % 2 == 0

Arquivo main.py:

from utilidades import texto, numeros

print(texto.contar_palavras("Python é muito legal"))
print(numeros.eh_par(10))

from utilidades import texto, numeros

print(texto.contar_palavras("Python é muito legal"))
print(numeros.eh_par(10))

Resultado:

4
True

Esse exemplo mostra como um pacote simples já pode ser útil.

Distribuindo seus pacotes

Além de criar pacotes para uso próprio, você pode compartilhar com outras pessoas. O Python possui um repositório oficial chamado PyPI (Python Package Index). É nele que ficam bibliotecas famosas como NumPy e Pandas.

Para publicar seu pacote, você precisa:

1. Criar o pacote com uma estrutura organizada.
2. Adicionar um arquivo setup.py com as informações do pacote.
3. Usar ferramentas como setuptools e twine para enviar ao PyPI.

Esse processo é mais avançado, mas mostra como qualquer pessoa pode contribuir com a comunidade Python.

Quando usar pacotes e módulos?

• Se o projeto é pequeno, um único arquivo pode bastar.
• Se o código começa a ficar grande, divida em módulos.
• Se há muitos módulos, crie um pacote.
• Se o projeto cresce ainda mais, use pacotes com subpacotes.

Dicas para iniciantes

• Comece pequeno: crie primeiro um módulo com duas funções.
• Teste muito: sempre execute seu código para garantir que funciona.
• Aprenda com exemplos: veja pacotes já existentes no GitHub.
• Não complique: só crie pacotes se realmente precisar.

Conclusão

Criar módulos e pacotes em Python é uma habilidade essencial para qualquer programador. Eles trazem organização, reutilização e clareza ao código. Mesmo iniciantes conseguem entender o básico rapidamente e aplicar em projetos reais.

Com o tempo, você pode criar pacotes cada vez mais complexos, até chegar ao ponto de compartilhar suas próprias bibliotecas com a comunidade.

Seja para projetos pequenos ou grandes, dominar módulos e pacotes vai deixar seu código mais profissional e fácil de manter.

Perguntas Frequentes (FAQ)