onerom-desktop 1.0.0__tar.gz

onerom_desktop-1.0.0/.gitignore

@@ -0,0 +1,50 @@
+# Local Netlify folder
+.netlify
+
+# Binarios e artefatos de build
+*.exe
+*.pkg
+*.pyz
+*.zip
+*.tar
+*.tar.gz
+*.toc
+*.html
+*.txt
+
+# Diretorios de build do PyInstaller
+runner/build/
+runner/dist/
+runner/installer/build/
+runner/installer/dist/
+
+# Artefatos de deploy
+rebuild/backend/dist/
+rebuild/frontend/dist/
+
+# Execucoes locais do runner
+runner/executions/
+
+# Dependencias Python
+**/__pycache__/
+**/.venv/
+*.pyc
+*.pyo
+
+# Node
+frontend/node_modules/
+
+# Env local do monorepo / compose
+.env
+.env.*.local
+
+# Deploy images (apenas o deploy/ da RAIZ; nao os deploy/ de subprojetos)
+/deploy/
+deployimages*
+
+# Scripts venv
+scripts/.venv/
+
+# Distribuicoes de pacotes
+onerom_core/dist/
+.DS_Store

onerom_desktop-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Onerom
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

onerom_desktop-1.0.0/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.5
+Name: onerom-desktop
+Version: 1.0.0
+Summary: Runtime de automacao desktop da plataforma ONEROM (UIA, OCR, imagem, coordenadas e SAP GUI)
+Project-URL: Homepage, https://onerom.dev.br
+Author: ONEROM Team
+License: MIT
+License-File: LICENSE
+Keywords: automation,desktop,ocr,onerom,rpa,sap,uia
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Requires-Dist: mss>=9.0.0
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: pyautogui>=0.9.54
+Requires-Dist: pyperclip>=1.9.0
+Provides-Extra: all
+Requires-Dist: comtypes>=1.4.16; (sys_platform == 'win32') and extra == 'all'
+Requires-Dist: numpy>=1.24; extra == 'all'
+Requires-Dist: opencv-python-headless<5,>=4.9.0; extra == 'all'
+Requires-Dist: pytesseract>=0.3.10; extra == 'all'
+Requires-Dist: pywin32>=306; (sys_platform == 'win32') and extra == 'all'
+Requires-Dist: pywinauto>=0.6.9; (sys_platform == 'win32') and extra == 'all'
+Provides-Extra: backend
+Requires-Dist: comtypes>=1.4.16; (sys_platform == 'win32') and extra == 'backend'
+Requires-Dist: pywin32>=306; (sys_platform == 'win32') and extra == 'backend'
+Requires-Dist: pywinauto>=0.6.9; (sys_platform == 'win32') and extra == 'backend'
+Provides-Extra: image
+Requires-Dist: numpy>=1.24; extra == 'image'
+Requires-Dist: opencv-python-headless<5,>=4.9.0; extra == 'image'
+Provides-Extra: ocr
+Requires-Dist: numpy>=1.24; extra == 'ocr'
+Requires-Dist: opencv-python-headless<5,>=4.9.0; extra == 'ocr'
+Requires-Dist: pytesseract>=0.3.10; extra == 'ocr'
+Provides-Extra: sap
+Requires-Dist: pywin32>=306; (sys_platform == 'win32') and extra == 'sap'
+Description-Content-Type: text/markdown
+
+# onerom-desktop
+
+Runtime de automação desktop da plataforma ONEROM.
+
+É a biblioteca que os bots gerados pelo **ONEROM Inspector** importam para clicar,
+preencher e ler telas — de aplicações Windows nativas a SAP GUI, passando por
+janelas que não expõem nenhuma árvore de automação.
+
+```bash
+pip install "onerom-desktop[all]"
+```
+
+## Uma classe, cinco estratégias
+
+```python
+from onerom_desktop import App
+
+app = App(strategy="backend", automation_id="btnLogin", window_title="Login")
+app.wait_visible()
+app.click()
+```
+
+O que você passa no construtor vira padrão para todas as ações; o que passa na
+ação vale só para aquela chamada. É isso que deixa o script curto sem esconder o
+que ele está mirando.
+
+| `strategy=` | Como localiza | Quando usar |
+|---|---|---|
+| `backend` | UIAutomation via pywinauto | **Padrão.** Sobrevive a janela movida, resolução diferente e troca de tema |
+| `ocr` | Texto lido da tela (Tesseract) | Citrix, RDP, canvas Java/Delphi — quando não há árvore de automação |
+| `image` | Template matching (OpenCV + ORB) | Ícones e controles desenhados, sem identidade nem rótulo |
+| `coordinate` | Ponto fixo na tela | Último recurso: não verifica nada |
+| `sap` | SAP GUI Scripting (COM) | Sempre, quando o alvo é SAP |
+| `auto` | `backend` → `ocr` → `image` → `coordinate` | Degrada sozinho quando a aplicação muda |
+
+```python
+app.fill(strategy="ocr", text="Usuário", value="admin")
+app.click(strategy="image", image="botao.png", confidence=0.9)
+app.press(strategy="sap", sap_id="wnd[0]/tbar[0]/btn[0]")
+app.click(strategy="auto")
+```
+
+## Ações
+
+`click` · `double_click` · `right_click` · `hover` · `fill` · `click_and_fill` ·
+`type_text` · `get_text` · `wait_visible` · `exists` · `screenshot`
+
+Para SAP, também: `find` · `set_text` · `press` · `submit`.
+
+```python
+if app.exists(strategy="backend", automation_id="dlgErro", window_title="Erro"):
+    app.click(automation_id="btnFechar")
+
+total = app.get_text(strategy="ocr", x=800, y=440, width=160, height=28)
+app.screenshot("evidencia.png")
+```
+
+## Erros dizem o que fazer
+
+Tudo herda de `OneromDesktopError`, e as classes existem para separar os três
+casos que pedem tratamento diferente:
+
+```python
+from onerom_desktop import (
+    OneromDesktopError,          # base de tudo
+    DesktopLocatorError,         # bug no bot — repetir não adianta
+    DesktopBackendUnavailableError,  # ambiente quebrado — avisar o operador
+    ElementNotFoundError,        # não achou agora — repetir pode funcionar
+    WaitTimeoutError,
+    MissingDependencyError,      # traz o comando de instalação na mensagem
+)
+```
+
+`exists()` responde `False` para ausência de verdade, mas **levanta** exceção
+quando a verificação em si não pôde ser feita — dependência faltando, backend
+indisponível, imagem de template ausente, SAP fechado. Responder `False` nesses
+casos é como um bot acaba entrando no branch errado.
+
+## Dependências opcionais
+
+O `import onerom_desktop` é barato: OpenCV, Tesseract, pywinauto e pywin32 só
+são carregados quando a estratégia correspondente é usada.
+
+```bash
+pip install onerom-desktop              # coordenadas, teclado, screenshot
+pip install "onerom-desktop[backend]"   # + UIAutomation (Windows)
+pip install "onerom-desktop[image]"     # + OpenCV
+pip install "onerom-desktop[ocr]"       # + Tesseract (o binário também é necessário)
+pip install "onerom-desktop[sap]"       # + SAP GUI Scripting (Windows)
+pip install "onerom-desktop[all]"       # tudo
+```
+
+Faltando uma delas, a mensagem já traz o `pip install` certo em vez de um
+`ModuleNotFoundError` cru no log do bot.
+
+## Coordenadas são pixels FÍSICOS
+
+Toda coordenada nesta biblioteca é pixel físico da mesa virtual (a união de
+todos os monitores) — o mesmo espaço em que o Inspector captura, o `mss`
+fotografa e o `pyautogui` clica.
+
+O processo é marcado como *per-monitor DPI aware* no import. Sem isso, o Windows
+reescala silenciosamente as coordenadas de um processo DPI-unaware e todo clique
+erra o alvo em tela a 125%/150% — o clássico "funciona na minha tela".
+
+## Arquitetura
+
+```
+onerom_desktop/
+├── app.py          App: defaults, dispatch e a cadeia auto
+├── locators.py     kwargs soltos -> locators validados
+├── strategies/     interface uniforme de ações (base + 5 estratégias)
+├── engines/        uia · ocr · template · sap · windows
+├── pointer.py      mouse           screen.py    captura de tela
+├── keyboard.py     texto           geometry.py  Region
+├── errors.py       hierarquia      optional.py  deps sob demanda
+└── dpi.py          invariante de pixel físico
+```
+
+`strategies/base.py` concentra o caminho comum: as três estratégias que acabam
+clicando um ponto (`ocr`, `image`, `coordinate`) só implementam `locate()` e
+herdam todas as ações.
+
+## Desenvolvimento
+
+```bash
+uv sync --group dev
+./check.sh
+```
+
+MIT.

onerom_desktop-1.0.0/README.md

@@ -0,0 +1,131 @@
+# onerom-desktop
+
+Runtime de automação desktop da plataforma ONEROM.
+
+É a biblioteca que os bots gerados pelo **ONEROM Inspector** importam para clicar,
+preencher e ler telas — de aplicações Windows nativas a SAP GUI, passando por
+janelas que não expõem nenhuma árvore de automação.
+
+```bash
+pip install "onerom-desktop[all]"
+```
+
+## Uma classe, cinco estratégias
+
+```python
+from onerom_desktop import App
+
+app = App(strategy="backend", automation_id="btnLogin", window_title="Login")
+app.wait_visible()
+app.click()
+```
+
+O que você passa no construtor vira padrão para todas as ações; o que passa na
+ação vale só para aquela chamada. É isso que deixa o script curto sem esconder o
+que ele está mirando.
+
+| `strategy=` | Como localiza | Quando usar |
+|---|---|---|
+| `backend` | UIAutomation via pywinauto | **Padrão.** Sobrevive a janela movida, resolução diferente e troca de tema |
+| `ocr` | Texto lido da tela (Tesseract) | Citrix, RDP, canvas Java/Delphi — quando não há árvore de automação |
+| `image` | Template matching (OpenCV + ORB) | Ícones e controles desenhados, sem identidade nem rótulo |
+| `coordinate` | Ponto fixo na tela | Último recurso: não verifica nada |
+| `sap` | SAP GUI Scripting (COM) | Sempre, quando o alvo é SAP |
+| `auto` | `backend` → `ocr` → `image` → `coordinate` | Degrada sozinho quando a aplicação muda |
+
+```python
+app.fill(strategy="ocr", text="Usuário", value="admin")
+app.click(strategy="image", image="botao.png", confidence=0.9)
+app.press(strategy="sap", sap_id="wnd[0]/tbar[0]/btn[0]")
+app.click(strategy="auto")
+```
+
+## Ações
+
+`click` · `double_click` · `right_click` · `hover` · `fill` · `click_and_fill` ·
+`type_text` · `get_text` · `wait_visible` · `exists` · `screenshot`
+
+Para SAP, também: `find` · `set_text` · `press` · `submit`.
+
+```python
+if app.exists(strategy="backend", automation_id="dlgErro", window_title="Erro"):
+    app.click(automation_id="btnFechar")
+
+total = app.get_text(strategy="ocr", x=800, y=440, width=160, height=28)
+app.screenshot("evidencia.png")
+```
+
+## Erros dizem o que fazer
+
+Tudo herda de `OneromDesktopError`, e as classes existem para separar os três
+casos que pedem tratamento diferente:
+
+```python
+from onerom_desktop import (
+    OneromDesktopError,          # base de tudo
+    DesktopLocatorError,         # bug no bot — repetir não adianta
+    DesktopBackendUnavailableError,  # ambiente quebrado — avisar o operador
+    ElementNotFoundError,        # não achou agora — repetir pode funcionar
+    WaitTimeoutError,
+    MissingDependencyError,      # traz o comando de instalação na mensagem
+)
+```
+
+`exists()` responde `False` para ausência de verdade, mas **levanta** exceção
+quando a verificação em si não pôde ser feita — dependência faltando, backend
+indisponível, imagem de template ausente, SAP fechado. Responder `False` nesses
+casos é como um bot acaba entrando no branch errado.
+
+## Dependências opcionais
+
+O `import onerom_desktop` é barato: OpenCV, Tesseract, pywinauto e pywin32 só
+são carregados quando a estratégia correspondente é usada.
+
+```bash
+pip install onerom-desktop              # coordenadas, teclado, screenshot
+pip install "onerom-desktop[backend]"   # + UIAutomation (Windows)
+pip install "onerom-desktop[image]"     # + OpenCV
+pip install "onerom-desktop[ocr]"       # + Tesseract (o binário também é necessário)
+pip install "onerom-desktop[sap]"       # + SAP GUI Scripting (Windows)
+pip install "onerom-desktop[all]"       # tudo
+```
+
+Faltando uma delas, a mensagem já traz o `pip install` certo em vez de um
+`ModuleNotFoundError` cru no log do bot.
+
+## Coordenadas são pixels FÍSICOS
+
+Toda coordenada nesta biblioteca é pixel físico da mesa virtual (a união de
+todos os monitores) — o mesmo espaço em que o Inspector captura, o `mss`
+fotografa e o `pyautogui` clica.
+
+O processo é marcado como *per-monitor DPI aware* no import. Sem isso, o Windows
+reescala silenciosamente as coordenadas de um processo DPI-unaware e todo clique
+erra o alvo em tela a 125%/150% — o clássico "funciona na minha tela".
+
+## Arquitetura
+
+```
+onerom_desktop/
+├── app.py          App: defaults, dispatch e a cadeia auto
+├── locators.py     kwargs soltos -> locators validados
+├── strategies/     interface uniforme de ações (base + 5 estratégias)
+├── engines/        uia · ocr · template · sap · windows
+├── pointer.py      mouse           screen.py    captura de tela
+├── keyboard.py     texto           geometry.py  Region
+├── errors.py       hierarquia      optional.py  deps sob demanda
+└── dpi.py          invariante de pixel físico
+```
+
+`strategies/base.py` concentra o caminho comum: as três estratégias que acabam
+clicando um ponto (`ocr`, `image`, `coordinate`) só implementam `locate()` e
+herdam todas as ações.
+
+## Desenvolvimento
+
+```bash
+uv sync --group dev
+./check.sh
+```
+
+MIT.

onerom_desktop-1.0.0/onerom_desktop/__init__.py

@@ -0,0 +1,86 @@
+"""onerom-desktop -- runtime de automacao desktop da plataforma ONEROM.
+
+Uma classe, cinco estrategias:
+
+    from onerom_desktop import App
+
+    app = App(strategy="backend", automation_id="btnLogin", window_title="Login")
+    app.wait_visible()
+    app.click()
+
+    app.fill(strategy="ocr", text="Usuario", value="admin")
+    app.click(strategy="image", image="botao.png", confidence=0.9)
+    app.click(strategy="coordinate", x=500, y=300)
+    app.press(strategy="sap", sap_id="wnd[0]/tbar[0]/btn[0]")
+    app.click(strategy="auto")   # backend -> ocr -> imagem -> coordenada
+
+Todas as dependencias pesadas (OpenCV, Tesseract, pywinauto, pywin32) sao
+opcionais e carregadas apenas quando a estrategia correspondente e usada --
+instale com o extra que precisar: ``pip install "onerom-desktop[all]"``.
+"""
+from __future__ import annotations
+
+from .app import App
+from .dpi import set_process_dpi_aware
+from .errors import (
+    AllStrategiesFailedError,
+    DesktopAutomationError,
+    DesktopBackendUnavailableError,
+    DesktopElementNotFoundError,
+    DesktopLocatorError,
+    ElementNotFoundError,
+    MissingDependencyError,
+    OneromDesktopError,
+    SAPAutomationError,
+    SAPConnectionError,
+    SAPGuiNotOpenError,
+    SAPLocatorError,
+    SAPScriptingUnavailableError,
+    SAPSessionUnavailableError,
+    StrategyError,
+    TemplateImageNotFoundError,
+    WaitTimeoutError,
+)
+from .geometry import Region
+from .locators import (
+    STRATEGY_AUTO,
+    STRATEGY_BACKEND,
+    STRATEGY_COORDINATE,
+    STRATEGY_IMAGE,
+    STRATEGY_OCR,
+    STRATEGY_SAP,
+)
+from .strategies import available_strategies
+
+__version__ = "1.0.0"
+
+__all__ = [
+    "AllStrategiesFailedError",
+    "App",
+    "DesktopAutomationError",
+    "DesktopBackendUnavailableError",
+    "DesktopElementNotFoundError",
+    "DesktopLocatorError",
+    "ElementNotFoundError",
+    "MissingDependencyError",
+    "OneromDesktopError",
+    "Region",
+    "SAPAutomationError",
+    "SAPConnectionError",
+    "SAPGuiNotOpenError",
+    "SAPLocatorError",
+    "SAPScriptingUnavailableError",
+    "SAPSessionUnavailableError",
+    "STRATEGY_AUTO",
+    "STRATEGY_BACKEND",
+    "STRATEGY_COORDINATE",
+    "STRATEGY_IMAGE",
+    "STRATEGY_OCR",
+    "STRATEGY_SAP",
+    "StrategyError",
+    "TemplateImageNotFoundError",
+    "WaitTimeoutError",
+    "__version__",
+    "available_strategies",
+    "set_process_dpi_aware",
+]