Metadata-Version: 2.4
Name: teody-rpa-engine
Version: 1.0.0
Summary: An enterprise object-oriented framework for UI automation, PDF parsing, macro loops, and OCR.
Author-email: Teody Arboneda Banagan <teody882011@gmail.com>
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: overrides>=7.0.0
Requires-Dist: lackey>=0.7.2
Requires-Dist: wxPython>=4.2.0
Requires-Dist: pytesseract>=0.3.10
Requires-Dist: pypdf>=3.0.0
Requires-Dist: pyperclip>=1.8.2
Requires-Dist: opencv-python>=4.8.0
Dynamic: license-file

# Teody RPA Engine (`teody-rpa-engine`)

[![PyPI version](https://shields.io)](https://pypi.org)
[![License: MIT](https://shields.io)](https://opensource.org)
[![Python 3.8+](https://shields.io)](https://python.org)

An enterprise-grade, highly decoupled, object-oriented Robotic Process Automation (RPA) and cross-platform GUI automation framework written in Python.

The **Teody RPA Engine** bridges foundational automated testing mechanisms, computer vision (OpenCV), hardware simulation driver interfaces, and Optical Character Recognition (OCR/Tesseract) into a scalable, single-namespace architectural design pattern.

---

## 🏛️ Core Architectural Benefits & Innovation

* **The Open-Closed Principle:** Features an advanced Registry/Strategy pattern for image recognition routines. New automation interactions can be added without modifying downstream engine dependencies.
* **Dynamic Environment Resolution:** Replaces rigid machine paths with smart environment scanning to automatically detect and bind native system binaries (such as Tesseract OCR engines).
* **Isolated Scope Execution:** Wraps pipeline operations inside robust exception-handling scopes, protecting asynchronous enterprise workflows from terminal runtime crashes.
* **Micro-Interval Event Timing:** Provides granular micro-interval input latency delays, allowing developers to safely calibrate human-realistic macro actions.

---

## 🚀 Installation & Implementation

```bash
pip install teody-rpa-engine
```

### Quick Start Code Block
```python
from teody_rpa import AutomationScreenFactory, OCRScreenFactory

automation = AutomationScreenFactory()
automation.execute_action(
    automation_type="DoubleClickOnImage", 
    image_path="assets/", 
    image_source="btn.png", 
    similarity=0.95
)
```

---

## ⚖️ Legal Manifest & Copyright Notice

* **Official Registration:** Prepared for filing under the Intellectual Property Office of the Philippines (IPOPHL) within the Computer Programs / Software category.
* **Copyright Notice:** `Copyright (c) 2026 Teody Arboneda Banagan. All rights reserved.`
* **Open Source License:** Distributed globally under the highly permissive **MIT License**.

---

## 🔬 About the Author & Project Maintainer

**Teody Arboneda Banagan, PhD (Candidate)**
*Solution Architect, & AI Engineer and Researcher*
* **Email:** teody882011@gmail.com

### Professional Stature & Domain Expertise
The structural maintenance, systems design, and algorithmic orchestration of this framework are driven by 20 years of progressive IT experience and top-tier credentials spanning international enterprise teams:
* **Doctor of Philosophy (PhD) in IT Candidate** — University of San Carlos, specializing in Advanced IT Frameworks, Computer Vision, and Enterprise AI Architectures.
* **Master in Information Technology (MIT)** — Cebu Institute of Technology - University.
* **Peer-Reviewed Reviewer & Author** — Invited Peer Reviewer for Scopus-indexed and Web of Science international journals.
