""" Automated WCAG 2.1 AA Compliance Tests This module provides automated accessibility testing using axe-core via Selenium. Tests verify WCAG 2.1 AA compliance across key pages of the ThrillWiki application. Requirements: - selenium - axe-selenium-python - Chrome browser with ChromeDriver Installation: pip install selenium axe-selenium-python Usage: python manage.py test backend.tests.accessibility Note: These tests require a running server and browser. They are skipped if dependencies are not installed or if running in CI without browser support. """ import os import unittest from django.contrib.auth import get_user_model from django.test import LiveServerTestCase, TestCase, override_settings from django.urls import reverse # Check if selenium and axe are available try: from selenium import webdriver from selenium.webdriver.chrome.options import Options from selenium.webdriver.common.by import By from selenium.webdriver.support import expected_conditions as EC from selenium.webdriver.support.ui import WebDriverWait HAS_SELENIUM = True except ImportError: HAS_SELENIUM = False try: from axe_selenium_python import Axe HAS_AXE = True except ImportError: HAS_AXE = False User = get_user_model() def skip_if_no_browser(): """Decorator to skip tests if browser dependencies are not available.""" if not HAS_SELENIUM: return unittest.skip("Selenium not installed") if not HAS_AXE: return unittest.skip("axe-selenium-python not installed") if os.environ.get('CI') and not os.environ.get('BROWSER_TESTS'): return unittest.skip("Browser tests disabled in CI") return lambda func: func class AccessibilityTestMixin: """Mixin providing common accessibility testing utilities.""" def run_axe_audit(self, url_name=None, url=None): """ Run axe accessibility audit on a page. Args: url_name: Django URL name to reverse url: Full URL (alternative to url_name) Returns: dict: Axe results containing violations and passes """ if url_name: url = f'{self.live_server_url}{reverse(url_name)}' elif not url: raise ValueError("Either url_name or url must be provided") self.driver.get(url) WebDriverWait(self.driver, 10).until( EC.presence_of_element_located((By.TAG_NAME, "body")) ) axe = Axe(self.driver) axe.inject() results = axe.run() return results def assert_no_critical_violations(self, results, page_name="page"): """ Assert no critical or serious accessibility violations. Args: results: Axe audit results page_name: Name of page for error messages """ critical_violations = [ v for v in results.get('violations', []) if v.get('impact') in ('critical', 'serious') ] if critical_violations: violation_details = "\n".join([ f"- {v['id']}: {v['description']} (impact: {v['impact']})" for v in critical_violations ]) self.fail( f"Critical accessibility violations found on {page_name}:\n" f"{violation_details}" ) def assert_wcag_aa_compliant(self, results, page_name="page"): """ Assert WCAG 2.1 AA compliance (no violations at all). Args: results: Axe audit results page_name: Name of page for error messages """ violations = results.get('violations', []) if violations: violation_details = "\n".join([ f"- {v['id']}: {v['description']} (impact: {v['impact']})" for v in violations ]) self.fail( f"WCAG 2.1 AA violations found on {page_name}:\n" f"{violation_details}" ) @skip_if_no_browser() @override_settings(DEBUG=True) class WCAGComplianceTests(AccessibilityTestMixin, LiveServerTestCase): """ Automated WCAG 2.1 AA compliance tests for ThrillWiki. These tests use axe-core via Selenium to automatically detect accessibility issues across key pages. """ @classmethod def setUpClass(cls): super().setUpClass() # Configure Chrome for headless testing chrome_options = Options() chrome_options.add_argument('--headless') chrome_options.add_argument('--no-sandbox') chrome_options.add_argument('--disable-dev-shm-usage') chrome_options.add_argument('--disable-gpu') chrome_options.add_argument('--window-size=1920,1080') try: cls.driver = webdriver.Chrome(options=chrome_options) cls.driver.implicitly_wait(10) except Exception as e: raise unittest.SkipTest(f"Chrome WebDriver not available: {e}") from None @classmethod def tearDownClass(cls): if hasattr(cls, 'driver'): cls.driver.quit() super().tearDownClass() def test_homepage_accessibility(self): """Test homepage WCAG 2.1 AA compliance.""" results = self.run_axe_audit(url_name='home') self.assert_no_critical_violations(results, "homepage") def test_park_list_accessibility(self): """Test park list page WCAG 2.1 AA compliance.""" results = self.run_axe_audit(url_name='parks:park_list') self.assert_no_critical_violations(results, "park list") def test_ride_list_accessibility(self): """Test ride list page WCAG 2.1 AA compliance.""" results = self.run_axe_audit(url_name='rides:global_ride_list') self.assert_no_critical_violations(results, "ride list") def test_manufacturer_list_accessibility(self): """Test manufacturer list page WCAG 2.1 AA compliance.""" results = self.run_axe_audit(url_name='rides:manufacturer_list') self.assert_no_critical_violations(results, "manufacturer list") def test_login_page_accessibility(self): """Test login page WCAG 2.1 AA compliance.""" results = self.run_axe_audit(url_name='account_login') self.assert_no_critical_violations(results, "login page") def test_signup_page_accessibility(self): """Test signup page WCAG 2.1 AA compliance.""" results = self.run_axe_audit(url_name='account_signup') self.assert_no_critical_violations(results, "signup page") class HTMLAccessibilityTests(TestCase): """ Unit tests for accessibility features in rendered HTML. These tests don't require a browser and verify that templates render correct accessibility attributes. """ def test_homepage_has_main_landmark(self): """Verify homepage has a main landmark.""" response = self.client.get(reverse('home')) self.assertContains(response, ']*>', content) for img in img_tags: self.assertIn( 'alt=', img, f"Image missing alt attribute: {img[:100]}" ) def test_form_fields_have_labels(self): """Verify form fields have associated labels.""" response = self.client.get(reverse('account_login')) content = response.content.decode('utf-8') # Find input elements (excluding hidden and submit) import re inputs = re.findall( r']*type=["\'](?!hidden|submit)[^"\']*["\'][^>]*>', content ) for inp in inputs: # Each input should have id attribute for label association self.assertTrue( 'id=' in inp or 'aria-label' in inp, f"Input missing id or aria-label: {inp[:100]}" ) def test_buttons_are_accessible(self): """Verify buttons have accessible names.""" response = self.client.get(reverse('home')) content = response.content.decode('utf-8') import re # Find button elements buttons = re.findall(r']*>.*?', content, re.DOTALL) for button in buttons: # Button should have text content or aria-label has_text = bool(re.search(r'>([^<]+)<', button)) has_aria = 'aria-label' in button self.assertTrue( has_text or has_aria, f"Button missing accessible name: {button[:100]}" ) class KeyboardNavigationTests(TestCase): """ Tests for keyboard navigation requirements. These tests verify that interactive elements are keyboard accessible. """ def test_interactive_elements_are_focusable(self): """Verify interactive elements don't have tabindex=-1.""" response = self.client.get(reverse('home')) content = response.content.decode('utf-8') # Links and buttons should not have tabindex=-1 (unless intentionally hidden) import re problematic = re.findall( r'<(a|button)[^>]*tabindex=["\']?-1["\']?[^>]*>', content ) # Filter out elements that are legitimately hidden for elem in problematic: self.assertIn( 'aria-hidden', elem, f"Interactive element has tabindex=-1 without aria-hidden: {elem}" ) def test_modals_have_escape_handler(self): """Verify modal templates include escape key handling.""" from django.template.loader import get_template template = get_template('components/modals/modal_inner.html') source = template.template.source self.assertIn( 'escape', source.lower(), "Modal should handle Escape key" ) def test_dropdowns_have_keyboard_support(self): """Verify dropdown menus support keyboard navigation.""" response = self.client.get(reverse('home')) content = response.content.decode('utf-8') # Check for aria-expanded on dropdown triggers if 'dropdown' in content.lower() or 'menu' in content.lower(): self.assertIn( 'aria-expanded', content, "Dropdown should have aria-expanded attribute" ) class ARIAAttributeTests(TestCase): """ Tests for correct ARIA attribute usage. """ def test_modal_has_dialog_role(self): """Verify modal has role=dialog.""" from django.template.loader import get_template template = get_template('components/modals/modal_inner.html') source = template.template.source self.assertIn( 'role="dialog"', source, "Modal should have role=dialog" ) def test_modal_has_aria_modal(self): """Verify modal has aria-modal=true.""" from django.template.loader import get_template template = get_template('components/modals/modal_inner.html') source = template.template.source self.assertIn( 'aria-modal="true"', source, "Modal should have aria-modal=true" ) def test_breadcrumb_has_navigation_role(self): """Verify breadcrumbs use nav element with aria-label.""" from django.template.loader import get_template template = get_template('components/navigation/breadcrumbs.html') source = template.template.source self.assertIn( '