Keep your place in this quest

Log in or sign up for free to subscribe, follow lesson progress, and access more learning content.

Agora que você sabe o que são módulos, vamos dar um passo adiante e falar sobre pacotes em Python.

Um pacote é uma forma de agrupar módulos relacionados dentro de uma única pasta organizada.
Se os módulos são como ferramentas individuais, um pacote é como uma caixa de ferramentas contendo várias ferramentas arrumadas de forma organizada.


O que Define um Pacote?

Um pacote é simplesmente um diretório que contém:

  • Um arquivo __init__.py (mesmo que esteja vazio)
  • Um ou mais arquivos de módulo (.py)
  • Pacotes opcionais (pastas com seu próprio __init__.py)

O arquivo __init__.py é executado quando o pacote é importado.
Ele pode ser usado para configurar importações padrão, definir variáveis ou executar código de inicialização.

Estrutura de Pacote Exemplo

Aqui está um pacote simples chamado mypackage:

mypackage/
__init__.py
module1.py
module2.py

Usando __init__.py para Importações Padrão

Dentro do __init__.py, você pode escolher quais partes do pacote estarão diretamente disponíveis ao importar.

Exemplo — em mypackage/__init__.py:

from .module1 import my_function
from .module2 import another_function

Dessa forma, quando você importa o pacote, pode usar essas funções sem precisar importar cada módulo individualmente.

Importando e Usando o Pacote

Exemplo — em outro arquivo Python:

import mypackage

mypackage.my_function()
mypackage.another_function()

Aqui:

  • import mypackage executa o código em __init__.py.
  • As funções dos módulos module1 e module2 ficam disponíveis porque as importamos em __init__.py.
DICA: Você ainda pode importar módulos específicos de um pacote se preferir:
from mypackage import module1

Por que Usar Pacotes?

Pacotes ajudam você a: • Organizar seu código em seções lógicas. • Reutilizar módulos relacionados em diferentes projetos. • Escalar seus programas à medida que crescem em complexidade.

Seja trabalhando em uma aplicação grande ou apenas mantendo seu código organizado, os pacotes são fundamentais para projetos Python limpos e fáceis de manter.


A seguir, aprenderemos mais sobre importar módulos e pacotes usando diferentes técnicas — e quando escolher cada uma.