python-tools

Caixa de ferramentas reutilizável (Python). Toda ferramenta/scriptzinho útil vai pra cá pra reusar no futuro — sem precisar recriar.

Estrutura

python-tools/
├── toolkit/        # biblioteca modular (importável) — veja toolkit/README.md
├── examples/       # exemplos de integração entre os módulos
├── requirements.txt
├── bcrypting.py        # legado: hash/verify bcrypt
└── create-pass-md5.py  # legado: gera senha forte + MD5

toolkit/ — módulos (sem segredos no código; tudo por parâmetro/ENV)

Módulo	O que faz	Deps
proc	run (captura), stream (linha a linha ao vivo), stream_sse (Server-Sent Events)	stdlib
ssh	classe SSH (run/put/get + get_resilient com resume/retry) + run_on_hosts	paramiko
mysql_db	query/exists/execute — sempre parametrizado (anti SQL injection)	mysql-connector / PyMySQL
docker_fleet	containers/container_ips/ip_range/exec_in/control/fleet_exec	docker
netcheck	ping/port_open/http_ok	stdlib (+requests opcional)
watchdog	is_running/watch (religa serviço caído) / prune_old_files (limpa por idade)	stdlib
config	load_ini/env(required)/mask	stdlib
crypto	hash_senha/conferir_senha/gerar_senha/read_keepass	bcrypt / pykeepass
archive	zip_file/zip_dir/unzip/md5_file/recombine_parts (junta split validando MD5)	stdlib
logutil	escrever_log/FileLogger (log em arquivo com timestamp)	stdlib
github_backup	backup_repo (clona repo de org/user + zip; token por ENV)	git (+PyGithub opcional)
pfsense	PFSenseBackup/backup_config (exporta config XML do pfSense via webGUI)	beautifulsoup4

Detalhes em toolkit/README.md. Exemplos em examples/: sse_script_panel.py (painel web SSE), fleet_update.py (update de frota), uptime_monitor.py.

Uso

pip install -r requirements.txt   # instale só o que for usar

from toolkit.proc import stream
from toolkit import ssh, mysql_db, docker_fleet

Princípios

1. Zero segredo no código — parâmetro ou variável de ambiente.
2. Módulos independentes — use um sem arrastar os outros.
3. Queries parametrizadas; docker exec em vez de SSH-no-container; chave SSH > senha.

---

Sintaxe básica (cheatsheet Markdown)

Markdown	Resultado
# Título	Título grande
## Subtítulo	Título médio
**negrito**	negrito
*itálico*	itálico
- Item	Lista
código entre crases	Bloco de código
[Texto](URL)	Link