Merge pull request #1193 from seleniumbase/grid-capabilities-and-more

Improvements to Grid capabilities, Safari automation, Shadow-DOM support, and more

Author: mdmintz

README.md

@@ -149,7 +149,36 @@ pytest my_first_test.py --demo
 
 > (Chrome is the default browser if not specified with ``--browser``. On Linux, ``--headless`` is the default behavior.)
 
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py"><img src="https://seleniumbase.io/cdn/gif/my_first_test_2.gif" alt="SeleniumBase Test" title="SeleniumBase Demo Mode" width="400" /></a>
+<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py"><img src="https://seleniumbase.io/cdn/gif/swag_labs_4.gif" alt="SeleniumBase Test" title="SeleniumBase Test" width="400" /></a>
+
+<p align="left"><b>Here's the code for <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py">my_first_test.py</a>:</b></p>
+
+```python
+from seleniumbase import BaseCase
+
+class MyTestClass(BaseCase):
+    def test_swag_labs(self):
+        self.open("https://www.saucedemo.com")
+        self.type("#user-name", "standard_user")
+        self.type("#password", "secret_sauce\n")
+        self.assert_element("#inventory_container")
+        self.assert_text("PRODUCTS", "span.title")
+        self.click('button[name*="backpack"]')
+        self.click("#shopping_cart_container a")
+        self.assert_text("YOUR CART", "span.title")
+        self.assert_text("Backpack", "div.cart_item")
+        self.click("button#checkout")
+        self.type("#first-name", "SeleniumBase")
+        self.type("#last-name", "Automation")
+        self.type("#postal-code", "77123")
+        self.click("input#continue")
+        self.assert_text("CHECKOUT: OVERVIEW")
+        self.assert_text("Backpack", "div.cart_item")
+        self.click("button#finish")
+        self.assert_exact_text("THANK YOU FOR YOUR ORDER", "h2")
+        self.assert_element('img[alt="Pony Express"]')
+        self.js_click("a#logout_sidebar_link")
+```
 
 * By default, **[CSS Selectors](https://www.w3schools.com/cssref/css_selectors.asp)** are used for finding page elements.
 * If you're new to CSS Selectors, games like [CSS Diner](http://flukeout.github.io/) can help you learn.

examples/ReadMe.md

@@ -21,6 +21,8 @@ Run an example test in Chrome: (Default: ``--browser=chrome``)
 pytest my_first_test.py
 ```
 
+<img src="https://seleniumbase.io/cdn/gif/swag_labs_4.gif" /><br />
+
 Run an example test in Firefox:
 
 ```bash
@@ -29,14 +31,6 @@ pytest my_first_test.py --browser=firefox
 
 Run an example test in Demo Mode: (highlight assertions)
 
-```bash
-pytest my_first_test.py --demo
-```
-
-<img src="https://seleniumbase.io/cdn/gif/my_first_test_2.gif" title="SeleniumBase Demo Mode" /><br />
-
-Run a different example in Demo Mode:
-
 ```bash
 pytest test_swag_labs.py --demo
 ```

examples/basic_test.py

@@ -1,14 +1,18 @@
+"""
+Add an item to a shopping cart, and verify.
+"""
 from seleniumbase import BaseCase
 
 
 class MyTestClass(BaseCase):
     def test_basics(self):
-        self.open("https://store.xkcd.com/search")
-        self.type('input[name="q"]', "xkcd book\n")
-        self.assert_text("xkcd book", "div.results")
-        self.open("https://xkcd.com/353/")
-        self.click('a[rel="license"]')
-        self.go_back()
-        self.click_link("About")
-        self.click_link("comic #249")
-        self.assert_element('img[alt*="Chess"]')
+        self.open("https://www.saucedemo.com")
+        self.type("#user-name", "standard_user")
+        self.type("#password", "secret_sauce\n")
+        self.assert_element("#inventory_container")
+        self.assert_exact_text("PRODUCTS", "span.title")
+        self.click('button[name*="backpack"]')
+        self.click("#shopping_cart_container a")
+        self.assert_exact_text("YOUR CART", "span.title")
+        self.assert_text("Backpack", "div.cart_item")
+        self.js_click("a#logout_sidebar_link")

examples/list_assert_test.py

@@ -7,8 +7,8 @@
 
 class MyTestClass(BaseCase):
     def test_assert_list_of_elements(self):
-        self.open("https://store.xkcd.com/collections/posters")
+        self.open("https://seleniumbase.io/demo_page")
         self.assert_elements_present("head", "style", "script")
         self.assert_elements("h1", "h2", "h3")
-        my_list = ["#top-menu", "#col-main", "#col-widgets"]
+        my_list = ["#myDropdown", "#myButton", "#svgRect"]
         self.assert_elements(my_list)

examples/my_first_test.py

@@ -1,21 +1,31 @@
+"""
+A complete end-to-end test for an e-commerce website.
+"""
 from seleniumbase import BaseCase
 
 
 class MyTestClass(BaseCase):
-    def test_basics(self):
-        url = "https://store.xkcd.com/collections/posters"
-        self.open(url)
-        self.type('input[name="q"]', "xkcd book")
-        self.click('input[value="Search"]')
-        self.assert_text("xkcd: volume 0", "h3")
-        self.open("https://xkcd.com/353/")
-        self.assert_title("xkcd: Python")
-        self.assert_element('img[alt="Python"]')
-        self.click('a[rel="license"]')
-        self.assert_text("free to copy and reuse")
-        self.go_back()
-        self.click_link("About")
-        self.assert_exact_text("xkcd.com", "h2")
+    def test_swag_labs(self):
+        self.open("https://www.saucedemo.com")
+        self.type("#user-name", "standard_user")
+        self.type("#password", "secret_sauce\n")
+        self.assert_element("#inventory_container")
+        self.assert_text("PRODUCTS", "span.title")
+        self.click('button[name*="backpack"]')
+        self.click("#shopping_cart_container a")
+        self.assert_text("YOUR CART", "span.title")
+        self.assert_text("Backpack", "div.cart_item")
+        self.click("button#checkout")
+        self.type("#first-name", "SeleniumBase")
+        self.type("#last-name", "Automation")
+        self.type("#postal-code", "77123")
+        self.click("input#continue")
+        self.assert_text("CHECKOUT: OVERVIEW")
+        self.assert_text("Backpack", "div.cart_item")
+        self.click("button#finish")
+        self.assert_exact_text("THANK YOU FOR YOUR ORDER", "h2")
+        self.assert_element('img[alt="Pony Express"]')
+        self.js_click("a#logout_sidebar_link")
 
         ####
 
@@ -123,10 +133,12 @@ def test_basics(self):
         #    whitespace in the TEXT assertion.
         #    So, self.assert_exact_text("Some Text") will find [" Some Text "].
         #
-        # 7. If a URL starts with "://", then "https://" is automatically used.
+        # 7. self.js_click(SELECTOR) can be used to click on hidden elements.
+        #
+        # 8. If a URL starts with "://", then "https://" is automatically used.
         #    Example: [self.open("://URL")] becomes [self.open("https://URL")]
         #    This helps by reducing the line length by 5 characters.
         #
-        # 8. For the full method list, see one of the following:
+        # 9. For the full method list, see one of the following:
         #    * SeleniumBase/seleniumbase/fixtures/base_case.py
         #    * SeleniumBase/help_docs/method_summary.md

examples/swag_labs_suite.py

@@ -45,7 +45,7 @@ def test_swag_labs_basic_flow(self, username):
         self.assert_exact_text("1", "span.shopping_cart_badge")
 
         # Verify your cart
-        self.click("#shopping_cart_container")
+        self.click("#shopping_cart_container a")
         self.assert_element('span:contains("Your Cart")')
         self.assert_text(item_name, "div.inventory_item_name")
         self.assert_exact_text("1", "div.cart_quantity")

examples/test_download_files.py

@@ -60,12 +60,12 @@ def test_download_files(self):
 
         # Get file sizes in kB to compare actual values with displayed values
         whl_file_kb = whl_file_bytes / 1000.0
-        whl_line_fi = self.get_text('a[href$=".whl"]')
-        whl_line = self.get_text('tbody th:contains("%s")' % whl_line_fi)
+        whl_line_fi = self.get_text('a[href$=".whl"]').strip()
+        whl_line = self.get_text('div.file:contains("%s")' % whl_line_fi)
         whl_display_kb = float(whl_line.split("(")[1].split(" ")[0])
         tar_gz_file_kb = tar_gz_file_bytes / 1000.0
-        tar_gz_line_fi = self.get_text('a[href$=".tar.gz"]')
-        tar_gz_line = self.get_text('tbody th:contains("%s")' % tar_gz_line_fi)
+        tar_gz_line_fi = self.get_text('a[href$=".tar.gz"]').strip()
+        tar_gz_line = self.get_text('div.file:contains("%s")' % tar_gz_line_fi)
         tar_gz_display_kb = float(tar_gz_line.split("(")[1].split(" ")[0])
 
         # Verify downloaded files are the correct size (account for rounding)

examples/test_event_firing.py

@@ -31,6 +31,9 @@ def test_event_firing_webdriver(self):
         print("\n* EventFiringWebDriver example *")
         self.open("https://xkcd.com/1862/")
         self.click("link=About")
-        self.open("https://store.xkcd.com/search")
-        self.type('input[name="q"]', "xkcd book\n")
-        self.open("https://xkcd.com/1822/")
+        self.open("https://xkcd.com/1820/")
+        self.assert_text("Security Advice", "#ctitle")
+        self.click('a:contains("Next >")')
+        self.assert_text("Incinerator", "#ctitle")
+        self.click('a[rel="next"]')
+        self.assert_text("Existential Bug Reports", "#ctitle")

examples/test_swag_labs.py

@@ -34,7 +34,7 @@ def test_swag_labs_basic_flow(self):
         self.assert_exact_text("1", "span.shopping_cart_badge")
 
         # Verify your cart
-        self.click("#shopping_cart_container")
+        self.click("#shopping_cart_container a")
         self.assert_element('span:contains("Your Cart")')
         self.assert_text(item_name, "div.inventory_item_name")
         self.assert_exact_text("1", "div.cart_quantity")
@@ -60,7 +60,7 @@ def test_swag_labs_basic_flow(self):
         # Finish Checkout and verify that the cart is now empty
         self.click("button#finish")
         self.assert_exact_text("THANK YOU FOR YOUR ORDER", "h2")
-        self.click("#shopping_cart_container")
+        self.click("#shopping_cart_container a")
         self.assert_element_absent("div.inventory_item_name")
         self.click("button#continue-shopping")
         self.assert_element_absent("span.shopping_cart_badge")

examples/test_xkcd.py

@@ -0,0 +1,15 @@
+from seleniumbase import BaseCase
+
+
+class MyTestClass(BaseCase):
+    def test_xkcd(self):
+        self.open("https://xkcd.com/353/")
+        self.assert_title("xkcd: Python")
+        self.assert_element('img[alt="Python"]')
+        self.click('a[rel="license"]')
+        self.assert_text("free to copy and reuse")
+        self.go_back()
+        self.click_link("About")
+        self.assert_exact_text("xkcd.com", "h2")
+        self.click_link("comic #249")
+        self.assert_element('img[alt*="Chess"]')