pomcorn 0.8.7__tar.gz → 0.9.0__tar.gz

{pomcorn-0.8.7 → pomcorn-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pomcorn
-Version: 0.8.7
+Version: 0.9.0
 Summary: Base implementation of Page Object Model
 Home-page: https://pypi.org/project/pomcorn/
 License: MIT

{pomcorn-0.8.7 → pomcorn-0.9.0}/pomcorn/locators/base_locators.py

@@ -157,25 +157,41 @@ class XPathLocator(Locator):
         """
         return XPathLocator(query=f"({self.query} | {other.query})")
 
-    def __getitem__(self, index: int) -> XPathLocator:
-        """Allow get related xpath locator by index.
+    def __getitem__(self, value: int | str | XPathLocator) -> XPathLocator:
+        """Allow to set xpath expressions or index into the locator query.
 
-        Example:
+        Examples:
             div_locator = XPathLocator("//div") --> `//div`
+
+            # Indexation
             div_locator[0]  --> `(//div)[1]`   # xpath numeration starts with 1
             div_locator[-1] --> `(//div)[last()]`
 
+            # Attribute condition
+            div_locator["@type='black'"] --> `//div[@type='black']
+
+            # Checking if there are children
+            child_locator = XPathLocator("//label").contains("Schedule")
+                --> `//label[contains(., 'Star']`
+            div_locator[child_locator] --> `//div[//label[contains(., 'Star']]`
+
         """
         query = f"({self.query})"
 
-        if index >= 0:
+        if isinstance(value, XPathLocator):
+            value = value.query
+
+        if isinstance(value, str):
+            return XPathLocator(f"{query}[{value}]")
+
+        if value >= 0:
             # `+1` is used here because numeration in xpath starts with 1
-            query += f"[{index + 1}]"
-        elif index == -1:
+            query += f"[{value + 1}]"
+        elif value == -1:
             # To avoid ugly locators with `...)[last() - 0]`
             query += "[last()]"
         else:
-            query += f"[last() - {abs(index + 1)}]"
+            query += f"[last() - {abs(value + 1)}]"
 
         return XPathLocator(query)
 

{pomcorn-0.8.7 → pomcorn-0.9.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pomcorn"
-version = "0.8.7"
+version = "0.9.0"
 description = "Base implementation of Page Object Model"
 authors = [
   "Saritasa <pypi@saritasa.com>",