personallize 1.3.2

Biblioteca Python com ferramentas essenciais para desenvolvimento de RPA e ML, oferecendo recursos para conexão com bancos de dados, logging e utilitários.

Personallize

Uma biblioteca Python com ferramentas essenciais para desenvolvimento de RPA (Robotic Process Automation) e ML (Machine Learning), oferecendo recursos para conexão com bancos de dados, logging e utilitários.

✨ Funcionalidades

• 🔌 Dialetic: Conexões SQLAlchemy para SQLite, MySQL, PostgreSQL e SQL Server
• 📊 Logging: Sistema de logging simples e avançado
• 🌐 BrowserService (extra opcional): Captura de cookies/token via Playwright e montagem de requests.Session

📋 Requisitos

• Python >= 3.11

📦 Instalação

Com uv (recomendado)

uv add personallize

Com pip

pip install personallize

Para desenvolvimento

uv pip install -e ".[dev]"

🚀 Uso

🔌 Conexão com Banco de Dados

from sqlalchemy import text

from personallize.dialetic.sqlite import SqliteConnection

# SQLite (arquivo; se não passar path, cria por padrão em ./data/<nome_da_pasta>.db)
with SqliteConnection("data/app.db") as db:
    db.session.execute(text("SELECT 1"))

# Acessar engine diretamente
engine = SqliteConnection("data/app.db").get_engine()

📊 Sistema de Logging

from personallize.loggers import ConsoleFormats, FileFormats, LogManager, RetentionOptions

manager = LogManager()

manager.config.console({
    "icon_status": "active",
    "show_debug": True,
    "format": ConsoleFormats.MEDIUM,
    "enqueue": True,
})

manager.config.file({
    "log_file": "logs/my_app",
    "format": FileFormats.FULL,
    "retention": RetentionOptions.ONE_WEEK,
    "rotation": "00:00",
    "enqueue": True,
})

log = manager.get_logger()
log.info("Aplicação iniciada")
log.error("Erro encontrado")

🌐 BrowserService (extra opcional)

Instale com o extra browser:

uv add "personallize[browser]"

from personallize.browser_service import BrowserService

with BrowserService(base_url="https://seu-sistema.com", headless=True) as bs:
    bs.goto("https://seu-sistema.com/login")
    snap = bs.snapshot_auth()
    session = bs.build_requests_session(cookie_domain_filter="seu-sistema.com")

🔧 Desenvolvimento

Executando testes

uv run pytest

Linting

uv run ruff check .

📦 Publicação (PyPI) com uv

uv build
uv publish dist/*

📄 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

👨‍💻 Autor

Miguel Tenório

• Email: [e-mail]
• GitHub: @MiguelTenorio42

🤝 Contribuindo

Contribuições são bem-vindas! Por favor, sinta-se à vontade para submeter um Pull Request.