Update the examples

Author: mdmintz

examples/chart_maker/ReadMe.md

@@ -10,14 +10,14 @@ SeleniumBase Chart Maker allows you to create HTML charts with Python. (HighChar
 
 ([Click to see a presentation with multiple charts](https://seleniumbase.io/other/chart_presentation.html))
 
-Here's how to run the example presentation with a pie chart from [github.com/seleniumbase/SeleniumBase/tree/master/examples/chart_maker](https://github.com/seleniumbase/SeleniumBase/tree/master/examples/chart_maker):
+Here's how to run the example presentation with a pie chart from [GitHub => seleniumbase/SeleniumBase/examples/chart_maker](https://github.com/seleniumbase/SeleniumBase/tree/master/examples/chart_maker):
 
 ```bash
 cd examples/chart_maker
 pytest my_chart.py
 ```
 
-Here's the code for that pie chart presentation ([github.com/seleniumbase/SeleniumBase/blob/master/examples/chart_maker/my_chart.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/chart_maker/my_chart.py)):
+Here's the code for that pie chart presentation ([GitHub => seleniumbase/SeleniumBase/examples/chart_maker/my_chart.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/chart_maker/my_chart.py)):
 
 ```python
 from seleniumbase import BaseCase

examples/chart_maker/chart_presentation.py

@@ -4,7 +4,7 @@
 class MyChartMakerClass(BaseCase):
 
     def test_chart_maker_presentation(self):
-        self.create_presentation(theme="sky")
+        self.create_presentation(theme="sky", transition="zoom")
 
         self.create_pie_chart(title="Automated Tests")
         self.add_data_point("Passed", 7, color="#95d96f")

examples/presenter/ReadMe.md

@@ -23,7 +23,7 @@ pytest my_presentation.py
 ### Creating a new presentation:
 
 ```python
-self.create_presentation(name=None, theme="serif")
+self.create_presentation(name=None, theme="serif", transition="default")
 """ Creates a Reveal-JS presentation that you can add slides to.
     @Params
     name - If creating multiple presentations at the same time,
@@ -32,6 +32,9 @@ self.create_presentation(name=None, theme="serif")
             Valid themes: "serif" (default), "sky", "white", "black",
                           "simple", "league", "moon", "night",
                           "beige", "blood", and "solarized".
+    transition - Set a transition between slides.
+                 Valid transitions: "none" (default), "slide", "fade",
+                                    "zoom", "convex", and "concave".
 """
 ```
 
@@ -44,7 +47,7 @@ Notes are disabled by default. You can enable notes by specifying:
 
 ```python
 self.add_slide(content=None, image=None, code=None, iframe=None,
-               content2=None, notes=None, name=None)
+               content2=None, notes=None, transition=None, name=None)
 """ Allows the user to add slides to a presentation.
     @Params
     content - The HTML content to display on the presentation slide.
@@ -55,6 +58,9 @@ self.add_slide(content=None, image=None, code=None, iframe=None,
     content2 - HTML content to display after adding an image or code.
     notes - Additional notes to include with the slide.
             ONLY SEEN if show_notes is set for the presentation.
+    transition - Set a transition between slides. (overrides previous)
+                 Valid transitions: "none" (default), "slide", "fade",
+                                    "zoom", "convex", and "concave".
     name - If creating multiple presentations at the same time,
            use this to select the presentation to add slides to.
 """

examples/presenter/my_presentation.py

@@ -4,7 +4,7 @@
 class MyPresenterClass(BaseCase):
 
     def test_presenter(self):
-        self.create_presentation(theme="serif")
+        self.create_presentation(theme="serif", transition="none")
         self.add_slide(
             '<h1>Welcome</h1><br />\n'
             '<h3>Press the <b>Right Arrow</b></h3>')

examples/test_deferred_asserts.py

@@ -13,6 +13,7 @@ class MyTestClass(BaseCase):
     def test_deferred_asserts(self):
         self.open('https://xkcd.com/993/')
         self.wait_for_element('#comic')
+        print("\n(This test fails on purpose)")
         self.deferred_assert_element('img[alt="Brand Identity"]')
         self.deferred_assert_element('img[alt="Rocket Ship"]')  # Will Fail
         self.deferred_assert_element('#comicmap')

examples/test_xfail.py

@@ -0,0 +1,16 @@
+""" Testing the @pytest.mark.xfail marker.
+    https://docs.pytest.org/en/latest/skipping.html
+    (The test is expected to fail, but don't fail the entire build for it.)
+"""
+
+import pytest
+from seleniumbase import BaseCase
+
+
+class MyTestClass(BaseCase):
+
+    @pytest.mark.xfail
+    def test_xfail(self):
+        self.open("https://xkcd.com/376/")
+        self.sleep(1)  # Time to read the comic
+        self.fail("There is a known bug here!")

examples/timeout_test.py

@@ -15,4 +15,5 @@ class MyTestClass(BaseCase):
     def test_time_limit_feature(self):
         self.set_time_limit(5)  # Fail test if time exceeds 5 seconds
         self.open("https://xkcd.com/1658/")
+        print("\n(This test fails on purpose)")
         self.sleep(7)

examples/tour_examples/ReadMe.md

@@ -7,11 +7,14 @@ SeleniumBase Tours utilize 5 JavaScript libraries for creating interactive walkt
 **Example tour:**
 
 <img src="https://cdn2.hubspot.net/hubfs/100006/google_tour_3.gif" title="SeleniumBase Tour of Google"><br>
-```
+
+```bash
 cd examples/tour_examples
 pytest google_tour.py
 ```
 
+(From [GitHub => SeleniumBase/examples/tour_examples](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/tour_examples))
+
 
 ### Creating a new tour:
 

examples/tour_examples/bootstrap_google_tour.py

@@ -29,9 +29,9 @@ def test_google_tour(self):
         self.play_tour(interval=5)  # Tour automatically continues after 5 sec
 
         self.open("https://www.google.com/maps/@42.3598616,-71.0912631,15z")
-        self.wait_for_element("#searchboxinput")
-        self.wait_for_element("#minimap")
-        self.wait_for_element("#zoom")
+        self.wait_for_element("#searchboxinput", timeout=20)
+        self.wait_for_element("#minimap", timeout=20)
+        self.wait_for_element("#zoom", timeout=20)
 
         self.create_bootstrap_tour()
         self.add_tour_step("Welcome to Google Maps!")

examples/tour_examples/driverjs_maps_tour.py

@@ -5,9 +5,9 @@ class MyTestClass(BaseCase):
 
     def test_create_tour(self):
         self.open("https://www.google.com/maps/@42.3598616,-71.0912631,15z")
-        self.wait_for_element("#searchboxinput")
-        self.wait_for_element("#minimap")
-        self.wait_for_element("#zoom")
+        self.wait_for_element("#searchboxinput", timeout=20)
+        self.wait_for_element("#minimap", timeout=20)
+        self.wait_for_element("#zoom", timeout=20)
 
         # Create a website tour using the DriverJS library
         # Same as:  self.create_driverjs_tour()