widgetastic.patternfly5 25.7.30.0__py3-none-any.whl → 25.12.15.0a1__py3-none-any.whl

widgetastic_patternfly5/charts/alerts_timeline_chart.py

@@ -11,10 +11,10 @@ class AlertsTimelineChart(LineChart):
         locator: If you have specific locator else it will take pf-chart.
     """
 
-    Y_AXIS_ROW = "./*[name()='svg']/*[name()='g'][3]/*[name()='g']"
-    Y_AXIS_ROW_LINE = "./*[name()='path']"
+    Y_AXIS_ROW = ".//*[name()='svg']/*[name()='g'][3]/*[name()='g']"
+    Y_AXIS_ROW_LINE = ".//*[name()='path']"
 
-    TOOLTIP = "./*[name()='svg']/*[name()='g'][5]"
+    TOOLTIP = ".//*[name()='svg']/*[name()='g'][5]"
     TOOLTIP_X_AXIS_LABLE = None
     TOOLTIP_LABLES = None
     TOOLTIP_VALUES = ".//*[name()='text']/*[name()='tspan']"
@@ -48,7 +48,8 @@ class AlertsTimelineChart(LineChart):
             _row_data = []
             for line_el in lines_el:
                 self.browser.move_to_element(line_el)
-                self.browser.click(line_el)
+                # Sometime path elements are not interactable so use force click.
+                self.browser.click(line_el, force=True)
                 tooltip_el = self.browser.wait_for_element(self.TOOLTIP)
 
                 label_data = {}

widgetastic_patternfly5/charts/bullet_chart.py

@@ -1,5 +1,7 @@
 import re
+import time
 
+from cached_property import cached_property
 from widgetastic.utils import ParametrizedLocator
 from widgetastic.widget import Text, View
 from widgetastic.xpath import quote
@@ -21,7 +23,7 @@ class BulletChart(View):
     ROOT = ParametrizedLocator("{@locator}")
 
     DEFAULT_LOCATOR = ".//div[contains(@class, 'chartbullet')]"
-    ITEMS = ".//*[name()='g']/*[name()='path' and not(contains(@style, 'type:square'))]"
+    ITEMS = "//*[name()='g' and not(./*[name()='rect'])]/*[name()='path']"
     TOOLTIP_REGEX = re.compile(r"(.*?): ([\d]+)")
     APPLY_OFFSET = True
 
@@ -73,20 +75,20 @@ class BulletChart(View):
         except StopIteration:
             return None
 
-    @property
+    @cached_property
     def data(self):
         """Read graph and returns all Data Point objects."""
         _data = []
         # focus away from graph
         self.parent_browser.move_to_element("//body")
-
         for el in self.browser.elements(self.ITEMS):
-            self.browser.move_to_element(el)
-            self.browser.click(el)
+            time.sleep(0.2)
+            # Sometime path elements are not interactable so use force click.
+            self.browser.click(el, force=True)
 
             if self.APPLY_OFFSET:
                 dx, dy = self._offsets(el)
-                self.browser.move_by_offset(dx, dy)
+                self.browser.move_by_offset(origin=el, x=dx, y=dy)
 
             match = self.TOOLTIP_REGEX.match(self.tooltip.text)
             if match:
@@ -94,7 +96,7 @@ class BulletChart(View):
                     DataPoint(
                         label=match.groups()[0],
                         value=int(match.groups()[1]),
-                        color=el.value_of_css_property("fill"),
+                        color=self.browser.value_of_css_property(el, "fill"),
                     )
                 )
         return _data

widgetastic_patternfly5/charts/donut_chart.py

@@ -5,9 +5,9 @@ from widgetastic.xpath import quote
 
 
 class DonutLegendItem(ParametrizedView, ClickableMixin):
-    PARAMETERS = ("label_text",)
+    PARAMETERS = ("label_name",)
     ROOT = ParametrizedLocator(
-        ".//*[name()='text']/*[name()='tspan' and contains(., '{label_text}')]"
+        ".//*[name()='text']/*[name()='tspan' and contains(., '{label_name}:')]"
     )
     ALL_ITEMS = ".//*[name()='text']/*[name()='tspan']"
     LEGEND_ITEM_REGEX = re.compile(r"(.*?): ([\d]+)")
@@ -32,8 +32,14 @@ class DonutLegendItem(ParametrizedView, ClickableMixin):
 
     @classmethod
     def all(cls, browser):
-        """Returns a list of all items"""
-        return [(browser.text(el),) for el in browser.elements(cls.ALL_ITEMS)]
+        """Returns a list of all item labels"""
+        result = []
+        for el in browser.elements(cls.ALL_ITEMS):
+            text = browser.text(el)
+            # Extract just the label
+            label, _ = cls._get_legend_item(text)
+            result.append((label,))
+        return result
 
 
 class DonutLegend(View):

widgetastic_patternfly5/charts/legend.py

@@ -32,9 +32,9 @@ class Legend(ParametrizedView):
             self.browser.elements(self.LEGEND_ICON_ITEMS),
             self.browser.elements(self.LEGEND_LABEL_ITEMS),
         ):
-            color = icon.value_of_css_property("fill")
-            if not color:
-                color = icon.value_of_css_property("color")
+            color = self.browser.value_of_css_property(
+                icon, "fill"
+            ) or self.browser.value_of_css_property(icon, "color")
             _data[self.browser.text(label_el)] = color
         return _data
 

widgetastic_patternfly5/charts/line_chart.py

@@ -83,9 +83,9 @@ class LineChart(View):
         _data = {}
 
         for lab_el in self._x_axis_labels_map.values():
-            self.browser.move_to_element(lab_el)
-            self.browser.click(lab_el)
-            self.browser.move_by_offset(*offset)
+            # Sometime path elements are not interactable so use force click.
+            self.browser.click(lab_el, force=True)
+            self.browser.move_by_offset(lab_el, *offset)
             tooltip_el = self.browser.wait_for_element(self.TOOLTIP)
 
             x_axis_label = self.browser.text(self.TOOLTIP_X_AXIS_LABLE, parent=tooltip_el)

widgetastic_patternfly5/components/clipboard_copy.py

@@ -20,10 +20,7 @@ class BaseClipboardCopy:
     def is_editable(self):
         if self.is_inline:
             return False
-        if self.browser.get_attribute("readonly", self.text):
-            return False
-        else:
-            return True
+        return "readonly" not in self.browser.attributes(self.text)
 
     @property
     def is_inline(self):

widgetastic_patternfly5/components/date_and_time/calendar_month.py

@@ -1,5 +1,4 @@
-from selenium.common.exceptions import NoSuchElementException
-from selenium.webdriver.common.keys import Keys
+from widgetastic.exceptions import NoSuchElementException
 from widgetastic.utils import ParametrizedLocator
 from widgetastic.widget import Widget
 from widgetastic.xpath import quote
@@ -17,18 +16,15 @@ class BaseCalendarMonth:
     https://www.patternfly.org/components/date-and-time/calendar-month
     """
 
-    CALENDAR_HEADER = ".//div[contains(@class, '-c-calendar-month__header')]"
-    MONTH_SELECT_LOCATOR = f"{CALENDAR_HEADER}//div[contains(@class, 'header-month')]"
+    MONTH_SELECT_LOCATOR = ".//div[contains(@class, '-c-calendar-month__header-month')]"
     _month_select_widget = Select(locator=MONTH_SELECT_LOCATOR)
-    YEAR_INPUT_LOCATOR = (
-        f"{CALENDAR_HEADER}//div[contains(@class, '-c-calendar-month__header-year')]//input"
-    )
+    YEAR_INPUT_LOCATOR = ".//div[contains(@class, '-c-calendar-month__header-year')]//input"
     DATE_LOCATOR = (
         ".//button[text()={date} and not(ancestor::td[contains(@class, 'pf-m-adjacent-month')])]"
     )
 
-    PREV_BUTTON_LOCATOR = f"{CALENDAR_HEADER}//div[contains(@class, 'prev-month')]"
-    NEXT_BUTTON_LOCATOR = f"{CALENDAR_HEADER}//div[contains(@class, 'next-month')]"
+    PREV_BUTTON_LOCATOR = ".//div[contains(@class, 'prev-month')]"
+    NEXT_BUTTON_LOCATOR = ".//div[contains(@class, 'next-month')]"
 
     TABLE = ".//table"
     SELECTED_DATE_LOCATOR = f"{TABLE}/tbody//td[contains(@class, 'pf-m-selected')]"
@@ -46,14 +42,14 @@ class BaseCalendarMonth:
 
     @year.setter
     def year(self, value):
+        self.browser.fill(str(value), self.YEAR_INPUT_LOCATOR)
+        # value attribute not setting at same time we need release that web element.
         el = self.browser.element(self.YEAR_INPUT_LOCATOR)
-        el.send_keys(Keys.CONTROL + "a")
-        el.send_keys(str(value) + Keys.ENTER)
+        self.browser.execute_script("arguments[0].blur();", el)
 
     @property
     def month(self):
-        el = self.browser.element(self.MONTH_SELECT_LOCATOR)
-        return self.browser.text(el)
+        return self._month_select_widget.read()
 
     @month.setter
     def month(self, value):
@@ -62,10 +58,9 @@ class BaseCalendarMonth:
     @property
     def day(self):
         try:
-            el = self.browser.element(self.SELECTED_DATE_LOCATOR)
+            return self.browser.text(self.SELECTED_DATE_LOCATOR)
         except NoSuchElementException:
             return ""
-        return self.browser.text(el)
 
     @day.setter
     def day(self, value):

widgetastic_patternfly5/components/dual_list_selector.py

@@ -25,11 +25,11 @@ class BaseDualListSelector:
 
     @property
     def _available(self):
-        return self.browser.element(self.AVAILABLE, parent=self)
+        return self.browser.element(self.AVAILABLE)
 
     @property
     def _chosen(self):
-        return self.browser.element(self.CHOSEN, parent=self)
+        return self.browser.element(self.CHOSEN)
 
     @property
     def _left_list(self):
@@ -41,11 +41,11 @@ class BaseDualListSelector:
 
     @property
     def _left_title(self):
-        return self.browser.element(self.SECTION_TITLE, parent=self._available).text
+        return self.browser.text(self.SECTION_TITLE, parent=self._available)
 
     @property
     def _right_title(self):
-        return self.browser.element(self.SECTION_TITLE, parent=self._chosen).text
+        return self.browser.text(self.SECTION_TITLE, parent=self._chosen)
 
     @property
     def _left_elements(self):
@@ -86,8 +86,8 @@ class BaseDualListSelector:
             right_elements = self._right_elements
             left_elements = self._left_elements
 
-        data[self._left_title] = [el.text for el in left_elements]
-        data[self._right_title] = [el.text for el in right_elements]
+        data[self._left_title] = [self.browser.text(el) for el in left_elements]
+        data[self._right_title] = [self.browser.text(el) for el in right_elements]
         return data
 
     def reset_selected(self, left_items=True):

widgetastic_patternfly5/components/forms/form_select.py

@@ -1,4 +1,3 @@
-from selenium.webdriver.support.ui import Select
 from widgetastic.exceptions import NoSuchElementException
 from widgetastic.widget import GenericLocatorWidget
 
@@ -68,10 +67,6 @@ class BaseFormSelect:
                 result.append(self.browser.text(el))
         return result
 
-    @property
-    def _select_element(self):
-        return Select(self.__element__())
-
     def fill(self, value):
         """Select desired option in FormSelect.
 
@@ -90,11 +85,11 @@ class BaseFormSelect:
             raise FormSelectOptionDisabled(
                 f'Option "{value}" is disabled in {repr(self)}. Enabled options are: {self.all_enabled_options}'
             )
-        self._select_element.select_by_visible_text(value)
+        self.__element__().select_option(label=value)
 
     def read(self):
         """Returns selected option."""
-        return self.browser.text(self._select_element.first_selected_option)
+        return self.browser.text("option:checked")
 
     def __repr__(self):
         return f"{type(self).__name__}({self.locator!r})"

widgetastic_patternfly5/components/menus/dropdown.py

@@ -1,7 +1,7 @@
 from contextlib import contextmanager
 
 from cached_property import cached_property
-from widgetastic.exceptions import NoSuchElementException, UnexpectedAlertPresentException
+from widgetastic.exceptions import NoSuchElementException
 from widgetastic.utils import ParametrizedLocator
 from widgetastic.widget import Widget
 from widgetastic.xpath import quote
@@ -87,7 +87,7 @@ class BaseDropdown:
         # def _click():
         #     self.browser.click(self.BUTTON_LOCATOR)
         #     return self.is_open
-        el = self.browser.wait_for_element(self.BUTTON_LOCATOR)
+        el = self.browser.element(self.BUTTON_LOCATOR)
         self.browser.click(el)
         return self.is_open
 
@@ -202,11 +202,7 @@ class BaseDropdown:
                 self.browser.handle_alert(cancel=not handle_alert, wait=10.0)
                 self.browser.plugin.ensure_page_safe()
         finally:
-            try:
-                self.close(ignore_nonpresent=True)
-            except UnexpectedAlertPresentException:
-                self.logger.warning("There is an unexpected alert present.")
-                pass
+            self.close(ignore_nonpresent=True)
 
     @property
     def button_text(self):

widgetastic_patternfly5/components/menus/menu.py

@@ -208,7 +208,7 @@ class BaseCheckboxMenu(BaseMenu):
                     # get the child element of the label
                     selected[item] = self.browser.element(
                         parent=el, locator=".//input"
-                    ).is_selected()
+                    ).is_checked()
                 except NoSuchElementException:
                     selected[item] = False
 

widgetastic_patternfly5/components/menus/select.py

@@ -157,7 +157,7 @@ class BaseCheckboxSelect(BaseSelect):
                     # get the child element of the label
                     selected[item] = self.browser.element(
                         parent=el, locator=".//input"
-                    ).is_selected()
+                    ).is_checked()
                 except NoSuchElementException:
                     selected[item] = False
 

widgetastic_patternfly5/components/navigation.py

@@ -56,9 +56,7 @@ class BaseNavigation:
     def nav_links(self, *levels):
         """Returns a list of all navigation items."""
         if not levels:
-            return [
-                el.get_property("textContent").strip() for el in self.browser.elements(self.ITEMS)
-            ]
+            return [self.browser.text(el) for el in self.browser.elements(self.ITEMS)]
         current_item = self
         for i, level in enumerate(levels):
             li = self.browser.element(
@@ -73,8 +71,7 @@ class BaseNavigation:
                 else:
                     raise
         return [
-            el.get_property("textContent").strip()
-            for el in self.browser.elements(self.ITEMS, parent=current_item)
+            self.browser.text(el) for el in self.browser.elements(self.ITEMS, parent=current_item)
         ]
 
     @check_nav_loaded

widgetastic_patternfly5/components/pagination.py

@@ -1,7 +1,6 @@
 import math
 from contextlib import contextmanager
 
-from selenium.webdriver.common.keys import Keys
 from widgetastic.utils import ParametrizedLocator
 from widgetastic.widget import GenericLocatorWidget, Text, TextInput, View
 
@@ -43,7 +42,7 @@ class BasePagination:
         Returns ``True`` when pagination dropdown button is enabled along with next & last button.
         """
         el = self.browser.element(self._last)
-        last_flag = el.is_enabled() if el.is_displayed() else True
+        last_flag = el.is_enabled() if el.is_visible() else True
         return (
             self.browser.element(self._options.BUTTON_LOCATOR).is_enabled()
             and self.browser.element(self._next).is_enabled()
@@ -178,7 +177,7 @@ class BasePagination:
     def go_to_page(self, value):
         """Navigate to custom page number."""
         self._current_page.fill(value)
-        self.browser.send_keys(Keys.RETURN, self._current_page)
+        self._current_page.__element__().press("Enter")
 
     def __iter__(self):
         if self.current_page > 1:

widgetastic_patternfly5/components/slider.py

@@ -1,4 +1,3 @@
-from selenium.webdriver.common.keys import Keys
 from widgetastic.widget import GenericLocatorWidget
 
 
@@ -12,7 +11,7 @@ class BaseSlider:
     THUMB = ".//div[contains(@class, '-c-slider__thumb')]"
     STEPS = (
         ".//div[contains(@class, '-c-slider__steps')]"
-        "/child::div[contains(@class, '-c-slider__step')]"
+        "//child::div[contains(@class, '-c-slider__step-tick')]"
     )
 
     def _str_num(self, value):
@@ -79,7 +78,7 @@ class BaseSlider:
         source_el = el_map[self.text] if self.text in el_map else self.browser.element(self.THUMB)
         self.browser.move_to_element(source_el)
         self.browser.drag_and_drop(source_el, target_el)
-        self.browser.click(target_el)
+        self.browser.click(target_el, force=True)
         return True
 
     def read(self):
@@ -99,6 +98,7 @@ class InputSlider(Slider):
         if self.text == value:
             return False
         el = self.browser.element(self.INPUT)
-        el.send_keys(Keys.CONTROL + "a")
-        el.send_keys(str(value) + Keys.ENTER)
+        el.press("Control+A")
+        el.fill(str(value))
+        el.press("Enter")
         return True

widgetastic_patternfly5/components/switch.py

@@ -12,10 +12,10 @@ class BaseSwitch:
     https://www.patternfly.org/components/switch
     """
 
-    CHECKBOX_LOCATOR = "./input"
-    PF_5_LABEL_ON = "./span[contains(@class, 'pf-m-on')]"
-    PF_5_LABEL_OFF = "./span[contains(@class, 'pf-m-off')]"
-    PF_6_LABLE = "./span[contains(@class, '-c-switch__label')]"
+    CHECKBOX_LOCATOR = ".//input"
+    PF_5_LABEL_ON = ".//span[contains(@class, 'pf-m-on')]"
+    PF_5_LABEL_OFF = ".//span[contains(@class, 'pf-m-off')]"
+    PF_6_LABEL = ".//span[contains(@class, '-c-switch__label')]"
 
     @property
     def is_enabled(self):
@@ -26,32 +26,36 @@ class BaseSwitch:
         """Click on a Switch."""
         if not self.is_enabled:
             raise SwitchDisabled(f"{repr(self)} is disabled")
-        else:
-            self.browser.click(self.CHECKBOX_LOCATOR)
-            return True
+
+        self.browser.click(self.CHECKBOX_LOCATOR, force=True)
+        return True
 
     @property
     def selected(self):
         """Returns a boolean detailing if the Switch is on (True) of off (False)."""
-        return self.browser.get_attribute("checked", self.CHECKBOX_LOCATOR) is not None
+        return self.browser.is_checked(self.CHECKBOX_LOCATOR)
 
-    def fill(self, value):
+    def fill(self, value: bool):
         """Fills a Switch with the supplied value."""
         if not self.is_enabled:
             raise SwitchDisabled(f"{repr(self)} is disabled")
-        if bool(value) == self.selected:
+        if value == self.selected:
             return False
+
+        el = self.browser.element(self.CHECKBOX_LOCATOR)
+        if value:
+            el.check(force=True)
         else:
-            self.browser.click(self.CHECKBOX_LOCATOR)
-            return True
+            el.uncheck(force=True)
+        return True
 
     @property
     def label(self):
         """Returns the label of the Switch."""
         if self.selected:
-            return self._read_locator(self.PF_5_LABEL_ON) or self._read_locator(self.PF_6_LABLE)
+            return self._read_locator(self.PF_5_LABEL_ON) or self._read_locator(self.PF_6_LABEL)
         else:
-            return self._read_locator(self.PF_5_LABEL_OFF) or self._read_locator(self.PF_6_LABLE)
+            return self._read_locator(self.PF_5_LABEL_OFF) or self._read_locator(self.PF_6_LABEL)
 
     def read(self):
         """Returns a boolean detailing if the Switch is on (True) of off (False)."""

widgetastic_patternfly5/components/table.py

@@ -1,4 +1,4 @@
-from selenium.common.exceptions import NoSuchElementException
+from widgetastic.exceptions import NoSuchElementException
 from widgetastic.log import create_item_logger
 from widgetastic.widget import Table, TableColumn, TableRow, Text, Widget
 from widgetastic.widget.table import resolve_table_widget
@@ -302,7 +302,7 @@ class ExpandableTable(BaseExpandableTable, PatternflyTable):
 
 
 class ExpandableColumn(TableColumn):
-    EXPAND_LOCATOR = "./button"
+    EXPAND_LOCATOR = ".//button"
 
     def __init__(
         self,

widgetastic_patternfly5/components/title.py

@@ -9,11 +9,11 @@ class BaseTitle:
 
     @property
     def heading_level(self):
-        return self.browser.element(self, parent=self.parent).tag_name
+        return self.browser.tag(self)
 
     @property
     def text(self):
-        return self.browser.text(self, parent=self.parent)
+        return self.browser.text(self)
 
     def read(self):
         return self.text

{widgetastic.patternfly5-25.7.30.0.dist-info → widgetastic_patternfly5-25.12.15.0a1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: widgetastic.patternfly5
-Version: 25.7.30.0
+Version: 25.12.15.0a1
 Summary: Patternfly5 widget library for Widgetastic.
 Project-URL: repository, https://github.com/RedHatQE/widgetastic.patternfly5
 Maintainer-email: Nikhil Dhandre <ndhandre@redhat.com>, Egor Shamardin <eshamard@redhat.com>, Mike Shriver <mshriver@redhat.com>
@@ -28,13 +28,14 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Software Development :: Testing
 Requires-Python: >=3.11
-Requires-Dist: widgetastic-core>=1.0.6
+Requires-Dist: widgetastic-core>=2.0.0a2
 Provides-Extra: dev
 Requires-Dist: codecov; extra == 'dev'
 Requires-Dist: pre-commit; extra == 'dev'
 Requires-Dist: pytest; extra == 'dev'
 Requires-Dist: pytest-cov; extra == 'dev'
 Requires-Dist: pytest-rerunfailures; extra == 'dev'
+Requires-Dist: pytest-timeout; extra == 'dev'
 Requires-Dist: pytest-xdist; extra == 'dev'
 Provides-Extra: doc
 Requires-Dist: sphinx; extra == 'doc'
@@ -60,11 +61,31 @@ Description-Content-Type: text/markdown
     </a>
 </p>
 
+## Overview
+
 This library offers Widgetastic Widgets for [PatternFly v5/v6](https://www.patternfly.org/), serving as an extended
-itteration of [widgetastic.patternfly4](https://github.com/RedHatQE/widgetastic.patternfly4).
+iteration of [widgetastic.patternfly4](https://github.com/RedHatQE/widgetastic.patternfly4).
+
+Built on top of [widgetastic.core](https://github.com/RedHatQE/widgetastic.core) with **Playwright** as the browser
+automation engine, this library provides a robust and modern approach to UI testing for PatternFly components.
+
+> **Note**: The `main` branch now uses **Playwright** for browser automation. For the legacy Selenium implementation, please refer to the [legacy-selenium-support](https://github.com/RedHatQE/widgetastic.patternfly5/tree/legacy-selenium-support) branch.
+
+## Installation
+
+```bash
+# Install from PyPI
+pip install widgetastic.patternfly5
+
+# Or install from source
+git clone https://github.com/RedHatQE/widgetastic.patternfly5.git
+cd widgetastic.patternfly5
+pip install -e .
+```
 
+## Supported Components
 
-### Components:
+### Components
 - [alert](https://www.patternfly.org/components/alert)
 - [breadcrumb](https://www.patternfly.org/components/breadcrumb)
 - [button](https://www.patternfly.org/components/button)
@@ -107,9 +128,10 @@ itteration of [widgetastic.patternfly4](https://github.com/RedHatQE/widgetastic.
 - [line-chart](https://www.patternfly.org/charts/line-chart)
 - [pie-chart](https://www.patternfly.org/charts/pie-chart)
 
-### Patterns:
+### Patterns
 - [card-view](https://www.patternfly.org/patterns/card-view)
 
+## Development
 
 ### Contribution guide
 
@@ -130,24 +152,91 @@ pip install -e .[dev]
 # if you use zsh, pip install will fail. Use this instead:
 pip install -e ".[dev]"
 
+# install Playwright browsers for testing
+playwright install chromium firefox
+playwright install-deps
+
+# setup pre-commit hooks
 pre-commit install
 ```
 
 ### Testing
 
-The library has selenium tests that are performed against [Patternfly v6 docs](https://www.patternfly.org) and [Patternfly v5 docs](https://v5-archive.patternfly.org).
-It's also configured to run the tests every time when a new version of that page is released.
+The library includes comprehensive tests that run against the official PatternFly documentation pages:
+- [PatternFly v6](https://www.patternfly.org) (latest)
+- [PatternFly v5](https://v5-archive.patternfly.org) (archived)
+
+Tests are powered by **Playwright**, providing fast, reliable, and modern browser automation.
+
+#### Prerequisites
+
+Before running tests, install Playwright browsers:
+
+```bash
+# Install Playwright (included in dev dependencies)
+pip install -e ".[dev]"
+
+# Install Playwright browsers
+playwright install chromium firefox
+
+# Install system dependencies (if needed)
+playwright install-deps
+```
+
+#### Running Tests
+
+**Basic test execution:**
+
+```bash
+# Run tests with default settings (chromium, v6, headed mode)
+pytest -v
+
+# Run tests against PatternFly v5
+pytest -v --pf-version v5
+
+# Run tests with Firefox
+pytest -v --browser firefox
+
+# Run tests in headless mode (no browser window)
+pytest -v --headless
+```
+
+**Advanced options:**
+
+```bash
+# Run tests in parallel (speeds up execution)
+pytest -v -n 3 --browser chromium --pf-version v6
+
+# Run with slow motion for debugging (100ms delay between actions)
+pytest -v --slowmo 100
+
+# Run specific test file
+pytest testing/components/test_button.py -v --browser firefox
+
+# Run tests with coverage
+pytest -v --cov=./ --cov-report=html
+```
+
+**Available test options:**
 
-Tests spawn a container from official selenium image - [selenium/standalone-{chrome/firefox}](https://hub.docker.com/u/selenium).
-We can check local runs via vnc `http://localhost:7900`
+| Option | Choices | Default | Description |
+|--------|---------|---------|-------------|
+| `--browser` | `chromium`, `firefox` | `chromium` | Browser to use for testing |
+| `--pf-version` | `v5`, `v6` | `v6` | PatternFly version to test against |
+| `--headless` | flag | `False` | Run in headless mode (no UI) |
+| `--slowmo` | milliseconds | `0` | Slow down operations for debugging |
+| `-n` | number | `1` | Number of parallel workers (requires pytest-xdist) |
 
-**Note:** Tests use `podman` to manage containers. Please install it before running.
 
-It's possible to run tests in parallel to speed up the execution. Make sure that you have **xdist** python plugin installed.
+#### Debugging Tests
 
-Use `-n` key to specify a number
-of workers:
+When debugging, it's helpful to:
+1. Run tests in **headed mode** (without `--headless`) to see browser interactions
+2. Use `--slowmo` to slow down actions and observe what's happening
+3. Run a single test file or test function instead of the entire suite
+4. Reduce parallelism (`-n 1` or remove `-n` flag) to avoid race conditions
 
 ```bash
-pytest --browser-name firefox --pf-version v5 -n 2 -vv
+# Debug specific test with visible browser and slow execution
+pytest testing/components/test_modal.py::test_modal_basic -v --slowmo 1000
 ```

{widgetastic.patternfly5-25.7.30.0.dist-info → widgetastic_patternfly5-25.12.15.0a1.dist-info}/RECORD

@@ -1,12 +1,12 @@
 widgetastic_patternfly5/__init__.py,sha256=Yv3sZRQsi__Wjp5K5odVRZFr6-UQsPLL6lk6g6GWZIg,3822
 widgetastic_patternfly5/ouia.py,sha256=ZAUgIka9odt4yCKQxD2R0fZ30hZKPtOAL-Fjw2xIGS0,4046
 widgetastic_patternfly5/charts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-widgetastic_patternfly5/charts/alerts_timeline_chart.py,sha256=U7hJvxAG1Wgj9WFt5QxAmLh9cJm2qzs2YHs2wfEW0Pk,2377
+widgetastic_patternfly5/charts/alerts_timeline_chart.py,sha256=7oAs2JX9ZLH7bYpbz3LMsRlHrwIdx1T6SKpFMd0Jw8U,2474
 widgetastic_patternfly5/charts/boxplot_chart.py,sha256=6Ek6gwbmwNeazy-5o2fVfvkjpd6bhbTyitiPomvLBts,405
-widgetastic_patternfly5/charts/bullet_chart.py,sha256=zfAdvxzPFqeGFzDoqJIUxwkERUlHfPohHOjzPJEjVdw,3680
-widgetastic_patternfly5/charts/donut_chart.py,sha256=RmDKyWjhKnGWQwZ1twPN837LYuvlF1inQlYhIgJgFxU,2570
-widgetastic_patternfly5/charts/legend.py,sha256=nLv2dEXTICsIT3PJfYn4Ko2WvvgFFggaXVedRTZ3NkE,3057
-widgetastic_patternfly5/charts/line_chart.py,sha256=9gjoUqWopSYTng0iRpvppm-CL-QA8H_HpTvFddg0sB4,3995
+widgetastic_patternfly5/charts/bullet_chart.py,sha256=BLAtgqVvIrE3tAGQf3Labp7c5MrQXBW_FAoIWCyLJz4,3830
+widgetastic_patternfly5/charts/donut_chart.py,sha256=ilDQR8ErGp4NqfkbHyvzIKKYVADk5rZkHy9U_BaT2Os,2750
+widgetastic_patternfly5/charts/legend.py,sha256=C5XBUKICsWS_zudVSMbDoKrLuWOqMIAqnYtshnEuKac,3068
+widgetastic_patternfly5/charts/line_chart.py,sha256=ihwbO75pGMZgqBT16gT5e3NgtrmDNl2krRZJjK4iD0w,4044
 widgetastic_patternfly5/charts/pie_chart.py,sha256=rIxMv6vPERj9FnTp8daejL7MxUTKFCTj9057C1KuuKw,218
 widgetastic_patternfly5/components/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 widgetastic_patternfly5/components/alert.py,sha256=8wF4348n7Yp6BnOlbDNGw4_fFKyyjzgpQDOe9a96EsI,2579
@@ -14,33 +14,33 @@ widgetastic_patternfly5/components/breadcrumb.py,sha256=_lQ7pqmh2P9FSwMae_quUTte
 widgetastic_patternfly5/components/button.py,sha256=dduqxjnTHsHLkPO9TjbWO4HUfpiObMM4yuq3_q8XlA0,3539
 widgetastic_patternfly5/components/card.py,sha256=YScmzLsxO72ITZFz9u3vyxpD2r0QAzP4yaBmJD9FcZE,2677
 widgetastic_patternfly5/components/chip.py,sha256=t5_9oTJ__9ccwrCMzVYllDFY7oyJcMwwWKbr3jiIK0w,11218
-widgetastic_patternfly5/components/clipboard_copy.py,sha256=r9RESokgZ7s5C2_ByOGLqfIjUx15-ZzFi5usSTdb-ac,1292
+widgetastic_patternfly5/components/clipboard_copy.py,sha256=GgZnhwSLzOZ7gIyODqpjvuM588AnYfL7vaWShzg9wh4,1235
 widgetastic_patternfly5/components/description_list.py,sha256=sVhKwKnvJguZh9FqyPC1NU2UA_w7uA3ugkY5eoVRlPk,989
 widgetastic_patternfly5/components/drawer.py,sha256=TKunpAtEyTZSSuOgL5y--lbuUcj5Eiqrm60ICi9O620,1172
-widgetastic_patternfly5/components/dual_list_selector.py,sha256=jL1SOfnR5z_rWniN-KU9a26n-0HxBcL2pJbBcOFT2b8,4839
+widgetastic_patternfly5/components/dual_list_selector.py,sha256=MJtEtte5CqEsT3yky04m4W1zKMT7_rl0Ncr1vc6UbHA,4825
 widgetastic_patternfly5/components/expandable_section.py,sha256=QCqonn1kiYfL-mGcjwrG6x4TiJBr9RKXZvyDerVTUmQ,1876
 widgetastic_patternfly5/components/modal.py,sha256=uaOsMxWvgCKrF61YX5Dh9z4YCtB0uheQdQTF6cMswxY,2000
-widgetastic_patternfly5/components/navigation.py,sha256=uaAc-FoOdYt0xiH_oPK564KjztQLEusk3LhhHSX4PQ4,5333
-widgetastic_patternfly5/components/pagination.py,sha256=rumYxlMJcO7F0uQtIU24oANwi6JHHzDkD-YMo-eyltA,8707
+widgetastic_patternfly5/components/navigation.py,sha256=0E8MvWwJY9uTNxG2Z4OUGeP0Ac33sXa-Ls_jPgufF20,5257
+widgetastic_patternfly5/components/pagination.py,sha256=md-OxLeTUzfbnZtA_rY--7UeOYy2wpak74zndLMmJ6M,8649
 widgetastic_patternfly5/components/popover.py,sha256=_XZlM4v8gsmen73DoSpylMXAMeEkdkjRsuBIIKHHhtE,2242
 widgetastic_patternfly5/components/progress.py,sha256=UXNjRgy7aW0YerRWR6cwMF-9AjitI6LO8qlOdz0dYW8,1391
-widgetastic_patternfly5/components/slider.py,sha256=B9gr8mnndLWivSlS9lIRd3SW6W5Iev9ESnQE9b0A55Y,3128
-widgetastic_patternfly5/components/switch.py,sha256=7-ezYAQ3T_cz70GBIW78vTlVaDmRGRhNgi1hWg14Ig8,2226
-widgetastic_patternfly5/components/table.py,sha256=fA5LM7buASXOH3z32t1D5ZkFXyMa3ZZmzFJ6kjF73ZQ,17183
+widgetastic_patternfly5/components/slider.py,sha256=icg5VoLPospL6qPyT0XbTdBqEHqDTTw_3YqJBP-pqws,3095
+widgetastic_patternfly5/components/switch.py,sha256=bZWDdeYY6Ub9NSfeYxkpdidajRmF20OyqqF5kQ1j5ws,2281
+widgetastic_patternfly5/components/table.py,sha256=UzOy8v0G9UoU5kNBT9TyxIqfJxcXT8xK0emQJVlI2jg,17180
 widgetastic_patternfly5/components/tabs.py,sha256=tSuS6x3_rnc5z8yUW_75ZtkdFOzzWPMmMa48VEEZWQk,2260
-widgetastic_patternfly5/components/title.py,sha256=bIUzFaptG2i84CF4-AMfjbmdVeKYR32wkOBH9P6V3XQ,920
-widgetastic_patternfly5/components/date_and_time/calendar_month.py,sha256=WwpfHWei2GsWxqcvwys9DbxSbzICTBsU2VLgkaqrVns,3386
+widgetastic_patternfly5/components/title.py,sha256=WdxoiSaTyQHNmLru1pSp20cgZhiIxTu1u6syF0r4hJs,867
+widgetastic_patternfly5/components/date_and_time/calendar_month.py,sha256=HTRStubVRVc8Z2aMfMJEw5vwgkVWuK-r6Alwk0fxsFU,3228
 widgetastic_patternfly5/components/forms/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-widgetastic_patternfly5/components/forms/form_select.py,sha256=ht_go5lOXhMzq_FyLxS1ny9jaiBkRI6K_5vMv1DASaw,3531
+widgetastic_patternfly5/components/forms/form_select.py,sha256=CQpwoicDKsUJo9TwrFV1bZu-x5OFhLSMWZYrqynfgqw,3363
 widgetastic_patternfly5/components/forms/radio.py,sha256=d1fpzoicgSDgoV8K9bHlXFvHEjH3zw59t_WbxTGZyQ8,2009
 widgetastic_patternfly5/components/menus/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 widgetastic_patternfly5/components/menus/context_selector.py,sha256=Bqj8MrxJypLfjcqrrKQj9jfFWHeSWbHIVcH2aA6sRQ8,1156
-widgetastic_patternfly5/components/menus/dropdown.py,sha256=uP1bUVqc7b2FxnVHJ7SO8lD-zTlZOz1WQp5GdGFCBt8,10472
-widgetastic_patternfly5/components/menus/menu.py,sha256=sRkb46XWMNGueDCkOjs4vyb9Ehjiru71DY3MD2qsorM,8138
+widgetastic_patternfly5/components/menus/dropdown.py,sha256=783reAUtlcKmQCo-nQ-8DjLN4cTgznzly2eftHzlOkY,10259
+widgetastic_patternfly5/components/menus/menu.py,sha256=an0iXBhrswn6rK_FXJckgG0r7B8kv2nMmYPcfHSTiDY,8137
 widgetastic_patternfly5/components/menus/menu_toggle.py,sha256=PBwNvg6E2RPdCG6ALBUqyTZxCwThJgk5S-9ghTiZ9hM,1029
 widgetastic_patternfly5/components/menus/options_menu.py,sha256=-7pRukhgxln0rMV77VhNyQ-njLPAE6Wnp2vNAoJUXZk,1474
-widgetastic_patternfly5/components/menus/select.py,sha256=X8DApXg_7tLIOulpmEP-f09bDShYL8jcEb1tYvNHwrE,6482
-widgetastic.patternfly5-25.7.30.0.dist-info/METADATA,sha256=K5-Y-AiWsKPfFl7Yr21erTcYeGA4YMH_0fiSqxPQmOg,6910
-widgetastic.patternfly5-25.7.30.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-widgetastic.patternfly5-25.7.30.0.dist-info/licenses/LICENSE,sha256=nDhhj8jp0XsTdmvWpTWFpOKVn0LPXPb6ecA9zFF3Exk,576
-widgetastic.patternfly5-25.7.30.0.dist-info/RECORD,,
+widgetastic_patternfly5/components/menus/select.py,sha256=GxuD4RH1me7UAy5Zy1rEeUlTA1kL1ginil-TqUKmLOE,6481
+widgetastic_patternfly5-25.12.15.0a1.dist-info/METADATA,sha256=Qt2m5azr0RdnA6j41YqwFhRtZnuZmzHljB3wMuMzAjs,9371
+widgetastic_patternfly5-25.12.15.0a1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+widgetastic_patternfly5-25.12.15.0a1.dist-info/licenses/LICENSE,sha256=nDhhj8jp0XsTdmvWpTWFpOKVn0LPXPb6ecA9zFF3Exk,576
+widgetastic_patternfly5-25.12.15.0a1.dist-info/RECORD,,

{widgetastic.patternfly5-25.7.30.0.dist-info → widgetastic_patternfly5-25.12.15.0a1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.27.0
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any