Merge pull request #1187 from seleniumbase/improve-logging-and-shadow-dom-support-3

Improve Logging, Shadow DOM support, and more

Author: mdmintz

.github/workflows/python-package.yml

@@ -14,9 +14,9 @@ jobs:
     runs-on: ubuntu-18.04
     strategy:
       fail-fast: false
-      max-parallel: 7
+      max-parallel: 6
       matrix:
-        python-version: ["2.7", "3.5", "3.6", "3.7", "3.8", "3.9", "3.10"]
+        python-version: ["2.7", "3.6", "3.7", "3.8", "3.9", "3.10"]
 
     steps:
     - uses: actions/checkout@v1

azure-pipelines.yml

@@ -11,8 +11,6 @@ jobs:
     vmImage: 'Ubuntu-20.04'
   strategy:
     matrix:
-      Python3_5:
-        python.version: '3.5'
       Python3_6:
         python.version: '3.6'
       Python3_7:
@@ -21,6 +19,8 @@ jobs:
         python.version: '3.8'
       Python3_9:
         python.version: '3.9'
+      Python3_10:
+        python.version: '3.10'
     maxParallel: 5
 
   steps:

examples/dialog_boxes/dialog_box_tour.py

@@ -72,7 +72,7 @@ def test_dialog_boxes(self):
         message = "<b>This is the SeleniumBase Docs website!</b><br /><br />"
         message += "What would you like to search for?<br />"
         text = self.get_jqc_text_input(message, ["Search"])
-        self.update_text('input[aria-label="Search"]', text + "\n")
+        self.type('input[aria-label="Search"]', text + "\n")
         self.wait_for_ready_state_complete()
         self.set_jqc_theme("bootstrap", color="red", width="32%")
         if self.is_text_visible("No matching documents", ".md-search-result"):
@@ -103,7 +103,7 @@ def test_dialog_boxes(self):
             self.open("https://store.xkcd.com/search")
         else:
             self.open("https://en.wikipedia.org/wiki/Special:Search")
-        self.highlight_update_text('input[id*="search"]', text + "\n")
+        self.highlight_type('input[id*="search"]', text + "\n")
         self.wait_for_ready_state_complete()
         self.sleep(1)
         self.highlight("body")

examples/raw_browser_launcher.py

@@ -0,0 +1,22 @@
+"""
+This script can be run with pure "python". (pytest not needed).
+"get_driver()" is from [seleniumbase/core/browser_launcher.py].
+"""
+from seleniumbase import get_driver
+from seleniumbase import js_utils
+from seleniumbase import page_actions
+
+success = False
+try:
+    driver = get_driver("chrome", headless=False)
+    driver.get('data:text/html,<h1 class="top">Data URL</h2>')
+    source = driver.page_source
+    assert "Data URL" in source
+    # An example of "is_element_visible()" from "page_actions"
+    assert page_actions.is_element_visible(driver, "h1.top")
+    # Extra fun with Javascript
+    js_utils.highlight_with_js(driver, "h1.top", 8, "")
+    success = True  # No errors
+finally:
+    driver.quit()
+assert success

examples/setup.cfg

@@ -1,11 +1,12 @@
 [flake8]
-# W503,W504 (line break before or after binary operators)
+# W503 (line break before binary operator) can be ignored.
 exclude=recordings,temp
-ignore=W503,W504
+ignore=W503
 
 [nosetests]
-# nocapture=1 displays print statements from output. Undo this by using: --nologcapture
-# logging-level=INFO keeps the logs much cleaner than using DEBUG
+# nocapture=1 (Display print statements from output)
+#             (Undo this by using: "--nologcapture")
+# logging-level=INFO (Shorter logs than using DEBUG)
 nocapture=1
 logging-level=INFO
 

examples/unit_tests/verify_framework.py

@@ -16,7 +16,7 @@ def test_failing(self):
                 self.assert_equal('yes', 'no')
         """
     )
-    result = testdir.inline_run("--headless", "--rs")
+    result = testdir.inline_run("--headless", "--rs", "-v")
     assert result.matchreport("test_passing").passed
     assert result.matchreport("test_failing").skipped
 
@@ -34,10 +34,29 @@ def test_basecase(self):
                 self.click("body p")  # selector
         """
     )
-    result = testdir.inline_run("--headless")
+    result = testdir.inline_run("--headless", "-v")
     assert result.matchreport("test_basecase").passed
 
 
+def test_run_with_dashboard(testdir):
+    testdir.makepyfile(
+        """
+        from seleniumbase import BaseCase
+        class MyTestCase(BaseCase):
+            def test_1_passing(self):
+                self.assert_equal('yes', 'yes')
+            def test_2_failing(self):
+                self.assert_equal('yes', 'no')
+            def test_3_skipped(self):
+                self.skip("Skip!")
+        """
+    )
+    result = testdir.inline_run("--headless", "--rs", "--dashboard", "-v")
+    assert result.matchreport("test_1_passing").passed
+    assert result.matchreport("test_2_failing").failed
+    assert result.matchreport("test_3_skipped").skipped
+
+
 def test_sb_fixture(testdir):
     testdir.makepyfile(
         """
@@ -49,7 +68,7 @@ def test_sb_fixture(sb):
             sb.click("body p")  # selector
         """
     )
-    result = testdir.inline_run("--headless")
+    result = testdir.inline_run("--headless", "-v")
     assert result.matchreport("test_sb_fixture").passed
 
 
@@ -66,5 +85,51 @@ def test_request_sb_fixture(request):
             sb.tearDown()
         """
     )
-    result = testdir.inline_run("--headless")
+    result = testdir.inline_run("--headless", "-v")
     assert result.matchreport("test_request_sb_fixture").passed
+
+
+def test_browser_launcher(testdir):
+    testdir.makepyfile(
+        """
+        from seleniumbase import get_driver
+        def test_browser_launcher():
+            success = False
+            try:
+                driver = get_driver("chrome", headless=True)
+                driver.get("data:text/html,<p>Data URL</p>")
+                source = driver.page_source
+                assert "Data URL" in source
+                success = True  # No errors
+            finally:
+                driver.quit()
+            assert success
+        """
+    )
+    result = testdir.inline_run("--headless", "-v")
+    assert result.matchreport("test_browser_launcher").passed
+
+
+def test_framework_components(testdir):
+    testdir.makepyfile(
+        """
+        from seleniumbase import get_driver
+        from seleniumbase import js_utils
+        from seleniumbase import page_actions
+        def test_framework_components():
+            success = False
+            try:
+                driver = get_driver("chrome", headless=True)
+                driver.get('data:text/html,<h1 class="top">Data URL</h2>')
+                source = driver.page_source
+                assert "Data URL" in source
+                assert page_actions.is_element_visible(driver, "h1.top")
+                js_utils.highlight_with_js(driver, "h1.top", 2, "")
+                success = True  # No errors
+            finally:
+                driver.quit()
+            assert success
+        """
+    )
+    result = testdir.inline_run("--headless", "-v")
+    assert result.matchreport("test_framework_components").passed

examples/wordle_test.py

@@ -55,8 +55,8 @@ def skip_if_incorrect_env(self):
             print(message)
             self.skip(message)
         version = [int(i) for i in __version__.split(".") if i.isdigit()]
-        if version < [2, 4, 2]:
-            message = "This test requires SeleniumBase 2.4.2 or newer!"
+        if version < [2, 4, 3]:
+            message = "This test requires SeleniumBase 2.4.3 or newer!"
             print(message)
             self.skip(message)
 

help_docs/method_summary.md

@@ -218,15 +218,44 @@ self.switch_to_newest_window()
 # Duplicates: self.switch_to_newest_tab()
 
 self.get_new_driver(
-    browser=None, headless=None, locale_code=None, protocol=None,
-    servername=None, port=None, proxy=None, agent=None, switch_to=True,
-    cap_file=None, cap_string=None, disable_csp=None, enable_ws=None,
-    enable_sync=None, use_auto_ext=None, no_sandbox=None, disable_gpu=None,
-    incognito=None, guest_mode=None, devtools=None, remote_debug=None,
-    swiftshader=None, block_images=None,
-    chromium_arg=None, firefox_arg=None, firefox_pref=None,
-    user_data_dir=None, extension_zip=None, extension_dir=None,
-    is_mobile=None, d_width=None, d_height=None, d_p_r=None)
+    browser=None,
+    headless=None,
+    locale_code=None,
+    protocol=None,
+    servername=None,
+    port=None,
+    proxy=None,
+    proxy_bypass_list=None,
+    agent=None,
+    switch_to=True,
+    cap_file=None,
+    cap_string=None,
+    recorder_ext=None,
+    disable_csp=None,
+    enable_ws=None,
+    enable_sync=None,
+    use_auto_ext=None,
+    no_sandbox=None,
+    disable_gpu=None,
+    incognito=None,
+    guest_mode=None,
+    devtools=None,
+    remote_debug=None,
+    swiftshader=None,
+    ad_block_on=None,
+    block_images=None,
+    chromium_arg=None,
+    firefox_arg=None,
+    firefox_pref=None,
+    user_data_dir=None,
+    extension_zip=None,
+    extension_dir=None,
+    external_pdf=None,
+    is_mobile=None,
+    d_width=None,
+    d_height=None,
+    d_p_r=None,
+)
 
 self.switch_to_driver(driver)
 
@@ -275,8 +304,9 @@ self.bring_to_front(selector, by=By.CSS_SELECTOR)
 
 self.highlight_click(selector, by=By.CSS_SELECTOR, loops=3, scroll=True)
 
-self.highlight_update_text(
-    selector, text, by=By.CSS_SELECTOR, loops=3, scroll=True)
+self.highlight_type(selector, text, by=By.CSS_SELECTOR, loops=3, scroll=True)
+# Duplicates:
+# self.highlight_update_text(selector, text, by=By.CSS_SELECTOR, loops=3, scroll=True)
 
 self.highlight(selector, by=By.CSS_SELECTOR, loops=4, scroll=True)
 
@@ -584,8 +614,7 @@ self.post_success_message(message, duration=None, pause=True)
 
 self.post_error_message(message, duration=None, pause=True)
 
-self.set_messenger_theme(theme="default", location="default",
-                         max_messages="default")
+self.set_messenger_theme(theme="default", location="default", max_messages="default")
 
 ############
 

seleniumbase/__init__.py

@@ -1,5 +1,7 @@
 from seleniumbase.__version__ import __version__  # noqa
 from seleniumbase.core.browser_launcher import get_driver  # noqa
+from seleniumbase.fixtures import js_utils  # noqa
+from seleniumbase.fixtures import page_actions  # noqa
 from seleniumbase.fixtures.base_case import BaseCase  # noqa
 from seleniumbase.masterqa.master_qa import MasterQA  # noqa
 from seleniumbase.common import decorators  # noqa

seleniumbase/__version__.py

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "2.4.2"
+__version__ = "2.4.3"