Importação de Módulos em Python

Pode-se utilizar duas maneiras distintas para importação de módulos em Python, são elas: import e from. Basicamente, provêem as mesmas funcionalidades, só que, com algumas pequenas diferenças:

• import: a instrução import traz o módulo como um todo. Tal característica faz com que seja preciso qualificar um atributo em sua busca.
• from: a instrução from realiza uma cópia de nomes de um módulo não necessitando de qualificar um atributo.

Nota: Tome o módulo employee.py como parâmetro para o restante da postagem. Tal módulo contém apenas duas funções sem nenhuma funcionalidade real.

# !/usr/bin/env python

# MODULE: employee -> file module reponsible for tasks to employees
# AUTHOR: Jose Mauro da Silva Sandy - http://informacaocomdiversao.blogspot.com
#
# CONTACT: jmsandy_at_gmail_dot_com
#
# DATE: 2008-12-26
#
# This is a fictitious example.
# The correct way to implement this module would be using class.
###############################################################################

# Arguments 1. percentage increase
#           2. salary
# result    wage hike
#
def salary_inc(perc=0, salary=0):
   return (salary + ((salary / 100) * perc))

# Arguments 1. list employee
# result    sum of number of employee
#
def sum_emp(list_emp=[]):
   return len(list_emp)

Instruções: import vs. from

Import

Quando importado, o módulo employee.py, passa a ser uma variável no script que o importa. Como apresentado, a instrução import traz um módulo como um todo, logo precisa-se utilizar o módulo importado para qualificar seus atributos.

import employee
print employee.salary_inc(10, 1500), " - ", employee.sum_emp()

Note que foi necessário fornecer o nome do módulo importado para se obter acesso as funções(atributos) e que com essa simples importação obteve-se ingresso a TODOS os seus atributos.

from e from *

Ao contrário do import, a instrução from copia nomes de um arquivo de módulo. Devido a isso não é necessário informar o nome do módulo que foi importado.

from employee import salary_inc
print salary_inc(10, 1500)

Observe que o único atributo importado pela instrução from, foi salary_inc, logo não será possível ter acesso a nenhum outro atributo do módulo. Para conseguir ingresso aos demais atributos torna-se indispensável utilizar a instrução from *, como abaixo:

from employee import *
print salary_inc(10, 1500), " - ", sum_emp()

Nota: Caso haja a curiosidade de executar o print usado no primeiro exemplo(import) em from omitindo o objeto importado, verá que acontecerá um erro em tempo de execução, pois o interpretador não encontrará a variável sum_emp().

Detalhes importantes na construção de módulos

Antes que qualquer atributo presente em um módulo possa ser acessado, o mesmo deve ter sido importado por uma das instruções acima citadas. É importante ressaltar, que para um arquivo ser importado é preciso que o módulo esteje no caminho de pesquisa e também possua a extensão .py, pois todos os arquivos com extensão diferente ou ausente são desconsiderados, causando assim erro de execução.

Uma vez carregado, os módulos em execução não sofrem nenhum mudança a menos que sejam recarregados. Tal episódio não reflete muito a realidade e fica apenas a termo de conceituação. Para recarregar um módulo é preciso que este tenha sido carregado previamente com sucesso, usa-se a função interna reload(module) para realizar esse processo. Este recarregamento trabalha de forma diferente para as instruções import e from. Em import, todas as mudanças alteradas são refletidas imediatamente em todos os clientes que importem o módulo, já na instrução from, os clientes não serão atingidos pois tal instrução trabalha com cópias para os atributos do módulo.

José Mauro da Silva Sandy

---

Referências

• MARK, Lutz. ASCHER, David. Aprendendo Python. Tradução João Tortello. 2. ed. Porto Alegre : Bookman, 2007.

Série Módulos em Python

• Visão Geral de Módulos em Python - Funcionamento básico e pesquisa de um módulo

Leia Também

• Funções Anônimas: LAMBDA - Apresentação de umas das principais funções de programação funcional de Python.
  
• Resposta ao Algoritmo de Luhn - Tratamento e validação de Cartões de Crédito.