8. Módulos e Pacotes#

À medida que os seus projetos em Python crescem, manter todo o código em um único arquivo torna-se inviável. É aqui que entram os conceitos de Módulos e Pacotes, permitindo a organização, manutenção e reutilização do código.

O que são Módulos e Pacotes?#

  • Módulos: É qualquer arquivo com a extensão .py. Ele funciona como uma caixa de ferramentas que contém funções, variáveis e classes específicas (ex: calculos.py).

  • Pacotes: É uma pasta que contém um ou mais módulos. Em projetos Python, pastas de pacotes costumam conter um arquivo especial chamado __init__.py, que indica ao interpretador que aquela pasta é, de fato, um pacote importável.

Importando Ferramentas#

O Python possui “pilhas incluídas” (a Standard Library), o que significa que muitos módulos já vêm instalados. Para usá-los, empregamos a instrução import seguida pelo nome do módulo desejado.

Existem três formas principais de importar:

  1. Importação Direta: Traz o módulo inteiro.

import math # importando módulo math
print(math.sqrt(25)) # Saída: 5.0
5.0
  1. Importação Seletiva: Traz apenas uma ferramenta específica do módulo.

from math import pi # Importando função pi do módulo math
print(pi) # Saída: 3.141592653589793
3.141592653589793
  1. Importação com Apelido (Alias): Muito comum em Ciência de Dados para economizar digitação.

import math as mt # Importando e apelidando o módulo math como mt
print(mt.sqrt(144)) # Saída: 12.0
12.0

Instalando Bibliotecas Externas#

Nem tudo vem instalado no Python por padrão. Para acessar o vasto ecossistema da comunidade global (PyPI), utilizamos o gerenciador de pacotes PIP.

Para instalar uma biblioteca global usamos o comando pip install seguido pelo nome do pacote que desejamos.

🔴 Importante: Em ambientes interativos como o Google Colab ou Jupyter Notebook, você pode instalar pacotes diretamente em uma célula de código colocando um ponto de exclamação ! antes do comando:

# Executa a instalação no terminal virtual do Colab
# !pip install yfinance (retire a # do inicio para testar)

# Após a instalação, basta importar e usar
# import yfinance as yf (retire a # do inicio para testar)

🎉 Excelente trabalho! Você aprendeu a estruturar seu projeto em múltiplos arquivos e a importar bibliotecas externas. Essa organização é o padrão de mercado para manter a clareza e escalar projetos maiores.