seleniumbase 4.30.8__py3-none-any.whl → 4.31.1__py3-none-any.whl

sbase/__init__.py

@@ -11,3 +11,4 @@ from seleniumbase import MasterQA  # noqa
 from seleniumbase import page_actions  # noqa
 from seleniumbase import page_utils  # noqa
 from seleniumbase import SB  # noqa
+from seleniumbase import translate  # noqa

seleniumbase/__init__.py

@@ -10,7 +10,7 @@ from selenium import webdriver
 from seleniumbase.__version__ import __version__
 from seleniumbase.common import decorators  # noqa
 from seleniumbase.common import encryption  # noqa
-from seleniumbase.core import colored_traceback
+from seleniumbase.core import colored_traceback  # noqa
 from seleniumbase.core.browser_launcher import get_driver  # noqa
 from seleniumbase.fixtures import js_utils  # noqa
 from seleniumbase.fixtures import page_actions  # noqa
@@ -36,8 +36,7 @@ if sys.version_info[0] < 3 and "pdbp" in locals():
         pdb.DefaultConfig.sticky_by_default = True
 colored_traceback.add_hook()
 os.environ["SE_AVOID_STATS"] = "true"  # Disable Selenium Manager stats
-if sys.version_info >= (3, 7):
-    webdriver.TouchActions = None  # Lifeline for past selenium-wire versions
+webdriver.TouchActions = None  # Lifeline for past selenium-wire versions
 if sys.version_info >= (3, 10):
     collections.Callable = collections.abc.Callable  # Lifeline for nosetests
 del collections  # Undo "import collections" / Simplify "dir(seleniumbase)"

seleniumbase/__version__.py

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "4.30.8"
+__version__ = "4.31.1"

seleniumbase/behave/behave_sb.py

@@ -44,10 +44,12 @@ behave -D agent="User Agent String" -D demo
 -D sjw  (Skip JS Waits for readyState to be "complete" or Angular to load.)
 -D wfa  (Wait for AngularJS to be done loading after specific web actions.)
 -D pls=PLS  (Set pageLoadStrategy on Chrome: "normal", "eager", or "none".)
--D headless  (Run tests in headless mode. The default arg on Linux OS.)
--D headless2  (Use the new headless mode, which supports extensions.)
+-D headless  (The default headless mode. Linux uses this mode by default.)
+-D headless1  (Use Chrome's old headless mode. Fast, but has limitations.)
+-D headless2  (Use Chrome's new headless mode, which supports extensions.)
 -D headed  (Run tests in headed/GUI mode on Linux OS, where not default.)
 -D xvfb  (Run tests using the Xvfb virtual display server on Linux OS.)
+-D xvfb-metrics=STRING  (Set Xvfb display size on Linux: "Width,Height".)
 -D locale=LOCALE_CODE  (Set the Language Locale Code for the web browser.)
 -D pdb  (Activate Post Mortem Debug Mode if a test fails.)
 -D interval=SECONDS  (The autoplay interval for presentations & tour steps)
@@ -90,6 +92,7 @@ behave -D agent="User Agent String" -D demo
 -D rcs | -D reuse-class-session  (Reuse session for tests in class/feature)
 -D crumbs  (Delete all cookies between tests reusing a session.)
 -D disable-beforeunload  (Disable the "beforeunload" event on Chrome.)
+-D window-position=X,Y  (Set the browser's starting window position.)
 -D window-size=WIDTH,HEIGHT  (Set the browser's starting window size.)
 -D maximize  (Start tests with the browser window maximized.)
 -D screenshot  (Save a screenshot at the end of each test.)
@@ -104,6 +107,7 @@ import colorama
 import os
 import re
 import sys
+from contextlib import suppress
 from seleniumbase import config as sb_config
 from seleniumbase.config import settings
 from seleniumbase.core import download_helper
@@ -141,10 +145,12 @@ def get_configured_sb(context):
     sb.browser = "chrome"
     sb.is_behave = True
     sb.headless = False
+    sb.headless1 = False
     sb.headless2 = False
     sb.headless_active = False
     sb.headed = False
     sb.xvfb = False
+    sb.xvfb_metrics = None
     sb.start_page = None
     sb.locale_code = None
     sb.pdb_option = False
@@ -193,6 +199,7 @@ def get_configured_sb(context):
     sb._disable_beforeunload = False
     sb.visual_baseline = False
     sb.use_wire = False
+    sb.window_position = None
     sb.window_size = None
     sb.maximize_option = False
     sb.is_context_manager = False
@@ -291,6 +298,11 @@ def get_configured_sb(context):
             sb.headless = True
             continue
         # Handle: -D headless2
+        if low_key == "headless1":
+            sb.headless1 = True
+            sb.headless = True
+            continue
+        # Handle: -D headless2
         if low_key == "headless2":
             sb.headless2 = True
             continue
@@ -302,6 +314,13 @@ def get_configured_sb(context):
         if low_key == "xvfb":
             sb.xvfb = True
             continue
+        # Handle: -D xvfb-metrics=STR / xvfb_metrics=STR
+        if low_key in ["xvfb-metrics", "xvfb_metrics"]:
+            xvfb_metrics = userdata[key]
+            if xvfb_metrics == "true":
+                xvfb_metrics = sb.xvfb_metrics  # revert to default
+            sb.xvfb_metrics = xvfb_metrics
+            continue
         # Handle: -D start-page=URL / start_page=URL / url=URL
         if low_key in ["start-page", "start_page", "url"]:
             start_page = userdata[key]
@@ -601,6 +620,13 @@ def get_configured_sb(context):
         if low_key == "wire":
             sb.use_wire = True
             continue
+        # Handle: -D window-position=X,Y / window_position=X,Y
+        if low_key in ["window-position", "window_position"]:
+            window_position = userdata[key]
+            if window_position == "true":
+                window_position = sb.window_position  # revert to default
+            sb.window_position = window_position
+            continue
         # Handle: -D window-size=Width,Height / window_size=Width,Height
         if low_key in ["window-size", "window_size"]:
             window_size = userdata[key]
@@ -845,6 +871,7 @@ def get_configured_sb(context):
     # Recorder Mode can still optimize scripts in "-D headless2" mode.
     if sb.recorder_ext and sb.headless:
         sb.headless = False
+        sb.headless1 = False
         sb.headless2 = True
     if sb.headless2 and sb.browser == "firefox":
         sb.headless2 = False  # Only for Chromium browsers
@@ -881,11 +908,13 @@ def get_configured_sb(context):
     # Recorder Mode can still optimize scripts in --headless2 mode.
     if sb.recorder_mode and sb.headless:
         sb.headless = False
+        sb.headless1 = False
         sb.headless2 = True
     if not sb.headless and not sb.headless2:
         sb.headed = True
     if sb.browser == "safari" and sb.headless:
         sb.headless = False  # Safari doesn't support headless mode
+        sb.headless1 = False
     if sb.save_screenshot_after_test and sb.no_screenshot_after_test:
         sb.save_screenshot_after_test = False  # "no_screenshot" has priority
     if sb.servername != "localhost":
@@ -904,6 +933,29 @@ def get_configured_sb(context):
     else:
         sb.enable_ws = False
         sb.disable_ws = True
+    if sb.window_position:
+        window_position = sb.window_position
+        if window_position.count(",") != 1:
+            message = (
+                '\n\n  window_position expects an "x,y" string!'
+                '\n  (Your input was: "%s")\n' % window_position
+            )
+            raise Exception(message)
+        window_position = window_position.replace(" ", "")
+        win_x = None
+        win_y = None
+        try:
+            win_x = int(window_position.split(",")[0])
+            win_y = int(window_position.split(",")[1])
+        except Exception:
+            message = (
+                '\n\n  Expecting integer values for "x,y"!'
+                '\n  (window_position input was: "%s")\n'
+                % window_position
+            )
+            raise Exception(message)
+        settings.WINDOW_START_X = win_x
+        settings.WINDOW_START_Y = win_y
     if sb.window_size:
         window_size = sb.window_size
         if window_size.count(",") != 1:
@@ -938,9 +990,11 @@ def get_configured_sb(context):
     sb_config.is_pytest = False
     sb_config.is_nosetest = False
     sb_config.is_context_manager = False
+    sb_config.window_position = sb.window_position
     sb_config.window_size = sb.window_size
     sb_config.maximize_option = sb.maximize_option
     sb_config.xvfb = sb.xvfb
+    sb_config.xvfb_metrics = sb.xvfb_metrics
     sb_config.reuse_class_session = sb._reuse_class_session
     sb_config.save_screenshot = sb.save_screenshot_after_test
     sb_config.no_screenshot = sb.no_screenshot_after_test
@@ -1162,12 +1216,10 @@ def behave_dashboard_prepare():
         sb_config.item_count_untested = sb_config.item_count
         dash_path = os.path.join(os.getcwd(), "dashboard.html")
         star_len = len("Dashboard: ") + len(dash_path)
-        try:
+        with suppress(Exception):
             terminal_size = os.get_terminal_size().columns
             if terminal_size > 30 and star_len > terminal_size:
                 star_len = terminal_size
-        except Exception:
-            pass
         stars = "*" * star_len
         c1 = ""
         cr = ""
@@ -1263,7 +1315,7 @@ def _perform_behave_unconfigure_():
 
 
 def do_final_driver_cleanup_as_needed():
-    try:
+    with suppress(Exception):
         if hasattr(sb_config, "last_driver") and sb_config.last_driver:
             if (
                 not is_windows
@@ -1271,8 +1323,6 @@ def do_final_driver_cleanup_as_needed():
                 or sb_config.last_driver.service.process
             ):
                 sb_config.last_driver.quit()
-    except Exception:
-        pass
 
 
 def _perform_behave_terminal_summary_():
@@ -1281,12 +1331,10 @@ def _perform_behave_terminal_summary_():
     )
     dash_path = os.path.join(os.getcwd(), "dashboard.html")
     equals_len = len("Dashboard: ") + len(dash_path)
-    try:
+    with suppress(Exception):
         terminal_size = os.get_terminal_size().columns
         if terminal_size > 30 and equals_len > terminal_size:
             equals_len = terminal_size
-    except Exception:
-        pass
     equals = "=" * (equals_len + 2)
     c2 = ""
     cr = ""

seleniumbase/config/settings.py

@@ -110,6 +110,10 @@ DISABLE_CSP_ON_CHROME = False
 # (This applies when using --proxy=[PROXY_STRING] for using a proxy server.)
 RAISE_INVALID_PROXY_STRING_EXCEPTION = True
 
+# Default browser coordinates when opening new windows for tests.
+WINDOW_START_X = 20
+WINDOW_START_Y = 54
+
 # Default browser resolutions when opening new windows for tests.
 # (Headless resolutions take priority, and include all browsers.)
 # (Firefox starts maximized by default when running in GUI Mode.)

seleniumbase/console_scripts/logo_helper.py

@@ -3,7 +3,9 @@
     http://www.patorjk.com/software/taag/#p=display&f=Slant&t=SeleniumBase """
 
 import colorama
+import os
 import sys
+from contextlib import suppress
 
 r"""
    ______     __           _                  ____
@@ -66,4 +68,49 @@ def get_seleniumbase_logo():
     sb += "                        "
     sb += cr
     sb += cr
+    with suppress(Exception):
+        terminal_width = os.get_terminal_size().columns
+        if isinstance(terminal_width, int) and terminal_width >= 66:
+            return sb
+
+    # If the logo is wider than the screen width, use a smaller one:
+    r"""
+     ___      _          _             ___
+    / __| ___| |___ _ _ (_)_  _ _ __  | _ ) __ _ ______
+    \__ \/ -_) / -_) ' \| | \| | '  \ | _ \/ _` (_-< -_)
+    |___/\___|_\___|_||_|_|\_,_|_|_|_\|___/\__,_/__|___|
+    """
+    sb = " "
+    sb += cr
+    sb += "\n"
+    sb += c1
+    sb += " ___      _          _            "
+    sb += c2
+    sb += " ___              "
+    sb += cr
+    sb += "\n"
+    sb += c1
+    sb += "/ __| ___| |___ _ _ (_)_  _ _ __  "
+    sb += c2
+    sb += "| _ ) __ _ ______ "
+    sb += cr
+    sb += "\n"
+    sb += c1
+    sb += "\\__ \\/ -_) / -_) ' \\| | \\| | '  \\ "
+    sb += c2
+    sb += "| _ \\/ _` (_-< -_)"
+    sb += cr
+    sb += "\n"
+    sb += c1
+    sb += "|___/\\___|_\\___|_||_|_|\\_,_|_|_|_\\"
+    sb += c2
+    sb += "|___/\\__,_/__|___|"
+    sb += cr
+    sb += "\n"
+    sb += c3
+    sb += "                                  "
+    sb += c4
+    sb += "                  "
+    sb += cr
+    sb += cr
     return sb

seleniumbase/console_scripts/run.py

@@ -54,8 +54,8 @@ else:
 def show_usage():
     show_basic_usage()
     sc = ""
-    sc += '    Type "sbase help [COMMAND]" for specific command info.\n'
-    sc += '    For info on all commands, type: "seleniumbase --help".\n'
+    sc += '    Type "sbase help [COMMAND]" for specific info.\n'
+    sc += '    For all commands, type: "seleniumbase --help".\n'
     sc += '    Use "pytest" for running tests.\n'
     if "linux" not in sys.platform:
         c1 = colorama.Fore.BLUE + colorama.Back.LIGHTCYAN_EX
@@ -76,12 +76,15 @@ def show_basic_usage():
 
     seleniumbase_logo = logo_helper.get_seleniumbase_logo()
     print(seleniumbase_logo)
+    time.sleep(0.044)
     print("")
-    time.sleep(0.28)  # Enough time to see the logo
+    time.sleep(0.033)
     show_package_location()
+    time.sleep(0.032)
     show_version_info()
+    time.sleep(0.031)
     print("")
-    time.sleep(0.62)  # Enough time to see the version
+    time.sleep(0.68)  # Enough time to see the logo & version
     sc = ""
     sc += ' * USAGE: "seleniumbase [COMMAND] [PARAMETERS]"\n'
     sc += ' *    OR:        "sbase [COMMAND] [PARAMETERS]"\n'

seleniumbase/console_scripts/sb_behave_gui.py

@@ -16,16 +16,16 @@ Output:
 import colorama
 import subprocess
 import sys
+import tkinter as tk
+from seleniumbase.fixtures import shared_utils
+from tkinter.scrolledtext import ScrolledText
 
-if sys.version_info <= (3, 7):
+if sys.version_info <= (3, 8):
     current_version = ".".join(str(ver) for ver in sys.version_info[:3])
     raise Exception(
-        "\n* SBase Commander requires Python 3.7 or newer!"
+        "\n* SBase Commander requires Python 3.8 or newer!"
         "\n** You are currently using Python %s" % current_version
     )
-from seleniumbase.fixtures import shared_utils
-import tkinter as tk  # noqa: E402
-from tkinter.scrolledtext import ScrolledText  # noqa: E402
 
 
 def set_colors(use_colors):

seleniumbase/console_scripts/sb_caseplans.py

@@ -20,17 +20,17 @@ import colorama
 import os
 import subprocess
 import sys
+import tkinter as tk
+from seleniumbase.fixtures import shared_utils
+from tkinter import messagebox
+from tkinter.scrolledtext import ScrolledText
 
-if sys.version_info <= (3, 7):
+if sys.version_info <= (3, 8):
     current_version = ".".join(str(ver) for ver in sys.version_info[:3])
     raise Exception(
-        "\n* SBase Case Plans Generator requires Python 3.7 or newer!"
+        "\n* SBase Case Plans Generator requires Python 3.8 or newer!"
         "\n** You are currently using Python %s" % current_version
     )
-from seleniumbase.fixtures import shared_utils
-import tkinter as tk  # noqa: E402
-from tkinter import messagebox  # noqa: E402
-from tkinter.scrolledtext import ScrolledText  # noqa: E402
 
 
 def set_colors(use_colors):

seleniumbase/console_scripts/sb_commander.py

@@ -21,16 +21,16 @@ import colorama
 import os
 import subprocess
 import sys
+import tkinter as tk
+from seleniumbase.fixtures import shared_utils
+from tkinter.scrolledtext import ScrolledText
 
-if sys.version_info <= (3, 7):
+if sys.version_info <= (3, 8):
     current_version = ".".join(str(ver) for ver in sys.version_info[:3])
     raise Exception(
-        "\n* SBase Commander requires Python 3.7 or newer!"
+        "\n* SBase Commander requires Python 3.8 or newer!"
         "\n** You are currently using Python %s" % current_version
     )
-from seleniumbase.fixtures import shared_utils
-import tkinter as tk  # noqa: E402
-from tkinter.scrolledtext import ScrolledText  # noqa: E402
 
 
 def set_colors(use_colors):

seleniumbase/console_scripts/sb_install.py

@@ -578,10 +578,18 @@ def main(override=None, intel_for_uc=None, force_uc=None):
             else:
                 invalid_run_command()
         if IS_MAC:
-            file_name = "geckodriver-%s-macos.tar.gz" % use_version
+            if IS_ARM_MAC:
+                file_name = "geckodriver-%s-macos-aarch64.tar.gz" % use_version
+            else:
+                file_name = "geckodriver-%s-macos.tar.gz" % use_version
         elif IS_LINUX:
             if "64" in ARCH:
-                file_name = "geckodriver-%s-linux64.tar.gz" % use_version
+                if "aarch64" in platform.processor():
+                    file_name = (
+                        "geckodriver-%s-linux-aarch64.tar.gz" % use_version
+                    )
+                else:
+                    file_name = "geckodriver-%s-linux64.tar.gz" % use_version
             else:
                 file_name = "geckodriver-%s-linux32.tar.gz" % use_version
         elif IS_WINDOWS:

seleniumbase/console_scripts/sb_recorder.py

@@ -18,23 +18,23 @@ import colorama
 import os
 import subprocess
 import sys
+import tkinter as tk
 from seleniumbase import config as sb_config
 from seleniumbase.fixtures import page_utils
 from seleniumbase.fixtures import shared_utils
+from tkinter import messagebox
 
 sb_config.rec_subprocess_p = None
 sb_config.rec_subprocess_used = False
 sys_executable = sys.executable
 if " " in sys_executable:
     sys_executable = "python"
-if sys.version_info <= (3, 7):
+if sys.version_info <= (3, 8):
     current_version = ".".join(str(ver) for ver in sys.version_info[:3])
     raise Exception(
-        "\n* Recorder Desktop requires Python 3.7 or newer!"
+        "\n* Recorder Desktop requires Python 3.8 or newer!"
         "\n*** You are currently using Python %s" % current_version
     )
-import tkinter as tk  # noqa: E402
-from tkinter import messagebox  # noqa: E402
 
 
 def set_colors(use_colors):