selenium-query 0.3.2__tar.gz → 0.3.3__tar.gz

{selenium_query-0.3.2 → selenium_query-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: selenium-query
-Version: 0.3.2
+Version: 0.3.3
 Summary: Python equivalent of jQuery, to write selenium tests.
 License: GPL-3.0-or-later
 Author: Frédéric Zinelli
@@ -113,6 +113,7 @@ A `Getter` represents the current collection of matching elements and provides a
     is_displayed()
     exists()                - extra
     count(n)                - extra
+    clear()                 - semi-extra (works only on inputs/textarea)
     ```
 
     Note: when used without "helpers" properties (see below), these behave like predicates. See implementation details.
@@ -142,10 +143,11 @@ A `Getter` represents the current collection of matching elements and provides a
     release
     pause
     scroll_to               - behaves differently from selenium
-    __getitem__             - extra (index or slice)
     ```
 
-* It also adds its own helpers, to change the behaviors of the main observers (see above):
+* It also adds its own accessors and helpers, to change the behaviors of the main observers (see above):
+
+    ___Accessors:___
 
     ```python
     items = MyPage.find(".item")
@@ -160,6 +162,31 @@ A `Getter` represents the current collection of matching elements and provides a
     items.not_      # revert the behavior (for check.not_, filter.not_, all.not_ or not_.all, ...)
     ```
 
+    ___Helpers:___
+
+    ```
+    find(css_selector, *, in_page=False, as_="")
+        -> Search for children (or in the page if in_page is True)
+
+    __iter__
+        -> send each element of the collection as an individual Getter.
+
+    __getitem__
+        -> index or slice. Returned as Getter.
+
+    run_js(code:str, *args, async_=False, with_promise=True)
+        -> Execute JS code in te browser.
+
+    wait_for_element(css_selector, as_="", *, timeout:float=None, error=False)
+        -> Wait for the given element to show up and returns it (as Getter).
+           If timeout is not None and waiting too long, TimeoutError() is returned instead, unless `error=True` (then it is raised).
+
+    wait_until(truthy_provider) -> None
+
+    wait_prompt_or_alert() -> Alert
+    ```
+
+
 For example (each method is a different way to use selenium query objects):
 
 ```python
@@ -976,8 +1003,7 @@ For a direct element wait, the page exposes:
 
 ```python
 @classmethod
-def wait_for_element(cls, css_selector):
-    return cls._getter.wait_for_element(css_selector)
+def wait_for_element(cls, css_selector, as_="", *, timeout=None, error=False)
 ```
 
 Example:

selenium_query-0.3.2/selenium_query/__init__.py → selenium_query-0.3.3/README.md

@@ -1,4 +1,3 @@
-"""
 # Selenium Query
 
 
@@ -96,6 +95,7 @@ A `Getter` represents the current collection of matching elements and provides a
     is_displayed()
     exists()                - extra
     count(n)                - extra
+    clear()                 - semi-extra (works only on inputs/textarea)
     ```
 
     Note: when used without "helpers" properties (see below), these behave like predicates. See implementation details.
@@ -125,10 +125,11 @@ A `Getter` represents the current collection of matching elements and provides a
     release
     pause
     scroll_to               - behaves differently from selenium
-    __getitem__             - extra (index or slice)
     ```
 
-* It also adds its own helpers, to change the behaviors of the main observers (see above):
+* It also adds its own accessors and helpers, to change the behaviors of the main observers (see above):
+
+    ___Accessors:___
 
     ```python
     items = MyPage.find(".item")
@@ -143,6 +144,31 @@ A `Getter` represents the current collection of matching elements and provides a
     items.not_      # revert the behavior (for check.not_, filter.not_, all.not_ or not_.all, ...)
     ```
 
+    ___Helpers:___
+
+    ```
+    find(css_selector, *, in_page=False, as_="")
+        -> Search for children (or in the page if in_page is True)
+
+    __iter__
+        -> send each element of the collection as an individual Getter.
+
+    __getitem__
+        -> index or slice. Returned as Getter.
+
+    run_js(code:str, *args, async_=False, with_promise=True)
+        -> Execute JS code in te browser.
+
+    wait_for_element(css_selector, as_="", *, timeout:float=None, error=False)
+        -> Wait for the given element to show up and returns it (as Getter).
+           If timeout is not None and waiting too long, TimeoutError() is returned instead, unless `error=True` (then it is raised).
+
+    wait_until(truthy_provider) -> None
+
+    wait_prompt_or_alert() -> Alert
+    ```
+
+
 For example (each method is a different way to use selenium query objects):
 
 ```python
@@ -959,8 +985,7 @@ For a direct element wait, the page exposes:
 
 ```python
 @classmethod
-def wait_for_element(cls, css_selector):
-    return cls._getter.wait_for_element(css_selector)
+def wait_for_element(cls, css_selector, as_="", *, timeout=None, error=False)
 ```
 
 Example:
@@ -1261,17 +1286,3 @@ page.find("css selector")
 ```
 
 `BaseSeleniumPage` is therefore not just a convenience wrapper around `WebDriver`: it is the page-level abstraction that owns the browser context, synchronization, page loading, caching and the root from which Selenium Query collections are created.
-
-"""
-
-from .colors import use_colors, color, Color
-from ._types_and_tools import center_of
-from .getter import Getter
-from ._any_all_getters import BoolAnyGetter, BoolAllGetter
-from ._values_getter import ValuesGetter
-from ._asserter_getter import AsserterGetter
-from ._filter_getter import FilterGetter
-from ._order_getter import OrderGetter
-from ._mapper_getter import MapperGetter
-from ._negation_transmitter import NotTransmitter
-from .base_selenium_page import BaseSeleniumPage, depends_on

{selenium_query-0.3.2 → selenium_query-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "selenium-query"
-version = "0.3.2"
+version = "0.3.3"
 description = "Python equivalent of jQuery, to write selenium tests."
 license = { text = "GPL-3.0-or-later" }
 authors = [

selenium_query-0.3.2/README.md → selenium_query-0.3.3/selenium_query/__init__.py

@@ -1,3 +1,4 @@
+"""
 # Selenium Query
 
 
@@ -95,6 +96,7 @@ A `Getter` represents the current collection of matching elements and provides a
     is_displayed()
     exists()                - extra
     count(n)                - extra
+    clear()                 - semi-extra (works only on inputs/textarea)
     ```
 
     Note: when used without "helpers" properties (see below), these behave like predicates. See implementation details.
@@ -124,10 +126,11 @@ A `Getter` represents the current collection of matching elements and provides a
     release
     pause
     scroll_to               - behaves differently from selenium
-    __getitem__             - extra (index or slice)
     ```
 
-* It also adds its own helpers, to change the behaviors of the main observers (see above):
+* It also adds its own accessors and helpers, to change the behaviors of the main observers (see above):
+
+    ___Accessors:___
 
     ```python
     items = MyPage.find(".item")
@@ -142,6 +145,31 @@ A `Getter` represents the current collection of matching elements and provides a
     items.not_      # revert the behavior (for check.not_, filter.not_, all.not_ or not_.all, ...)
     ```
 
+    ___Helpers:___
+
+    ```
+    find(css_selector, *, in_page=False, as_="")
+        -> Search for children (or in the page if in_page is True)
+
+    __iter__
+        -> send each element of the collection as an individual Getter.
+
+    __getitem__
+        -> index or slice. Returned as Getter.
+
+    run_js(code:str, *args, async_=False, with_promise=True)
+        -> Execute JS code in te browser.
+
+    wait_for_element(css_selector, as_="", *, timeout:float=None, error=False)
+        -> Wait for the given element to show up and returns it (as Getter).
+           If timeout is not None and waiting too long, TimeoutError() is returned instead, unless `error=True` (then it is raised).
+
+    wait_until(truthy_provider) -> None
+
+    wait_prompt_or_alert() -> Alert
+    ```
+
+
 For example (each method is a different way to use selenium query objects):
 
 ```python
@@ -958,8 +986,7 @@ For a direct element wait, the page exposes:
 
 ```python
 @classmethod
-def wait_for_element(cls, css_selector):
-    return cls._getter.wait_for_element(css_selector)
+def wait_for_element(cls, css_selector, as_="", *, timeout=None, error=False)
 ```
 
 Example:
@@ -1260,3 +1287,17 @@ page.find("css selector")
 ```
 
 `BaseSeleniumPage` is therefore not just a convenience wrapper around `WebDriver`: it is the page-level abstraction that owns the browser context, synchronization, page loading, caching and the root from which Selenium Query collections are created.
+
+"""
+
+from .colors import use_colors, color, Color
+from ._types_and_tools import center_of
+from .getter import Getter
+from ._any_all_getters import BoolAnyGetter, BoolAllGetter
+from ._values_getter import ValuesGetter
+from ._asserter_getter import AsserterGetter
+from ._filter_getter import FilterGetter
+from ._order_getter import OrderGetter
+from ._mapper_getter import MapperGetter
+from ._negation_transmitter import NotTransmitter
+from .base_selenium_page import BaseSeleniumPage, depends_on

selenium_query-0.3.3/selenium_query/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.3.3"

{selenium_query-0.3.2 → selenium_query-0.3.3}/selenium_query/_basics/base_getter.py

@@ -140,7 +140,7 @@ class BaseGetter:
         return getattr(self.driver, method)(code, *args)
 
 
-    def wait_for_element(self, css_selector, as_="", *, timeout=None, error=False):
+    def wait_for_element(self, css_selector, as_="", *, timeout:float=None, error=False):
         if self._actions:
             raise ValueError(f"Cannot use `wait_until(...)` on objects with defined ActionChains.")
 

{selenium_query-0.3.2 → selenium_query-0.3.3}/selenium_query/_filter_getter.py

@@ -26,8 +26,8 @@ from .getter import Getter
 class FilterGetter(Getter, accessor="filter"):
     """
     Accessible through `Getter.filter`.
-    Transform the css, data, props, ... methods into filters: each of them now returns a
-    new FilterGetter instance whose the elements are only containing those which match the
+    Transform the css, data, props, ... methods into filters: each of them now returns
+    a new Getter instance whose the elements are only containing those which match the
     desired values.
 
     Basic usage:

{selenium_query-0.3.2 → selenium_query-0.3.3}/selenium_query/base_selenium_page.py

@@ -188,7 +188,6 @@ class BaseSeleniumPage:
         url = cls.get_address_from_class_url(address)
 
         if url == cls._LAST_LOADED_PAGE:
-            print(cls.URL, 'cached...')
             return
 
         BaseSeleniumPage._LAST_LOADED_PAGE = url

selenium_query-0.3.2/selenium_query/__version__.py

@@ -1 +0,0 @@
-__version__ = "0.3.2"