Merge pull request #283 from seleniumbase/small-updates

Clone an existing method with an additional name

Author: mdmintz

README.md

@@ -181,19 +181,19 @@ from seleniumbase import BaseCase
 class MyTestClass(BaseCase):
 
     def test_basic(self):
-        self.open('https://xkcd.com/353/')
+        self.open("https://xkcd.com/353/")
         self.assert_element('img[alt="Python"]')
         self.click('a[rel="license"]')
-        self.assert_text('free to copy', 'div center')
+        self.assert_text("free to copy", "div center")
         self.open("https://xkcd.com/1481/")
         title = self.get_attribute("#comic img", "title")
         self.assert_true("86,400 seconds per day" in title)
-        self.click('link=Blag')
-        self.assert_text('The blag of the webcomic', 'h2')
-        self.update_text('input#s', 'Robots!\n')
-        self.assert_text('Hooray robots!', '#content')
-        self.open('https://xkcd.com/1319/')
-        self.assert_text('Automation', 'div#ctitle')
+        self.click("link=Blag")
+        self.assert_text("The blag of the webcomic", "h2")
+        self.update_text("input#s", "Robots!\n")
+        self.assert_text("Hooray robots!", "#content")
+        self.open("https://xkcd.com/1319/")
+        self.assert_exact_text("Automation", "#ctitle")
 ```
 (<i>By default, [CSS Selectors](https://www.w3schools.com/cssref/css_selectors.asp) are used for finding page elements.</i>)
 

help_docs/method_summary.md

@@ -256,6 +256,9 @@ self.find_element(selector, by=By.CSS_SELECTOR, timeout=settings.LARGE_TIMEOUT)
 self.assert_element(
     selector, by=By.CSS_SELECTOR, timeout=settings.SMALL_TIMEOUT)
 
+self.assert_element_visible(
+    selector, by=By.CSS_SELECTOR, timeout=settings.SMALL_TIMEOUT)
+
 ########
 
 self.wait_for_text_visible(text, selector="html", by=By.CSS_SELECTOR,

seleniumbase/fixtures/base_case.py

@@ -2051,6 +2051,15 @@ def assert_element(self, selector, by=By.CSS_SELECTOR,
             self.__highlight_with_assert_success(messenger_post, selector, by)
         return True
 
+    def assert_element_visible(self, selector, by=By.CSS_SELECTOR,
+                               timeout=settings.SMALL_TIMEOUT):
+        """ Same as self.assert_element()
+            As above, will raise an exception if nothing can be found. """
+        if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
+            timeout = self.__get_new_timeout(timeout)
+        self.assert_element(selector, by=by, timeout=timeout)
+        return True
+
     # For backwards compatibility, earlier method names of the next
     # four methods have remained even though they do the same thing,
     # with the exception of assert_*, which won't return the element,

setup.py

@@ -17,7 +17,7 @@
 
 setup(
     name='seleniumbase',
-    version='1.19.6',
+    version='1.19.7',
     description='Reliable Browser Automation & Testing Framework',
     long_description=long_description,
     long_description_content_type='text/markdown',