Agora que aprendemos o que são módulos e pacotes, vamos ver as diferentes formas de importá-los em nossos programas.

Lembre-se:

• Um módulo é um único arquivo Python (.py) contendo código que você pode reutilizar.
• Um pacote é uma coleção de módulos relacionados em uma pasta com um arquivo __init__.py.

O principal objetivo da importação é organizar o código e facilitar a reutilização sem copiar e colar.

Importando um Pacote ou Módulo Inteiro

A forma mais comum de importar é com a palavra-chave import.
Exemplo — importando o módulo embutido math do Python:

import math

Uma vez importado, você acessa suas funcionalidades usando a sintaxe:

nome_modulo.nome_funcao()

Exemplo:

print(math.sqrt(25))  # retorna 5.0

Aqui, math.sqrt() significa “use a função sqrt do módulo math”.

DICA: Essa abordagem mantém seu código claro porque mostra exatamente de onde cada função veio.

Importando uma Função ou Variável Específica

Você também pode importar apenas o que precisa de um módulo usando from ... import ....

Exemplo — importando somente a função sqrt:

from math import sqrt

print(sqrt(25))  # retorna 5.0

Agora podemos chamar sqrt() diretamente, sem escrever math. na frente.

Nota: Isso pode deixar o código mais curto, mas se você importar muitas coisas dessa forma, fica mais difícil saber de onde cada função vem.

Importando Tudo de um Módulo (Não Recomendado)

Você pode importar todas as funções e variáveis de um módulo de uma vez usando *:

from math import *
print(sqrt(25))  # retorna 5.0

Por que isso é desaconselhado:

• Pode sobrescrever variáveis ou funções já existentes sem aviso.
• Deixa pouco claro de qual módulo uma função veio.
• Pode deixar seu programa mais lento se o módulo for grande.

IMPORTANTE!: Evite from module import * a menos que tenha uma razão muito boa e controle todo o código.

Importando com um Apelido

Às vezes, o nome do módulo é longo ou usado com muita frequência no seu código. Você pode dar um apelido mais curto usando as.

Exemplo — importando NumPy com o apelido np:

import numpy as np

x = np.array([1, 2, 3])

Agora você pode chamar as funções do NumPy com np. em vez de numpy.. Isso é uma convenção comum na comunidade Python.

Resumo dos Estilos de Importação

• import module — Claro e explícito; usa o nome completo sempre.
• from module import function — Chamadas mais curtas, mas menos explícitas.
• from module import * — Evite a menos que seja absolutamente necessário.
• import module as alias — Encurta nomes longos mantendo clareza.

Na próxima lição, avançaremos para manipulação de arquivos — lendo e escrevendo dados em arquivos para que seus programas possam lembrar informações mesmo depois de serem encerrados.