py4quality 0.1.0__tar.gz

py4quality-0.1.0/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: py4quality
+Version: 0.1.0
+Summary: A highly user-friendly, kid-friendly automation framework using Chrome DevTools Protocol (CDP).
+Author: Venkata Santosh Tharigoppala
+License: MIT
+Project-URL: Homepage, https://github.com/santoshtvk-new/Pyquality
+Project-URL: Bug Tracker, https://github.com/santoshtvk-new/Pyquality/issues
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: websocket-client>=1.6.1
+Requires-Dist: requests>=2.31.0
+
+# pyquality 🎈
+
+A kid-friendly, yet exceptionally powerful automation framework for Python driven directly by the Chrome DevTools Protocol (CDP).
+
+`pyquality` is designed to be as simple as possible. Want to close the browser? Just call `b.bye()`. Want to navigate? `b.go_to("https://...")`
+
+Under the hood, it retains uncompromising power. Advanced users have **unfiltered access** to all 40+ raw Chromium DevTools domains (DOM, Network, Page, etc.) auto-generated from the official Google spec!
+
+---
+
+## 🚀 Installation (Source)
+If you are developing locally:
+```bash
+git clone https://github.com/santoshtvk-new/Pyquality.git
+cd pyquality
+pip install -e .
+```
+
+## 🛠️ Installation (PIP)
+*(When published to PyPi)*
+```bash
+pip install pyquality
+```
+
+---
+
+## 📖 Quick Start
+
+```python
+from pyquality.browser import Browser
+
+# 1. Start it up
+b = Browser(headless=False)
+
+# 2. Go somewhere
+b.go_to("https://example.com")
+
+# 3. Validation is easy
+b.should_be_seen("h1")
+
+# 4. Say goodbye
+b.bye()
+```
+
+## ✨ The Kid-Friendly Aliases
+
+`pyquality` dynamically binds methods defined in `METHOD_ALIASES.yml` so you can use vocabulary that makes sense to you.
+
+### Navigation
+- `navigate(url)` -> `go_to`, `open_website`
+- `reload()` -> `refresh`, `reload_page`
+- `close()` -> `close_browser`, `bye`
+- `go_back()` -> `step_back`, `previous_page`
+- `go_forward()` -> `step_forward`, `next_page`
+
+### Interaction
+- `click_element(selector)` -> `click_this`, `tap`
+- `type_text(selector, text)` -> `type_in`, `write_this`
+- `hover_element(selector)` -> `point_at`, `hover_over`
+
+### APIs & Data
+- `API.get(endpoint)` -> `fetch_data`, `grab`
+- `API.post(endpoint, json)` -> `create_data`, `send_new`
+
+---
+
+## ⚡ Raw CDP Power (Advanced)
+
+If you need capabilities beyond the simple wrappers, `pyquality` has raw auto-generated bindings for **EVERY** CDP Domain. They are attached natively to the browser instance:
+
+```python
+from pyquality.browser import Browser
+b = Browser()
+
+# Use raw 'Page' domain to capture a PDF
+b.page.printToPDF()
+
+# Use raw 'Network' domain to throttle connection
+b.network.emulateNetworkConditions(
+    offline=False, 
+    latency=200, 
+    downloadThroughput=1000, 
+    uploadThroughput=1000
+)
+
+# Use raw 'DOM' domain to get node information
+b.dom.getDocument(depth=-1)
+```
+
+## 📦 Deploying Initial PIP Package
+
+To package this framework and upload it to PyPi:
+
+1. **Install build tools:**
+   ```bash
+   pip install build twine
+   ```
+
+2. **Generate Native Wrappers:**
+   Ensure your CDP protocol bindings are up-to-date:
+   ```bash
+   python src/pyquality/generate_cdp_wrappers.py
+   ```
+
+3. **Build wheels:**
+   ```bash
+   python -m build
+   ```
+   *This generates `.tar.gz` and `.whl` files in the `/dist` folder.*
+
+4. **Upload to PyPi (Requires Account):**
+   ```bash
+   python -m twine upload dist/*
+   ```
+
+5. **Done!** Users can now run `pip install pyquality`.

py4quality-0.1.0/README.md

@@ -0,0 +1,116 @@
+# pyquality 🎈
+
+A kid-friendly, yet exceptionally powerful automation framework for Python driven directly by the Chrome DevTools Protocol (CDP).
+
+`pyquality` is designed to be as simple as possible. Want to close the browser? Just call `b.bye()`. Want to navigate? `b.go_to("https://...")`
+
+Under the hood, it retains uncompromising power. Advanced users have **unfiltered access** to all 40+ raw Chromium DevTools domains (DOM, Network, Page, etc.) auto-generated from the official Google spec!
+
+---
+
+## 🚀 Installation (Source)
+If you are developing locally:
+```bash
+git clone https://github.com/santoshtvk-new/Pyquality.git
+cd pyquality
+pip install -e .
+```
+
+## 🛠️ Installation (PIP)
+*(When published to PyPi)*
+```bash
+pip install pyquality
+```
+
+---
+
+## 📖 Quick Start
+
+```python
+from pyquality.browser import Browser
+
+# 1. Start it up
+b = Browser(headless=False)
+
+# 2. Go somewhere
+b.go_to("https://example.com")
+
+# 3. Validation is easy
+b.should_be_seen("h1")
+
+# 4. Say goodbye
+b.bye()
+```
+
+## ✨ The Kid-Friendly Aliases
+
+`pyquality` dynamically binds methods defined in `METHOD_ALIASES.yml` so you can use vocabulary that makes sense to you.
+
+### Navigation
+- `navigate(url)` -> `go_to`, `open_website`
+- `reload()` -> `refresh`, `reload_page`
+- `close()` -> `close_browser`, `bye`
+- `go_back()` -> `step_back`, `previous_page`
+- `go_forward()` -> `step_forward`, `next_page`
+
+### Interaction
+- `click_element(selector)` -> `click_this`, `tap`
+- `type_text(selector, text)` -> `type_in`, `write_this`
+- `hover_element(selector)` -> `point_at`, `hover_over`
+
+### APIs & Data
+- `API.get(endpoint)` -> `fetch_data`, `grab`
+- `API.post(endpoint, json)` -> `create_data`, `send_new`
+
+---
+
+## ⚡ Raw CDP Power (Advanced)
+
+If you need capabilities beyond the simple wrappers, `pyquality` has raw auto-generated bindings for **EVERY** CDP Domain. They are attached natively to the browser instance:
+
+```python
+from pyquality.browser import Browser
+b = Browser()
+
+# Use raw 'Page' domain to capture a PDF
+b.page.printToPDF()
+
+# Use raw 'Network' domain to throttle connection
+b.network.emulateNetworkConditions(
+    offline=False, 
+    latency=200, 
+    downloadThroughput=1000, 
+    uploadThroughput=1000
+)
+
+# Use raw 'DOM' domain to get node information
+b.dom.getDocument(depth=-1)
+```
+
+## 📦 Deploying Initial PIP Package
+
+To package this framework and upload it to PyPi:
+
+1. **Install build tools:**
+   ```bash
+   pip install build twine
+   ```
+
+2. **Generate Native Wrappers:**
+   Ensure your CDP protocol bindings are up-to-date:
+   ```bash
+   python src/pyquality/generate_cdp_wrappers.py
+   ```
+
+3. **Build wheels:**
+   ```bash
+   python -m build
+   ```
+   *This generates `.tar.gz` and `.whl` files in the `/dist` folder.*
+
+4. **Upload to PyPi (Requires Account):**
+   ```bash
+   python -m twine upload dist/*
+   ```
+
+5. **Done!** Users can now run `pip install pyquality`.

py4quality-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "py4quality"
+version = "0.1.0"
+description = "A highly user-friendly, kid-friendly automation framework using Chrome DevTools Protocol (CDP)."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+  { name="Venkata Santosh Tharigoppala" }
+]
+dependencies = [
+    "websocket-client>=1.6.1",
+    "requests>=2.31.0"
+]
+
+[project.urls]
+"Homepage" = "https://github.com/santoshtvk-new/Pyquality"
+"Bug Tracker" = "https://github.com/santoshtvk-new/Pyquality/issues"

py4quality-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

py4quality-0.1.0/src/py4quality.egg-info/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: py4quality
+Version: 0.1.0
+Summary: A highly user-friendly, kid-friendly automation framework using Chrome DevTools Protocol (CDP).
+Author: Venkata Santosh Tharigoppala
+License: MIT
+Project-URL: Homepage, https://github.com/santoshtvk-new/Pyquality
+Project-URL: Bug Tracker, https://github.com/santoshtvk-new/Pyquality/issues
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: websocket-client>=1.6.1
+Requires-Dist: requests>=2.31.0
+
+# pyquality 🎈
+
+A kid-friendly, yet exceptionally powerful automation framework for Python driven directly by the Chrome DevTools Protocol (CDP).
+
+`pyquality` is designed to be as simple as possible. Want to close the browser? Just call `b.bye()`. Want to navigate? `b.go_to("https://...")`
+
+Under the hood, it retains uncompromising power. Advanced users have **unfiltered access** to all 40+ raw Chromium DevTools domains (DOM, Network, Page, etc.) auto-generated from the official Google spec!
+
+---
+
+## 🚀 Installation (Source)
+If you are developing locally:
+```bash
+git clone https://github.com/santoshtvk-new/Pyquality.git
+cd pyquality
+pip install -e .
+```
+
+## 🛠️ Installation (PIP)
+*(When published to PyPi)*
+```bash
+pip install pyquality
+```
+
+---
+
+## 📖 Quick Start
+
+```python
+from pyquality.browser import Browser
+
+# 1. Start it up
+b = Browser(headless=False)
+
+# 2. Go somewhere
+b.go_to("https://example.com")
+
+# 3. Validation is easy
+b.should_be_seen("h1")
+
+# 4. Say goodbye
+b.bye()
+```
+
+## ✨ The Kid-Friendly Aliases
+
+`pyquality` dynamically binds methods defined in `METHOD_ALIASES.yml` so you can use vocabulary that makes sense to you.
+
+### Navigation
+- `navigate(url)` -> `go_to`, `open_website`
+- `reload()` -> `refresh`, `reload_page`
+- `close()` -> `close_browser`, `bye`
+- `go_back()` -> `step_back`, `previous_page`
+- `go_forward()` -> `step_forward`, `next_page`
+
+### Interaction
+- `click_element(selector)` -> `click_this`, `tap`
+- `type_text(selector, text)` -> `type_in`, `write_this`
+- `hover_element(selector)` -> `point_at`, `hover_over`
+
+### APIs & Data
+- `API.get(endpoint)` -> `fetch_data`, `grab`
+- `API.post(endpoint, json)` -> `create_data`, `send_new`
+
+---
+
+## ⚡ Raw CDP Power (Advanced)
+
+If you need capabilities beyond the simple wrappers, `pyquality` has raw auto-generated bindings for **EVERY** CDP Domain. They are attached natively to the browser instance:
+
+```python
+from pyquality.browser import Browser
+b = Browser()
+
+# Use raw 'Page' domain to capture a PDF
+b.page.printToPDF()
+
+# Use raw 'Network' domain to throttle connection
+b.network.emulateNetworkConditions(
+    offline=False, 
+    latency=200, 
+    downloadThroughput=1000, 
+    uploadThroughput=1000
+)
+
+# Use raw 'DOM' domain to get node information
+b.dom.getDocument(depth=-1)
+```
+
+## 📦 Deploying Initial PIP Package
+
+To package this framework and upload it to PyPi:
+
+1. **Install build tools:**
+   ```bash
+   pip install build twine
+   ```
+
+2. **Generate Native Wrappers:**
+   Ensure your CDP protocol bindings are up-to-date:
+   ```bash
+   python src/pyquality/generate_cdp_wrappers.py
+   ```
+
+3. **Build wheels:**
+   ```bash
+   python -m build
+   ```
+   *This generates `.tar.gz` and `.whl` files in the `/dist` folder.*
+
+4. **Upload to PyPi (Requires Account):**
+   ```bash
+   python -m twine upload dist/*
+   ```
+
+5. **Done!** Users can now run `pip install pyquality`.

py4quality-0.1.0/src/py4quality.egg-info/SOURCES.txt

@@ -0,0 +1,62 @@
+README.md
+pyproject.toml
+src/py4quality.egg-info/PKG-INFO
+src/py4quality.egg-info/SOURCES.txt
+src/py4quality.egg-info/dependency_links.txt
+src/py4quality.egg-info/requires.txt
+src/py4quality.egg-info/top_level.txt
+src/pyquality/__init__.py
+src/pyquality/api.py
+src/pyquality/browser.py
+src/pyquality/cdp_driver.py
+src/pyquality/generate_cdp_wrappers.py
+src/pyquality/domains/__init__.py
+src/pyquality/domains/accessibility.py
+src/pyquality/domains/animation.py
+src/pyquality/domains/audits.py
+src/pyquality/domains/autofill.py
+src/pyquality/domains/backgroundservice.py
+src/pyquality/domains/bluetoothemulation.py
+src/pyquality/domains/browser.py
+src/pyquality/domains/cachestorage.py
+src/pyquality/domains/cast.py
+src/pyquality/domains/css.py
+src/pyquality/domains/deviceaccess.py
+src/pyquality/domains/deviceorientation.py
+src/pyquality/domains/dom.py
+src/pyquality/domains/domdebugger.py
+src/pyquality/domains/domsnapshot.py
+src/pyquality/domains/domstorage.py
+src/pyquality/domains/emulation.py
+src/pyquality/domains/eventbreakpoints.py
+src/pyquality/domains/extensions.py
+src/pyquality/domains/fedcm.py
+src/pyquality/domains/fetch.py
+src/pyquality/domains/filesystem.py
+src/pyquality/domains/headlessexperimental.py
+src/pyquality/domains/indexeddb.py
+src/pyquality/domains/input.py
+src/pyquality/domains/inspector.py
+src/pyquality/domains/io.py
+src/pyquality/domains/layertree.py
+src/pyquality/domains/log.py
+src/pyquality/domains/media.py
+src/pyquality/domains/memory.py
+src/pyquality/domains/network.py
+src/pyquality/domains/overlay.py
+src/pyquality/domains/page.py
+src/pyquality/domains/performance.py
+src/pyquality/domains/performancetimeline.py
+src/pyquality/domains/preload.py
+src/pyquality/domains/pwa.py
+src/pyquality/domains/security.py
+src/pyquality/domains/serviceworker.py
+src/pyquality/domains/smartcardemulation.py
+src/pyquality/domains/storage.py
+src/pyquality/domains/systeminfo.py
+src/pyquality/domains/target.py
+src/pyquality/domains/tethering.py
+src/pyquality/domains/tracing.py
+src/pyquality/domains/webaudio.py
+src/pyquality/domains/webauthn.py
+src/pyquality/domains/webmcp.py

py4quality-0.1.0/src/py4quality.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

py4quality-0.1.0/src/py4quality.egg-info/requires.txt

@@ -0,0 +1,2 @@
+websocket-client>=1.6.1
+requests>=2.31.0

py4quality-0.1.0/src/py4quality.egg-info/top_level.txt

@@ -0,0 +1 @@
+pyquality

py4quality-0.1.0/src/pyquality/__init__.py

@@ -0,0 +1,15 @@
+import yaml
+import os
+
+def load_aliases():
+    alias_path = os.path.join(os.path.dirname(__file__), "..", "..", "METHOD_ALIASES.yml")
+    if not os.path.exists(alias_path):
+        return {}
+    with open(alias_path, 'r') as f:
+        return yaml.safe_load(f)
+
+# The loaded aliases can be used by the browser instance to dynamically map methods.
+ALIASES = load_aliases()
+
+from .api import API
+__version__ = "0.1.0"

py4quality-0.1.0/src/pyquality/api.py

@@ -0,0 +1,59 @@
+import requests
+
+class API:
+    """
+    Kid-friendly wrapper for REST API calls.
+    """
+    def __init__(self, base_url=""):
+        self.base_url = base_url
+        self.session = requests.Session()
+        self._apply_aliases()
+
+    def _apply_aliases(self):
+        """Bind kid-friendly aliases to instance methods dynamically."""
+        from .__init__ import ALIASES
+        if "api" in ALIASES:
+            for method_name, aliases in ALIASES["api"].items():
+                if hasattr(self, method_name):
+                    func = getattr(self, method_name)
+                    for alias in aliases:
+                        setattr(self, alias, func)
+
+    def _build_url(self, endpoint):
+        if endpoint.startswith("http"):
+            return endpoint
+        return f"{self.base_url.rstrip('/')}/{endpoint.lstrip('/')}"
+
+    def set_header(self, key, value):
+        """Set a header for subsequent requests."""
+        self.session.headers.update({key: value})
+
+    def use_token(self, token):
+        """Authenticate with a Bearer token."""
+        self.set_header("Authorization", f"Bearer {token}")
+
+    def get(self, endpoint, **kwargs):
+        """Send a GET request."""
+        return self.session.get(self._build_url(endpoint), **kwargs)
+
+    def post(self, endpoint, json=None, data=None, **kwargs):
+        """Send a POST request."""
+        return self.session.post(self._build_url(endpoint), json=json, data=data, **kwargs)
+
+    def put(self, endpoint, json=None, data=None, **kwargs):
+        """Send a PUT request."""
+        return self.session.put(self._build_url(endpoint), json=json, data=data, **kwargs)
+
+    def delete(self, endpoint, **kwargs):
+        """Send a DELETE request."""
+        return self.session.delete(self._build_url(endpoint), **kwargs)
+
+    def patch(self, endpoint, json=None, data=None, **kwargs):
+        """Send a PATCH request."""
+        return self.session.patch(self._build_url(endpoint), json=json, data=data, **kwargs)
+
+    def should_be_status(self, response, expected_status):
+        """Kid-friendly assertion for status codes."""
+        if response.status_code != expected_status:
+            raise AssertionError(f"Expected status {expected_status}, but got {response.status_code}.")
+        return True