Merge pull request #584 from seleniumbase/many-changes

New console scripts interface, translations, fixes, and more

Author: mdmintz

docs/prepare.py

@@ -100,7 +100,7 @@ def main(*args, **kwargs):
                 r'<a href="https://github.com/seleniumbase/SeleniumBase">'
                 r'<img src="https://img.shields.io/badge/'
                 r'✅%20💛%20View%20Code-on%20GitHub%20🌎%20🚀'
-                r'-02A79E.svg" alt="SeleniumBase.io Docs" />'
+                r'-02A79E.svg" alt="SeleniumBase on GitHub" />'
                 r'</a></div></p>')
         if "<!-- SeleniumBase Header -->" in line:
             changed = True

examples/master_qa/ReadMe.md

@@ -4,7 +4,7 @@
 
 ![](https://cdn2.hubspot.net/hubfs/100006/images/masterqa6.gif "MasterQA")
 
-Here's example code from [basic_masterqa_test.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/master_qa/basic_masterqa_test.py):
+Here's example code from [basic_masterqa_test_0.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/master_qa/basic_masterqa_test_0.py):
 
 ```python
 self.open("https://xkcd.com/1700/")
@@ -17,7 +17,7 @@ self.verify('Do you see "dragons" in the search results?')
 
 After each automation checkpoint, a pop-up window will ask the user questions for each verification command.
 
-When the test run completes, as seen from [this longer example](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/master_qa/masterqa_test.py), you'll reach the results page that appears after answering all the verification questions. (Failed verifications generate links to screenshots and log files.)
+When the test run completes, as seen from [this longer example](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/master_qa/masterqa_test_1.py), you'll reach the results page that appears after answering all the verification questions. (Failed verifications generate links to screenshots and log files.)
 
 ![](https://cdn2.hubspot.net/hubfs/100006/images/hybrid_screen.png "MasterQA")
 
@@ -30,13 +30,13 @@ cd SeleniumBase
 pip install -r requirements.txt --upgrade
 python setup.py develop
 cd examples/master_qa
-pytest basic_masterqa_test.py
-pytest masterqa_test.py
+pytest basic_masterqa_test_0.py
+pytest masterqa_test_1.py
 ```
 
 At the end of your test run, you'll receive a report with results, screenshots, and log files. Close the Results Page window when you're done.
 
-### Check out [masterqa_test.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/master_qa/masterqa_test.py) to learn how to write your own MasterQA tests:
+### Check out [masterqa_test_1.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/master_qa/masterqa_test_1.py) to learn how to write your own MasterQA tests:
 
 You'll notice that tests are written the same way as regular [SeleniumBase](https://seleniumbase.com) tests, with the key difference being a different import: ``from seleniumbase import MasterQA`` rather than ``from seleniumbase import BaseCase``. Now your Python test class will import ``MasterQA`` instead of ``BaseCase``.
 

examples/master_qa/basic_masterqa_test.py renamed to examples/master_qa/basic_masterqa_test_0.py

@@ -90,10 +90,10 @@ def test_basic(self):
         #
         # 6. For backwards-compatibilty, some SeleniumBase methods that do the
         #    same thing have multiple names, kept on from previous versions.
-        #    Ex: wait_for_element_visible() is the same as find_element().
+        #    Ex: self.wait_for_element() is the same as self.find_element().
         #    Both search for and return the element, and raise an exception if
         #    the element does not appear on the page within the timeout limit.
-        #    And assert_element() also does this (minus returning the element).
+        #    And self.assert_element() does this too (without returning it).
         #
         # 7. For the full method list, see one of the following:
         #    * SeleniumBase/seleniumbase/fixtures/base_case.py

examples/master_qa/masterqa_test.py renamed to examples/master_qa/masterqa_test_1.py

@@ -1,3 +1,4 @@
+import os
 import pytest
 from seleniumbase import BaseCase
 
@@ -7,7 +8,11 @@ class OfflineTestClass(BaseCase):
 
     def test_demo_page(self):
         # Load a local html file into the browser
-        self.load_html_file("demo_page.html")
+        dir_name = os.path.dirname(os.path.abspath(__file__))
+        self.load_html_file(dir_name + "/demo_page.html")
+
+        # Assert the title of the current web page
+        self.assert_title("Web Testing Page")
 
         # Assert that the element is visible on the page
         self.assert_element("tbody#tbodyId")
@@ -88,4 +93,7 @@ def test_demo_page(self):
         self.assert_link_text("SeleniumBase on GitHub")
 
         # Assert the title of the current web page
-        self.assert_title("Web Testing Page")
+        self.assert_link_text("seleniumbase.com")
+        self.assert_link_text("SeleniumBase on GitHub")
+        self.assert_link_text("seleniumbase.io")
+        self.assert_link_text("SeleniumBase Demo Page")

examples/my_first_test.py

@@ -1,3 +1,4 @@
+# -*- coding: utf-8 -*-
 from seleniumbase import BaseCase
 
 

examples/offline_examples/test_demo_page.py

@@ -6,6 +6,9 @@ class MyTestClass(BaseCase):
     def test_demo_site(self):
         self.open("https://seleniumbase.io/demo_page.html")
 
+        # Assert the title of the current web page
+        self.assert_title("Web Testing Page")
+
         # Assert that the element is visible on the page
         self.assert_element("tbody#tbodyId")
 
@@ -80,9 +83,13 @@ def test_demo_site(self):
         self.assert_true(self.is_selected(".fBox"))
         self.switch_to_default_content()
 
-        # Assert link text - Use click_link_text() to click
+        # Assert link text
         self.assert_link_text("seleniumbase.com")
         self.assert_link_text("SeleniumBase on GitHub")
+        self.assert_link_text("seleniumbase.io")
 
-        # Assert the title of the current web page
-        self.assert_title("Web Testing Page")
+        # Click link text
+        self.click_link_text("SeleniumBase Demo Page")
+
+        # Assert exact text
+        self.assert_exact_text("Demo Page", "h1")

examples/test_apple_site.py

@@ -15,7 +15,7 @@ def test_skype_website_on_mobile(self):
         if not self.mobile_emulator:
             print("\n  This test is only for mobile devices / emulators!")
             print("  (Usage: '--mobile' with a Chromium-based browser.)")
-            self.skip("Please rerun this test using '--mobile!'!")
+            self.skip("Please rerun this test using '--mobile' !!!")
         self.open("https://www.skype.com/en/")
         self.assert_text("Install Skype", "div.appInfo")
         self.highlight("div.appBannerContent")

examples/test_demo_site.py

@@ -94,7 +94,7 @@ class MyTourClass(BaseCase):
         self.play_tour()
 ```
 
-#### This example was taken from [google_tour.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/tour_examples/google_tour.py), which you can run from the ``examples/tour_examples`` folder with the following command:
+#### This example is from [google_tour.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/tour_examples/google_tour.py), which you can run from the ``examples/tour_examples`` folder with the following command:
 
 ```bash
 pytest google_tour.py