qa-agent 0.2.0__tar.gz → 0.2.2__tar.gz

{qa_agent-0.2.0/qa_agent.egg-info → qa_agent-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qa-agent
-Version: 0.2.0
+Version: 0.2.2
 Summary: Agentic exploratory QA testing for web applications
 Author: Bill Richards
 License: MIT License
@@ -27,6 +27,7 @@ License: MIT License
         
 Project-URL: Homepage, https://github.com/billrichards/qa-agent
 Project-URL: Repository, https://github.com/billrichards/qa-agent
+Project-URL: Documentation, https://github.com/billrichards/qa-agent/blob/main/docs/README.md
 Project-URL: Issues, https://github.com/billrichards/qa-agent/issues
 Project-URL: Changelog, https://github.com/billrichards/qa-agent/blob/main/CHANGELOG.md
 Keywords: qa,testing,playwright,accessibility,agentic,automation,exploratory-testing
@@ -51,12 +52,13 @@ Requires-Dist: flask>=3.0; extra == "web"
 Requires-Dist: markdown>=3.5; extra == "web"
 Requires-Dist: nh3>=0.2.15; extra == "web"
 Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest>=8.0.0; extra == "dev"
 Requires-Dist: pytest-playwright>=0.4.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
 Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: pytest-xdist>=3.0.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: build>=1.0.0; extra == "dev"
 Provides-Extra: all
@@ -67,6 +69,10 @@ Dynamic: license-file
 
 Automated exploratory QA testing for web applications — powered by Playwright and, optionally, LLMs (Claude or GPT-4o).
 
+<p align="center">
+  <code>qa-agent example.com</code>
+</p>
+
 <p align="center">
   <a href="https://github.com/billrichards/qa-agent/actions/workflows/test.yml"><img src="https://github.com/billrichards/qa-agent/actions/workflows/test.yml/badge.svg" alt="Tests"></a>
   <a href="https://pypi.org/project/qa-agent/"><img src="https://img.shields.io/pypi/v/qa-agent" alt="PyPI version"></a>
@@ -89,18 +95,16 @@ Need targeted tests? Pass plain-English instructions and an LLM generates custom
 - [Features](#features)
 - [Installation](#installation)
 - [Quick Start](#quick-start)
+- [Programmatic Usage](#programmatic-usage)
 - [Agentic Testing](#agentic-testing)
 - [Web Interface & API](#web-interface--api)
 - [CLI Reference](#cli-reference)
-- [Programmatic Usage](#programmatic-usage)
 - [Test Categories](#test-categories)
 - [Output Formats](#output-formats)
 - [CI/CD Integration](#cicd-integration)
-- [Architecture](#architecture)
-- [Development](#development)
-- [Contributing](#contributing)
 - [Exit Codes](#exit-codes)
 - [Troubleshooting](#troubleshooting)
+- [Further Documentation](#further-documentation)
 - [License](#license)
 
 ---
@@ -169,6 +173,31 @@ python -m qa_agent https://example.com
 
 ---
 
+## Programmatic Usage
+
+```python
+from qa_agent import QAAgent, TestConfig, TestMode, OutputFormat
+
+config = TestConfig(
+    urls=["https://example.com"],
+    mode=TestMode.EXPLORE,
+    output_formats=[OutputFormat.CONSOLE, OutputFormat.JSON],
+    max_depth=2,
+    max_pages=10,
+    instructions="Verify the password reset flow.",  # optional
+)
+
+agent = QAAgent(config)
+session = agent.run()
+
+print(f"Pages tested:   {len(session.pages_tested)}")
+print(f"Total findings: {session.total_findings}")
+```
+
+→ [Full Python API Reference](https://github.com/billrichards/qa-agent/blob/main/docs/api-reference.md) — all classes, methods, and configuration options.
+
+---
+
 ## Agentic Testing
 
 Pass natural-language instructions and an LLM generates custom test steps that run alongside the standard suite. Supports **Anthropic** (Claude) and **OpenAI** (GPT-4o and others). No third-party AI packages are required — all API calls use Python's built-in `urllib`.
@@ -261,7 +290,7 @@ curl -N http://127.0.0.1:5000/api/stream/a1b2c3d4
 curl http://127.0.0.1:5000/api/sessions?limit=10
 ```
 
-→ [Full API reference](docs/web-api.md) — all endpoints, request body schema, and SSE event types.
+→ [Full API reference](https://github.com/billrichards/qa-agent/blob/main/docs/web-api.md) — all endpoints, request body schema, and SSE event types.
 
 ---
 
@@ -366,40 +395,11 @@ qa-agent --wcag-compliance    https://example.com
 
 ---
 
-## Programmatic Usage
-
-```python
-from qa_agent import QAAgent, TestConfig, TestMode, OutputFormat
-from qa_agent.llm_client import LLMProvider
-
-config = TestConfig(
-    urls=["https://example.com"],
-    mode=TestMode.EXPLORE,
-    output_formats=[OutputFormat.CONSOLE, OutputFormat.JSON],
-    max_depth=2,
-    max_pages=10,
-    instructions="Verify the password reset flow.",  # optional
-    llm_provider=LLMProvider.OPENAI,   # optional, default: LLMProvider.ANTHROPIC
-    ai_model="gpt-4o-mini",            # optional, default: None (uses provider default)
-)
-
-agent = QAAgent(config)
-session = agent.run()
-
-print(f"Pages tested:   {len(session.pages_tested)}")
-print(f"Total findings: {session.total_findings}")
-
-for finding in session.get_all_findings():
-    print(f"  [{finding.severity.value.upper()}] {finding.title}")
-```
-
----
-
 ## Test Categories
 
 Six built-in suites cover keyboard navigation, mouse interaction, form handling, accessibility (WCAG), runtime error detection, and an opt-in WCAG 2.1 AA compliance audit. Five run by default; enable the sixth with `--wcag-compliance`.
 
-→ [Detailed test-by-test reference](docs/test-categories.md)
+→ [Detailed test-by-test reference](https://github.com/billrichards/qa-agent/blob/main/docs/test-categories.md)
 
 ---
 
@@ -464,76 +464,6 @@ Exits with code `1` when critical or high severity issues are found, failing the
 
 ---
 
-## Architecture
-
-```
-qa_agent/
-├── cli.py                   # CLI entry point
-├── agent.py                 # Core orchestrator
-├── config.py                # Configuration dataclasses
-├── models.py                # Finding, PageAnalysis, TestSession, TestPlan
-├── llm_client.py            # Anthropic & OpenAI clients via stdlib urllib
-├── ai_planner.py            # LLM-powered test plan generation
-├── plan_cache.py            # Filesystem cache for test plans
-├── testers/
-│   ├── base.py              # BaseTester abstract class
-│   ├── keyboard.py          # Keyboard navigation
-│   ├── mouse.py             # Mouse interaction
-│   ├── forms.py             # Form handling
-│   ├── accessibility.py     # WCAG accessibility
-│   ├── wcag_compliance.py   # WCAG 2.1 AA compliance (opt-in)
-│   ├── errors.py            # Console & network errors
-│   └── custom.py            # AI-generated test steps
-├── reporters/
-│   ├── console.py           # Colored terminal output
-│   ├── markdown.py          # Markdown report
-│   ├── json_reporter.py     # JSON report
-│   └── pdf.py               # PDF report (requires weasyprint)
-└── web/
-    ├── server.py             # Flask app with SSE streaming
-    ├── templates/            # Jinja2 templates
-    └── static/               # CSS and JavaScript
-```
-
-→ [Extending QA Agent — adding custom testers](docs/architecture.md)
-
----
-
-## Development
-
-```bash
-git clone https://github.com/billrichards/qa-agent.git
-cd qa-agent
-pip install -e ".[dev,web,ai]"
-playwright install chromium
-
-# Unit tests (no browser needed)
-pytest -v -m "not integration and not network"
-
-# Integration tests (real Playwright)
-pytest -v -m integration --no-cov
-
-# Lint & type check
-ruff check .
-mypy qa_agent
-```
-
-CI runs unit tests across Python 3.10–3.12 on Ubuntu, macOS, and Windows. Integration tests run on Ubuntu with Playwright. See [`.github/workflows/test.yml`](.github/workflows/test.yml).
-
----
-
-## Contributing
-
-1. Fork the repository
-2. Create a feature branch (`git checkout -b my-feature`)
-3. Make your changes and add tests
-4. Run `pytest -v -m "not integration and not network"`
-5. Open a pull request against `main`
-
-Code style: Ruff + Black, line length 100.
-
----
-
 ## Exit Codes
 
 | Code | Meaning |
@@ -588,6 +518,19 @@ Requires **3.10+**. Check with `python --version`.
 
 ---
 
+## Further Documentation
+
+| Document | Description |
+|---|---|
+| [Architecture](https://github.com/billrichards/qa-agent/blob/main/docs/architecture.md) | System architecture and how to extend QA Agent |
+| [Development Guide](https://github.com/billrichards/qa-agent/blob/main/docs/development.md) | Detailed development setup, testing, and build processes |
+| [Python API Reference](https://github.com/billrichards/qa-agent/blob/main/docs/api-reference.md) | Programmatic usage for embedding QA Agent in Python code |
+| [Test Categories](https://github.com/billrichards/qa-agent/blob/main/docs/test-categories.md) | Detailed test-by-test reference |
+| [Web API](https://github.com/billrichards/qa-agent/blob/main/docs/web-api.md) | Full REST API documentation |
+| [Contributing](https://github.com/billrichards/qa-agent/blob/main/CONTRIBUTING.md) | Contribution guidelines and pull request process |
+
+---
+
 ## License
 
-MIT — Copyright (c) 2026 Bill Richards. See [LICENSE](LICENSE).
+MIT — Copyright (c) 2026 Bill Richards. See [LICENSE](https://github.com/billrichards/qa-agent/blob/main/LICENSE).

{qa_agent-0.2.0 → qa_agent-0.2.2}/README.md

@@ -2,6 +2,10 @@
 
 Automated exploratory QA testing for web applications — powered by Playwright and, optionally, LLMs (Claude or GPT-4o).
 
+<p align="center">
+  <code>qa-agent example.com</code>
+</p>
+
 <p align="center">
   <a href="https://github.com/billrichards/qa-agent/actions/workflows/test.yml"><img src="https://github.com/billrichards/qa-agent/actions/workflows/test.yml/badge.svg" alt="Tests"></a>
   <a href="https://pypi.org/project/qa-agent/"><img src="https://img.shields.io/pypi/v/qa-agent" alt="PyPI version"></a>
@@ -24,18 +28,16 @@ Need targeted tests? Pass plain-English instructions and an LLM generates custom
 - [Features](#features)
 - [Installation](#installation)
 - [Quick Start](#quick-start)
+- [Programmatic Usage](#programmatic-usage)
 - [Agentic Testing](#agentic-testing)
 - [Web Interface & API](#web-interface--api)
 - [CLI Reference](#cli-reference)
-- [Programmatic Usage](#programmatic-usage)
 - [Test Categories](#test-categories)
 - [Output Formats](#output-formats)
 - [CI/CD Integration](#cicd-integration)
-- [Architecture](#architecture)
-- [Development](#development)
-- [Contributing](#contributing)
 - [Exit Codes](#exit-codes)
 - [Troubleshooting](#troubleshooting)
+- [Further Documentation](#further-documentation)
 - [License](#license)
 
 ---
@@ -104,6 +106,31 @@ python -m qa_agent https://example.com
 
 ---
 
+## Programmatic Usage
+
+```python
+from qa_agent import QAAgent, TestConfig, TestMode, OutputFormat
+
+config = TestConfig(
+    urls=["https://example.com"],
+    mode=TestMode.EXPLORE,
+    output_formats=[OutputFormat.CONSOLE, OutputFormat.JSON],
+    max_depth=2,
+    max_pages=10,
+    instructions="Verify the password reset flow.",  # optional
+)
+
+agent = QAAgent(config)
+session = agent.run()
+
+print(f"Pages tested:   {len(session.pages_tested)}")
+print(f"Total findings: {session.total_findings}")
+```
+
+→ [Full Python API Reference](https://github.com/billrichards/qa-agent/blob/main/docs/api-reference.md) — all classes, methods, and configuration options.
+
+---
+
 ## Agentic Testing
 
 Pass natural-language instructions and an LLM generates custom test steps that run alongside the standard suite. Supports **Anthropic** (Claude) and **OpenAI** (GPT-4o and others). No third-party AI packages are required — all API calls use Python's built-in `urllib`.
@@ -196,7 +223,7 @@ curl -N http://127.0.0.1:5000/api/stream/a1b2c3d4
 curl http://127.0.0.1:5000/api/sessions?limit=10
 ```
 
-→ [Full API reference](docs/web-api.md) — all endpoints, request body schema, and SSE event types.
+→ [Full API reference](https://github.com/billrichards/qa-agent/blob/main/docs/web-api.md) — all endpoints, request body schema, and SSE event types.
 
 ---
 
@@ -301,40 +328,11 @@ qa-agent --wcag-compliance    https://example.com
 
 ---
 
-## Programmatic Usage
-
-```python
-from qa_agent import QAAgent, TestConfig, TestMode, OutputFormat
-from qa_agent.llm_client import LLMProvider
-
-config = TestConfig(
-    urls=["https://example.com"],
-    mode=TestMode.EXPLORE,
-    output_formats=[OutputFormat.CONSOLE, OutputFormat.JSON],
-    max_depth=2,
-    max_pages=10,
-    instructions="Verify the password reset flow.",  # optional
-    llm_provider=LLMProvider.OPENAI,   # optional, default: LLMProvider.ANTHROPIC
-    ai_model="gpt-4o-mini",            # optional, default: None (uses provider default)
-)
-
-agent = QAAgent(config)
-session = agent.run()
-
-print(f"Pages tested:   {len(session.pages_tested)}")
-print(f"Total findings: {session.total_findings}")
-
-for finding in session.get_all_findings():
-    print(f"  [{finding.severity.value.upper()}] {finding.title}")
-```
-
----
-
 ## Test Categories
 
 Six built-in suites cover keyboard navigation, mouse interaction, form handling, accessibility (WCAG), runtime error detection, and an opt-in WCAG 2.1 AA compliance audit. Five run by default; enable the sixth with `--wcag-compliance`.
 
-→ [Detailed test-by-test reference](docs/test-categories.md)
+→ [Detailed test-by-test reference](https://github.com/billrichards/qa-agent/blob/main/docs/test-categories.md)
 
 ---
 
@@ -399,76 +397,6 @@ Exits with code `1` when critical or high severity issues are found, failing the
 
 ---
 
-## Architecture
-
-```
-qa_agent/
-├── cli.py                   # CLI entry point
-├── agent.py                 # Core orchestrator
-├── config.py                # Configuration dataclasses
-├── models.py                # Finding, PageAnalysis, TestSession, TestPlan
-├── llm_client.py            # Anthropic & OpenAI clients via stdlib urllib
-├── ai_planner.py            # LLM-powered test plan generation
-├── plan_cache.py            # Filesystem cache for test plans
-├── testers/
-│   ├── base.py              # BaseTester abstract class
-│   ├── keyboard.py          # Keyboard navigation
-│   ├── mouse.py             # Mouse interaction
-│   ├── forms.py             # Form handling
-│   ├── accessibility.py     # WCAG accessibility
-│   ├── wcag_compliance.py   # WCAG 2.1 AA compliance (opt-in)
-│   ├── errors.py            # Console & network errors
-│   └── custom.py            # AI-generated test steps
-├── reporters/
-│   ├── console.py           # Colored terminal output
-│   ├── markdown.py          # Markdown report
-│   ├── json_reporter.py     # JSON report
-│   └── pdf.py               # PDF report (requires weasyprint)
-└── web/
-    ├── server.py             # Flask app with SSE streaming
-    ├── templates/            # Jinja2 templates
-    └── static/               # CSS and JavaScript
-```
-
-→ [Extending QA Agent — adding custom testers](docs/architecture.md)
-
----
-
-## Development
-
-```bash
-git clone https://github.com/billrichards/qa-agent.git
-cd qa-agent
-pip install -e ".[dev,web,ai]"
-playwright install chromium
-
-# Unit tests (no browser needed)
-pytest -v -m "not integration and not network"
-
-# Integration tests (real Playwright)
-pytest -v -m integration --no-cov
-
-# Lint & type check
-ruff check .
-mypy qa_agent
-```
-
-CI runs unit tests across Python 3.10–3.12 on Ubuntu, macOS, and Windows. Integration tests run on Ubuntu with Playwright. See [`.github/workflows/test.yml`](.github/workflows/test.yml).
-
----
-
-## Contributing
-
-1. Fork the repository
-2. Create a feature branch (`git checkout -b my-feature`)
-3. Make your changes and add tests
-4. Run `pytest -v -m "not integration and not network"`
-5. Open a pull request against `main`
-
-Code style: Ruff + Black, line length 100.
-
----
-
 ## Exit Codes
 
 | Code | Meaning |
@@ -523,6 +451,19 @@ Requires **3.10+**. Check with `python --version`.
 
 ---
 
+## Further Documentation
+
+| Document | Description |
+|---|---|
+| [Architecture](https://github.com/billrichards/qa-agent/blob/main/docs/architecture.md) | System architecture and how to extend QA Agent |
+| [Development Guide](https://github.com/billrichards/qa-agent/blob/main/docs/development.md) | Detailed development setup, testing, and build processes |
+| [Python API Reference](https://github.com/billrichards/qa-agent/blob/main/docs/api-reference.md) | Programmatic usage for embedding QA Agent in Python code |
+| [Test Categories](https://github.com/billrichards/qa-agent/blob/main/docs/test-categories.md) | Detailed test-by-test reference |
+| [Web API](https://github.com/billrichards/qa-agent/blob/main/docs/web-api.md) | Full REST API documentation |
+| [Contributing](https://github.com/billrichards/qa-agent/blob/main/CONTRIBUTING.md) | Contribution guidelines and pull request process |
+
+---
+
 ## License
 
-MIT — Copyright (c) 2026 Bill Richards. See [LICENSE](LICENSE).
+MIT — Copyright (c) 2026 Bill Richards. See [LICENSE](https://github.com/billrichards/qa-agent/blob/main/LICENSE).

{qa_agent-0.2.0 → qa_agent-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qa-agent"
-version = "0.2.0"
+version = "0.2.2"
 description = "Agentic exploratory QA testing for web applications"
 readme = "README.md"
 license = {file = "LICENSE"}
@@ -37,12 +37,13 @@ web = [
     "nh3>=0.2.15",
 ]
 dev = [
-    "pytest>=7.0.0",
+    "pytest>=8.0.0",
     "pytest-playwright>=0.4.0",
-    "pytest-cov>=4.0.0",
+    "pytest-cov>=5.0.0",
     "pytest-mock>=3.10.0",
+    "pytest-xdist>=3.0.0",
     "black>=23.0.0",
-    "ruff>=0.1.0",
+    "ruff>=0.4.0",
     "mypy>=1.0.0",
     "build>=1.0.0",
 ]
@@ -57,6 +58,7 @@ qa-agent-web = "qa_agent.web:serve_web_cli"
 [project.urls]
 Homepage = "https://github.com/billrichards/qa-agent"
 Repository = "https://github.com/billrichards/qa-agent"
+Documentation = "https://github.com/billrichards/qa-agent/blob/main/docs/README.md"
 Issues = "https://github.com/billrichards/qa-agent/issues"
 Changelog = "https://github.com/billrichards/qa-agent/blob/main/CHANGELOG.md"
 

{qa_agent-0.2.0 → qa_agent-0.2.2}/qa_agent/__init__.py

@@ -11,4 +11,4 @@ try:
     __version__ = version("qa-agent")
 except PackageNotFoundError:
     # Package not installed (e.g. running from source without install)
-    __version__ = "0.2.0"
+    __version__ = "0.2.2"

{qa_agent-0.2.0 → qa_agent-0.2.2}/qa_agent/testers/accessibility.py

@@ -1,11 +1,15 @@
 """Accessibility testing module."""
 
+import logging
+
 from playwright.sync_api import Page
 
 from ..config import TestConfig
 from ..models import Finding, FindingCategory, Severity
 from .base import BaseTester
 
+logger = logging.getLogger(__name__)
+
 
 class AccessibilityTester(BaseTester):
     """Tests accessibility issues and WCAG compliance."""
@@ -78,7 +82,8 @@ class AccessibilityTester(BaseTester):
                         if info['isInLink'] and info['alt'] in ['click here', 'read more', 'link', 'image']:
                             issues['suspicious_alt'].append({"alt": info['alt'], "src": info['src'], "issue": "link_image"})
 
-                except Exception:
+                except Exception as e:
+                    logger.debug("%s: error evaluating image element: %s", self.__class__.__name__, e)
                     continue
 
             if len(issues['missing_alt']) > 0:
@@ -105,8 +110,8 @@ class AccessibilityTester(BaseTester):
                     metadata={"images": issues['suspicious_alt'][:5]},
                 ))
 
-        except Exception:
-            pass
+        except Exception as e:
+            logger.debug("%s: _test_images_alt_text failed: %s", self.__class__.__name__, e)
 
     def _test_headings_structure(self):
         """Test heading hierarchy (h1-h6)."""
@@ -171,8 +176,8 @@ class AccessibilityTester(BaseTester):
                     metadata={"skips": skipped_levels[:5]},
                 ))
 
-        except Exception:
-            pass
+        except Exception as e:
+            logger.debug("%s: _test_headings_structure failed: %s", self.__class__.__name__, e)
 
     def _test_link_text(self):
         """Test that links have descriptive text."""
@@ -220,7 +225,8 @@ class AccessibilityTester(BaseTester):
                             "href": info['href']
                         })
 
-                except Exception:
+                except Exception as e:
+                    logger.debug("%s: error evaluating link element: %s", self.__class__.__name__, e)
                     continue
 
             empty_links = [lnk for lnk in bad_links if lnk['issue'] == 'empty']
@@ -250,8 +256,8 @@ class AccessibilityTester(BaseTester):
                     metadata={"links": generic_links[:5]},
                 ))
 
-        except Exception:
-            pass
+        except Exception as e:
+            logger.debug("%s: _test_link_text failed: %s", self.__class__.__name__, e)
 
     def _test_color_contrast(self):
         """Test color contrast of text elements."""
@@ -315,7 +321,8 @@ class AccessibilityTester(BaseTester):
                     if contrast_info and not contrast_info.get('passes') and not contrast_info.get('isTransparentBg'):
                         low_contrast.append(contrast_info)
 
-                except Exception:
+                except Exception as e:
+                    logger.debug("%s: error evaluating contrast for element: %s", self.__class__.__name__, e)
                     continue
 
             if len(low_contrast) > 3:
@@ -330,8 +337,8 @@ class AccessibilityTester(BaseTester):
                     metadata={"elements": low_contrast[:5]},
                 ))
 
-        except Exception:
-            pass
+        except Exception as e:
+            logger.debug("%s: _test_color_contrast failed: %s", self.__class__.__name__, e)
 
     def _test_aria_usage(self):
         """Test correct usage of ARIA attributes."""
@@ -439,8 +446,8 @@ class AccessibilityTester(BaseTester):
                             actual_behavior=f"Referenced ID '{issue['id']}' not found",
                         ))
 
-        except Exception:
-            pass
+        except Exception as e:
+            logger.debug("%s: _test_aria_usage failed: %s", self.__class__.__name__, e)
 
     def _test_landmark_regions(self):
         """Test for proper landmark regions."""
@@ -477,8 +484,8 @@ class AccessibilityTester(BaseTester):
                     actual_behavior=f"Found {landmarks['main']} main landmarks",
                 ))
 
-        except Exception:
-            pass
+        except Exception as e:
+            logger.debug("%s: _test_landmark_regions failed: %s", self.__class__.__name__, e)
 
     def _test_language_attribute(self):
         """Test for lang attribute on html element."""
@@ -510,8 +517,8 @@ class AccessibilityTester(BaseTester):
                     actual_behavior=f"Lang attribute value: '{lang_info.get('lang')}'",
                 ))
 
-        except Exception:
-            pass
+        except Exception as e:
+            logger.debug("%s: _test_language_attribute failed: %s", self.__class__.__name__, e)
 
     def _test_skip_links(self):
         """Test for skip navigation links."""
@@ -579,8 +586,8 @@ class AccessibilityTester(BaseTester):
                     actual_behavior="Skip link target ID not found",
                 ))
 
-        except Exception:
-            pass
+        except Exception as e:
+            logger.debug("%s: _test_skip_links failed: %s", self.__class__.__name__, e)
 
     def _test_motion_preferences(self):
         """Test respect for reduced motion preference."""
@@ -640,5 +647,5 @@ class AccessibilityTester(BaseTester):
                     actual_behavior="No prefers-reduced-motion media query found in stylesheets",
                 ))
 
-        except Exception:
-            pass
+        except Exception as e:
+            logger.debug("%s: _test_motion_preferences failed: %s", self.__class__.__name__, e)