Modules | Python

• Modules | Python

# Import básico
import moduleA

# Especificando imports
from moduleB import functionA, classA

# Não é recomendado
from moduleC import *

from packageD import moduleE

PYTHONPATH

O PYTHONPATH é uma variável de ambiente em Python que especifica os diretórios onde o interpretador Python deve procurar por módulos e pacotes quando você usa uma instrução import. Ele permite que você adicione caminhos personalizados para que o Python encontre módulos que não estão nos diretórios padrão.

Como Funciona o PYTHONPATH

Quando você importa um módulo, o Python procura por ele na seguinte ordem:

1. Diretório Atual: O diretório onde o script está sendo executado.
2. Variável de Ambiente PYTHONPATH: Diretórios especificados na variável de ambiente.
3. Diretórios Padrão: Diretórios padrão do sistema, como o diretório de bibliotecas padrão do Python.

Configurando o PYTHONPATH

Você pode configurar o PYTHONPATH de diferentes maneiras:

1. Temporariamente no Terminal

No Windows, você pode definir o PYTHONPATH temporariamente no terminal antes de executar o script:

set PYTHONPATH=C:\meu\diretorio\personalizado
python meu_script.py

No Linux ou macOS:

export PYTHONPATH=/meu/diretorio/personalizado
python meu_script.py

2. Permanentemente no Sistema

Você pode adicionar o PYTHONPATH ao ambiente do sistema para que ele seja carregado automaticamente. No Windows, isso pode ser feito nas configurações de variáveis de ambiente. No Linux/macOS, você pode adicionar ao arquivo ~/.bashrc ou ~/.zshrc:

export PYTHONPATH=/meu/diretorio/personalizado

3. Diretamente no Código

Você também pode modificar o sys.path diretamente no código para adicionar um caminho personalizado:

import sys
sys.path.append("C:/meu/diretorio/personalizado")

Exemplo de Uso

Se você tiver a seguinte estrutura de diretórios:

projeto/
├── meu_modulo/
│   ├── __init__.py
│   └── util.py
└── main.py

E quiser importar util.py no main.py, você pode adicionar o diretório meu_modulo ao PYTHONPATH: