Merge pull request #889 from seleniumbase/mostly-dashboard-updates

Dashboard upgrades and a lot more

Author: mdmintz

docs/img/dash_pie.png

@@ -10,7 +10,7 @@ pymdown-extensions==8.1.1
 importlib-metadata==4.0.1;python_version>="3.6"
 lunr==0.5.8
 mkdocs==1.1.2
-mkdocs-material==7.1.2
+mkdocs-material==7.1.3
 mkdocs-exclude-search==0.5.1;python_version>="3.6"
 mkdocs-simple-hooks==0.1.3
 mkdocs-material-extensions==1.0.1

docs/requirements.txt

@@ -0,0 +1,28 @@
+from seleniumbase import BaseCase
+
+
+class ChromedriverTests(BaseCase):
+
+    def test_fail_if_using_an_old_chromedriver(self):
+        if self.browser != "chrome":
+            print("\n  This test is only for Chrome!")
+            print("  (Run with: '--browser=chrome')")
+            self.skip("This test is only for Chrome!")
+        chrome_version = self.get_chrome_version()
+        major_chrome_version = chrome_version.split('.')[0]
+        chromedriver_version = self.get_chromedriver_version()
+        major_chromedriver_version = chromedriver_version.split('.')[0]
+        install_sb = "sbase install chromedriver %s" % major_chrome_version
+        if (
+            int(major_chromedriver_version) < 73
+            and int(major_chrome_version) >= 73
+        ):
+            message = (
+                'Your version of chromedriver: "%s"\n  '
+                'is too old for your version of Chrome: "%s"\n'
+                'You should upgrade chromedriver '
+                "to receive important bug fixes!\n"
+                'Run this command to upgrade: "%s"'
+                % (chromedriver_version, chrome_version, install_sb)
+            )
+            raise Exception(message)  # chromedriver is out-of-date

examples/fail_if_old_driver_test.py

@@ -1,3 +1,4 @@
+import os
 import pytest
 from seleniumbase import BaseCase
 
@@ -12,7 +13,8 @@ def test_pull_image_from_website(self):
         file_name = "comic.png"
         folder = "images_exported"
         self.save_element_as_image_file(selector, file_name, folder)
-        print('"%s/%s" has been saved!' % (folder, file_name))
+        self.assert_true(os.path.exists("%s/%s" % (folder, file_name)))
+        print('\n"%s/%s" was saved!' % (folder, file_name))
 
     @pytest.mark.run(order=2)
     def test_add_text_overlay_to_image(self):
@@ -24,7 +26,8 @@ def test_add_text_overlay_to_image(self):
         overlay_text = 'This is an XKCD comic!\nTitle: "My Sky"'
         self.save_element_as_image_file(
             selector, file_name, folder, overlay_text)
-        print('"%s/%s" has been saved!' % (folder, file_name))
+        self.assert_true(os.path.exists("%s/%s" % (folder, file_name)))
+        print('\n"%s/%s" was saved!' % (folder, file_name))
 
     @pytest.mark.run(order=3)
     def test_add_text_overlay_to_page_section(self):
@@ -40,7 +43,8 @@ def test_add_text_overlay_to_page_section(self):
             % self.get_current_url())
         self.save_element_as_image_file(
             selector, file_name, folder, overlay_text)
-        print('"%s/%s" has been saved!' % (folder, file_name))
+        self.assert_true(os.path.exists("%s/%s" % (folder, file_name)))
+        print('\n"%s/%s" was saved!' % (folder, file_name))
 
     @pytest.mark.run(order=4)
     def test_add_text_overlay_to_full_page(self):
@@ -53,4 +57,5 @@ def test_add_text_overlay_to_full_page(self):
         overlay_text = ("A text overlay on %s" % self.get_current_url())
         self.save_element_as_image_file(
             selector, file_name, folder, overlay_text)
-        print('"%s/%s" has been saved!' % (folder, file_name))
+        self.assert_true(os.path.exists("%s/%s" % (folder, file_name)))
+        print('\n"%s/%s" was saved!' % (folder, file_name))

examples/image_test.py

@@ -6,6 +6,7 @@ class CheckboxTests(BaseCase):
     def test_checkboxes_and_radio_buttons(self):
         self.open("https://www.w3schools.com/tags/tryit.asp"
                   "?filename=tryhtml5_input_type_checkbox")
+        self.ad_block()
         self.switch_to_frame("iframeResult")
         checkbox = "input#vehicle2"
         self.assert_false(self.is_selected(checkbox))

examples/test_checkboxes.py

@@ -13,15 +13,9 @@ def test_chromedriver_matches_chrome(self):
             print("\n  This test is only for Chrome!")
             print("  (Run with: '--browser=chrome')")
             self.skip("This test is only for Chrome!")
-        driver_capabilities = self.driver.capabilities
-        if "version" in driver_capabilities:
-            chrome_version = driver_capabilities["version"]
-        else:
-            chrome_version = driver_capabilities["browserVersion"]
+        chrome_version = self.get_chrome_version()
         major_chrome_version = chrome_version.split('.')[0]
-        chrome_dict = self.driver.capabilities["chrome"]
-        chromedriver_version = chrome_dict["chromedriverVersion"]
-        chromedriver_version = chromedriver_version.split(' ')[0]
+        chromedriver_version = self.get_chromedriver_version()
         major_chromedriver_version = chromedriver_version.split('.')[0]
         colorama.init(autoreset=True)
         c1 = colorama.Fore.BLUE + colorama.Back.LIGHTCYAN_EX

examples/test_chromedriver.py

@@ -14,10 +14,20 @@ def test_download_files(self):
         # Click the links to download the files into: "./downloaded_files/"
         # (If using Safari, IE, or Chromium Guest Mode: download directly.)
         # (The default Downloads Folder can't be changed when using those.)
+        # (The same problem occurs when using an out-of-date chromedriver.)
+        # (Use self.get_browser_downloads_folder() to get the folder used.)
         whl_selector = 'div#files a[href$="%s"]' % whl_file
         tar_selector = 'div#files a[href$="%s"]' % tar_gz_file
-        if self.browser == "safari" or self.browser == "ie" or (
-                self.is_chromium() and self.guest_mode and not self.headless):
+        if (
+            self.browser == "safari"
+            or self.browser == "ie"
+            or (self.is_chromium() and self.guest_mode and not self.headless)
+            or (
+                self.browser == "chrome"
+                and self.is_chromedriver_too_old()
+                and self.headless
+            )
+        ):
             whl_href = self.get_attribute(whl_selector, "href")
             tar_href = self.get_attribute(tar_selector, "href")
             self.download_file(whl_href)

examples/test_download_files.py

@@ -0,0 +1,40 @@
+import os
+from seleniumbase import BaseCase
+
+
+class ScreenshotTests(BaseCase):
+
+    def test_save_screenshot(self):
+        self.open("https://seleniumbase.io/demo_page")
+        # "./downloaded_files" is a special SeleniumBase folder for downloads
+        self.save_screenshot("demo_page.png", folder="./downloaded_files")
+        self.assert_downloaded_file("demo_page.png")
+        print('\n"%s/%s" was saved!' % ("downloaded_files", "demo_page.png"))
+
+    def test_save_screenshot_to_logs(self):
+        self.open("https://seleniumbase.io/demo_page")
+        self.save_screenshot_to_logs()
+        # "self.log_path" is the absolute path to the "./latest_logs" folder.
+        # Each test that generates log files will create a subfolder in there
+        test_logpath = os.path.join(self.log_path, self.test_id)
+        expected_screenshot = os.path.join(test_logpath, "_1_screenshot.png")
+        self.assert_true(os.path.exists(expected_screenshot))
+        print('\n"%s" was saved!' % (expected_screenshot))
+
+        self.open("https://seleniumbase.io/tinymce/")
+        self.save_screenshot_to_logs()
+        expected_screenshot = os.path.join(test_logpath, "_2_screenshot.png")
+        self.assert_true(os.path.exists(expected_screenshot))
+        print('"%s" was saved!' % (expected_screenshot))
+
+        self.open("https://seleniumbase.io/error_page/")
+        self.save_screenshot_to_logs("error_page")
+        expected_screenshot = os.path.join(test_logpath, "_3_error_page.png")
+        self.assert_true(os.path.exists(expected_screenshot))
+        print('"%s" was saved!' % (expected_screenshot))
+
+        self.open("https://seleniumbase.io/devices/")
+        self.save_screenshot_to_logs("devices")
+        expected_screenshot = os.path.join(test_logpath, "_4_devices.png")
+        self.assert_true(os.path.exists(expected_screenshot))
+        print('"%s" was saved!' % (expected_screenshot))

examples/test_save_screenshots.py

@@ -1,4 +1,4 @@
-""" Testing the self.choose_file() method. """
+""" Testing the self.choose_file() and self.assert_attribute() methods. """
 
 import os
 from seleniumbase import BaseCase
@@ -11,11 +11,13 @@ def test_file_upload_button(self):
                   "?filename=tryjsref_fileupload_get")
         self.ad_block()
         self.switch_to_frame('iframeResult')
-        zoom_in = 'input[type="file"]{zoom: 1.5;-moz-transform: scale(1.5);}'
+        zoom_in = 'input[type="file"]{zoom: 1.6;-moz-transform: scale(1.6);}'
         self.add_css_style(zoom_in)
         self.highlight('input[type="file"]')
         dir_name = os.path.dirname(os.path.abspath(__file__))
-        file_path = os.path.join(dir_name, "example_logs/screenshot.png")
+        my_file = "screenshot.png"
+        file_path = os.path.join(dir_name, "example_logs/%s" % my_file)
+        self.assert_attribute("#myFile", "value", "")
         self.choose_file('input[type="file"]', file_path)
-        self.demo_mode = True  # Adds highlighting to the assert statement
-        self.assert_element('input[type="file"]')
+        self.assert_attribute("#myFile", "value", "C:\\fakepath\\%s" % my_file)
+        self.highlight('input[type="file"]')

examples/upload_file_test.py

@@ -205,6 +205,8 @@ self.switch_to_default_driver()
 
 self.save_screenshot(name, folder=None)
 
+self.save_screenshot_to_logs(name=None)
+
 self.save_page_source(name, folder=None)
 
 self.save_cookies(name="cookies.txt")
@@ -334,6 +336,12 @@ self.assert_not_equal(first, second, msg=None)
 
 self.assert_raises(*args, **kwargs)
 
+self.wait_for_attribute(selector, attribute, value=None,
+                        by=By.CSS_SELECTOR, timeout=None)
+
+self.assert_attribute(selector, attribute, value=None,
+                      by=By.CSS_SELECTOR, timeout=None)
+
 self.assert_title(title)
 
 self.assert_no_js_errors()
@@ -342,6 +350,12 @@ self.inspect_html()
 
 self.is_chromium()
 
+self.get_chrome_version()
+
+self.get_chromedriver_version()
+
+self.is_chromedriver_too_old()
+
 self.get_google_auth_password(totp_key=None)
 
 self.convert_css_to_xpath(css)