cucu 1.2.0__tar.gz → 1.2.2__tar.gz

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

@@ -5,6 +5,15 @@ 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.2
+- Chore - make lint also run ruff format --check
+- Add - tags command to list tags and affected scenario counts
+- Add - click parent label of an input element when the size of the input element is zero
+
+## 1.2.1
+- Add - tab information to html report and cucu debug console log
+
 ## 1.2.0
 - Add - levels 2-4 to section step
 - Change - rename comment step to section step

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cucu
-Version: 1.2.0
+Version: 1.2.2
 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.0 → cucu-1.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cucu"
-version = "1.2.0"
+version = "1.2.2"
 description = "Easy BDD web testing"
 readme = "README.md"
 license = { text = "The Clear BSD License" }
@@ -82,7 +82,7 @@ exclude = [
 [tool.uv]
 dev-dependencies = [
     "pre-commit>=3.8.0",
-    "pytest~=8.3.5",
+    "pytest~=8.4.0",
     "ruff>=0.6.4",
 ]
 

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

@@ -76,5 +76,5 @@ class Browser:
                 start = time.time()
                 hook(self)
                 logger.debug(
-                    f'executed page check "{name}" in {round(time.time()-start, 3)}s'
+                    f'executed page check "{name}" in {round(time.time() - start, 3)}s'
                 )

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

@@ -215,7 +215,6 @@ class Selenium(Browser):
 
         if window_handle_index == len(window_handles) - 1:
             raise RuntimeError("no next browser tab available")
-
         self.driver.switch_to.window(window_handles[window_handle_index + 1])
 
     def switch_to_previous_tab(self):
@@ -225,7 +224,6 @@ class Selenium(Browser):
 
         if window_handle_index == 0:
             raise RuntimeError("no previous browser tab available")
-
         self.driver.switch_to.window(window_handles[window_handle_index - 1])
 
     def back(self):

{cucu-1.2.0 → cucu-1.2.2}/src/cucu/cli/core.py

@@ -7,6 +7,7 @@ import signal
 import sys
 import time
 import xml.etree.ElementTree as ET
+from collections import Counter
 from importlib.metadata import version
 from pathlib import Path
 from threading import Timer
@@ -14,6 +15,8 @@ from threading import Timer
 import click
 import coverage
 import psutil
+from behave.model_core import FileLocation
+from behave.runner_util import parse_features
 from click import ClickException
 from mpire import WorkerPool
 from tabulate import tabulate
@@ -851,5 +854,56 @@ def debug(browser, url, detach, logging_level):
             time.sleep(5)
 
 
+@main.command()
+@click.option(
+    "-l",
+    "--logging-level",
+    default="INFO",
+    help="set logging level to one of debug, warn or info (default)",
+)
+@click.argument(
+    "filepath", default="features", type=click.Path(path_type=Path)
+)
+def tags(filepath, logging_level):
+    """
+    print a table of tags and affected scenario counts
+    """
+    init_global_hook_variables()
+    os.environ["CUCU_LOGGING_LEVEL"] = logging_level.upper()
+    logger.init_logging(logging_level.upper())
+
+    if filepath.is_file():
+        feature_files = [filepath]
+    else:
+        feature_files = list(filepath.rglob("*.feature"))
+
+    if not filepath.exists() or not feature_files:
+        raise ClickException("No feature files found.")
+
+    file_locations = [
+        FileLocation(os.path.abspath(str(f))) for f in feature_files
+    ]
+    features = parse_features(file_locations)
+    tag_scenarios = Counter()
+
+    for feature in features:
+        for scenario in feature.scenarios:
+            affecting_tags = set(feature.tags + scenario.tags)
+            tag_scenarios.update(affecting_tags)
+
+    if not tag_scenarios:
+        print("No tags found in feature files.")
+        return
+
+    table_data = [["Tag", "Scenarios Affected"]] + [
+        [tag_name, str(count)]
+        for tag_name, count in sorted(
+            tag_scenarios.items(), key=lambda x: x[0].lower()
+        )
+    ]
+
+    print(tabulate(table_data, headers="firstrow", tablefmt="fancy_grid"))
+
+
 if __name__ == "__main__":
     main()

{cucu-1.2.0 → cucu-1.2.2}/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, take_screenshot
+from cucu.utils import ellipsize_filename, get_tab_information, take_screenshot
 
 CONFIG.define(
     "FEATURE_RESULTS_DIR",
@@ -24,7 +24,7 @@ CONFIG.define(
 )
 CONFIG.define(
     "SCENARIO_DOWNLOADS_DIR",
-    "the browser downloads directory for the currently " "executing scenario",
+    "the browser downloads directory for the currently executing scenario",
     default=None,
 )
 
@@ -264,6 +264,21 @@ 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"]
+        log_message = (
+            f"\ntab({current_tab} of {total_tabs}): {title}\nurl: {url}\n"
+        )
+        logger.debug(log_message)
+
+        # Add tab info to step.stdout so it shows up in the HTML report
+        step.stdout += (
+            f"\ntab({current_tab} of {total_tabs}): {title}\nurl: {url}\n"
+        )
+
     # if the step has substeps from using `run_steps` then we already moved
     # the step index in the run_steps method and shouldn't do it here
     if not step.has_substeps:

{cucu-1.2.0 → cucu-1.2.2}/src/cucu/formatter/cucu.py

@@ -66,7 +66,7 @@ class CucuFormatter(Formatter):
     # -- IMPLEMENT-INTERFACE FOR: Formatter
     def feature(self, feature):
         self.write_tags(feature.tags, for_feature=True)
-        text = f'{self.colorize(feature.keyword, "magenta")}: {feature.name}\n'
+        text = f"{self.colorize(feature.keyword, 'magenta')}: {feature.name}\n"
         self.stream.write(text)
 
     def colorize(self, text, color):
@@ -193,7 +193,7 @@ class CucuFormatter(Formatter):
             status_text_padding = (
                 max_line_length - len(current_step_text) - len(prefix)
             )
-            status_text = f'{" " * status_text_padding}{status_text}'
+            status_text = f"{' ' * status_text_padding}{status_text}"
             status_text = self.colorize(status_text, "yellow")
 
             self.stream.write(f"{status_text}\n")
@@ -227,7 +227,7 @@ class CucuFormatter(Formatter):
                     ]
                 )
 
-                padding = f"    {' '*(len('Given')-len(step.keyword))}"
+                padding = f"    {' ' * (len('Given') - len(step.keyword))}"
                 variable_line = f"{padding}# {expanded}\n"
                 # hide secrets before we do anything to add color which could
                 # modify the output and result in not being able to correctly

{cucu-1.2.0 → cucu-1.2.2}/src/cucu/formatter/json.py

@@ -176,7 +176,7 @@ class CucuJSONFormatter(Formatter):
                         for (key, value) in step_variables.items()
                     ]
                 )
-                padding = f"    {' '*(len('Given')-len(step.keyword))}"
+                padding = f"    {' ' * (len('Given') - len(step.keyword))}"
                 step.stdout.insert(
                     0, f"{padding}# {CONFIG.hide_secrets(expanded)}\n"
                 )

{cucu-1.2.0 → cucu-1.2.2}/src/cucu/reporter/html.py

@@ -171,7 +171,7 @@ def generate(results, basepath, only_failures=False):
                     sub_headers.append(handler(scenario))
                 except Exception:
                     logger.warning(
-                        f"Exception while trying to run sub_headers hook for scenario: \"{scenario['name']}\"\n{traceback.format_exc()}"
+                        f'Exception while trying to run sub_headers hook for scenario: "{scenario["name"]}"\n{traceback.format_exc()}'
                     )
             scenario["sub_headers"] = "<br/>".join(sub_headers)
 
@@ -204,7 +204,7 @@ def generate(results, basepath, only_failures=False):
                     # Map the count to the appropriate HTML heading (h2-h5)
                     # We use h2-h5 instead of h1-h4 so h1 can be reserved for scenario/feature titles
                     step["heading_level"] = (
-                        f"h{step["name"][:4].count("#") + 1}"
+                        f"h{step['name'][:4].count('#') + 1}"
                     )
 
                 if os.path.exists(image_dirpath):
@@ -422,7 +422,7 @@ def generate(results, basepath, only_failures=False):
         )
 
         feature_output_filepath = os.path.join(
-            basepath, f'{feature["name"]}.html'
+            basepath, f"{feature['name']}.html"
         )
 
         with open(feature_output_filepath, "wb") as output:

{cucu-1.2.0 → cucu-1.2.2}/src/cucu/steps/button_steps.py

@@ -1,5 +1,9 @@
 from cucu import fuzzy, helpers
-from cucu.utils import take_saw_element_screenshot
+from cucu.utils import (
+    find_n_click_input_parent_label,
+    is_element_size_zero,
+    take_saw_element_screenshot,
+)
 
 from . import base_steps
 
@@ -67,6 +71,10 @@ def click_button(ctx, button):
     if base_steps.is_disabled(button):
         raise RuntimeError("unable to click the button, as it is disabled")
 
+    if is_element_size_zero(button):
+        find_n_click_input_parent_label(ctx, button)
+        return
+
     ctx.browser.click(button)
 
 

{cucu-1.2.0 → cucu-1.2.2}/src/cucu/steps/checkbox_steps.py

@@ -1,5 +1,9 @@
 from cucu import fuzzy, helpers
-from cucu.utils import take_saw_element_screenshot
+from cucu.utils import (
+    find_n_click_input_parent_label,
+    is_element_size_zero,
+    take_saw_element_screenshot,
+)
 
 from . import base_steps
 
@@ -66,6 +70,10 @@ def check_checkbox(ctx, checkbox):
     if base_steps.is_disabled(checkbox):
         raise RuntimeError("unable to check the checkbox, as it is disabled")
 
+    if is_element_size_zero(checkbox):
+        find_n_click_input_parent_label(ctx, checkbox)
+        return
+
     ctx.browser.click(checkbox)
 
 
@@ -78,6 +86,10 @@ def uncheck_checkbox(ctx, checkbox):
     if is_not_checked(checkbox):
         raise Exception("checkbox already unchecked")
 
+    if is_element_size_zero(checkbox):
+        find_n_click_input_parent_label(ctx, checkbox)
+        return
+
     ctx.browser.click(checkbox)
 
 

{cucu-1.2.0 → cucu-1.2.2}/src/cucu/steps/radio_steps.py

@@ -1,6 +1,10 @@
 from cucu import fuzzy, helpers, retry, step
 from cucu.config import CONFIG
-from cucu.utils import take_saw_element_screenshot
+from cucu.utils import (
+    find_n_click_input_parent_label,
+    is_element_size_zero,
+    take_saw_element_screenshot,
+)
 
 from . import base_steps
 
@@ -90,6 +94,10 @@ def find_n_select_radio_button(ctx, name, index=0, ignore_if_selected=False):
 
         raise Exception(f'radio button "{name}" already selected')
 
+    if is_element_size_zero(radio):
+        find_n_click_input_parent_label(ctx, radio)
+        return
+
     ctx.browser.click(radio)
 
 
@@ -123,6 +131,10 @@ def select_radio_button(ctx, radiobox):
     if selected:
         raise Exception("radiobox already selected")
 
+    if is_element_size_zero(radiobox):
+        find_n_click_input_parent_label(ctx, radiobox)
+        return
+
     ctx.browser.click(radiobox)
 
 

{cucu-1.2.0 → cucu-1.2.2}/src/cucu/steps/table_steps.py

@@ -306,7 +306,7 @@ def get_table_cell_value(ctx, table, row, column, variable_name):
         cell_value = tables[table][row][column]
     except IndexError:
         raise RuntimeError(
-            f"Cannot find table:{table+1},row:{row+1},column:{column+1}. Please check your table data."
+            f"Cannot find table:{table + 1},row:{row + 1},column:{column + 1}. Please check your table data."
         )
     config.CONFIG[variable_name] = cell_value
 
@@ -343,7 +343,7 @@ def find_table_element(ctx, nth=1):
         return ctx.browser.css_find_elements("table")[nth]
     except IndexError:
         raise RuntimeError(
-            f"Cannot find table:{nth+1}. Please check your table data."
+            f"Cannot find table:{nth + 1}. Please check your table data."
         )
 
 
@@ -364,7 +364,7 @@ def click_table_cell(ctx, row, column, table):
         cell = row.find_elements(By.CSS_SELECTOR, "td")[column]
     except IndexError:
         raise RuntimeError(
-            f"Cannot find table:{table+1},row:{row+1},column:{column+1}. Please check your table data."
+            f"Cannot find table:{table + 1},row:{row + 1},column:{column + 1}. Please check your table data."
         )
     ctx.browser.click(cell)
 
@@ -409,7 +409,7 @@ def wait_click_table_cell_matching_text(ctx, column, match_text, table):
             cell = row[0].find_elements(By.CSS_SELECTOR, "td")[column]
         except IndexError:
             raise RuntimeError(
-                f"Cannot find table:{table+1},column:{column+1},text:{match_text}. Please check your table data."
+                f"Cannot find table:{table + 1},column:{column + 1},text:{match_text}. Please check your table data."
             )
 
         ctx.browser.click(cell)
@@ -431,7 +431,7 @@ def wait_table_row_count(ctx, row_count, table):
             return
         else:
             raise RuntimeError(
-                f"Unable to find {row_count} rows in table {table+1}. Please check your table data."
+                f"Unable to find {row_count} rows in table {table + 1}. Please check your table data."
             )
 
     retry(find_table_row_count)(ctx, row_count, table)

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

@@ -9,6 +9,7 @@ import pkgutil
 import shutil
 
 import humanize
+from selenium.webdriver.common.by import By
 from tabulate import DataRow, TableFormat, tabulate
 from tenacity import (
     after_log,
@@ -271,3 +272,41 @@ def take_screenshot(ctx, step_name, label="", element=None):
         shutil.copyfile(filepath, CONFIG["CUCU_MONITOR_PNG"])
 
     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).
+    """
+    try:
+        # Find the closest ancestor <label> element
+        label = input_element.find_element(By.XPATH, "ancestor::label[1]")
+
+        if label and label.is_displayed():
+            ctx.browser.click(label)
+            logger.debug("Successfully clicked the parent label.")
+        else:
+            logger.warning("Parent label is not displayed or not found.")
+
+    except Exception as e:
+        logger.error(
+            f"Click on parent label failed (possibly missing label ancestor): {e}"
+        )
+
+
+def is_element_size_zero(element):
+    size = element.size
+    return size["width"] == 0 and size["height"] == 0