mops 3.0.0__tar.gz → 3.2.0__tar.gz

{mops-3.0.0 → mops-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mops
-Version: 3.0.0
+Version: 3.2.0
 Summary: Wrapper of Selenium, Appium and Playwright with single API
 Author-email: Podolian Vladimir <vladimir.podolyan64@gmail.com>
 License: MIT
@@ -22,7 +22,7 @@ Classifier: Topic :: Software Development :: Testing :: Acceptance
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Requires-Dist: Appium-Python-Client>=3.1.0
-Requires-Dist: playwright>=1.41.0
+Requires-Dist: playwright>=1.48.0
 Requires-Dist: selenium>=4.12.0
 Requires-Dist: numpy>=2.0.1; python_version >= "3.11"
 Requires-Dist: numpy<2.0.0,>=1.24.2; python_version >= "3.8" and python_version <= "3.10"
@@ -85,7 +85,6 @@ process, giving you the flexibility and power to automate complex testing scenar
 ## Installation and usage
 For information on installation and usage, please refer to our **[ReadTheDocs documentation](https://mops.readthedocs.io)**. Check it out for more details.
 
-
 ## Contributing
 
 Mops is an open-source project, and we welcome contributions from the community. If you'd like to contribute, please open an pull request from your fork

{mops-3.0.0 → mops-3.2.0}/README.md

@@ -50,7 +50,6 @@ process, giving you the flexibility and power to automate complex testing scenar
 ## Installation and usage
 For information on installation and usage, please refer to our **[ReadTheDocs documentation](https://mops.readthedocs.io)**. Check it out for more details.
 
-
 ## Contributing
 
 Mops is an open-source project, and we welcome contributions from the community. If you'd like to contribute, please open an pull request from your fork

{mops-3.0.0 → mops-3.2.0}/mops/__init__.py

@@ -1,2 +1,2 @@
-__version__ = '3.0.0'
+__version__ = '3.2.0'
 __project_name__ = 'mops'

{mops-3.0.0 → mops-3.2.0}/mops/abstraction/driver_wrapper_abc.py

@@ -6,7 +6,7 @@ from typing import List, Union, Any, Tuple, TYPE_CHECKING
 
 from playwright.sync_api import Page as PlaywrightPage
 
-from mops.mixins.objects.cut_box import CutBox
+from mops.mixins.objects.box import Box
 from selenium.webdriver.common.alert import Alert
 from PIL import Image
 
@@ -95,14 +95,6 @@ class DriverWrapperABC(ABC):
         """
         raise NotImplementedError()
 
-    def get_inner_window_size(self) -> Size:
-        """
-        Retrieve the inner size of the driver window.
-
-        :return: :class:`Size` - An object representing the window's dimensions.
-        """
-        raise NotImplementedError()
-
     def wait(self, timeout: Union[int, float] = WAIT_UNIT) -> DriverWrapper:
         """
         Pauses the execution for a specified amount of time.
@@ -110,7 +102,7 @@ class DriverWrapperABC(ABC):
         :param timeout: The time to sleep in seconds (can be an integer or float).
         :type timeout: typing.Union[int, float]
 
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper.
         """
         raise NotImplementedError()
 
@@ -122,7 +114,7 @@ class DriverWrapperABC(ABC):
         :type url: str
         :param silent: If :obj:`True`, suppresses logging.
         :type silent: bool
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper.
         """
         raise NotImplementedError()
 
@@ -155,7 +147,7 @@ class DriverWrapperABC(ABC):
         """
         Reload the current page.
 
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper.
         """
         raise NotImplementedError()
 
@@ -163,7 +155,7 @@ class DriverWrapperABC(ABC):
         """
         Navigate forward in the browser.
 
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper.
         """
         raise NotImplementedError()
 
@@ -171,7 +163,7 @@ class DriverWrapperABC(ABC):
         """
         Navigate backward in the browser.
 
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper.
         """
         raise NotImplementedError()
 
@@ -183,7 +175,7 @@ class DriverWrapperABC(ABC):
 
         :param cookies: A list of dictionaries, each containing cookie data.
         :type cookies: typing.List[dict]
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper.
         """
         raise NotImplementedError()
 
@@ -191,20 +183,15 @@ class DriverWrapperABC(ABC):
         """
         Delete all cookies in the current session.
 
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper.
         """
         raise NotImplementedError()
 
     def delete_cookie(self, name: str) -> DriverWrapper:
         """
-        Appium/Selenium only: Delete a cookie by name.
-
-        Note: Playwright does not support deleting specific cookies:
-            https://github.com/microsoft/playwright/issues/10143
-
-            Todo: Fixed in playwright 1.43.0
+        Delete a cookie by name.
 
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper.
         """
         raise NotImplementedError()
 
@@ -219,19 +206,19 @@ class DriverWrapperABC(ABC):
 
     def switch_to_frame(self, frame: Element) -> DriverWrapper:
         """
-        Appium/Selenium only: Switch to a specified frame.
+        Switch to a specified frame.
 
         :param frame: The frame element to switch to.
         :type frame: Element
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper.
         """
         raise NotImplementedError()
 
     def switch_to_default_content(self) -> DriverWrapper:
         """
-        Appium/Selenium only: Switch back to the default content from a frame.
+        Switch back to the default content from a frame.
 
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper.
         """
         raise NotImplementedError()
 
@@ -266,19 +253,38 @@ class DriverWrapperABC(ABC):
 
         :param timeout: The timeout duration to set, in seconds.
         :type timeout: int
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper.
+        """
+        raise NotImplementedError()
+
+    def set_window_size(self, size: Size) -> DriverWrapper:
+        """
+        Set the inner window size (viewport) of the current browser context.
+
+        :param size: The desired inner window size as a :class:`.Size` object.
+        :return: The current instance of :obj:`.DriverWrapper`.
+        """
+        raise NotImplementedError()
+
+    def get_inner_window_size(self) -> Size:
+        """
+        Retrieve the inner window size (viewport) of the current browser context.
+
+        :return: The size of the inner window as a :class:`.Size` object.
         """
         raise NotImplementedError()
 
-    def set_window_size(self, width: int, height: int) -> DriverWrapper:
+    def get_window_size(self) -> Size:
         """
-        Set the width and height of the current window.
+        Retrieve the outer window size of the current browser context.
+
+        .. note::
+            Playwright behaves differently in headless mode, where the reported window
+             size may not reflect the actual dimensions.
+            In contrast, Appium does not support retrieving the window size in the
+             same way as traditional web browsers.
 
-        :param width: The width, in pixels, to set the window to.
-        :type width: int
-        :param height: The height, in pixels, to set the window to.
-        :type height: int
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper.
+        :return: The size of the outer window as a :class:`.Size` object.
         """
         raise NotImplementedError()
 
@@ -308,9 +314,9 @@ class DriverWrapperABC(ABC):
             name_suffix: str = '',
             threshold: Union[int, float] = None,
             delay: Union[int, float] = None,
-            remove: Union[Any, List[Any]] = None,
-            cut_box: CutBox = None,
-            hide: Union[Any, List[Any]] = None,
+            remove: Union[Element, List[Element]] = None,
+            cut_box: Box = None,
+            hide: Union[Element, List[Element]] = None,
     ) -> None:
         """
         Asserts that the given screenshot matches the currently taken screenshot.
@@ -333,9 +339,9 @@ class DriverWrapperABC(ABC):
         :param remove: :class:`Element` to remove from the screenshot.
           Can be a single element or a list of elements.
         :type remove: typing.Optional[Element or typing.List[Element]]
-        :param cut_box: A `CutBox` specifying a region to cut from the screenshot.
+        :param cut_box: A :class:`.Box` specifying a region to cut from the screenshot.
             If :obj:`None`, no region is cut.
-        :type cut_box: typing.Optional[CutBox]
+        :type cut_box: typing.Optional[Box]
         :param hide: :class:`Element` to hide in the screenshot.
           Can be a single element or a list of elements.
         :type hide: typing.Optional[Element or typing.List[Element]]
@@ -350,9 +356,9 @@ class DriverWrapperABC(ABC):
             name_suffix: str = '',
             threshold: Union[int, float] = None,
             delay: Union[int, float] = None,
-            remove: Union[Any, List[Any]] = None,
-            cut_box: CutBox = None,
-            hide: Union[Any, List[Any]] = None,
+            remove: Union[Element, List[Element]] = None,
+            cut_box: Box = None,
+            hide: Union[Element, List[Element]] = None,
     ) -> Tuple[bool, str]:
         """
         Compares the currently taken screenshot to the expected screenshot and returns a result.
@@ -374,9 +380,9 @@ class DriverWrapperABC(ABC):
         :type delay: typing.Optional[int or float]
         :param remove: :class:`Element` to remove from the screenshot.
         :type remove: typing.Optional[Element or typing.List[Element]]
-        :param cut_box: A `CutBox` specifying a region to cut from the screenshot.
+        :param cut_box: A :class:`.Box` specifying a region to cut from the screenshot.
             If :obj:`None`, no region is cut.
-        :type cut_box: typing.Optional[CutBox]
+        :type cut_box: typing.Optional[Box]
         :param hide: :class:`Element` to hide in the screenshot.
           Can be a single element or a list of elements.
         :return: :class:`typing.Tuple` (:class:`bool`, :class:`str`) - result state and result message
@@ -417,7 +423,7 @@ class DriverWrapperABC(ABC):
         """
         Selenium/Playwright only: Create a new tab and switch to it.
 
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper, now switched to the new tab.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper, now switched to the new tab.
         """
         raise NotImplementedError()
 
@@ -425,7 +431,7 @@ class DriverWrapperABC(ABC):
         """
         Selenium/Playwright only: Switch back to the original tab.
 
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper, now switched to the original tab.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper, now switched to the original tab.
         """
         raise NotImplementedError()
 
@@ -435,7 +441,7 @@ class DriverWrapperABC(ABC):
 
         :param tab: The index of the tab to switch to, starting from 1. Default is the latest tab.
         :type tab: int
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper, now switched to the specified tab.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper, now switched to the specified tab.
         """
         raise NotImplementedError()
 
@@ -443,7 +449,7 @@ class DriverWrapperABC(ABC):
         """
         Selenium/Playwright only: Close all tabs except the original.
 
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper,
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper,
           with all tabs except the original closed.
         """
         raise NotImplementedError()
@@ -458,7 +464,7 @@ class DriverWrapperABC(ABC):
         :type y: int
         :param silent: If :obj:`True`, suppresses the log message. Default is :obj:`False`.
         :type silent: bool
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper.
         """
         raise NotImplementedError()
 
@@ -516,7 +522,7 @@ class DriverWrapperABC(ABC):
         """
         Appium only: Switch to the native app context.
 
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper, now in the native app context.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper, now in the native app context.
         """
         raise NotImplementedError()
 
@@ -524,7 +530,7 @@ class DriverWrapperABC(ABC):
         """
         Appium only: Switch to the web app context.
 
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper, now in the web app context.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper, now in the web app context.
         """
         raise NotImplementedError()
 
@@ -575,7 +581,7 @@ class DriverWrapperABC(ABC):
         Appium only: Hide the keyboard on a real device.
 
         :param kwargs: Additional arguments passed to the `Keyboard.hide_keyboard` method.
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper.
         """
         raise NotImplementedError()
 
@@ -611,7 +617,7 @@ class DriverWrapperABC(ABC):
         """
         Appium/Selenium only: Wait for an alert, switch to it, and click accept.
 
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper.
         """
         raise NotImplementedError()
 
@@ -619,7 +625,7 @@ class DriverWrapperABC(ABC):
         """
         Appium/Selenium only: Wait for an alert, switch to it, and click dismiss.
 
-        :return: :obj:`DriverWrapper` - The current instance of the driver wrapper.
+        :return: :obj:`.DriverWrapper` - The current instance of the driver wrapper.
         """
         raise NotImplementedError()
 

{mops-3.0.0 → mops-3.2.0}/mops/abstraction/element_abc.py

@@ -5,7 +5,8 @@ from typing import Union, Any, List, Tuple, Optional, TYPE_CHECKING
 
 from PIL.Image import Image
 from appium.webdriver.extensions.location import Location
-from mops.mixins.objects.cut_box import CutBox
+
+from mops.mixins.objects.box import Box
 from mops.mixins.objects.scrolls import ScrollTo, ScrollTypes
 from selenium.webdriver.remote.webelement import WebElement as SeleniumWebElement
 from appium.webdriver.webelement import WebElement as AppiumWebElement
@@ -17,16 +18,16 @@ from mops.mixins.objects.size import Size
 from mops.utils.internal_utils import WAIT_EL, QUARTER_WAIT_EL
 
 if TYPE_CHECKING:
+    from mops.mixins.objects.locator import Locator
     from mops.base.element import Element
 
 
 class ElementABC(MixinABC, ABC):
 
-    locator: str = None
-    locator_type: str = None
-    name: str = None
-    parent: Optional[Element] = None
-    wait: bool = None
+    locator: Union[Locator, str]
+    name: str = ''
+    parent: Union[Any, bool, None] = None
+    wait: Optional[bool] = None
 
     @property
     def element(self) -> Union[SeleniumWebElement, AppiumWebElement, PlayWebElement]:
@@ -51,7 +52,7 @@ class ElementABC(MixinABC, ABC):
         raise NotImplementedError()
 
     @property
-    def all_elements(self) -> Union[list, List[Element]]:
+    def all_elements(self) -> Union[List[Element], List[Any]]:
         """
         Returns a list of all matching elements.
 
@@ -142,10 +143,19 @@ class ElementABC(MixinABC, ABC):
         """
         raise NotImplementedError()
 
-    def wait_visibility(self, *, timeout: int = WAIT_EL, silent: bool = False) -> Element:
+    def wait_visibility(
+            self,
+            *,
+            timeout: int = WAIT_EL,
+            silent: bool = False,
+            continuous: Union[bool, int, float] = False,
+    ) -> Element:
         """
         Waits until the element becomes visible.
-        **Note:** The method requires the use of named arguments.
+         **Note:** The method requires the use of named arguments.
+
+        A continuous visibility verification may be applied for given
+        or default amount of time after the first condition is met.
 
         **Selenium:**
 
@@ -162,14 +172,26 @@ class ElementABC(MixinABC, ABC):
         :type timeout: int
         :param silent: If :obj:`True`, suppresses logging.
         :type silent: bool
+        :param continuous: If :obj:`True`, a continuous visibility verification applied for another 2.5 seconds.
+          An :obj:`int` or :obj:`float` modifies the continuous wait timeout.
+        :type continuous: typing.Union[int, float, bool]
         :return: :class:`Element`
         """
         raise NotImplementedError()
 
-    def wait_hidden(self, *, timeout: int = WAIT_EL, silent: bool = False) -> Element:
+    def wait_hidden(
+            self,
+            *,
+            timeout: int = WAIT_EL,
+            silent: bool = False,
+            continuous: Union[bool, int, float] = False,
+    ) -> Element:
         """
         Waits until the element becomes hidden.
-        **Note:** The method requires the use of named arguments.
+         **Note:** The method requires the use of named arguments.
+
+        A continuous invisibility verification may be applied for given
+        or default amount of time after the first condition is met.
 
         **Selenium:**
 
@@ -186,6 +208,9 @@ class ElementABC(MixinABC, ABC):
         :type timeout: int
         :param silent: If :obj:`True`, suppresses logging.
         :type silent: bool
+        :param continuous: If :obj:`True`, a continuous invisibility verification applied for another 2.5 seconds.
+          An :obj:`int` or :obj:`float` modifies the continuous wait timeout.
+        :type continuous: typing.Union[int, float, bool]
         :return: :class:`Element`
         """
         raise NotImplementedError()
@@ -193,7 +218,7 @@ class ElementABC(MixinABC, ABC):
     def wait_availability(self, *, timeout: int = WAIT_EL, silent: bool = False) -> Element:
         """
         Waits until the element becomes available in DOM tree. \n
-        **Note:** The method requires the use of named arguments.
+         **Note:** The method requires the use of named arguments.
 
         **Selenium:**
 
@@ -374,7 +399,7 @@ class ElementABC(MixinABC, ABC):
         """
         Get the size of the current element, including width and height.
 
-        :return: :class:`Size` - An object representing the element's dimensions.
+        :return: :class:`.Size` - An object representing the element's dimensions.
         """
         raise NotImplementedError()
 
@@ -383,7 +408,7 @@ class ElementABC(MixinABC, ABC):
         """
         Get the location of the current element, including the x and y coordinates.
 
-        :return: :class:`Location` - An object representing the element's position.
+        :return: :class:`.Location` - An object representing the element's position.
         """
         raise NotImplementedError()
 
@@ -529,7 +554,7 @@ class ElementABC(MixinABC, ABC):
         :param expected_text: The text to wait for. :obj:`None` - any text; :class:`str` - expected text.
         :type expected_text: typing.Optional[str]
         :param timeout: The maximum time to wait for the condition (in seconds). Default: :obj:`WAIT_EL`.
-        :type timeout: int or float
+        :type timeout: typing.Union[int, float]
         :param silent: If :obj:`True`, suppresses logging.
         :type silent: bool
         :return: :class:`Element`
@@ -562,7 +587,7 @@ class ElementABC(MixinABC, ABC):
         :param expected_value: The value to waiting for. :obj:`None` - any value; :class:`str` - expected value.
         :type expected_value: typing.Optional[str]
         :param timeout: The maximum time to wait for the condition (in seconds). Default: :obj:`WAIT_EL`.
-        :type timeout: int or float
+        :type timeout: typing.Union[int, float]
         :param silent: If :obj:`True`, suppresses logging.
         :type silent: bool
         :return: :class:`Element`
@@ -573,12 +598,15 @@ class ElementABC(MixinABC, ABC):
             self,
             *,
             timeout: Union[int, float] = QUARTER_WAIT_EL,
-            silent: bool = False
+            silent: bool = False,
+            continuous: Union[bool, int, float] = False,
     ) -> Element:
         """
         Wait for the element to become visible, without raising an error if it does not.
+         **Note:** The method requires the use of named arguments.
 
-        **Note:** The method requires the use of named arguments.
+        A continuous visibility verification may be applied for given
+        or default amount of time after the first condition is met.
 
         **Selenium & Playwright:**
 
@@ -592,9 +620,12 @@ class ElementABC(MixinABC, ABC):
           with each iteration during the waiting process.
 
         :param timeout: The maximum time to wait for the condition (in seconds). Default: :obj:`QUARTER_WAIT_EL`.
-        :type timeout: int or float
+        :type timeout: typing.Union[int, float]
         :param silent: If :obj:`True`, suppresses logging.
         :type silent: bool
+        :param continuous: If :obj:`True`, a continuous visibility verification applied for another 2.5 seconds.
+          An :obj:`int` or :obj:`float` modifies the continuous wait timeout.
+        :type continuous: typing.Union[int, float, bool]
         :return: :class:`Element`
         """
         raise NotImplementedError()
@@ -603,12 +634,15 @@ class ElementABC(MixinABC, ABC):
             self,
             *,
             timeout: Union[int, float] = QUARTER_WAIT_EL,
-            silent: bool = False
+            silent: bool = False,
+            continuous: Union[bool, int, float] = False,
     ) -> Element:
         """
         Wait for the element to become hidden, without raising an error if it does not.
+         **Note:** The method requires the use of named arguments.
 
-        **Note:** The method requires the use of named arguments.
+        A continuous invisibility verification may be applied for given
+        or default amount of time after the first condition is met.
 
         **Selenium & Playwright:**
 
@@ -622,9 +656,12 @@ class ElementABC(MixinABC, ABC):
           with each iteration during the waiting process.
 
         :param timeout: The maximum time to wait for the condition (in seconds). Default: :obj:`QUARTER_WAIT_EL`.
-        :type timeout: int or float
+        :type timeout: typing.Union[int, float]
         :param silent: If :obj:`True`, suppresses logging.
         :type silent: bool
+        :param continuous: If :obj:`True`, a continuous invisibility verification applied for another 2.5 seconds.
+          An :obj:`int` or :obj:`float` modifies the continuous wait timeout.
+        :type continuous: typing.Union[int, float, bool]
         :return: :class:`Element`
         """
         raise NotImplementedError()
@@ -647,7 +684,7 @@ class ElementABC(MixinABC, ABC):
           with each iteration during the waiting process.
 
         :param timeout: The maximum time to wait for the condition (in seconds). Default: :obj:`WAIT_EL`.
-        :type timeout: int or float
+        :type timeout: typing.Union[int, float]
         :param silent: If :obj:`True`, suppresses logging.
         :type silent: bool
         :return: :class:`Element`
@@ -687,7 +724,7 @@ class ElementABC(MixinABC, ABC):
             silent: bool = False
     ) -> Element:
         """
-        Wait until element size will be equal to given :class:`Size` object
+        Wait until element size will be equal to given :class:`.Size` object
 
         **Note:** The method requires the use of named arguments except ``expected_size``.
 
@@ -703,9 +740,9 @@ class ElementABC(MixinABC, ABC):
           with each iteration during the waiting process.
 
         :param expected_size: expected element size
-        :type expected_size: :class:`Size`
+        :type expected_size: :class:`.Size`
         :param timeout: The maximum time to wait for the condition (in seconds). Default: :obj:`WAIT_EL`.
-        :type timeout: int or float
+        :type timeout: typing.Union[int, float]
         :param silent: If :obj:`True`, suppresses logging.
         :type silent: bool
         :return: :class:`Element`
@@ -748,12 +785,12 @@ class ElementABC(MixinABC, ABC):
         """
         Scrolls the element into view using a JavaScript script.
 
-        :param block: The scrolling block alignment. One of the :class:`ScrollTo` options.
+        :param block: The scrolling block alignment. One of the :class:`.ScrollTo` options.
         :type block: ScrollTo
-        :param behavior: The scrolling behavior. One of the :class:`ScrollTypes` options.
+        :param behavior: The scrolling behavior. One of the :class:`.ScrollTypes` options.
         :type behavior: ScrollTypes
         :param sleep: Delay in seconds after scrolling. Can be an integer or a float.
-        :type sleep: int or float
+        :type sleep: typing.Union[int, float]
         :param silent: If :obj:`True`, suppresses logging.
         :type silent: bool
         :return: :class:`Element`
@@ -770,7 +807,7 @@ class ElementABC(MixinABC, ABC):
             scroll: bool = False,
             remove: Union[Element, List[Element]] = None,
             fill_background: Union[str, bool] = False,
-            cut_box: CutBox = None,
+            cut_box: Box = None,
             hide: Union[Element, List[Element]] = None,
     ) -> None:
         """
@@ -787,10 +824,10 @@ class ElementABC(MixinABC, ABC):
         :type name_suffix: str
         :param threshold: The acceptable threshold for comparing screenshots.
           If :obj:`None` - takes default threshold or calculate its automatically based on screenshot size.
-        :type threshold: typing.Optional[int or float]
+        :type threshold: typing.Optional[int, float]
         :param delay: The delay in seconds before taking the screenshot.
           If :obj:`None` - takes default delay.
-        :type delay: typing.Optional[int or float]
+        :type delay: typing.Optional[int, float]
         :param scroll: Whether to scroll to the element before taking the screenshot.
         :type scroll: bool
         :param remove: :class:`Element` to remove from the screenshot.
@@ -799,9 +836,9 @@ class ElementABC(MixinABC, ABC):
         :param fill_background: The color to fill the background.
           If :obj:`True`, uses a default color (black). If a :class:`str`, uses the specified color.
         :type fill_background: typing.Optional[str or bool]
-        :param cut_box: A `CutBox` specifying a region to cut from the screenshot.
+        :param cut_box: A :class:`.Box` specifying a region to cut from the screenshot.
             If :obj:`None`, no region is cut.
-        :type cut_box: typing.Optional[CutBox]
+        :type cut_box: typing.Optional[Box]
         :param hide: :class:`Element` to hide in the screenshot.
           Can be a single element or a list of elements.
         :type hide: typing.Optional[Element or typing.List[Element]]
@@ -819,7 +856,7 @@ class ElementABC(MixinABC, ABC):
             scroll: bool = False,
             remove: Union[Element, List[Element]] = None,
             fill_background: Union[str, bool] = False,
-            cut_box: CutBox = None,
+            cut_box: Box = None,
             hide: Union[Element, List[Element]] = None,
     ) -> Tuple[bool, str]:
         """
@@ -836,10 +873,10 @@ class ElementABC(MixinABC, ABC):
         :type name_suffix: str
         :param threshold: The acceptable threshold for comparing screenshots.
           If :obj:`None` - takes default threshold or calculate its automatically based on screenshot size.
-        :type threshold: typing.Optional[int or float]
+        :type threshold: typing.Optional[int, float]
         :param delay: The delay in seconds before taking the screenshot.
           If :obj:`None` - takes default delay.
-        :type delay: typing.Optional[int or float]
+        :type delay: typing.Optional[int, float]
         :param scroll: Whether to scroll to the element before taking the screenshot.
         :type scroll: bool
         :param remove: :class:`Element` to remove from the screenshot.
@@ -847,9 +884,9 @@ class ElementABC(MixinABC, ABC):
         :param fill_background: The color to fill the background.
           If :obj:`True`, uses a default color (black). If a :class:`str`, uses the specified color.
         :type fill_background: typing.Optional[str or bool]
-        :param cut_box: A `CutBox` specifying a region to cut from the screenshot.
+        :param cut_box: A :class:`.Box` specifying a region to cut from the screenshot.
             If :obj:`None`, no region is cut.
-        :type cut_box: typing.Optional[CutBox]
+        :type cut_box: typing.Optional[Box]
         :param hide: :class:`Element` to hide in the screenshot.
           Can be a single element or a list of elements.
         :return: :class:`typing.Tuple` (:class:`bool`, :class:`str`) - result state and result message

{mops-3.0.0 → mops-3.2.0}/mops/abstraction/mixin_abc.py

@@ -28,7 +28,7 @@ class MixinABC(ABC):
         """
         Retrieves the driver wrapper instance.
 
-        :return: The current :class:`DriverWrapper` instance that assigned for this object.
+        :return: The current :obj:`.DriverWrapper` instance that assigned for this object.
         :rtype: DriverWrapper
         """
         raise NotImplementedError()