Módulos em Python: Criação, Importação e Uso Avançado

Módulos em Python

Descubra como construir, importar e gerenciar módulos Python. Aprenda boas práticas, técnicas avançadas de importação e caminhos de busca de módulos.

Vídeo: Módulos em Python

Assista a um tutorial aprofundado sobre fundamentos de módulos.

O que são Módulos em Python?

Um módulo é simplesmente um arquivo contendo declarações e definições Python. Por exemplo, exemplo.py é um módulo chamado exemplo. Módulos ajudam a dividir programas grandes em pedaços gerenciáveis e reutilizáveis. Defina funções comuns uma vez e importe onde necessário.

Vamos criar um pequeno módulo. Salve o seguinte como exemplo.py:

# exemplo.py – módulo simples de adição def adicionar(a, b): """Retorna a soma de dois números.""" return a + b 

Como importar módulos em Python

Use a palavra-chave import para trazer um módulo para o namespace atual. Por exemplo:

>>> import exemplo 

Acesse seu conteúdo via operador ponto:

>>> exemplo.adicionar(4, 5.5) 9.5 

Python vem com rica biblioteca padrão. Você pode navegar todos os módulos em Python Standard Library.

Declaração import em Python

# Importa o módulo math padrão import math print("O valor de pi é", math.pi) 

O valor de pi é 3.141592653589793

Importação com renomeação

# Importa math como alias mais curto import math as m print("O valor de pi é", m.pi) 

Renomeação economiza digitação, mas lembre que o nome original (math) não está mais disponível.

Declaração from…import em Python

# Importa apenas a constante pi de math from math import pi print("O valor de pi é", pi) 

Múltiplos nomes podem ser importados em uma linha:

from math import pi, e print(pi, e) 

Importar todos os nomes

from math import * print("O valor de pi é", pi) 

Usar * é desencorajado porque polui o namespace e pode obscurecer de onde um nome veio.

Caminho de busca de módulo Python

Quando Python importa um módulo, ele verifica:

• O diretório atual.
• Diretórios listados na variável de ambiente PYTHONPATH.
• Diretórios padrão específicos da instalação Python.

Inspecione a lista de caminhos com sys.path:

import sys print(sys.path) # ['', 'C:\Python33\Lib\idlelib', 'C:\Windows\system32\python33.zip', ...] 

Recarregando um módulo

Módulos são carregados apenas uma vez por sessão do interpretador. Para reavaliar um módulo alterado, use importlib.reload() (o módulo imp é depreciado no Python 3). Exemplo:

# meu_modulo.py print("Este código foi executado") 

>>> import meu_modulo Este código foi executado >>> importlib.reload(meu_modulo) Este código foi executado 

A função embutida dir()

Use dir() para listar todos atributos de um módulo:

import exemplo print(dir(exemplo)) # ['__builtins__', '__cached__', '__doc__', '__file__', '__name__', 'adicionar'] 

Atributos especiais como __name__ revelam metadados do módulo:

print(exemplo.__name__) # 'exemplo' 

Chamar dir() sem argumentos mostra todos os nomes no namespace atual.