Módulos e pacotes em Python – importando bibliotecas e instalando com pip

Em Python, programas simples podem ser escritos usando apenas as funções básicas da linguagem, mas à medida que os projetos crescem, é essencial reutilizar código e aproveitar bibliotecas prontas. É aí que entram módulos e pacotes.

Neste post, você vai aprender:

• O que são módulos e pacotes

• Como importar bibliotecas padrão do Python

• Como instalar pacotes externos com pip

• Como organizar seu próprio código em módulos e pacotes

• Boas práticas e exemplos práticos

---

1️⃣ O que são módulos e pacotes?

Módulos

Um módulo é um arquivo .py que contém funções, classes ou variáveis. Você pode importar módulos para usar funcionalidades já definidas.

Exemplo de módulo matematica.py:

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

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

No seu programa principal, você pode importar e usar:

import matematica

print(matematica.soma(5, 3))      # 8
print(matematica.subtrai(10, 4))  # 6

---

Pacotes

Um pacote é uma coleção de módulos organizados em pastas, permitindo criar bibliotecas complexas.

Estrutura de um pacote:

meu_pacote/
    __init__.py
    modulo1.py
    modulo2.py

Importando um módulo de um pacote:

from meu_pacote import modulo1

modulo1.funcao_exemplo()

O arquivo __init__.py indica que aquela pasta é um pacote Python.

---

2️⃣ Bibliotecas padrão do Python

Python já vem com muitos módulos úteis instalados por padrão, conhecidos como bibliotecas padrão.

Exemplos:

• math – funções matemáticas avançadas

import math

print(math.sqrt(16))   # 4.0
print(math.pi)         # 3.141592653589793

• random – gerar números aleatórios

import random

print(random.randint(1, 10))  # número aleatório entre 1 e 10

• datetime – manipulação de datas e horários

from datetime import datetime

agora = datetime.now()
print("Data e hora atuais:", agora)

• os – interação com o sistema operacional

import os

print(os.getcwd())  # diretório atual

• sys – informações do sistema e argumentos da linha de comando

import sys

print(sys.version)  # versão do Python

Importar bibliotecas padrão não exige instalação, apenas a palavra-chave import.

---

3️⃣ Instalando pacotes externos com pip

O pip é o gerenciador de pacotes do Python, usado para baixar e instalar bibliotecas de terceiros.

Passos básicos:

1. Verificar se o pip está instalado:

pip --version

2. Instalar um pacote:

pip install nome_do_pacote

Exemplo:

pip install requests

3. Importar no código:

import requests

resposta = requests.get("https://www.python.org")
print(resposta.status_code)  # 200 se sucesso

4. Atualizar um pacote:

pip install --upgrade requests

5. Desinstalar um pacote:

pip uninstall requests

Dica: use ambientes virtuais (venv) para manter dependências isoladas por projeto, evitando conflitos.

---

4️⃣ Criando e usando seu próprio módulo

Você pode criar módulos próprios para organizar funções e classes.

Exemplo:

Arquivo meu_modulo.py:

def saudacao(nome):
    return f"Olá, {nome}!"

def dobrar_numero(n):
    return n * 2

Programa principal:

import meu_modulo

print(meu_modulo.saudacao("Thales"))  # Olá, Thales!
print(meu_modulo.dobrar_numero(5))    # 10

Isso ajuda a separar funcionalidades, deixando o código mais limpo e modular.

---

5️⃣ Boas práticas

1. Organize código em módulos por funcionalidade

   • Ex.: matematica.py, manipulacao_strings.py, arquivos.py

2. Use pacotes para projetos grandes

   • Facilita manutenção e colaboração

3. Prefira bibliotecas padrão quando possível

   • Evita instalar pacotes desnecessários

4. Use ambientes virtuais (venv)

   • Mantém dependências isoladas e evita conflitos entre projetos

5. Documente seu código

   • Use docstrings para explicar funções e módulos:

def soma(a, b):
    """Retorna a soma de dois números"""
    return a + b

---

6️⃣ Exemplos práticos do dia a dia

a) Usando math para calcular áreas

import math

raio = 5
area = math.pi * raio ** 2
print("Área do círculo:", area)

b) Usando requests para baixar conteúdo web

import requests

url = "https://www.python.org"
resposta = requests.get(url)

if resposta.status_code == 200:
    print("Site acessado com sucesso!")

c) Organizando funções em módulos

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

def media(lista):
    return sum(lista)/len(lista)

# arquivo principal
import calculos

print(calculos.soma(10, 5))
print(calculos.media([10, 20, 30]))

---

7️⃣ Exercícios práticos

1. Crie um módulo textos.py com funções para:

   • Converter texto para maiúsculas

   • Contar palavras em uma frase

2. Instale a biblioteca requests e faça um script que verifique se um site está online (status code 200).

3. Use a biblioteca math para criar um script que calcule a hipotenusa de um triângulo usando math.sqrt() e math.pow().

4. Crie um pacote chamado meu_pacote com dois módulos:

   • calculadora.py → funções de soma, subtração

   • saudacao.py → função que recebe o nome do usuário e retorna uma saudação

---

8️⃣ Conclusão

• Módulos → arquivos .py com funções e classes reutilizáveis

• Pacotes → pastas com módulos organizados

• Bibliotecas padrão → já vêm com Python, não precisam instalar

• Pacotes externos → instalados via pip, ampliando as funcionalidades

• Criar seus próprios módulos e pacotes → ajuda na organização e manutenção do código

Com esses conhecimentos, você pode escrever programas mais organizados, reutilizáveis e profissionais, além de explorar milhares de bibliotecas Python prontas para usar.