Merge pull request #430 from seleniumbase/add-click-nth-visible-element

Add click_nth_visible_element(selector, number, by=By.CSS_SELECTOR)

Author: mdmintz

help_docs/method_summary.md

@@ -100,6 +100,8 @@ self.find_visible_elements(selector, by=By.CSS_SELECTOR, limit=0)
 
 self.click_visible_elements(selector, by=By.CSS_SELECTOR, limit=0)
 
+self.click_nth_visible_element(selector, number, by=By.CSS_SELECTOR)
+
 self.click_if_visible(selector, by=By.CSS_SELECTOR)
 
 self.is_element_in_an_iframe(selector, by=By.CSS_SELECTOR)

requirements.txt

@@ -1,5 +1,5 @@
 pip>=19.3.1
-setuptools>=42.0.0
+setuptools>=42.0.1
 setuptools-scm>=3.3.3
 wheel>=0.33.6
 six>=1.13.0

seleniumbase/console_scripts/run.py

@@ -42,6 +42,7 @@ def show_usage():
 def show_basic_usage():
     seleniumbase_logo = logo_helper.get_seleniumbase_logo()
     print(seleniumbase_logo)
+    print("%s" % get_version()[0:1])
     print("")
     print('Usage: "seleniumbase [COMMAND] [PARAMETERS]"')
     print("Commands:")
@@ -256,6 +257,16 @@ def show_grid_node_usage():
     print("")
 
 
+def get_version():
+    import pkg_resources
+    return pkg_resources.require("seleniumbase")[0:1]
+
+
+def show_version_info():
+    version = get_version()
+    print('\n%s\n' % version)
+
+
 def show_detailed_help():
     show_basic_usage()
     print("More Info:")
@@ -359,6 +370,11 @@ def main():
         else:
             show_basic_usage()
             show_grid_node_usage()
+    elif command == "version" or command == "--version":
+        if len(command_args) == 0:
+            show_version_info()
+        else:
+            show_basic_usage()
     elif command == "help" or command == "--help":
         if len(command_args) >= 1:
             if command_args[0] == "install":

seleniumbase/fixtures/base_case.py

@@ -947,6 +947,7 @@ def find_elements(self, selector, by=By.CSS_SELECTOR, limit=0):
         """ Returns a list of matching WebElements.
             If "limit" is set and > 0, will only return that many elements. """
         self.wait_for_ready_state_complete()
+        time.sleep(0.05)
         selector, by = self.__recalculate_selector(selector, by)
         elements = self.driver.find_elements(by=by, value=selector)
         if limit and limit > 0 and len(elements) > limit:
@@ -957,6 +958,7 @@ def find_visible_elements(self, selector, by=By.CSS_SELECTOR, limit=0):
         """ Returns a list of matching WebElements that are visible.
             If "limit" is set and > 0, will only return that many elements. """
         self.wait_for_ready_state_complete()
+        time.sleep(0.05)
         selector, by = self.__recalculate_selector(selector, by)
         v_elems = page_actions.find_visible_elements(self.driver, selector, by)
         if limit and limit > 0 and len(v_elems) > limit:
@@ -999,6 +1001,28 @@ def click_visible_elements(self, selector, by=By.CSS_SELECTOR, limit=0):
                     except (StaleElementReferenceException, ENI_Exception):
                         return  # Probably on new page / Elements are all stale
 
+    def click_nth_visible_element(self, selector, number, by=By.CSS_SELECTOR):
+        """ Finds all matching page elements and clicks the nth visible one.
+            Example:  self.click_nth_visible_element('[type="checkbox"]', 5)
+                        (Clicks the 5th visible checkbox on the page.) """
+        elements = self.find_visible_elements(selector, by=by)
+        if len(elements) < number:
+            raise Exception("Not enough matching {%s} elements of type {%s} to"
+                            " click number %s!" % (selector, by, number))
+        number = number - 1
+        if number < 0:
+            number = 0
+        element = elements[number]
+        self.wait_for_ready_state_complete()
+        try:
+            self.__scroll_to_element(element)
+            element.click()
+        except (StaleElementReferenceException, ENI_Exception):
+            self.wait_for_ready_state_complete()
+            time.sleep(0.05)
+            self.__scroll_to_element(element)
+            element.click()
+
     def click_if_visible(self, selector, by=By.CSS_SELECTOR):
         """ If the page selector exists and is visible, clicks on the element.
             This method only clicks on the first matching element found.

setup.py

@@ -45,7 +45,7 @@
 
 setup(
     name='seleniumbase',
-    version='1.33.5',
+    version='1.33.6',
     description='Fast, Easy, and Reliable Browser Automation & Testing.',
     long_description=long_description,
     long_description_content_type='text/markdown',