Promium 3.5.2__tar.gz → 3.6.2__tar.gz

promium-3.6.2/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.1
+Name: Promium
+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
+Project-URL: Documentation, https://none
+Keywords: Testing UI,Selenium,PageObject,Selenium wrapper
+Platform: linux
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Testing
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.10, <4
+License-File: LICENSE
+Requires-Dist: six>=1.10.0
+Requires-Dist: json_checker>=1.2.1
+Requires-Dist: urllib3>=2.0.2
+Requires-Dist: py>=1.5.2
+Requires-Dist: pytest>=5.0.0
+Requires-Dist: pytest_rerunfailures>=4.1.0
+Requires-Dist: pytest-forked>=0.2
+Requires-Dist: pytest-instafail>=0.3.0
+Requires-Dist: deepdiff>=5.7.0
+Requires-Dist: selenium>=4.10.0
+
+Promium
+=======
+
+.. image:: https://img.shields.io/badge/Python%3A%203.13-blue
+   :target: https://pypi.org/project/Promium/
+
+.. image:: https://badge.fury.io/py/Promium.svg
+   :target: https://badge.fury.io/py/Promium
+
+Promium is a simple Selenium wrapper designed to facilitate writing UI tests.
+
+`Promium Documentation <https://qa-automation.git-doc.evo.dev/promium>`_
+
+Overview
+--------
+
+Promium simplifies the UI testing process using Selenium. The framework is designed for ease of test creation and provides essential tools for working with elements, pages, and test cases. Supports Python 3.13 and works on Linux and macOS.
+
+Installation and Setup
+----------------------
+
+**System Requirements**
+
+- Python 3.13
+- Systems: Linux, macOS
+
+To install all dependencies:
+
+.. code-block:: text
+
+   pip install -r requirements.txt
+
+**Install Promium**
+
+.. code-block:: text
+
+   pip install promium
+
+**Driver and Chrome Setup**
+
+To use Promium with Chrome, both Google Chrome and ChromeDriver need to be installed. Use the following commands to set up Chrome and ChromeDriver:
+
+.. code-block:: text
+
+   ARG CHROME_MILESTONE=130
+
+   #============================================
+   # Google Chrome
+   #============================================
+   RUN CHROME_VERSION=$(curl -s https://googlechromelabs.github.io/chrome-for-testing/LATEST_RELEASE_${CHROME_MILESTONE}) && \
+       curl -Lo /tmp/chrome-linux.zip https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing/${CHROME_VERSION}/linux64/chrome-linux64.zip && \
+       apt-get install -y unzip && \
+       unzip /tmp/chrome-linux.zip -d /usr/local/ && \
+       ln -s /usr/local/chrome-linux64/chrome /usr/local/bin/google-chrome && \
+       rm /tmp/chrome-linux.zip
+
+   #============================================
+   # ChromeDriver
+   #============================================
+   RUN CHROME_DRIVER_VERSION=$(curl -s https://googlechromelabs.github.io/chrome-for-testing/latest-versions-per-milestone.json | python3 -c "import sys, json; print(json.load(sys.stdin)['milestones'][str(${CHROME_MILESTONE})]['version'])") && \
+       wget --no-verbose -O /tmp/chromedriver_linux64.zip https://storage.googleapis.com/chrome-for-testing-public/${CHROME_DRIVER_VERSION}/linux64/chromedriver-linux64.zip && \
+       unzip /tmp/chromedriver_linux64.zip -d /opt/selenium && \
+       ln -fs /opt/selenium/chromedriver-linux64/chromedriver /usr/bin/chromedriver && \
+       rm /tmp/chromedriver_linux64.zip
+
+Usage Examples
+--------------
+
+Below is a basic example of how to define a page object and run a simple test. For more examples, refer to the `Examples Documentation <https://github.com/your-repo-path/promium/doc/examples.md>`_.
+
+**Page Object Example**
+
+.. code-block:: text
+
+    from selenium.webdriver.common.by import By
+    from promium import Page, Block, Element, InputField, Link
+
+    class ResultBlock(Block):
+        title = Link(By.CSS_SELECTOR, 'h3')
+        link = Element(By.CSS_SELECTOR, '.f')
+        description = Element(By.CSS_SELECTOR, '.st')
+        tags = Element.as_list(By.CSS_SELECTOR, '.osl .fl')
+
+    class GoogleResultPage(Page):
+        results_blocks = ResultBlock.as_list(By.CSS_SELECTOR, '#rso .srg div.g')
+
+    class GoogleMainPage(Page):
+        url = 'https://google.com'
+        logo = Element(By.CSS_SELECTOR, '#hplogo')
+        search_input = InputField(By.CSS_SELECTOR, '[name="q"]')
+
+        def search(self, text):
+            self.search_input.send_keys(text)
+            self.search_input.submit()
+            return GoogleResultPage(self.driver)
+
+
+**Test Example**
+
+.. code-block:: text
+
+    from promium.test_case import WebDriverTestCase
+    from tests.pages.google_page import GoogleMainPage
+
+    class TestMainGooglePage(WebDriverTestCase):
+        def test_search(self):
+            main_page = GoogleMainPage(self.driver)
+            main_page.open()
+            self.soft_assert_element_is_displayed(main_page.logo)
+            result_page = main_page.search('Selenium')
+            result_block = result_page.results_blocks.first_item
+            self.soft_assert_in('Selenium', result_block.title.text)
+
+
+**Run a Simple Test**
+
+.. code-block:: text
+
+   # all tests
+   pytest tests/
+
+   # all tests in suite
+   pytest tests/test_google.py
+
+   # only one test
+   pytest tests/test_google.py -k test_search
+
+Development and Testing
+-----------------------
+
+To set up a development environment and run tests, use the following commands:
+
+- **Build Docker Image**: `docker build -t promium/base-env .`
+- **Run Tests**: `docker-compose run test-se`
+- **Check Linting**: `docker-compose run flake8`
+
+Additional Documentation
+------------------------
+
+For detailed information on using and configuring Promium, refer to the following documentation files:
+
+
+- `Assertions <./doc/assertions.md>`_ - Description of available assertion methods for validating test conditions.
+- `CI Setup <./doc/ci.md>`_ - Configuration of CI/CD for automating integration processes.
+- `Commands <./doc/command.md>`_ - List of available commands and their usage within the framework.
+- `Containers <./doc/containers.md>`_ - Information on setting up and using containers for an isolated testing environment.
+- `Devices(emulation) <./doc/device.md>`_ - Description of supported devices and configurations.
+- `Drivers <./doc/driver.md>`_ - Configuration of drivers for browser interaction.
+- `Elements <./doc/element.md>`_ - Working with web elements and their properties.
+- `Examples <./doc/examples.md>`_ - Sample tests and scenarios to get started with the framework.
+- `Exceptions <./doc/exceptions.md>`_ - Handling exceptions and errors during testing.
+- `Test Cases <./doc/test_case.md>`_ - Creating and structuring test cases in Promium.
+
+
+

promium-3.6.2/Promium.egg-info/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.1
+Name: Promium
+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
+Project-URL: Documentation, https://none
+Keywords: Testing UI,Selenium,PageObject,Selenium wrapper
+Platform: linux
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Testing
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.10, <4
+License-File: LICENSE
+Requires-Dist: six>=1.10.0
+Requires-Dist: json_checker>=1.2.1
+Requires-Dist: urllib3>=2.0.2
+Requires-Dist: py>=1.5.2
+Requires-Dist: pytest>=5.0.0
+Requires-Dist: pytest_rerunfailures>=4.1.0
+Requires-Dist: pytest-forked>=0.2
+Requires-Dist: pytest-instafail>=0.3.0
+Requires-Dist: deepdiff>=5.7.0
+Requires-Dist: selenium>=4.10.0
+
+Promium
+=======
+
+.. image:: https://img.shields.io/badge/Python%3A%203.13-blue
+   :target: https://pypi.org/project/Promium/
+
+.. image:: https://badge.fury.io/py/Promium.svg
+   :target: https://badge.fury.io/py/Promium
+
+Promium is a simple Selenium wrapper designed to facilitate writing UI tests.
+
+`Promium Documentation <https://qa-automation.git-doc.evo.dev/promium>`_
+
+Overview
+--------
+
+Promium simplifies the UI testing process using Selenium. The framework is designed for ease of test creation and provides essential tools for working with elements, pages, and test cases. Supports Python 3.13 and works on Linux and macOS.
+
+Installation and Setup
+----------------------
+
+**System Requirements**
+
+- Python 3.13
+- Systems: Linux, macOS
+
+To install all dependencies:
+
+.. code-block:: text
+
+   pip install -r requirements.txt
+
+**Install Promium**
+
+.. code-block:: text
+
+   pip install promium
+
+**Driver and Chrome Setup**
+
+To use Promium with Chrome, both Google Chrome and ChromeDriver need to be installed. Use the following commands to set up Chrome and ChromeDriver:
+
+.. code-block:: text
+
+   ARG CHROME_MILESTONE=130
+
+   #============================================
+   # Google Chrome
+   #============================================
+   RUN CHROME_VERSION=$(curl -s https://googlechromelabs.github.io/chrome-for-testing/LATEST_RELEASE_${CHROME_MILESTONE}) && \
+       curl -Lo /tmp/chrome-linux.zip https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing/${CHROME_VERSION}/linux64/chrome-linux64.zip && \
+       apt-get install -y unzip && \
+       unzip /tmp/chrome-linux.zip -d /usr/local/ && \
+       ln -s /usr/local/chrome-linux64/chrome /usr/local/bin/google-chrome && \
+       rm /tmp/chrome-linux.zip
+
+   #============================================
+   # ChromeDriver
+   #============================================
+   RUN CHROME_DRIVER_VERSION=$(curl -s https://googlechromelabs.github.io/chrome-for-testing/latest-versions-per-milestone.json | python3 -c "import sys, json; print(json.load(sys.stdin)['milestones'][str(${CHROME_MILESTONE})]['version'])") && \
+       wget --no-verbose -O /tmp/chromedriver_linux64.zip https://storage.googleapis.com/chrome-for-testing-public/${CHROME_DRIVER_VERSION}/linux64/chromedriver-linux64.zip && \
+       unzip /tmp/chromedriver_linux64.zip -d /opt/selenium && \
+       ln -fs /opt/selenium/chromedriver-linux64/chromedriver /usr/bin/chromedriver && \
+       rm /tmp/chromedriver_linux64.zip
+
+Usage Examples
+--------------
+
+Below is a basic example of how to define a page object and run a simple test. For more examples, refer to the `Examples Documentation <https://github.com/your-repo-path/promium/doc/examples.md>`_.
+
+**Page Object Example**
+
+.. code-block:: text
+
+    from selenium.webdriver.common.by import By
+    from promium import Page, Block, Element, InputField, Link
+
+    class ResultBlock(Block):
+        title = Link(By.CSS_SELECTOR, 'h3')
+        link = Element(By.CSS_SELECTOR, '.f')
+        description = Element(By.CSS_SELECTOR, '.st')
+        tags = Element.as_list(By.CSS_SELECTOR, '.osl .fl')
+
+    class GoogleResultPage(Page):
+        results_blocks = ResultBlock.as_list(By.CSS_SELECTOR, '#rso .srg div.g')
+
+    class GoogleMainPage(Page):
+        url = 'https://google.com'
+        logo = Element(By.CSS_SELECTOR, '#hplogo')
+        search_input = InputField(By.CSS_SELECTOR, '[name="q"]')
+
+        def search(self, text):
+            self.search_input.send_keys(text)
+            self.search_input.submit()
+            return GoogleResultPage(self.driver)
+
+
+**Test Example**
+
+.. code-block:: text
+
+    from promium.test_case import WebDriverTestCase
+    from tests.pages.google_page import GoogleMainPage
+
+    class TestMainGooglePage(WebDriverTestCase):
+        def test_search(self):
+            main_page = GoogleMainPage(self.driver)
+            main_page.open()
+            self.soft_assert_element_is_displayed(main_page.logo)
+            result_page = main_page.search('Selenium')
+            result_block = result_page.results_blocks.first_item
+            self.soft_assert_in('Selenium', result_block.title.text)
+
+
+**Run a Simple Test**
+
+.. code-block:: text
+
+   # all tests
+   pytest tests/
+
+   # all tests in suite
+   pytest tests/test_google.py
+
+   # only one test
+   pytest tests/test_google.py -k test_search
+
+Development and Testing
+-----------------------
+
+To set up a development environment and run tests, use the following commands:
+
+- **Build Docker Image**: `docker build -t promium/base-env .`
+- **Run Tests**: `docker-compose run test-se`
+- **Check Linting**: `docker-compose run flake8`
+
+Additional Documentation
+------------------------
+
+For detailed information on using and configuring Promium, refer to the following documentation files:
+
+
+- `Assertions <./doc/assertions.md>`_ - Description of available assertion methods for validating test conditions.
+- `CI Setup <./doc/ci.md>`_ - Configuration of CI/CD for automating integration processes.
+- `Commands <./doc/command.md>`_ - List of available commands and their usage within the framework.
+- `Containers <./doc/containers.md>`_ - Information on setting up and using containers for an isolated testing environment.
+- `Devices(emulation) <./doc/device.md>`_ - Description of supported devices and configurations.
+- `Drivers <./doc/driver.md>`_ - Configuration of drivers for browser interaction.
+- `Elements <./doc/element.md>`_ - Working with web elements and their properties.
+- `Examples <./doc/examples.md>`_ - Sample tests and scenarios to get started with the framework.
+- `Exceptions <./doc/exceptions.md>`_ - Handling exceptions and errors during testing.
+- `Test Cases <./doc/test_case.md>`_ - Creating and structuring test cases in Promium.
+
+
+

promium-3.6.2/README.rst

@@ -0,0 +1,155 @@
+Promium
+=======
+
+.. image:: https://img.shields.io/badge/Python%3A%203.13-blue
+   :target: https://pypi.org/project/Promium/
+
+.. image:: https://badge.fury.io/py/Promium.svg
+   :target: https://badge.fury.io/py/Promium
+
+Promium is a simple Selenium wrapper designed to facilitate writing UI tests.
+
+`Promium Documentation <https://qa-automation.git-doc.evo.dev/promium>`_
+
+Overview
+--------
+
+Promium simplifies the UI testing process using Selenium. The framework is designed for ease of test creation and provides essential tools for working with elements, pages, and test cases. Supports Python 3.13 and works on Linux and macOS.
+
+Installation and Setup
+----------------------
+
+**System Requirements**
+
+- Python 3.13
+- Systems: Linux, macOS
+
+To install all dependencies:
+
+.. code-block:: text
+
+   pip install -r requirements.txt
+
+**Install Promium**
+
+.. code-block:: text
+
+   pip install promium
+
+**Driver and Chrome Setup**
+
+To use Promium with Chrome, both Google Chrome and ChromeDriver need to be installed. Use the following commands to set up Chrome and ChromeDriver:
+
+.. code-block:: text
+
+   ARG CHROME_MILESTONE=130
+
+   #============================================
+   # Google Chrome
+   #============================================
+   RUN CHROME_VERSION=$(curl -s https://googlechromelabs.github.io/chrome-for-testing/LATEST_RELEASE_${CHROME_MILESTONE}) && \
+       curl -Lo /tmp/chrome-linux.zip https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing/${CHROME_VERSION}/linux64/chrome-linux64.zip && \
+       apt-get install -y unzip && \
+       unzip /tmp/chrome-linux.zip -d /usr/local/ && \
+       ln -s /usr/local/chrome-linux64/chrome /usr/local/bin/google-chrome && \
+       rm /tmp/chrome-linux.zip
+
+   #============================================
+   # ChromeDriver
+   #============================================
+   RUN CHROME_DRIVER_VERSION=$(curl -s https://googlechromelabs.github.io/chrome-for-testing/latest-versions-per-milestone.json | python3 -c "import sys, json; print(json.load(sys.stdin)['milestones'][str(${CHROME_MILESTONE})]['version'])") && \
+       wget --no-verbose -O /tmp/chromedriver_linux64.zip https://storage.googleapis.com/chrome-for-testing-public/${CHROME_DRIVER_VERSION}/linux64/chromedriver-linux64.zip && \
+       unzip /tmp/chromedriver_linux64.zip -d /opt/selenium && \
+       ln -fs /opt/selenium/chromedriver-linux64/chromedriver /usr/bin/chromedriver && \
+       rm /tmp/chromedriver_linux64.zip
+
+Usage Examples
+--------------
+
+Below is a basic example of how to define a page object and run a simple test. For more examples, refer to the `Examples Documentation <https://github.com/your-repo-path/promium/doc/examples.md>`_.
+
+**Page Object Example**
+
+.. code-block:: text
+
+    from selenium.webdriver.common.by import By
+    from promium import Page, Block, Element, InputField, Link
+
+    class ResultBlock(Block):
+        title = Link(By.CSS_SELECTOR, 'h3')
+        link = Element(By.CSS_SELECTOR, '.f')
+        description = Element(By.CSS_SELECTOR, '.st')
+        tags = Element.as_list(By.CSS_SELECTOR, '.osl .fl')
+
+    class GoogleResultPage(Page):
+        results_blocks = ResultBlock.as_list(By.CSS_SELECTOR, '#rso .srg div.g')
+
+    class GoogleMainPage(Page):
+        url = 'https://google.com'
+        logo = Element(By.CSS_SELECTOR, '#hplogo')
+        search_input = InputField(By.CSS_SELECTOR, '[name="q"]')
+
+        def search(self, text):
+            self.search_input.send_keys(text)
+            self.search_input.submit()
+            return GoogleResultPage(self.driver)
+
+
+**Test Example**
+
+.. code-block:: text
+
+    from promium.test_case import WebDriverTestCase
+    from tests.pages.google_page import GoogleMainPage
+
+    class TestMainGooglePage(WebDriverTestCase):
+        def test_search(self):
+            main_page = GoogleMainPage(self.driver)
+            main_page.open()
+            self.soft_assert_element_is_displayed(main_page.logo)
+            result_page = main_page.search('Selenium')
+            result_block = result_page.results_blocks.first_item
+            self.soft_assert_in('Selenium', result_block.title.text)
+
+
+**Run a Simple Test**
+
+.. code-block:: text
+
+   # all tests
+   pytest tests/
+
+   # all tests in suite
+   pytest tests/test_google.py
+
+   # only one test
+   pytest tests/test_google.py -k test_search
+
+Development and Testing
+-----------------------
+
+To set up a development environment and run tests, use the following commands:
+
+- **Build Docker Image**: `docker build -t promium/base-env .`
+- **Run Tests**: `docker-compose run test-se`
+- **Check Linting**: `docker-compose run flake8`
+
+Additional Documentation
+------------------------
+
+For detailed information on using and configuring Promium, refer to the following documentation files:
+
+
+- `Assertions <./doc/assertions.md>`_ - Description of available assertion methods for validating test conditions.
+- `CI Setup <./doc/ci.md>`_ - Configuration of CI/CD for automating integration processes.
+- `Commands <./doc/command.md>`_ - List of available commands and their usage within the framework.
+- `Containers <./doc/containers.md>`_ - Information on setting up and using containers for an isolated testing environment.
+- `Devices(emulation) <./doc/device.md>`_ - Description of supported devices and configurations.
+- `Drivers <./doc/driver.md>`_ - Configuration of drivers for browser interaction.
+- `Elements <./doc/element.md>`_ - Working with web elements and their properties.
+- `Examples <./doc/examples.md>`_ - Sample tests and scenarios to get started with the framework.
+- `Exceptions <./doc/exceptions.md>`_ - Handling exceptions and errors during testing.
+- `Test Cases <./doc/test_case.md>`_ - Creating and structuring test cases in Promium.
+
+
+

{Promium-3.5.2 → promium-3.6.2}/doc/conf.py

@@ -6,7 +6,7 @@ extensions = [
     'sphinx.ext.intersphinx',
     'sphinxemoji.sphinxemoji',
     'sphinx_autobuild',
-    'myst_parser',
+    # 'myst_parser',
 ]
 intersphinx_mapping = {
     'python': ('https://docs.python.org/3.7', None),
@@ -18,7 +18,7 @@ source_parsers = {
    '.md': 'recommonmark.parser.CommonMarkParser',
 }
 
-html_theme = 'sphinx_rtd_theme'
+# html_theme = 'sphinx_rtd_theme'
 html_theme_options = {
     'display_version': False,
 }

{Promium-3.5.2 → 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.5.2 → 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.5.2 → promium-3.6.2}/promium/browsers.py

@@ -51,6 +51,12 @@ 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'
 
     if device.__class__.__name__ == "CustomDevice":
         mobile_emulation = {

{Promium-3.5.2 → 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}");