Metadata-Version: 2.1
Name: pywebwizard
Version: 1.3.59
Summary: Industrial-grade autonomous navigation engine for stealthy web automation and resilient scraping.
Home-page: https://gitlab.com/connorlilhomer/pywebwizard
Download-URL: https://gitlab.com/connorlilhomer/pywebwizard/-/archive/main/pywebwizard-1.3.59.tar.gz
Author: ConnorLilHomer
Author-email: info@parendum.com
Maintainer: ConnorLilHomer
Maintainer-email: info@parendum.com
License: MIT
Project-URL: Documentation, https://gitlab.com/connorlilhomer/pywebwizard/-/blob/main/README.md
Project-URL: Source, https://gitlab.com/connorlilhomer/pywebwizard
Project-URL: Tracker, https://gitlab.com/connorlilhomer/pywebwizard/-/issues
Keywords: web,automation,browser,scraping,python,selenium,headless,browsing,stealth,anti-bot,bypass,resilient,autonomous,agent,navigation,crawler,data extraction,form automation,captcha-bypass,human-behavior,OODA,mimetismo,automatización de navegadores,robot,SaaS,professional-automation,industrial-scraping
Platform: Windows
Platform: Linux
Platform: MacOS
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
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: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.8, <3.15
Description-Content-Type: text/markdown
License-File: LICENSE

# 🧙‍♂️ PyWebWizard: PyWebWizard Engine Edition (v1.3.59)

[![PyPI version](https://img.shields.io/pypi/v/pywebwizard?color=blue&logo=pypi)](https://pypi.org/project/pywebwizard/)
[![Downloads](https://static.pepy.tech/badge/pywebwizard)](https://pepy.tech/project/pywebwizard)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python Versions](https://img.shields.io/pypi/pyversions/pywebwizard.svg)](https://pypi.org/project/pywebwizard/)

**PyWebWizard** is an industrial-grade autonomous navigation engine for stealthy web automation and resilient scraping. Designed for **resilience, stealth, and intelligence**, it enables orchestrating complex workflows via natural language missions or YAML "Spells", mimicking human behavior 100%.

---

## 💎 PyWebWizard Engine Technology Pillars

PyWebWizard integrates cutting-edge technologies to overcome the most advanced anti-bot defenses:

| Pillar | Technology | Status | Benefit |
| :--- | :--- | :--- | :--- |
| **Human Mimicry** | Bézier / Cadence | ✅ **Implemented** | 100% human-like mouse and keyboard interaction. |
| **VLM Perception** | Vision-Language Models | ✅ **Implemented** | Solves CAPTCHAs and reasons about UI layout. |
| **OODA Loop** | Dynamic Decision | 🟠 **In Progress** | Reasons and adapts to page changes in real-time. |
| **Dual Engine** | Selenium + Playwright | 🚀 **Roadmap** | Stealth for bypass, performance for scale. |

---

## 🚀 Features

-   **Dual Engine**: Seamless switching between Selenium (stealth) and Playwright (performance).
-   **VLM Perception**: AI-driven vision to solve CAPTCHAs and reason about UI layout.
-   **Human Mimicry**: Bézier mouse curves, randomized typing cadence, and realistic scroll patterns.
-   **OODA Loop Logic**: Dynamic decision-making based on visual and DOM feedback.

---

## 🔮 Examples: Spells & Missions

### 📜 YAML Spell (News Scraper)
```yaml
name: "News Scraper"
steps:
  - action: "open_url"
    url: "https://news.ycombinator.com"
  - action: "wait_for_selector"
    selector: ".athing"
  - action: "extract_list"
    selector: ".titleline > a"
    output_key: "headlines"
```

### 📝 JSON Mission (Search Automation)
```json
{
  "mission": "Search for PyWebWizard on Google",
  "steps": [
    { "action": "open_url", "url": "https://www.google.com" },
    { "action": "type", "selector": "textarea[name='q']", "text": "PyWebWizard Engine" },
    { "action": "press_key", "key": "Enter" },
    { "action": "wait", "seconds": 2 }
  ]
}
```

---

## 🛠️ Installation

```bash
pip install pywebwizard
```

## 🛡️ License

Software distributed under the **MIT** license.

---
*Designed with ❤️ by the Parendum team for the next generation of automation engineers.*
