django-spire 0.22.3__py3-none-any.whl → 0.23.0__py3-none-any.whl

django_spire/testing/playwright/components/notification_bell.py

@@ -0,0 +1,59 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from playwright.sync_api import Locator, Page
+
+
+class NotificationBell:
+    """Playwright component for django_spire/notification/app/element/notification_bell.html"""
+
+    def __init__(self, page: Page) -> None:
+        self.page = page
+
+    @property
+    def badge(self) -> Locator:
+        return self.bell.locator('.badge, .position-absolute')
+
+    @property
+    def bell(self) -> Locator:
+        return self.page.locator('.bi-bell').first
+
+    @property
+    def dropdown(self) -> Locator:
+        return self.page.locator('.notification-dropdown, [x-show*="notification"]')
+
+    def click(self) -> None:
+        self.bell.click()
+
+    def get_badge_count(self) -> int:
+        if not self.has_badge():
+            return 0
+
+        text = self.badge.inner_text()
+
+        if text.isdigit():
+            return int(text)
+
+        return 0
+
+    def has_badge(self) -> bool:
+        return self.badge.count() > 0 and self.badge.is_visible()
+
+    def has_notifications(self) -> bool:
+        return self.has_badge() and self.get_badge_count() > 0
+
+    def is_dropdown_open(self) -> bool:
+        return self.dropdown.is_visible()
+
+    def is_visible(self) -> bool:
+        return self.bell.is_visible()
+
+    def open_dropdown(self) -> None:
+        if not self.is_dropdown_open():
+            self.click()
+
+    def close_dropdown(self) -> None:
+        if self.is_dropdown_open():
+            self.click()

django_spire/testing/playwright/components/theme_selector.py

@@ -0,0 +1,46 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from playwright.sync_api import Locator, Page
+
+
+class ThemeSelector:
+    """Playwright component for django_spire/theme/element/theme_selector.html"""
+
+    def __init__(self, page: Page) -> None:
+        self.page = page
+
+    @property
+    def icon(self) -> Locator:
+        return self.page.locator('.bi-sun-fill, .bi-moon-fill').first
+
+    def click(self) -> None:
+        self.icon.click()
+
+    def get_current_mode(self) -> str:
+        html = self.page.locator('html')
+        return html.get_attribute('data-theme') or 'light'
+
+    def get_current_theme_family(self) -> str:
+        html = self.page.locator('html')
+        return html.get_attribute('data-theme-family') or ''
+
+    def is_dark_mode(self) -> bool:
+        return self.get_current_mode() == 'dark'
+
+    def is_light_mode(self) -> bool:
+        return self.get_current_mode() == 'light'
+
+    def is_visible(self) -> bool:
+        return self.icon.is_visible()
+
+    def toggle(self) -> None:
+        self.click()
+
+    def wait_for_theme_change(self, expected_mode: str, timeout: int = 5000) -> None:
+        self.page.wait_for_function(
+            f'() => document.documentElement.getAttribute("data-theme") === "{expected_mode}"',
+            timeout=timeout
+        )

django_spire/testing/playwright/components/toast.py

@@ -0,0 +1,72 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from playwright.sync_api import Locator, Page
+
+
+class Toast:
+    """Playwright component for django_spire/messages/messages.html"""
+
+    def __init__(self, page: Page) -> None:
+        self.page = page
+
+    @property
+    def container(self) -> Locator:
+        return self.page.locator('.fixed-top[\\@notify\\.window]')
+
+    @property
+    def toasts(self) -> Locator:
+        return self.container.locator('[x-data*="show:"]')
+
+    def get_toast(self, index: int = 0) -> Locator:
+        return self.toasts.nth(index)
+
+    def get_toast_count(self) -> int:
+        return self.toasts.count()
+
+    def get_toast_icon(self, index: int = 0) -> Locator:
+        return self.get_toast(index).locator('i.bi').first
+
+    def get_toast_message(self, index: int = 0) -> str:
+        return self.get_toast(index).locator('[x-text="notification.message"]').inner_text()
+
+    def get_toast_type(self, index: int = 0) -> str:
+        toast = self.get_toast(index)
+        classes = toast.get_attribute('class') or ''
+
+        if 'border-app-success' in classes:
+            return 'success'
+
+        if 'border-app-warning' in classes:
+            return 'warning'
+
+        if 'border-app-danger' in classes:
+            return 'error'
+
+        if 'border-app-primary' in classes:
+            return 'info'
+
+        return 'unknown'
+
+    def close_toast(self, index: int = 0) -> None:
+        self.get_toast(index).locator('.bi-x-lg').click()
+
+    def has_success_toast(self) -> bool:
+        return self.page.locator('.border-app-success').count() > 0
+
+    def has_warning_toast(self) -> bool:
+        return self.page.locator('.border-app-warning').count() > 0
+
+    def has_error_toast(self) -> bool:
+        return self.page.locator('.border-app-danger').count() > 0
+
+    def has_info_toast(self) -> bool:
+        return self.page.locator('.border-app-primary').count() > 0
+
+    def wait_for_toast(self, timeout: int = 5000) -> None:
+        self.toasts.first.wait_for(state='visible', timeout=timeout)
+
+    def wait_for_toast_to_disappear(self, timeout: int = 10000) -> None:
+        self.toasts.first.wait_for(state='hidden', timeout=timeout)

django_spire/testing/playwright/fixtures.py

@@ -0,0 +1,54 @@
+from __future__ import annotations
+
+import os
+import pytest
+
+from typing import Any, TYPE_CHECKING
+
+from django.contrib.auth import get_user_model
+
+if TYPE_CHECKING:
+    from playwright.sync_api import Page
+    from pytest_django.plugin import _LiveServer
+
+
+User = get_user_model()
+
+
+def pytest_configure(config: Any) -> None:
+    os.environ['DJANGO_ALLOW_ASYNC_UNSAFE'] = 'true'
+
+
+@pytest.fixture(scope='session')
+def browser_context_args(browser_context_args: dict[str, Any]) -> dict[str, Any]:
+    return {
+        **browser_context_args,
+        'no_viewport': True,
+        'viewport': None,
+    }
+
+
+@pytest.fixture(scope='session')
+def browser_type_launch_args(browser_type_launch_args: dict[str, Any]) -> dict[str, Any]:
+    return {
+        **browser_type_launch_args,
+        'args': ['--start-maximized'],
+    }
+
+
+@pytest.fixture
+def authenticated_page(page: Page, live_server: _LiveServer, transactional_db: None) -> Page:
+    User.objects.create_user(
+        username='testuser',
+        password='testpass123',
+        is_staff=True,
+        is_superuser=True
+    )
+
+    page.goto(f'{live_server.url}/admin/login/')
+    page.fill('input[name="username"]', 'testuser')
+    page.fill('input[name="password"]', 'testpass123')
+    page.click('input[type="submit"]')
+    page.wait_for_url(f'{live_server.url}/admin/')
+
+    return page

django_spire/testing/playwright/pages/__init__.py

@@ -0,0 +1,6 @@
+from django_spire.testing.playwright.pages.base import BasePage
+
+
+__all__ = [
+    'BasePage',
+]

django_spire/testing/playwright/pages/base.py

@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from playwright.sync_api import Page
+
+
+class BasePage:
+    def __init__(self, page: Page, base_url: str) -> None:
+        self.base_url = base_url
+        self.page = page
+
+    def goto(self, url: str) -> None:
+        self.page.goto(url)
+
+    def has_text(self, text: str) -> bool:
+        return text in self.page.locator('body').inner_text()
+
+    def wait_for_load_state(self, state: str = 'networkidle') -> None:
+        self.page.wait_for_load_state(state)
+
+    def wait_for_timeout(self, timeout: int) -> None:
+        self.page.wait_for_timeout(timeout)

django_spire/theme/models.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
-from typing_extensions import ClassVar
+from typing import ClassVar
 
 from django_spire.theme.enums import ThemeFamily, ThemeMode
 

django_spire/theme/tests/test_context_processor.py

@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 from unittest.mock import patch
-from typing_extensions import Any
 
 from django.test import TestCase, RequestFactory
 

django_spire/theme/views/json_views.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 import json
 
 from http import HTTPStatus
-from typing_extensions import TYPE_CHECKING
+from typing import TYPE_CHECKING
 
 from django.http import JsonResponse
 from django.views.decorators.cache import cache_page

django_spire/theme/views/page_views.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing_extensions import TYPE_CHECKING
+from typing import TYPE_CHECKING
 
 from django.contrib.auth.decorators import login_required
 from django.urls import reverse

{django_spire-0.22.3.dist-info → django_spire-0.23.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-spire
-Version: 0.22.3
+Version: 0.23.0
 Summary: A project for Django Spire
 Author-email: Brayden Carlson <braydenc@stratusadv.com>, Nathan Johnson <nathanj@stratusadv.com>
 License: Copyright (c) 2024 Stratus Advanced Technologies and Contributors.
@@ -73,9 +73,12 @@ Requires-Dist: django-browser-reload; extra == "development"
 Requires-Dist: django-debug-toolbar; extra == "development"
 Requires-Dist: django-watchfiles; extra == "development"
 Requires-Dist: pip; extra == "development"
+Requires-Dist: playwright; extra == "development"
 Requires-Dist: pyinstrument; extra == "development"
 Requires-Dist: pyrefly; extra == "development"
 Requires-Dist: pytest; extra == "development"
+Requires-Dist: pytest-django; extra == "development"
+Requires-Dist: pytest-playwright; extra == "development"
 Requires-Dist: setuptools; extra == "development"
 Requires-Dist: twine; extra == "development"
 Provides-Extra: documentation