apmt-reports 0.1.0__tar.gz

apmt_reports-0.1.0/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include src/pytest_apmt_reporter/templates *.html

apmt_reports-0.1.0/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: apmt-reports
+Version: 0.1.0
+Summary: A premium, feature-rich, and beautiful automated testing HTML reporter for pytest, python, and playwright.
+License: MIT
+Classifier: Framework :: Pytest
+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: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: pytest>=7.0.0
+Requires-Dist: jinja2>=3.0.0
+
+# ⚡ pytest-apmt-reporter
+
+`pytest-apmt-reporter` is a premium, feature-rich, and visually stunning automated testing HTML reporter for **Python**, **Pytest**, and **Playwright**. It is designed as a modern, high-fidelity alternative to Allure and Robot Framework, providing responsive layouts, glowing glassmorphic dark-mode dashboards, interactive SVG charts, expandable execution step logs, failure tracebacks, and seamlessly embedded Playwright screenshots.
+
+## ✨ Features
+
+- **🔌 True Plug-and-Play (Auto-Detect):** By hooking directly into standard pytest entry points, the reporter is automatically active the moment you `pip install` it. No configuration changes required!
+- **🌐 100% Offline-First (Self-Contained):** The final report compiles all layout, styles (CSS), logic (JS), and screenshots (base64 encoded PNGs) into a **single, standalone HTML file**. It requires absolutely zero Internet connection or CDNs to load, making it perfect for secure environments or CI/CD artifacts.
+- **🎨 Premium Visual Dashboard:** Designed with premium glassmorphism card layouts, smooth transition animations, sleek dark mode (with a light theme toggle), and neon indicators for passed/failed tests.
+- **📊 Interactive SVG Charts:** Includes clean, responsive circular progress indicators and data distributions drawn directly via SVG and animated with vanilla JS—no heavy charting libraries (like Chart.js) needed.
+- **📸 Auto Playwright Failure screenshots:** If a test case utilizes a Playwright `page` fixture and fails, the reporter **automatically captures and embeds** a failure screenshot inside the report.
+- **📝 Hierarchical Step Logging:** Allows defining nested execution steps using either standard decorators (`@apmt.step`) or context managers (`with apmt.step`), mirroring Allure and Robot Framework.
+- **📎 Multi-format Attachments:** Programmatically attach raw logs, JSON blobs, HTML widgets, and custom screenshots to any step or stage.
+
+---
+
+## 🚀 Installation
+
+You can easily install the reporter directly into your Python virtual environment from your project directory:
+
+```bash
+# Clone the repository and install in editable mode
+pip install -e .
+```
+
+---
+
+## 🛠️ Usage
+
+Once installed, running pytest will automatically enable the reporter and generate a file named `report.html` in your working directory.
+
+### Basic Commands
+
+```bash
+# Run pytest tests and generate the report with default parameters
+pytest
+
+# Specify a custom report name or output directory
+pytest --apmt-html=outputs/custom_dashboard.html
+
+# Provide a custom title for your report dashboard
+pytest --apmt-title="E2E Portal Smoketests"
+```
+
+---
+
+## 📝 Code API Examples
+
+### 1. Step-by-Step Logging
+
+Organize your test cases into nested, readable, and timed blocks:
+
+```python
+import pytest_apmt_reporter as apmt
+
+# Using step decorator
+@apmt.step("Authenticate credentials")
+def login(username, password):
+    ...
+
+def test_user_purchase_flow():
+    # Using step context manager
+    with apmt.step("Initialize customer basket"):
+        basket_id = 9988
+        
+    login("test_user", "password123")
+```
+
+### 2. Attaching Screenshots and Metadata
+
+Enrich your reports with logs, JSON responses, or manual Playwright screenshots:
+
+```python
+import pytest_apmt_reporter as apmt
+
+def test_payment_gateway_api():
+    # Attach plain text logs
+    apmt.attach("Connecting to stripe sandbox...", name="Stripe API Connection")
+    
+    # Attach JSON payload
+    apmt.attach('{"id": "ch_3M4", "status": "succeeded"}', name="Stripe Response", attachment_type=apmt.AttachmentType.JSON)
+    
+def test_dashboard_visual(page):
+    # Capture and attach a playwright page screenshot manually
+    page.goto("https://admin.portal.local")
+    apmt.attach_screenshot(page, name="Dashboard Main Panel")
+```
+
+### 3. Custom Dashboard Environment Stats
+
+Display important execution parameters (like environment, server names, CI build IDs) directly on the metrics header:
+
+```python
+import pytest_apmt_reporter as apmt
+
+def test_initialize():
+    apmt.set_environment_info("Environment", "Staging-US-East")
+    apmt.set_environment_info("Release Version", "v4.12.0-rc2")
+```
+
+---
+
+## 📊 Try the Demo
+
+Run the pre-configured demo test suite in the repository to see all features in action:
+
+```bash
+# Run the demo tests
+pytest demo/test_playwright_demo.py --apmt-html=demo_report.html
+
+# Open the beautiful dashboard!
+# Windows (PowerShell):
+Start-Process demo_report.html
+# macOS/Linux:
+open demo_report.html
+```

apmt_reports-0.1.0/README.md

@@ -0,0 +1,116 @@
+# ⚡ pytest-apmt-reporter
+
+`pytest-apmt-reporter` is a premium, feature-rich, and visually stunning automated testing HTML reporter for **Python**, **Pytest**, and **Playwright**. It is designed as a modern, high-fidelity alternative to Allure and Robot Framework, providing responsive layouts, glowing glassmorphic dark-mode dashboards, interactive SVG charts, expandable execution step logs, failure tracebacks, and seamlessly embedded Playwright screenshots.
+
+## ✨ Features
+
+- **🔌 True Plug-and-Play (Auto-Detect):** By hooking directly into standard pytest entry points, the reporter is automatically active the moment you `pip install` it. No configuration changes required!
+- **🌐 100% Offline-First (Self-Contained):** The final report compiles all layout, styles (CSS), logic (JS), and screenshots (base64 encoded PNGs) into a **single, standalone HTML file**. It requires absolutely zero Internet connection or CDNs to load, making it perfect for secure environments or CI/CD artifacts.
+- **🎨 Premium Visual Dashboard:** Designed with premium glassmorphism card layouts, smooth transition animations, sleek dark mode (with a light theme toggle), and neon indicators for passed/failed tests.
+- **📊 Interactive SVG Charts:** Includes clean, responsive circular progress indicators and data distributions drawn directly via SVG and animated with vanilla JS—no heavy charting libraries (like Chart.js) needed.
+- **📸 Auto Playwright Failure screenshots:** If a test case utilizes a Playwright `page` fixture and fails, the reporter **automatically captures and embeds** a failure screenshot inside the report.
+- **📝 Hierarchical Step Logging:** Allows defining nested execution steps using either standard decorators (`@apmt.step`) or context managers (`with apmt.step`), mirroring Allure and Robot Framework.
+- **📎 Multi-format Attachments:** Programmatically attach raw logs, JSON blobs, HTML widgets, and custom screenshots to any step or stage.
+
+---
+
+## 🚀 Installation
+
+You can easily install the reporter directly into your Python virtual environment from your project directory:
+
+```bash
+# Clone the repository and install in editable mode
+pip install -e .
+```
+
+---
+
+## 🛠️ Usage
+
+Once installed, running pytest will automatically enable the reporter and generate a file named `report.html` in your working directory.
+
+### Basic Commands
+
+```bash
+# Run pytest tests and generate the report with default parameters
+pytest
+
+# Specify a custom report name or output directory
+pytest --apmt-html=outputs/custom_dashboard.html
+
+# Provide a custom title for your report dashboard
+pytest --apmt-title="E2E Portal Smoketests"
+```
+
+---
+
+## 📝 Code API Examples
+
+### 1. Step-by-Step Logging
+
+Organize your test cases into nested, readable, and timed blocks:
+
+```python
+import pytest_apmt_reporter as apmt
+
+# Using step decorator
+@apmt.step("Authenticate credentials")
+def login(username, password):
+    ...
+
+def test_user_purchase_flow():
+    # Using step context manager
+    with apmt.step("Initialize customer basket"):
+        basket_id = 9988
+        
+    login("test_user", "password123")
+```
+
+### 2. Attaching Screenshots and Metadata
+
+Enrich your reports with logs, JSON responses, or manual Playwright screenshots:
+
+```python
+import pytest_apmt_reporter as apmt
+
+def test_payment_gateway_api():
+    # Attach plain text logs
+    apmt.attach("Connecting to stripe sandbox...", name="Stripe API Connection")
+    
+    # Attach JSON payload
+    apmt.attach('{"id": "ch_3M4", "status": "succeeded"}', name="Stripe Response", attachment_type=apmt.AttachmentType.JSON)
+    
+def test_dashboard_visual(page):
+    # Capture and attach a playwright page screenshot manually
+    page.goto("https://admin.portal.local")
+    apmt.attach_screenshot(page, name="Dashboard Main Panel")
+```
+
+### 3. Custom Dashboard Environment Stats
+
+Display important execution parameters (like environment, server names, CI build IDs) directly on the metrics header:
+
+```python
+import pytest_apmt_reporter as apmt
+
+def test_initialize():
+    apmt.set_environment_info("Environment", "Staging-US-East")
+    apmt.set_environment_info("Release Version", "v4.12.0-rc2")
+```
+
+---
+
+## 📊 Try the Demo
+
+Run the pre-configured demo test suite in the repository to see all features in action:
+
+```bash
+# Run the demo tests
+pytest demo/test_playwright_demo.py --apmt-html=demo_report.html
+
+# Open the beautiful dashboard!
+# Windows (PowerShell):
+Start-Process demo_report.html
+# macOS/Linux:
+open demo_report.html
+```

apmt_reports-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "apmt-reports"
+version = "0.1.0"
+description = "A premium, feature-rich, and beautiful automated testing HTML reporter for pytest, python, and playwright."
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+classifiers = [
+    "Framework :: Pytest",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Testing",
+]
+dependencies = [
+    "pytest>=7.0.0",
+    "jinja2>=3.0.0",
+]
+
+[project.entry-points.pytest11]
+apmt_reporter = "pytest_apmt_reporter.plugin"
+
+[tool.setuptools.packages.find]
+where = ["src"]

apmt_reports-0.1.0/setup.cfg

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

apmt_reports-0.1.0/setup.py

@@ -0,0 +1,18 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="apmt-reports",
+    version="0.1.0",
+    package_dir={"": "src"},
+    packages=find_packages(where="src"),
+    include_package_data=True,
+    install_requires=[
+        "pytest>=7.0.0",
+        "jinja2>=3.0.0",
+    ],
+    entry_points={
+        "pytest11": [
+            "apmt_reporter = pytest_apmt_reporter.plugin",
+        ],
+    },
+)

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

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: apmt-reports
+Version: 0.1.0
+Summary: A premium, feature-rich, and beautiful automated testing HTML reporter for pytest, python, and playwright.
+License: MIT
+Classifier: Framework :: Pytest
+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: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: pytest>=7.0.0
+Requires-Dist: jinja2>=3.0.0
+
+# ⚡ pytest-apmt-reporter
+
+`pytest-apmt-reporter` is a premium, feature-rich, and visually stunning automated testing HTML reporter for **Python**, **Pytest**, and **Playwright**. It is designed as a modern, high-fidelity alternative to Allure and Robot Framework, providing responsive layouts, glowing glassmorphic dark-mode dashboards, interactive SVG charts, expandable execution step logs, failure tracebacks, and seamlessly embedded Playwright screenshots.
+
+## ✨ Features
+
+- **🔌 True Plug-and-Play (Auto-Detect):** By hooking directly into standard pytest entry points, the reporter is automatically active the moment you `pip install` it. No configuration changes required!
+- **🌐 100% Offline-First (Self-Contained):** The final report compiles all layout, styles (CSS), logic (JS), and screenshots (base64 encoded PNGs) into a **single, standalone HTML file**. It requires absolutely zero Internet connection or CDNs to load, making it perfect for secure environments or CI/CD artifacts.
+- **🎨 Premium Visual Dashboard:** Designed with premium glassmorphism card layouts, smooth transition animations, sleek dark mode (with a light theme toggle), and neon indicators for passed/failed tests.
+- **📊 Interactive SVG Charts:** Includes clean, responsive circular progress indicators and data distributions drawn directly via SVG and animated with vanilla JS—no heavy charting libraries (like Chart.js) needed.
+- **📸 Auto Playwright Failure screenshots:** If a test case utilizes a Playwright `page` fixture and fails, the reporter **automatically captures and embeds** a failure screenshot inside the report.
+- **📝 Hierarchical Step Logging:** Allows defining nested execution steps using either standard decorators (`@apmt.step`) or context managers (`with apmt.step`), mirroring Allure and Robot Framework.
+- **📎 Multi-format Attachments:** Programmatically attach raw logs, JSON blobs, HTML widgets, and custom screenshots to any step or stage.
+
+---
+
+## 🚀 Installation
+
+You can easily install the reporter directly into your Python virtual environment from your project directory:
+
+```bash
+# Clone the repository and install in editable mode
+pip install -e .
+```
+
+---
+
+## 🛠️ Usage
+
+Once installed, running pytest will automatically enable the reporter and generate a file named `report.html` in your working directory.
+
+### Basic Commands
+
+```bash
+# Run pytest tests and generate the report with default parameters
+pytest
+
+# Specify a custom report name or output directory
+pytest --apmt-html=outputs/custom_dashboard.html
+
+# Provide a custom title for your report dashboard
+pytest --apmt-title="E2E Portal Smoketests"
+```
+
+---
+
+## 📝 Code API Examples
+
+### 1. Step-by-Step Logging
+
+Organize your test cases into nested, readable, and timed blocks:
+
+```python
+import pytest_apmt_reporter as apmt
+
+# Using step decorator
+@apmt.step("Authenticate credentials")
+def login(username, password):
+    ...
+
+def test_user_purchase_flow():
+    # Using step context manager
+    with apmt.step("Initialize customer basket"):
+        basket_id = 9988
+        
+    login("test_user", "password123")
+```
+
+### 2. Attaching Screenshots and Metadata
+
+Enrich your reports with logs, JSON responses, or manual Playwright screenshots:
+
+```python
+import pytest_apmt_reporter as apmt
+
+def test_payment_gateway_api():
+    # Attach plain text logs
+    apmt.attach("Connecting to stripe sandbox...", name="Stripe API Connection")
+    
+    # Attach JSON payload
+    apmt.attach('{"id": "ch_3M4", "status": "succeeded"}', name="Stripe Response", attachment_type=apmt.AttachmentType.JSON)
+    
+def test_dashboard_visual(page):
+    # Capture and attach a playwright page screenshot manually
+    page.goto("https://admin.portal.local")
+    apmt.attach_screenshot(page, name="Dashboard Main Panel")
+```
+
+### 3. Custom Dashboard Environment Stats
+
+Display important execution parameters (like environment, server names, CI build IDs) directly on the metrics header:
+
+```python
+import pytest_apmt_reporter as apmt
+
+def test_initialize():
+    apmt.set_environment_info("Environment", "Staging-US-East")
+    apmt.set_environment_info("Release Version", "v4.12.0-rc2")
+```
+
+---
+
+## 📊 Try the Demo
+
+Run the pre-configured demo test suite in the repository to see all features in action:
+
+```bash
+# Run the demo tests
+pytest demo/test_playwright_demo.py --apmt-html=demo_report.html
+
+# Open the beautiful dashboard!
+# Windows (PowerShell):
+Start-Process demo_report.html
+# macOS/Linux:
+open demo_report.html
+```

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

@@ -0,0 +1,15 @@
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+src/apmt_reports.egg-info/PKG-INFO
+src/apmt_reports.egg-info/SOURCES.txt
+src/apmt_reports.egg-info/dependency_links.txt
+src/apmt_reports.egg-info/entry_points.txt
+src/apmt_reports.egg-info/requires.txt
+src/apmt_reports.egg-info/top_level.txt
+src/pytest_apmt_reporter/__init__.py
+src/pytest_apmt_reporter/html_generator.py
+src/pytest_apmt_reporter/model.py
+src/pytest_apmt_reporter/plugin.py
+src/pytest_apmt_reporter/templates/report_template.html

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

@@ -0,0 +1 @@
+

apmt_reports-0.1.0/src/apmt_reports.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[pytest11]
+apmt_reporter = pytest_apmt_reporter.plugin

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

@@ -0,0 +1,2 @@
+pytest>=7.0.0
+jinja2>=3.0.0

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

@@ -0,0 +1 @@
+pytest_apmt_reporter

apmt_reports-0.1.0/src/pytest_apmt_reporter/__init__.py

@@ -0,0 +1,188 @@
+import base64
+import inspect
+import threading
+from typing import Any, Callable, List, Optional, Union
+import functools
+import time
+
+from .model import TestCase, Step, Attachment, TestStage
+
+# Thread-local state to track active test cases and step hierarchies
+class APMTRuntimeState(threading.local):
+    def __init__(self):
+        self.active_test: Optional[TestCase] = None
+        self.active_stage_name: str = "call"  # "setup", "call", "teardown"
+        self.step_stack: List[Step] = []
+        self.environment: dict = {}
+
+state = APMTRuntimeState()
+
+class AttachmentType:
+    TEXT = "text/plain"
+    HTML = "text/html"
+    JSON = "application/json"
+    PNG = "image/png"
+    JPG = "image/jpeg"
+    SVG = "image/svg+xml"
+
+class StepContext:
+    def __init__(self, name: str):
+        self.name = name
+        self.step: Optional[Step] = None
+
+    def __enter__(self):
+        self.step = Step(name=self.name)
+        if state.step_stack:
+            # Nest within parent step
+            state.step_stack[-1].steps.append(self.step)
+        else:
+            # Add to active test stage
+            if state.active_test:
+                stage = state.active_test.stages[state.active_stage_name]
+                stage.steps.append(self.step)
+                # Also mirror to test flattend steps
+                state.active_test.steps.append(self.step)
+        
+        state.step_stack.append(self.step)
+        return self.step
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        if not self.step:
+            return False
+        
+        status = "passed"
+        exception_msg = None
+        tb_str = None
+        
+        if exc_type:
+            status = "failed"
+            exception_msg = f"{exc_type.__name__}: {str(exc_val)}"
+            import traceback
+            tb_str = "".join(traceback.format_exception(exc_type, exc_val, exc_tb))
+            
+        self.step.finish(status=status, exception_message=exception_msg, traceback=tb_str)
+        
+        if state.step_stack and state.step_stack[-1] == self.step:
+            state.step_stack.pop()
+            
+        # Let exceptions bubble up
+        return False
+
+    def __call__(self, func: Callable) -> Callable:
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs):
+            with StepContext(self.name):
+                return func(*args, **kwargs)
+        return wrapper
+
+def step(name_or_func: Union[str, Callable]) -> Any:
+    """Decorator or context manager for defining steps.
+    
+    Usage as decorator:
+        @step("Perform login")
+        def login(user, password):
+            ...
+            
+    Usage as context manager:
+        with step("Perform login"):
+            ...
+    """
+    if isinstance(name_or_func, str):
+        return StepContext(name_or_func)
+    else:
+        # Direct decorator without name (use func name)
+        func = name_or_func
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs):
+            step_name = func.__name__.replace('_', ' ').capitalize()
+            with StepContext(step_name):
+                return func(*args, **kwargs)
+        return wrapper
+
+def attach(
+    body: Union[str, bytes],
+    name: str = "Attachment",
+    attachment_type: str = AttachmentType.TEXT
+) -> None:
+    """Attach data or files to the current running test case or step.
+    
+    Args:
+        body: String content or binary bytes.
+        name: User-friendly name for the attachment.
+        attachment_type: MIME type of attachment (e.g. image/png, text/plain).
+    """
+    if not state.active_test:
+        return  # No active test running to attach to
+        
+    is_base64 = False
+    content_str = ""
+    
+    # Process content based on type
+    if isinstance(body, bytes):
+        if "image" in attachment_type or attachment_type in (AttachmentType.PNG, AttachmentType.JPG):
+            content_str = base64.b64encode(body).decode('utf-8')
+            is_base64 = True
+        else:
+            try:
+                content_str = body.decode('utf-8')
+            except UnicodeDecodeError:
+                content_str = base64.b64encode(body).decode('utf-8')
+                is_base64 = True
+    else:
+        content_str = str(body)
+        if attachment_type in (AttachmentType.PNG, AttachmentType.JPG):
+            # Already encoded base64 string
+            is_base64 = True
+
+    attachment = Attachment(name=name, content=content_str, mime_type=attachment_type, is_base64=is_base64)
+    
+    # Add to active step if any, else active stage, else active test
+    if state.step_stack:
+        state.step_stack[-1].attachments.append(attachment)
+    else:
+        stage = state.active_test.stages[state.active_stage_name]
+        stage.attachments.append(attachment)
+        state.active_test.attachments.append(attachment)
+
+def attach_screenshot(page: Any, name: str = "Screenshot") -> None:
+    """Helper to attach a Playwright screenshot. Works with both Sync and Async pages.
+    
+    Args:
+        page: Playwright Page instance.
+        name: Name of the screenshot attachment.
+    """
+    # Check if page is sync or async
+    screenshot_func = getattr(page, "screenshot", None)
+    if not screenshot_func:
+        return
+        
+    # Check if this is a coroutine function (async page)
+    if inspect.iscoroutinefunction(screenshot_func):
+        # We are inside sync code, so executing async is harder without direct await.
+        # But we can try to get the current running loop or advise using manual attach.
+        # However, many async tests run under pytest-asyncio, so we can run it in a thread/loop if possible,
+        # or grab the existing async context. 
+        # A simpler fallback is to let the user know, or execute it safely:
+        try:
+            import asyncio
+            loop = asyncio.get_event_loop()
+            if loop.is_running():
+                # We are in a running loop, scheduled as a task.
+                # Since we can't block, we can schedule the capture, but the test might finish.
+                # For safety, let's advise capturing bytes and attaching:
+                # apmt.attach(await page.screenshot(), "name", apmt.AttachmentType.PNG)
+                # But let's try to block if we can, or log a warning.
+                pass
+        except Exception:
+            pass
+    else:
+        # Sync Playwright page - easy!
+        try:
+            screenshot_bytes = page.screenshot(type="png")
+            attach(screenshot_bytes, name=name, attachment_type=AttachmentType.PNG)
+        except Exception as e:
+            attach(f"Failed to capture screenshot: {str(e)}", name=f"{name} (Failed Capture)", attachment_type=AttachmentType.TEXT)
+
+def set_environment_info(key: str, value: str) -> None:
+    """Sets a global environment variable to be displayed on the report dashboard."""
+    state.environment[key] = str(value)