mmpg-rout 0.2.0

No project description provided

mmpg-rout

Biblioteca Python para gerenciar rotas de host no Windows, útil para cenários em que você precisa garantir que o tráfego para um destino (por exemplo, dlmg.prodemge.gov.br) seja direcionado para um gateway específico (exemplo: 10.14.56.1).

---

📦 Instalação

Você pode instalar a partir do TestPyPI (ou futuramente PyPI oficial):

pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple mmpg-rout

Se estiver desenvolvendo localmente (na pasta do projeto):

pip install -e .

Isso instalará o pacote no ambiente atual (conda/venv/etc.).

---

🚀 Uso no código Python

Exemplo simples:

from mmpg_rout import ensure_host_route

# Cria rota temporária (só até reiniciar)
ensure_host_route("dlmg.prodemge.gov.br", "10.14.56.1")

# Cria rota persistente (fica gravada no Windows)
ensure_host_route("dlmg.prodemge.gov.br", "10.14.56.1", persist=True)

• hostname → domínio ou IP do destino.
• nexthop → gateway da sua rede local.
• persist=True → mantém a rota mesmo após reiniciar.

Integração em projetos que usam ODBC

Basta garantir a rota antes de conectar:

from mmpg_rout import ensure_host_route
import pyodbc

# Garante a rota
ensure_host_route("dlmg.prodemge.gov.br", "10.14.56.1")

# Agora conecta normalmente
conn = pyodbc.connect("Driver={Cloudera ODBC Driver for Impala};...etc...")

Assim, qualquer código que rodar dentro desse ambiente já terá a rota configurada.

---

💻 Uso via CLI (linha de comando)

Após instalar o pacote, o comando mmpg-rout ficará disponível no terminal.

# Rota temporária (só até reiniciar)
mmpg-rout --host dlmg.prodemge.gov.br --nexthop 10.14.56.1

# Rota persistente (precisa rodar PowerShell como administrador)
mmpg-rout --host dlmg.prodemge.gov.br --nexthop 10.14.56.1 --persist

Funcionamento do modo persistente

Se você usar --persist, o Windows salva a rota de forma definitiva. Isso significa que qualquer programa (Python, navegador, ODBC, etc.) que tentar acessar o host especificado sempre usará o gateway configurado, sem precisar alterar o código.

Verificando as rotas atuais:

route print

Removendo uma rota manualmente:

route delete 10.100.62.20

(substitua pelo IP real do host que foi resolvido)

---

🔧 Alterando gateway ou máscara

Se precisar mudar o gateway, basta recriar a rota:

ensure_host_route("dlmg.prodemge.gov.br", "NOVO_GATEWAY", persist=True)

Ou pela CLI:

mmpg-rout --host dlmg.prodemge.gov.br --nexthop NOVO_GATEWAY --persist

A máscara usada é sempre /32 (255.255.255.255) porque a rota é criada para um único host.

---

❌ Desinstalação

Para remover a biblioteca do ambiente Python:

pip uninstall mmpg-rout

Para remover a rota persistente do Windows:

route delete 10.100.62.20

---

📌 Resumo das opções

• No código: garante a rota a cada execução.
• Via CLI (temporário): funciona até reiniciar o PC.
• Via CLI (persistente): fica registrado no Windows e vale para todos os programas.

---

📖 Observações importantes

• Requer execução em Windows.
• Para rotas persistentes, o PowerShell precisa estar aberto como Administrador.
• Expor o host 10.100.62.20 ou o gateway não representa risco de segurança, pois são endereços de rede interna (não roteáveis na internet).

---

👨‍💻 Autor

• Valfrido Novais PMMG · MMPG NOVAIS

Repositório: github.com/ValfridoNovais/mmpg-rout