Promium 3.6.1__tar.gz → 3.6.2__tar.gz

{promium-3.6.1 → promium-3.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Promium
-Version: 3.6.1
+Version: 3.6.2
 Summary: Selenium wrapper for testing Web UI
 Author: Denis Korytkin, Nataliia Guieva, Roman Zaporozhets, Vladimir Kritov, Oleh Dykusha
 Project-URL: Home page, https://none

{promium-3.6.1 → promium-3.6.2}/Promium.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Promium
-Version: 3.6.1
+Version: 3.6.2
 Summary: Selenium wrapper for testing Web UI
 Author: Denis Korytkin, Nataliia Guieva, Roman Zaporozhets, Vladimir Kritov, Oleh Dykusha
 Project-URL: Home page, https://none

{promium-3.6.1 → promium-3.6.2}/promium/assertions.py

@@ -303,6 +303,10 @@ class BaseSoftAssertion(object):
                 )
 
     def soft_assert_dicts_with_ignore_types(self, current, expected, msg=''):
+        """
+        Comparison of two dicts with ignoring type of values
+        If the dict key was lost, print it in missing list.
+        """
         expected_dict = _check_namedtuple(expected)
         current_dict = _check_namedtuple(current)
         errors = ''
@@ -331,7 +335,7 @@ class BaseSoftAssertion(object):
     ):
         """
         Comparison by type, if the types do not match - compares in a string
-        If the dict key was lost, print him in missing list.
+        If the dict key was lost, print it in missing list.
         """
         def _equal(
                 field_name: str,
@@ -405,26 +409,31 @@ class WebDriverSoftAssertion(BaseSoftAssertion):
         )
 
     def soft_assert_page_title(self, expected_title, msg=None):
+        """Page title is equals to expected_title"""
         default_msg = 'Wrong page title.'
         error = f"{self.base_msg(default_msg=default_msg, extend_msg=msg)}"
         self.soft_assert_equals(self.driver.title, expected_title, error)
 
     def soft_assert_current_url(self, expected_url, msg=None):
+        """Current url is equals to expected_title"""
         default_msg = 'Wrong current url.'
         error = f"{self.base_msg(default_msg=default_msg, extend_msg=msg)}"
         self.soft_assert_equals(self.url, expected_url, error)
 
     def soft_assert_current_url_contains(self, url_mask, msg=None):
+        """Current url contains ulr mask"""
         default_msg = f"URL {str(self.url)} doesn't contains {str(url_mask)}."
         error = f"{self.base_msg(default_msg=default_msg, extend_msg=msg)}"
         self.soft_assert_in(url_mask, self.url, error)
 
     def soft_assert_current_url_not_contains(self, url_mask, msg=None):
+        """Current url does not contain ulr mask"""
         default_msg = f"URL {str(self.url)} contains {str(url_mask)}."
         error = f"{self.base_msg(default_msg=default_msg, extend_msg=msg)}"
         self.soft_assert_not_in(url_mask, self.url, error)
 
     def soft_assert_element_is_present(self, element, msg=None):
+        """Element is present"""
         default_msg = (
             f"Element {element.by}={element.locator} is not present "
             f"on page at current time."
@@ -433,6 +442,7 @@ class WebDriverSoftAssertion(BaseSoftAssertion):
         self.soft_assert_true(element.is_present(), error, with_screen=True)
 
     def soft_assert_element_is_not_present(self, element, msg=None):
+        """Element is not present"""
         default_msg = (
             f"Element {element.by}={element.locator} is found on page."
         )
@@ -440,6 +450,7 @@ class WebDriverSoftAssertion(BaseSoftAssertion):
         self.soft_assert_false(element.is_present(), error, with_screen=True)
 
     def soft_assert_element_is_displayed(self, element, msg=None):
+        """Element is displayed to user"""
         default_msg = (
             f"Element {element.by}={element.locator} is "
             f"not visible to a user."
@@ -448,6 +459,7 @@ class WebDriverSoftAssertion(BaseSoftAssertion):
         self.soft_assert_true(element.is_displayed(), error, with_screen=True)
 
     def soft_assert_element_is_not_displayed(self, element, msg=None):
+        """Element is not displayed to user"""
         default_msg = (
             f"Element {element.by}={element.locator} is visible to a user."
         )
@@ -494,6 +506,7 @@ class WebDriverSoftAssertion(BaseSoftAssertion):
             self.assertion_errors.append(error)
 
     def soft_assert_image_status_code(self, image, status_code=200, msg=None):
+        """Compare image url status code with expected status code"""
         if not image.get_attribute('src'):
             return self.assertion_errors.append(
                 'Image does not have attribute "src"'

{promium-3.6.1 → promium-3.6.2}/promium/base.py

@@ -150,6 +150,7 @@ class Page(object):
         wait_for_page_loaded(self.driver)
 
     def wait_for_source_changed(self, action_func, *args, **kwargs):
+        """Waiting for status code of current page be changed"""
         source = self.driver.page_source
         action_func(*args, **kwargs)
         wait_until(

{promium-3.6.1 → promium-3.6.2}/promium/browsers.py

@@ -51,6 +51,9 @@ def get_chrome_opera_options(
         "profile.block_third_party_cookies": True
     }
     options.add_experimental_option("prefs", prefs)
+    options.add_experimental_option("excludeSwitches", [
+        "enable-automation",  # disable the automation bar
+    ])
     # fix use window.onbeforeunload
     options.enable_bidi = True
     options.unhandled_prompt_behavior = 'ignore'

{promium-3.6.1 → promium-3.6.2}/promium/common.py

@@ -50,6 +50,7 @@ def scroll_to_bottom(driver):
 
 
 def scroll_to_top(driver):
+    """Scrolls to the top of the page"""
     enable_jquery(driver)
     driver.execute_script(
         """jQuery('html, body').animate({scrollTop: 0 }, 'slow', null);"""
@@ -58,6 +59,7 @@ def scroll_to_top(driver):
 
 
 def scroll_to_bottom_in_block(driver, element_class):
+    """Scrolls to the bottom of the current block"""
     enable_jquery(driver)
     script = """
         var elem = '.'.concat(arguments[0]);
@@ -91,6 +93,10 @@ def scroll_to_element(driver, element, base_element=None):
 
 
 def scroll_with_offset(driver, element, with_offset=0):
+    """
+    Adjusting the final scroll position by adding or subtracting a
+    specified number of pixels
+    """
     enable_jquery(driver)
     script = """
         var elem = arguments[0];
@@ -235,11 +241,13 @@ def set_local_storage(driver, key, value):
 
 
 def delete_cookie_item(driver, name):
+    """Deleting cookie on current page"""
     driver.delete_cookie(name)
     driver.refresh()
 
 
 def delete_element_from_dom(driver, element):
+    """Removes a specific DOM element from the webpage"""
     enable_jquery(driver)
     driver.execute_script(f"""
         var element = document.querySelector("{element}");

{promium-3.6.1 → promium-3.6.2}/promium/device_config.py

@@ -5,7 +5,7 @@ from typing import NamedTuple
 DEFAULT_USER_AGENT_ANDROID = (
     "Mozilla/5.0 (Linux; Android 14; SM-G960U) "
     "AppleWebKit/537.36 (KHTML, like Gecko) "
-    "Chrome/125.0.6422.53 Mobile Safari/537.36"
+    "Chrome/131.0.0.0 Mobile Safari/537.36"
 )
 DEFAULT_USER_AGENT_IOS = (
     "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) "
@@ -15,7 +15,7 @@ DEFAULT_USER_AGENT_IOS = (
 DEFAULT_USER_AGENT_HUAWEI = (
     "Mozilla/5.0 (Linux; Android 11; HUAWEI Mate 40 Pro Build/HUAWEIMate40Pro; "
     "xx-xx) AppleWebKit/537.36 (KHTML, like Gecko) "
-    "Chrome/125.0.6422.53 Mobile Safari/537.36"
+    "Chrome/131.0.0.0 Mobile Safari/537.36"
 )
 
 

{promium-3.6.1 → promium-3.6.2}/promium/elements/frame.py

@@ -5,7 +5,9 @@ from promium.base import Element
 class Frame(Element):
 
     def switch_to_frame(self):
+        """Switch the focus from the main page content to the specific iframe"""
         self.driver.switch_to.frame(self.lookup())
 
     def exit_from_frame(self):
+        """Switch the focus from the specific iframe to the main page content"""
         self.driver.switch_to.window(self.driver.current_window_handle)

{promium-3.6.1 → promium-3.6.2}/promium/elements/input_field.py

@@ -36,10 +36,14 @@ class InputField(Element):
         return self.lookup().send_keys(*value)
 
     def _clear_field_with_keyboard(self):
+        """Clear the field using keyboard keys"""
         self.send_keys(f'{Keys.CONTROL}a')
         self.send_keys(Keys.BACKSPACE)
 
     def clear_and_fill(self, text):
+        """
+        Clear the field using keyboard keys and fill it with the given text
+        """
         expected_text = str(text).lower()
         self._clear_field_with_keyboard()
         self.send_keys(text)
@@ -51,6 +55,7 @@ class InputField(Element):
         )
 
     def fill_field(self, text):
+        """Clear element value if exists and fills it with the given text"""
         expected_text = str(text).lower()
         if self.value:
             self.clear()

{promium-3.6.1 → promium-3.6.2}/promium/elements/link.py

@@ -33,6 +33,7 @@ class Link(Element):
 
     @property
     def response(self):
+        """Get url response"""
         http = urllib3.PoolManager(
             cert_reqs=False,
             timeout=5,

{promium-3.6.1 → promium-3.6.2}/promium/waits.py

@@ -169,6 +169,7 @@ def wait_document_status(driver, seconds=NORMAL_LOAD_TIME):
 
 
 def wait_websocket_connection_open(driver, seconds=NORMAL_LOAD_TIME):
+    """Waiting for websocket connection to be opened"""
     wait = WebDriverWait(driver, timeout=seconds)
     try:
         wait.until(
@@ -182,6 +183,7 @@ def wait_websocket_connection_open(driver, seconds=NORMAL_LOAD_TIME):
 
 
 def wait_jquery_status(driver, seconds=NORMAL_LOAD_TIME):
+    """Wait for jquery will pass to active status"""
     wait = WebDriverWait(driver, timeout=seconds)
     try:
         wait.until(
@@ -220,6 +222,7 @@ def wait_for_alert(driver, seconds=NORMAL_LOAD_TIME):
 
 
 def wait_for_alert_is_displayed(driver, seconds=NORMAL_LOAD_TIME):
+    """Wait for alert to be displayed"""
     try:
         wait_for_alert(driver, seconds=seconds)
     except TimeoutException:
@@ -246,6 +249,7 @@ def wait_for_status_code(url, status_code=200, tries=10, allow_redirects=True):
 
 
 def wait_until_new_window_is_opened(driver, original_window, window_num=0):
+    """Wait until new window is opened in session"""
     wait_until(
         driver,
         lambda x: len(driver.window_handles) >= 2,
@@ -257,6 +261,7 @@ def wait_until_new_window_is_opened(driver, original_window, window_num=0):
 
 
 def wait_part_appear_in_class(driver, obj, part_class, msg=None):
+    """Wait some text in html class of the object"""
     if not msg:
         msg = f'"{part_class}" not present in attribute *class*.'
     wait_until(
@@ -268,6 +273,7 @@ def wait_part_appear_in_class(driver, obj, part_class, msg=None):
 
 
 def wait_part_disappear_in_class(driver, obj, part_class, msg=None):
+    """Wait some text not in html class of the object"""
     if not msg:
         msg = f'"{part_class}" not present in attribute *class*.'
     wait_until(
@@ -279,12 +285,14 @@ def wait_part_disappear_in_class(driver, obj, part_class, msg=None):
 
 
 def wait_url_contains(driver, text, msg=None, timeout=5):
+    """Wait some text is present in current url"""
     if not msg:
         msg = f'"{text}" not present in current url {driver.current_url}.'
     wait_until(driver, EC.url_contains(text), seconds=timeout, msg=msg)
 
 
 def wait_url_not_contains(driver, text, msg=None, timeout=5):
+    """Wait some text is not present in current url"""
     if not msg:
         msg = f'"{text}" not disappear in url.'
     wait_until_not(driver, EC.url_contains(text), seconds=timeout, msg=msg)

{promium-3.6.1 → promium-3.6.2}/setup.py

@@ -19,7 +19,7 @@ REQUIREMENTS = [
 
 setup(
     name='Promium',
-    version='3.6.1',
+    version='3.6.2',
     install_requires=REQUIREMENTS,
     author='Denis Korytkin, Nataliia Guieva, '
            'Roman Zaporozhets, Vladimir Kritov, '