josias 0.1.0

Biblioteca Python de automação web com Selenium e visão computacional.

Josias

Biblioteca Python para automação web com Selenium e visão computacional — simples, limpa e pronta para escalar.

Parte do ecossistema Josias, uma plataforma completa de automação RPA.

Instalação

pip install josias

# Com OCR (requer Tesseract instalado no sistema)
pip install josias[vision]

# Desenvolvimento local
pip install -e ".[dev,vision]"

Pré-requisitos

• Python 3.10+
• Google Chrome, Firefox ou Edge
• Tesseract OCR — necessário apenas para recursos de OCR

Uso rápido

from josias import Josias

with Josias() as bot:
    bot.open("https://example.com")

    # DOM — seletores CSS simples
    bot.click("#login")
    bot.type("#email", "[e-mail]")
    bot.type("#password", "senha123", submit=True)

    # Esperas
    bot.wait_for("#dashboard")

    # Visão computacional (OCR + imagem)
    bot.click_text("Confirmar")
    bot.click_image("assets/botao_ok.png")

Seletores

Formato	Exemplo	Descrição
CSS (padrão)	"#login", ".btn"	Seletor CSS
XPath	"xpath://button"	XPath explícito
ID	"id:username"	Por atributo id
Texto	"text:Entrar"	Por texto visível na página

Configuração

from josias import Josias, Config, VisionConfig
from josias.types import Browser

config = Config(
    browser=Browser.CHROME,
    headless=True,
    window_size=(1920, 1080),
    default_timeout=15.0,
    vision=VisionConfig(
        confidence_threshold=80.0,
        tesseract_lang="por",
    ),
)

with Josias(config) as bot:
    bot.open("https://example.com")

Tarefas com backtrack

Execute sequências de ações com retry automático entre etapas:

with Josias() as bot:
    bot.open("https://app.exemplo.com")

    bot.run([
        {"text": "Login", "sendtext": "usuario", "backtrack": True},
        {"text": "Senha", "sendtext": "123456", "backtrack": True},
        {"image": "submit.png", "backtrack": True, "confidence": 0.9},
    ])

Arquitetura

src/josias/
├── bot.py           # Classe principal
├── config.py        # Configuração centralizada
├── browser/         # Gerenciamento Selenium
├── dom/             # Seletores e interação DOM
├── vision/          # OCR e detecção de imagem
├── actions/         # Mouse, teclado e tarefas
└── waits.py         # Esperas explícitas

Publicação no PyPI

python -m build
python -m twine check dist/*
python -m twine upload dist/*

Ou crie uma Release no GitHub — o workflow publica automaticamente via Trusted Publishing.

Roadmap

• Core Selenium com API simplificada
• Visão computacional (OCR + imagem)
• Executor de tarefas com backtrack
• Orquestrador Josias
• Plugins (Excel, AWS, e-mail)
• CLI e deploy de bots

Licença

MIT — veja LICENSE.