cucu 1.2.2__tar.gz → 1.2.3__tar.gz

{cucu-1.2.2 → cucu-1.2.3}/CHANGELOG.md

@@ -5,6 +5,9 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project closely adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 1.2.3
+- Add - additional tab information steps
+- Change - retry open a browser
 
 ## 1.2.2
 - Chore - make lint also run ruff format --check

{cucu-1.2.2 → cucu-1.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cucu
-Version: 1.2.2
+Version: 1.2.3
 Summary: Easy BDD web testing
 Project-URL: Homepage, https://github.com/dominodatalab/cucu/wiki
 Project-URL: Download, https://pypi.org/project/cucu/

{cucu-1.2.2 → cucu-1.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cucu"
-version = "1.2.2"
+version = "1.2.3"
 description = "Easy BDD web testing"
 readme = "README.md"
 license = { text = "The Clear BSD License" }

{cucu-1.2.2 → cucu-1.2.3}/src/cucu/browser/core.py

@@ -55,6 +55,18 @@ class Browser:
     def close_window(self):
         raise RuntimeError("implement me")
 
+    def get_tab_info(self):
+        raise RuntimeError("implement me")
+
+    def get_all_tabs_info(self):
+        raise RuntimeError("implement me")
+
+    def switch_to_nth_tab(self, tab_index):
+        raise RuntimeError("implement me")
+
+    def switch_to_tab_that_matches_regex(self, text):
+        raise RuntimeError("implement me")
+
     def quit(self):
         raise RuntimeError("implement me")
 

{cucu-1.2.2 → cucu-1.2.3}/src/cucu/browser/selenium.py

@@ -1,5 +1,6 @@
 import logging
 import os
+import re
 
 import chromedriver_autoinstaller
 import geckodriver_autoinstaller
@@ -226,6 +227,51 @@ class Selenium(Browser):
             raise RuntimeError("no previous browser tab available")
         self.driver.switch_to.window(window_handles[window_handle_index - 1])
 
+    def switch_to_nth_tab(self, tab_number):
+        print(f"tab_number, {tab_number}")
+        window_handles = self.driver.window_handles
+        total_tabs = len(window_handles)
+        if tab_number > total_tabs:
+            raise RuntimeError(f"no {tab_number} browser tab available")
+        self.driver.switch_to.window(window_handles[tab_number])
+
+    def switch_to_tab_that_matches_regex(self, title_pattern):
+        window_handles = self.driver.window_handles
+
+        for handle in window_handles:
+            self.driver.switch_to.window(handle)
+            if re.search(title_pattern, self.driver.title):
+                return
+
+        raise Exception(f"No tab title matches pattern: {title_pattern}")
+
+    def get_tab_info(self):
+        window_handles = self.driver.window_handles
+        current_window = self.driver.current_window_handle
+        window_handle_index = window_handles.index(current_window)
+
+        return {
+            "tab_count": len(window_handles),
+            "index": window_handle_index,
+            "title": self.driver.title,
+            "url": self.driver.current_url,
+        }
+
+    def get_all_tabs_info(self):
+        tabs_info = []
+        handles = self.driver.window_handles
+        for idx, handle in enumerate(handles):
+            self.driver.switch_to.window(handle)
+            tabs_info.append(
+                {
+                    "index": idx,
+                    "title": self.driver.title,
+                    "url": self.driver.current_url,
+                }
+            )
+
+        return tabs_info
+
     def back(self):
         self.driver.back()
         self.wait_for_page_to_load()

{cucu-1.2.2 → cucu-1.2.3}/src/cucu/environment.py

@@ -10,7 +10,7 @@ from functools import partial
 from cucu import config, init_scenario_hook_variables, logger
 from cucu.config import CONFIG
 from cucu.page_checks import init_page_checks
-from cucu.utils import ellipsize_filename, get_tab_information, take_screenshot
+from cucu.utils import ellipsize_filename, take_screenshot
 
 CONFIG.define(
     "FEATURE_RESULTS_DIR",
@@ -264,11 +264,11 @@ def after_step(ctx, step):
     if ctx.browser is not None and ctx.current_step.has_substeps is False:
         take_screenshot(ctx, step.name, label=f"After {step.name}")
 
-        tab_info = get_tab_information(ctx)
-        total_tabs = tab_info["window_count"]
-        current_tab = tab_info["current_index"] + 1
-        title = tab_info["current_title"]
-        url = tab_info["current_url"]
+        tab_info = ctx.browser.get_tab_info()
+        total_tabs = tab_info["tab_count"]
+        current_tab = tab_info["index"] + 1
+        title = tab_info["title"]
+        url = tab_info["url"]
         log_message = (
             f"\ntab({current_tab} of {total_tabs}): {title}\nurl: {url}\n"
         )

{cucu-1.2.2 → cucu-1.2.3}/src/cucu/steps/browser_steps.py

@@ -32,7 +32,7 @@ def open_a_browser(ctx, url):
         Given I open a browser at the url "https://www.google.com"
     """
     if ctx.browser is None:
-        ctx.browser = open_browser(ctx)
+        ctx.browser = retry(open_browser)(ctx)
         ctx.browsers.append(ctx.browser)
     else:
         logger.debug("browser already open so using existing instance")
@@ -43,7 +43,7 @@ def open_a_browser(ctx, url):
 
 @step('I open a new browser at the url "{url}"')
 def open_a_new_browser(ctx, url):
-    ctx.browser = open_browser(ctx)
+    ctx.browser = retry(open_browser)(ctx)
     ctx.browsers.append(ctx.browser)
     logger.debug(f"navigating to url #{url}")
     ctx.browser.navigate(url)
@@ -219,6 +219,68 @@ def wait_to_switch_to_previous_browser_tab(ctx):
     retry(switch_to_previous_tab)(ctx)
 
 
+def switch_to_nth_tab(ctx, tab_number):
+    ctx.check_browser_initialized()
+    ctx.browser.switch_to_nth_tab(tab_number)
+
+
+@step('I switch to the "{nth:nth}" browser tab')
+def switch_to_nth_browser_tab(ctx, nth):
+    switch_to_nth_tab(ctx, nth)
+
+
+@step('I wait to switch to the "{nth:nth}" browser tab')
+def wait_to_switch_to_nth_browser_tab(ctx, nth):
+    retry(switch_to_nth_tab)(ctx, nth)
+
+
+def switch_to_tab_matching_regex(ctx, regex):
+    ctx.check_browser_initialized()
+    ctx.browser.switch_to_tab_that_matches_regex(regex)
+
+
+@step('I switch to the browser tab that matches "{regex}"')
+def switch_to_browser_tab_matching_regex(ctx, regex):
+    switch_to_tab_matching_regex(ctx, regex)
+
+
+@step('I wait to switch to the browser tab that matches "{regex}"')
+def wait_to_switch_to_browser_tab_matching_regex(ctx, regex):
+    retry(switch_to_tab_matching_regex)(ctx, regex)
+
+
+@step('I save the browser tabs info to the variable "{variable}"')
+def save_browser_tabs_info_to_variable(ctx, variable):
+    ctx.check_browser_initialized()
+    tabs_info = ctx.browser.get_all_tabs_info()
+    lst_tab_info = [
+        f"tab({tab['index'] + 1}): {tab['title']}, url: {tab['url']}"
+        for tab in tabs_info
+    ]
+    config.CONFIG[variable] = lst_tab_info
+
+
+@step("I list the current browser tab info")
+def list_current_browser_tab_info(ctx):
+    ctx.check_browser_initialized()
+    tab_info = ctx.browser.get_tab_info()
+    current_tab = tab_info["index"] + 1
+    title = tab_info["title"]
+    url = tab_info["url"]
+    print(f"\ntab({current_tab}): {title}\nurl: {url}\n")
+
+
+@step("I list all browser tabs info")
+def list_browser_tabs_info(ctx):
+    ctx.check_browser_initialized()
+    all_tabs_info = ctx.browser.get_all_tabs_info()
+    for tab in all_tabs_info:
+        tab_index = tab["index"] + 1
+        title = tab["title"]
+        url = tab["url"]
+        print(f"\ntab({tab_index}): {title}\nurl: {url}\n")
+
+
 def save_downloaded_file(ctx, filename):
     ctx.check_browser_initialized()
 

{cucu-1.2.2 → cucu-1.2.3}/src/cucu/utils.py

@@ -274,19 +274,6 @@ def take_screenshot(ctx, step_name, label="", element=None):
     CONFIG["__STEP_SCREENSHOT_COUNT"] += 1
 
 
-def get_tab_information(ctx):
-    driver = ctx.browser.driver
-    window_handles = driver.window_handles
-    current_window = driver.current_window_handle
-    window_handle_index = window_handles.index(current_window)
-    return {
-        "window_count": len(window_handles),
-        "current_index": window_handle_index,
-        "current_title": driver.title,
-        "current_url": driver.current_url,
-    }
-
-
 def find_n_click_input_parent_label(ctx, input_element):
     """
     Clicks the nearest parent <label> of an input elemnt (if input is visually hidden or size is zero).