Como Importar um Módulo Python Usando Seu Caminho Completo

Python é uma linguagem versátil que permite importar módulos dinamicamente, mesmo que eles não estejam no seu diretório atual ou no caminho do sistema. Isso pode ser particularmente útil quando você quer carregar módulos a partir de caminhos de arquivo arbitrários. Neste post, vamos explorar como importar um módulo Python usando seu caminho completo.

Importando Módulos no Python 3.5+

Se você está usando Python 3.5 ou mais recente, pode usar a biblioteca importlib para importar um módulo de um caminho de arquivo específico. Aqui está um exemplo simples:

import importlib.util
import sys

# Defina o nome do módulo e o caminho
module_name = "module.name"
file_path = "/caminho/para/arquivo.py"

# Crie uma especificação de módulo
spec = importlib.util.spec_from_file_location(module_name, file_path)
# Crie um módulo a partir da especificação
module = importlib.util.module_from_spec(spec)
# Adicione o módulo ao sys.modules
sys.modules[module_name] = module
# Execute o módulo
spec.loader.exec_module(module)

# Agora você pode usar seu módulo
module.MyClass()

Para Python 3.3 e 3.4

No Python 3.3 e 3.4, você pode usar o SourceFileLoader do módulo importlib.machinery:

from importlib.machinery import SourceFileLoader

module = SourceFileLoader("module.name", "/caminho/para/arquivo.py").load_module()
module.MyClass()

No entanto, tenha em mente que este método foi depreciado no Python 3.4.

Para Python 2

Para aqueles que ainda usam Python 2, o módulo imp é a solução:

import imp

module = imp.load_source('module.name', '/caminho/para/arquivo.py')
module.MyClass()

Simplificando Múltiplas Importações de um Pacote

Se você precisa importar múltiplos módulos do mesmo pacote, é mais conveniente adicionar o diretório do pacote ao sys.path:

import sys

# Adicione o diretório contendo seus módulos ao caminho do sistema
sys.path.append('/caminho/para/meus/modulos/')

# Agora você pode importar seus módulos como se estivessem no caminho do sistema
from testcase import TestCase
from testutils import RunTests
from mock import Mock, sentinel, patch

Adicionando um Caminho Permanentemente

Para adicionar um caminho permanentemente ao seu ambiente Python, você pode modificar a variável de ambiente PYTHONPATH. No Linux, você pode adicionar a seguinte linha ao seu arquivo .bashrc:

export PYTHONPATH="${PYTHONPATH}:/caminho/para/meus/modulos/"

Após adicionar a linha, execute source ~/.bashrc no terminal para aplicar as mudanças.

Resumo

Neste post, cobrimos como importar dinamicamente um módulo Python usando seu caminho completo. Examinamos métodos adequados para diferentes versões do Python e discutimos como simplificar o processo de importação para múltiplos módulos de um único pacote. Além disso, abordamos como adicionar permanentemente um caminho de módulo ao seu ambiente Python. Com essas técnicas, você pode gerenciar e importar módulos facilmente de qualquer lugar no sistema de arquivos onde você tenha direitos de acesso.