rpaflow 0.1.0

Biblioteca Python modular para automação RPA

rpaflow

Biblioteca Python modular para automação RPA.

Sumário

Documento	Descrição
01 - Visão Geral	Objetivo e contexto do projeto
02 - Arquitetura	Estrutura do projeto e módulos
03 - Módulos	API completa de cada módulo
04 - Exemplos	Scripts de exemplo
05 - Roadmap	Ordem de implementação

Módulos

Módulo	pip install	Descrição
sql	pip install rpaflow[sql]	MySQL, PostgreSQL, SQL Server, SQLite
excel	pip install rpaflow[excel]	Leitura e escrita de planilhas (openpyxl)
excel_com	pip install rpaflow[excel-com]	Automação Excel via COM (Windows) - 60+ métodos
browser	pip install rpaflow[browser]	Automação de navegador - recursive iframe
desktop	pip install rpaflow[desktop]	Automação via reconhecimento de imagem
log	pip install rpaflow[log]	Logging profissional (inspirado no Serilog)
ini	pip install rpaflow[ini]	Leitura e escrita de arquivos .ini
json	pip install rpaflow[json]	Leitura e escrita de JSON com dot notation
files	pip install rpaflow[files]	Operações com arquivos
api	pip install rpaflow[api]	Requisições HTTP/REST
email	pip install rpaflow[email]	Envio de emails SMTP

Quick Start - JSON

pip install rpaflow[json]

from rpaflow.json import Json

json = Json()
data = json.load("config.json")

# Dot notation
data.user.name                                   # "Maria"
data.user.address.city                           # "SP"

# Iterar arrays
for bot in data.bots:
    print(f"Bot: {bot.name}, Enabled: {bot.enabled}")

# Iterar dicionário
for empresa, config in data.empresas.items():
    print(f"{empresa}: {config.host}:{config.port}")

Quick Start - INI

pip install rpaflow[ini]

from rpaflow.ini import Ini

ini = Ini("C:/config/robô.ini")

host = ini.get("database", "host")
port = ini.get_int("database", "port")
debug = ini.get_bool("app", "debug")

ini.set("database", "host", "192.168.1.100")
ini.save()

Quick Start - Log

pip install rpaflow[log]

from rpaflow.log import Log

log = Log(path="C:/logs/meu_bot.log", level="DEBUG", json=True)

log = log.bind(bot="vendas", user="admin")
log.info("Iniciando robô")
log.error("Falha na conexão", host="localhost")
log.success("Robô finalizado")

Quick Start - Desktop

pip install rpaflow[desktop]

from rpaflow.desktop import Desktop

desktop = Desktop()

# Localizar e clicar
desktop.click_image("C:/imgs/botao.png")

# Com confiança
desktop.click_image("C:/imgs/botao.png", confidence=0.90)

# Encontrar todas as ocorrências
results = desktop.find_all_images("C:/imgs/icone.png")

Quick Start - Browser

pip install rpaflow[browser]

from rpaflow.browser import Browser

browser = Browser()
browser.start("https://site.com", type="playwright")

# Normal
browser.click("#botao")
browser.type_text("#campo", "texto")

# Recursive (busca em todos os iframes)
browser.click("#botao", recursive=True)

browser.close()

Quick Start - Excel COM

pip install rpaflow[excel-com]

from rpaflow.excel_com import ExcelCom

xl = ExcelCom(visible=True)
xl.open("C:/dados/vendas.xlsx")

xl.filter_column_values("Vendas", 1, ["PCD"])
xl.sort_column("Vendas", 3, order="desc")

xl.save()
xl.close()
xl.quit()

Instalar Tudo

pip install rpaflow[all]