Promium 3.5.2__tar.gz → 3.6.1__tar.gz

promium-3.6.1/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.1
+Name: Promium
+Version: 3.6.1
+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.1/Promium.egg-info/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.1
+Name: Promium
+Version: 3.6.1
+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.1/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.1}/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.1}/promium/browsers.py

@@ -51,6 +51,9 @@ def get_chrome_opera_options(
         "profile.block_third_party_cookies": True
     }
     options.add_experimental_option("prefs", prefs)
+    # 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.1}/promium/plugin.py

@@ -102,7 +102,7 @@ def pytest_addoption(parser):
         "--repeat",
         action="store",
         default=1,
-        type="int",
+        type=int,
         metavar='repeat',
         help='Number of times to repeat each test. Mostly for debug purposes'
     )

{Promium-3.5.2 → promium-3.6.1}/setup.py

@@ -19,7 +19,7 @@ REQUIREMENTS = [
 
 setup(
     name='Promium',
-    version='3.5.2',
+    version='3.6.1',
     install_requires=REQUIREMENTS,
     author='Denis Korytkin, Nataliia Guieva, '
            'Roman Zaporozhets, Vladimir Kritov, '
@@ -36,7 +36,7 @@ setup(
     entry_points={'pytest11': ['promium = promium.plugin']},
     python_requires='>=3.10, <4',
     classifiers=[
-        'Programming Language :: Python :: 3.12',
+        'Programming Language :: Python :: 3.13',
         'Topic :: Software Development :: Libraries :: Python Modules',
         'Topic :: Software Development :: Libraries :: Application Frameworks',
         'Topic :: Software Development :: Testing',

{Promium-3.5.2 → promium-3.6.1}/tests/test_enviroment.py

@@ -47,6 +47,7 @@ def docs_fixture(scope='function'):
 class TestEnvironment():
 
     @pytest.mark.env
+    @pytest.mark.skip('pass')
     def test_check_doc_command(self, docs_fixture):
         run_command(['sphinx-build', '-b', 'html', 'doc', 'public'])
         assert os.path.exists('public/index.html'), 'Not Create doc files'