whom-integration 1.0.0__tar.gz

whom_integration-1.0.0/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Initial project setup
+- Basic documentation structure
+
+## [1.0.0] - 2025-08-19
+
+### Added
+- Initial support for ECAC (Federal Revenue System)
+- Initial support for PJE (Judiciary System)
+- Selenium and Playwright drivers
+- Intelligent proxy system
+- Modular and extensible architecture
+- Complete documentation
+- Session management and authentication
+- Workflow execution system
+- Cookie and JavaScript command handling
+
+### Features
+- **ECAC System**: Integration with Federal Revenue systems using Playwright
+- **PJE System**: Integration with Judiciary systems using Selenium
+- **Multiple Drivers**: Support for both Selenium and Playwright automation
+- **Session Management**: Automatic authentication and connection handling
+- **Workflow System**: Predefined and customizable workflow execution
+- **Error Handling**: Robust exception handling and error recovery
+
+### Technical Details
+- Python 3.8+ compatibility
+- Type hints support
+- Modular architecture with abstract base classes
+- Context manager support for session handling
+- Comprehensive logging and status reporting

whom_integration-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Cleber Castro
+
+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. 

whom_integration-1.0.0/MANIFEST.in

@@ -0,0 +1,21 @@
+include README.md
+include LICENSE
+include requirements.txt
+include CHANGELOG.md
+include pyproject.toml
+
+recursive-include examples *
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]
+
+global-exclude *.pyc
+global-exclude *.pyo
+global-exclude *.pyd
+global-exclude .git*
+global-exclude .DS_Store
+global-exclude .env*
+global-exclude .venv*
+global-exclude venv*
+global-exclude build*
+global-exclude dist*
+global-exclude *.egg-info* 

whom_integration-1.0.0/PKG-INFO

@@ -0,0 +1,299 @@
+Metadata-Version: 2.4
+Name: whom-integration
+Version: 1.0.0
+Summary: Python library for Whom API integration, supporting multiple systems and web automation drivers
+Home-page: https://github.com/doc9/whom-integration
+Author: Doc9
+Author-email: Doc9 <cloud@doc9.com.br>
+Maintainer-email: Doc9 <cloud@doc9.com.br>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/doc9/whom-integration
+Project-URL: Documentation, https://github.com/doc9/whom-integration#readme
+Project-URL: Repository, https://github.com/doc9/whom-integration
+Project-URL: Bug Tracker, https://github.com/doc9/whom-integration/issues
+Project-URL: Changelog, https://github.com/doc9/whom-integration/blob/main/CHANGELOG.md
+Keywords: whom,api,integration,automation,selenium,playwright,ecac,pje,receita-federal,judiciary,web-scraping,browser-automation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: flake8>=5.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: pre-commit>=2.20.0; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Provides-Extra: selenium
+Requires-Dist: selenium>=4.0.0; extra == "selenium"
+Requires-Dist: webdriver-manager>=3.8.0; extra == "selenium"
+Provides-Extra: playwright
+Requires-Dist: playwright>=1.30.0; extra == "playwright"
+Requires-Dist: patchright>=0.1.0; extra == "playwright"
+Provides-Extra: all
+Requires-Dist: selenium>=4.0.0; extra == "all"
+Requires-Dist: webdriver-manager>=3.8.0; extra == "all"
+Requires-Dist: playwright>=1.30.0; extra == "all"
+Requires-Dist: patchright>=0.1.0; extra == "all"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# Whom Integration Library
+
+Versatile Python library for Whom API integration, supporting multiple systems and web automation drivers.
+
+## 🚀 Features
+
+- **🔌 Multiple Drivers**: Support for Selenium and Playwright
+- **🎯 Extensible Systems**: Modular architecture for different systems
+- **⚡ Easy to Use**: Simple and intuitive API
+- **🛡️ Error Handling**: Custom and robust exceptions
+- **📚 Well Documented**: Complete examples and documentation
+
+## 📦 Installation
+
+### Basic Installation
+
+```bash
+pip install whom-integration
+```
+
+### Installation with Specific Drivers
+
+```bash
+# Install with Selenium support
+pip install "whom-integration[selenium]"
+
+# Install with Playwright support
+pip install "whom-integration[playwright]"
+
+# Install with all drivers
+pip install "whom-integration[all]"
+```
+
+### Development Installation
+
+```bash
+# Install with development tools
+pip install "whom-integration[dev]"
+
+# Manual installation from source
+git clone https://github.com/doc9/whom-integration.git
+cd whom-integration
+pip install -e .
+```
+
+### Driver Setup
+
+After installation, you may need to set up the drivers:
+
+```bash
+# For Playwright
+playwright install chromium
+
+# For Selenium
+# ChromeDriver is usually auto-installed via webdriver-manager
+```
+
+## 🎯 Quick Start
+
+### Command Line Interface
+
+The library includes a CLI for quick testing:
+
+```bash
+# Test ECAC with Playwright
+whom-integration --system ecac --driver playwright --token YOUR_TOKEN --extension YOUR_EXTENSION
+
+# Test PJE with Selenium
+whom-integration --system pje --driver selenium --token YOUR_TOKEN --extension YOUR_EXTENSION
+
+# Show help
+whom-integration --help
+```
+
+### Example with Selenium
+
+```python
+from whom_integration import WhomClient, ECACSystem, SeleniumDriver
+
+# Configure client
+client = WhomClient(token="your_token", extension_id="your_extension_id")
+
+# Create session
+with client.create_session(ECACSystem, SeleniumDriver) as session:
+    # Authenticate and connect
+    session.authenticate_and_connect()
+    
+    # Execute workflow
+    result = session.execute_workflow("default")
+    
+    print(f"Success: {result['success']}")
+```
+
+### Example with Playwright
+
+```python
+from whom_integration import WhomClient, ECACSystem, PlaywrightDriver
+
+
+client = WhomClient(token="your_token", extension_id="your_extension_id")
+
+with client.create_session(ECACSystem, PlaywrightDriver) as session:
+    session.authenticate_and_connect()
+    result = session.execute_workflow("default")
+    print(f"Success: {result['success']}")
+
+```
+
+## 🏗️ Architecture
+
+### Main Components
+
+```
+whom_integration/
+├── __init__.py          # Main interface
+├── core.py              # Client and session
+├── drivers/             # Automation drivers
+│   ├── base.py         # Abstract base class
+│   ├── selenium_driver.py
+│   └── playwright_driver.py
+├── systems/             # Supported systems
+│   ├── base.py         # Abstract base class
+│   └── ecac_system.py  # ECAC system
+│   └── pje_system.py  # PJE system
+└── exceptions.py        # Custom exceptions
+```
+
+### Workflow
+
+1. **Whom Client**: Manages API authentication
+2. **Driver**: Controls the browser (Selenium/Playwright)
+3. **System**: Implements target system specific logic
+4. **Session**: Orchestrates the entire process
+
+## 🔧 Configuration
+
+### Basic Configuration
+
+```python
+from whom_integration import WhomClient
+
+client = WhomClient(
+    token="your_token_here",
+    extension_id="your_extension_id_here",
+    base_url="https://cloud.doc9.com.br"  # Optional
+)
+```
+
+### Driver Configuration
+
+```python
+# Selenium
+session = client.create_session(
+    ECACSystem,
+    SeleniumDriver,
+    headless=False,
+    window_size=(1920, 1080)
+)
+
+# Playwright
+session = client.create_session(
+    ECACSystem,
+    PlaywrightDriver,
+    headless=False,
+    viewport={'width': 1920, 'height': 1080}
+)
+```
+
+## 🎯 **Direct Access to Session Objects**
+
+When you create a session, you have direct access to all available objects and methods:
+
+### 📱 **Driver (Browser)**
+```python
+# Direct access to configured driver
+session.driver.navigate("https://example.com")
+session.driver.execute_script("alert('Hello!')")
+session.driver.click_element("#button")
+session.driver.wait_for_element(".class", timeout=10)
+session.driver.get_page_title()
+session.driver.get_current_url()
+
+# For Playwright - direct access to page object
+if hasattr(session.driver, 'page'):
+    session.driver.page.fill("#input", "text")
+    session.driver.page.screenshot(path="screenshot.png")
+    session.driver.page.pdf(path="page.pdf")
+
+# For Selenium - direct access to driver object
+if hasattr(session.driver, 'driver'):
+    session.driver.driver.find_element(By.ID, "element")
+    session.driver.driver.execute_script("return document.title")
+```
+
+### 🖥️ **System Data**
+```python
+# System specific methods
+redirect_url = session.system.get_redirect_url()
+target_url = session.system.get_target_url()
+js_commands = session.system.get_js_commands()
+cookies = session.system.get_cookies()
+
+# Execute custom workflows
+result = session.system.execute_workflow("custom_workflow", param1="value")
+```
+
+### 📊 **Session Data**
+```python
+# Direct access to data returned by API
+session_data = session.session_data
+
+# Session cookies
+cookies = session_data.get('cookies', [])
+
+# Important URLs
+entry_point = session_data.get('entry_point')
+redirect_url = session_data.get('redirect')
+target_url = session_data.get('url')
+
+# JavaScript commands for execution
+js_commands = session_data.get('js', [])
+
+# Allowed domains
+allowed_domains = session_data.get('domains', [])
+
+# Elements to hide
+hidden_elements = session_data.get('elements_to_hidden', {})
+
+# Extra data
+extra_data = session_data.get('extra', {})
+```
+
+## 🎯 Supported Systems
+
+### 📊 **Driver Compatibility Table**
+
+| System | Selenium | Playwright | Notes |
+|---------|----------|------------|-------|
+| **ECAC** | ❌ | ✅ | Federal Revenue System - only works with Playwright |
+| **PJE** | ✅ | ❌ | Judiciary System - only works with Selenium |
+
+## 🔄 Changelog
+
+### v1.0.0
+- ✅ Initial support for ECAC
+- ✅ Initial support for PJE
+- ✅ Selenium and Playwright drivers
+- ✅ Intelligent proxy system
+- ✅ Modular and extensible architecture
+- ✅ Complete documentation

whom_integration-1.0.0/README.md

@@ -0,0 +1,250 @@
+# Whom Integration Library
+
+Versatile Python library for Whom API integration, supporting multiple systems and web automation drivers.
+
+## 🚀 Features
+
+- **🔌 Multiple Drivers**: Support for Selenium and Playwright
+- **🎯 Extensible Systems**: Modular architecture for different systems
+- **⚡ Easy to Use**: Simple and intuitive API
+- **🛡️ Error Handling**: Custom and robust exceptions
+- **📚 Well Documented**: Complete examples and documentation
+
+## 📦 Installation
+
+### Basic Installation
+
+```bash
+pip install whom-integration
+```
+
+### Installation with Specific Drivers
+
+```bash
+# Install with Selenium support
+pip install "whom-integration[selenium]"
+
+# Install with Playwright support
+pip install "whom-integration[playwright]"
+
+# Install with all drivers
+pip install "whom-integration[all]"
+```
+
+### Development Installation
+
+```bash
+# Install with development tools
+pip install "whom-integration[dev]"
+
+# Manual installation from source
+git clone https://github.com/doc9/whom-integration.git
+cd whom-integration
+pip install -e .
+```
+
+### Driver Setup
+
+After installation, you may need to set up the drivers:
+
+```bash
+# For Playwright
+playwright install chromium
+
+# For Selenium
+# ChromeDriver is usually auto-installed via webdriver-manager
+```
+
+## 🎯 Quick Start
+
+### Command Line Interface
+
+The library includes a CLI for quick testing:
+
+```bash
+# Test ECAC with Playwright
+whom-integration --system ecac --driver playwright --token YOUR_TOKEN --extension YOUR_EXTENSION
+
+# Test PJE with Selenium
+whom-integration --system pje --driver selenium --token YOUR_TOKEN --extension YOUR_EXTENSION
+
+# Show help
+whom-integration --help
+```
+
+### Example with Selenium
+
+```python
+from whom_integration import WhomClient, ECACSystem, SeleniumDriver
+
+# Configure client
+client = WhomClient(token="your_token", extension_id="your_extension_id")
+
+# Create session
+with client.create_session(ECACSystem, SeleniumDriver) as session:
+    # Authenticate and connect
+    session.authenticate_and_connect()
+    
+    # Execute workflow
+    result = session.execute_workflow("default")
+    
+    print(f"Success: {result['success']}")
+```
+
+### Example with Playwright
+
+```python
+from whom_integration import WhomClient, ECACSystem, PlaywrightDriver
+
+
+client = WhomClient(token="your_token", extension_id="your_extension_id")
+
+with client.create_session(ECACSystem, PlaywrightDriver) as session:
+    session.authenticate_and_connect()
+    result = session.execute_workflow("default")
+    print(f"Success: {result['success']}")
+
+```
+
+## 🏗️ Architecture
+
+### Main Components
+
+```
+whom_integration/
+├── __init__.py          # Main interface
+├── core.py              # Client and session
+├── drivers/             # Automation drivers
+│   ├── base.py         # Abstract base class
+│   ├── selenium_driver.py
+│   └── playwright_driver.py
+├── systems/             # Supported systems
+│   ├── base.py         # Abstract base class
+│   └── ecac_system.py  # ECAC system
+│   └── pje_system.py  # PJE system
+└── exceptions.py        # Custom exceptions
+```
+
+### Workflow
+
+1. **Whom Client**: Manages API authentication
+2. **Driver**: Controls the browser (Selenium/Playwright)
+3. **System**: Implements target system specific logic
+4. **Session**: Orchestrates the entire process
+
+## 🔧 Configuration
+
+### Basic Configuration
+
+```python
+from whom_integration import WhomClient
+
+client = WhomClient(
+    token="your_token_here",
+    extension_id="your_extension_id_here",
+    base_url="https://cloud.doc9.com.br"  # Optional
+)
+```
+
+### Driver Configuration
+
+```python
+# Selenium
+session = client.create_session(
+    ECACSystem,
+    SeleniumDriver,
+    headless=False,
+    window_size=(1920, 1080)
+)
+
+# Playwright
+session = client.create_session(
+    ECACSystem,
+    PlaywrightDriver,
+    headless=False,
+    viewport={'width': 1920, 'height': 1080}
+)
+```
+
+## 🎯 **Direct Access to Session Objects**
+
+When you create a session, you have direct access to all available objects and methods:
+
+### 📱 **Driver (Browser)**
+```python
+# Direct access to configured driver
+session.driver.navigate("https://example.com")
+session.driver.execute_script("alert('Hello!')")
+session.driver.click_element("#button")
+session.driver.wait_for_element(".class", timeout=10)
+session.driver.get_page_title()
+session.driver.get_current_url()
+
+# For Playwright - direct access to page object
+if hasattr(session.driver, 'page'):
+    session.driver.page.fill("#input", "text")
+    session.driver.page.screenshot(path="screenshot.png")
+    session.driver.page.pdf(path="page.pdf")
+
+# For Selenium - direct access to driver object
+if hasattr(session.driver, 'driver'):
+    session.driver.driver.find_element(By.ID, "element")
+    session.driver.driver.execute_script("return document.title")
+```
+
+### 🖥️ **System Data**
+```python
+# System specific methods
+redirect_url = session.system.get_redirect_url()
+target_url = session.system.get_target_url()
+js_commands = session.system.get_js_commands()
+cookies = session.system.get_cookies()
+
+# Execute custom workflows
+result = session.system.execute_workflow("custom_workflow", param1="value")
+```
+
+### 📊 **Session Data**
+```python
+# Direct access to data returned by API
+session_data = session.session_data
+
+# Session cookies
+cookies = session_data.get('cookies', [])
+
+# Important URLs
+entry_point = session_data.get('entry_point')
+redirect_url = session_data.get('redirect')
+target_url = session_data.get('url')
+
+# JavaScript commands for execution
+js_commands = session_data.get('js', [])
+
+# Allowed domains
+allowed_domains = session_data.get('domains', [])
+
+# Elements to hide
+hidden_elements = session_data.get('elements_to_hidden', {})
+
+# Extra data
+extra_data = session_data.get('extra', {})
+```
+
+## 🎯 Supported Systems
+
+### 📊 **Driver Compatibility Table**
+
+| System | Selenium | Playwright | Notes |
+|---------|----------|------------|-------|
+| **ECAC** | ❌ | ✅ | Federal Revenue System - only works with Playwright |
+| **PJE** | ✅ | ❌ | Judiciary System - only works with Selenium |
+
+## 🔄 Changelog
+
+### v1.0.0
+- ✅ Initial support for ECAC
+- ✅ Initial support for PJE
+- ✅ Selenium and Playwright drivers
+- ✅ Intelligent proxy system
+- ✅ Modular and extensible architecture
+- ✅ Complete documentation

whom_integration-1.0.0/app/__init__.py

@@ -0,0 +1,58 @@
+"""
+Whom Integration Library
+
+Versatile Python library for Whom API integration, supporting multiple systems 
+and web automation drivers.
+
+This library provides a unified interface for integrating with various government
+systems like ECAC (Federal Revenue) and PJE (Judiciary) using different automation
+drivers including Selenium and Playwright.
+"""
+
+__version__ = "1.0.0"
+__author__ = "Doc9"
+__email__ = "cloud@doc9.com.br"
+__license__ = "MIT"
+__url__ = "https://github.com/doc9/whom-integration"
+
+# Core classes
+from .core import WhomClient, WhomSession
+
+# Systems
+from .systems.ecac_system import ECACSystem
+from .systems.pje_system import PJESystem
+
+# Drivers
+from .drivers.selenium_driver import SeleniumDriver
+from .drivers.playwright_driver import PlaywrightDriver
+
+# Exceptions
+from .exceptions import (
+    WhomError,
+    AuthenticationError,
+    ConnectionError,
+    WorkflowError,
+    DriverError,
+    SystemError,
+)
+
+# Version info
+__all__ = [
+    "__version__",
+    "__author__",
+    "__email__",
+    "__license__",
+    "__url__",
+    "WhomClient",
+    "WhomSession",
+    "ECACSystem",
+    "PJESystem",
+    "SeleniumDriver",
+    "PlaywrightDriver",
+    "WhomError",
+    "AuthenticationError",
+    "ConnectionError",
+    "WorkflowError",
+    "DriverError",
+    "SystemError",
+]