seleniumbase 4.50.3__tar.gz → 4.50.4__tar.gz

{seleniumbase-4.50.3/seleniumbase.egg-info → seleniumbase-4.50.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.50.3
+Version: 4.50.4
 Summary: SeleniumBase is a framework for web crawling, scraping, and testing. Supports pytest. CDP Mode adds stealth. Includes many tools.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -167,7 +167,7 @@ Requires-Dist: proxy.py==2.4.3; extra == "proxy"
 Provides-Extra: playwright
 Requires-Dist: playwright>=1.60.0; extra == "playwright"
 Requires-Dist: greenlet>=3.2.5; python_version < "3.10" and extra == "playwright"
-Requires-Dist: greenlet>=3.5.1; python_version >= "3.10" and extra == "playwright"
+Requires-Dist: greenlet>=3.5.3; python_version >= "3.10" and extra == "playwright"
 Provides-Extra: pyautogui
 Requires-Dist: PyAutoGUI>=0.9.54; platform_system != "Linux" and extra == "pyautogui"
 Dynamic: author
@@ -949,6 +949,7 @@ pytest test_coffee_cart.py --trace
 --brave  # (Shortcut for "--browser=brave".)
 --comet  # (Shortcut for "--browser=comet".)
 --atlas  # (Shortcut for "--browser=atlas".)
+--chromium  # (Shortcut for using base `Chromium`)
 --settings-file=FILE  # (Override default SeleniumBase settings.)
 --env=ENV  # (Set the test env. Access with "self.env" in tests.)
 --account=STR  # (Set account. Access with "self.account" in tests.)

{seleniumbase-4.50.3 → seleniumbase-4.50.4}/README.md

@@ -763,6 +763,7 @@ pytest test_coffee_cart.py --trace
 --brave  # (Shortcut for "--browser=brave".)
 --comet  # (Shortcut for "--browser=comet".)
 --atlas  # (Shortcut for "--browser=atlas".)
+--chromium  # (Shortcut for using base `Chromium`)
 --settings-file=FILE  # (Override default SeleniumBase settings.)
 --env=ENV  # (Set the test env. Access with "self.env" in tests.)
 --account=STR  # (Set account. Access with "self.account" in tests.)

{seleniumbase-4.50.3 → seleniumbase-4.50.4}/seleniumbase/__version__.py

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "4.50.3"
+__version__ = "4.50.4"

{seleniumbase-4.50.3 → seleniumbase-4.50.4}/seleniumbase/console_scripts/run.py

@@ -52,15 +52,15 @@ def show_basic_usage():
 
     seleniumbase_logo = logo_helper.get_seleniumbase_logo()
     print(seleniumbase_logo)
-    time.sleep(0.035)
+    time.sleep(0.044)
     print("")
-    time.sleep(0.031)
+    time.sleep(0.034)
     show_package_location()
-    time.sleep(0.031)
+    time.sleep(0.034)
     show_version_info()
-    time.sleep(0.031)
+    time.sleep(0.034)
     print("")
-    time.sleep(0.555)  # Enough time to see the logo & version
+    time.sleep(0.468)  # Enough time to see the logo & version
     sc = ""
     sc += "╭──────────────────────────────────────────────────╮\n"
     sc += '│  * USAGE: "seleniumbase [COMMAND] [PARAMETERS]"  │\n'
@@ -134,40 +134,40 @@ def show_install_usage():
     sc = "  " + c2 + "** " + c3 + "get / install" + c2 + " **" + cr
     print(sc)
     print("")
-    print("  Usage:")
-    print("     seleniumbase install [DRIVER_NAME] [OPTIONS]")
-    print("     OR: seleniumbase get [DRIVER_NAME] [OPTIONS]")
-    print("     OR:    sbase install [DRIVER_NAME] [OPTIONS]")
-    print("     OR:        sbase get [DRIVER_NAME] [OPTIONS]")
-    print("         (Drivers: chromedriver, cft, uc_driver,")
-    print("                   edgedriver, chs, geckodriver)")
-    print("  Options:")
-    print("     VERSION    Specify the version to download.")
-    print("                Tries to detect the needed version.")
-    print("                If using chromedriver or edgedriver,")
-    print("                you can use the major version integer.")
-    print()
-    print("     -p / --path    Also copy driver to /usr/local/bin")
-    print("  Examples:")
-    print("     sbase get chromedriver")
-    print("     sbase get geckodriver")
-    print("     sbase get edgedriver")
-    print("     sbase get chromedriver 149")
-    print("     sbase get chromedriver 149.0.7827.115")
-    print("     sbase get chromedriver stable")
-    print("     sbase get chromedriver beta")
-    print("     sbase get chromedriver -p")
-    print("     sbase get chromium")
-    print("     sbase get chromium --revision=1639046")
-    print("     sbase get cft 149")
-    print("     sbase get chs")
-    print("  Output:")
-    print("     Downloads the webdriver to seleniumbase/drivers/")
-    print("     (chromedriver is required for Chrome automation)")
-    print("     (geckodriver is required for Firefox automation)")
-    print("     (edgedriver is required for MS__Edge automation)")
-    print("     (cft is for the `Chrome for Testing` binary exe)")
-    print("     (chs is for the `Chrome-Headless-Shell` binary.)")
+    print("Usage:")
+    print("    seleniumbase install [DRIVER/BINARY] [OPTIONS]")
+    print("    OR: seleniumbase get [DRIVER/BINARY] [OPTIONS]")
+    print("    OR:    sbase install [DRIVER/BINARY] [OPTIONS]")
+    print("    OR:        sbase get [DRIVER/BINARY] [OPTIONS]")
+    print("        (Drivers:  chromedriver, uc_driver,")
+    print("                   edgedriver, geckodriver)")
+    print("        (Binaries:   cft, chs, chromium)")
+    print("Options:")
+    print("         VERSION  Driver/binary version to download.")
+    print("                   (Otherwise detects the version)")
+    print("      --revision  The Chromium revision to download.")
+    print("                   (Otherwise downloads the latest)")
+    print("    -p OR --path  Also copy driver to /usr/local/bin")
+    print("Examples:")
+    print("    sbase get chromedriver")
+    print("    sbase get geckodriver")
+    print("    sbase get edgedriver")
+    print("    sbase get chromedriver 149")
+    print("    sbase get chromedriver 149.0.7827.155")
+    print("    sbase get chromedriver stable")
+    print("    sbase get chromedriver beta")
+    print("    sbase get chromedriver -p")
+    print("    sbase get chromium")
+    print("    sbase get chromium --revision=1639046")
+    print("    sbase get cft 149")
+    print("    sbase get chs")
+    print("Output:")
+    print("    Downloads driver/binary to seleniumbase/drivers/")
+    print("    (chromedriver is for Selenium Chrome automation)")
+    print("    (geckodriver is for Selenium Firefox automation)")
+    print("    (edgedriver is for Selenium MS__Edge automation)")
+    print("    (cft is for the `Chrome for Testing` binary exe)")
+    print("    (chs is for the `Chrome-Headless-Shell` binary.)")
     print("")
 
 

{seleniumbase-4.50.3 → seleniumbase-4.50.4}/seleniumbase/console_scripts/sb_install.py

@@ -2,20 +2,25 @@
 Downloads the specified webdriver to "seleniumbase/drivers/"
 
 Usage:
-    sbase get {chromedriver|geckodriver|edgedriver|
-               iedriver|uc_driver|cft|chs} [OPTIONS]
+    seleniumbase install [DRIVER/BINARY] [OPTIONS]
+    OR: seleniumbase get [DRIVER/BINARY] [OPTIONS]
+    OR:    sbase install [DRIVER/BINARY] [OPTIONS]
+    OR:        sbase get [DRIVER/BINARY] [OPTIONS]
+        (Drivers:  chromedriver, uc_driver,
+                   edgedriver, geckodriver)
+        (Binaries:   cft, chs, chromium)
 Options:
-    VERSION         Specify the version.
-                    Tries to detect the needed version.
-                    If using chromedriver or edgedriver,
-                    you can use the major version integer.
-    -p OR --path    Also copy the driver to /usr/local/bin
+         VERSION  Driver/binary version to download.
+                   (Otherwise detects the version)
+      --revision  The Chromium revision to download.
+                   (Otherwise downloads the latest)
+    -p OR --path  Also copy driver to /usr/local/bin
 Examples:
     sbase get chromedriver
     sbase get geckodriver
     sbase get edgedriver
     sbase get chromedriver 149
-    sbase get chromedriver 149.0.7827.115
+    sbase get chromedriver 149.0.7827.155
     sbase get chromedriver stable
     sbase get chromedriver beta
     sbase get chromedriver -p
@@ -24,10 +29,12 @@ Examples:
     sbase get cft 149
     sbase get chs
 Output:
-    Downloads the webdriver to seleniumbase/drivers/
-    (chromedriver is required for Chrome automation)
-    (geckodriver is required for Firefox automation)
-    (edgedriver is required for MS__Edge automation)
+    Downloads driver/binary to seleniumbase/drivers/
+    (chromedriver is for Selenium Chrome automation)
+    (geckodriver is for Selenium Firefox automation)
+    (edgedriver is for Selenium MS__Edge automation)
+    (cft is for the `Chrome for Testing` binary exe)
+    (chs is for the `Chrome-Headless-Shell` binary.)
 """
 import colorama
 import logging
@@ -71,38 +78,40 @@ DEFAULT_EDGEDRIVER_VERSION = "115.0.1901.183"  # (If can't find LATEST_STABLE)
 
 def invalid_run_command():
     exp = "  ** get / install **\n\n"
-    exp += "  Usage:\n"
-    exp += "     seleniumbase install [DRIVER_NAME] [OPTIONS]\n"
-    exp += "     OR     sbase install [DRIVER_NAME] [OPTIONS]\n"
-    exp += "     OR  seleniumbase get [DRIVER_NAME] [OPTIONS]\n"
-    exp += "     OR         sbase get [DRIVER_NAME] [OPTIONS]\n"
-    exp += "         (Drivers: chromedriver, cft, uc_driver,\n"
-    exp += "                   edgedriver, chs, geckodriver)\n"
-    exp += "  Options:\n"
-    exp += "     VERSION    Specify the version.\n"
-    exp += "                Tries to detect the needed version.\n"
-    exp += "                If using chromedriver or edgedriver,\n"
-    exp += "                you can use the major version integer.\n"
-    exp += "\n"
-    exp += "     -p OR --path   Also copy the driver to /usr/local/bin\n"
-    exp += "  Examples:\n"
-    exp += "     sbase get chromedriver\n"
-    exp += "     sbase get geckodriver\n"
-    exp += "     sbase get edgedriver\n"
-    exp += "     sbase get chromedriver 114\n"
-    exp += "     sbase get chromedriver 114.0.5735.90\n"
-    exp += "     sbase get chromedriver stable\n"
-    exp += "     sbase get chromedriver beta\n"
-    exp += "     sbase get chromedriver -p\n"
-    exp += "     sbase get cft 131\n"
-    exp += "     sbase get chs\n"
-    exp += "  Output:\n"
-    exp += "     Downloads the webdriver to seleniumbase/drivers/\n"
-    exp += "     (chromedriver is required for Chrome automation)\n"
-    exp += "     (geckodriver is required for Firefox automation)\n"
-    exp += "     (edgedriver is required for MS__Edge automation)\n"
-    exp += "     (cft is for the `Chrome for Testing` binary exe)\n"
-    exp += "     (chs is for the `Chrome-Headless-Shell` binary.)\n"
+    exp += "Usage:\n"
+    exp += "    seleniumbase install [DRIVER/BINARY] [OPTIONS]\n"
+    exp += "    OR     sbase install [DRIVER/BINARY] [OPTIONS]\n"
+    exp += "    OR  seleniumbase get [DRIVER/BINARY] [OPTIONS]\n"
+    exp += "    OR         sbase get [DRIVER/BINARY] [OPTIONS]\n"
+    exp += "        (Drivers:  chromedriver, uc_driver,\n"
+    exp += "                   edgedriver, geckodriver)\n"
+    exp += "        (Binaries:   cft, chs, chromium)\n"
+    exp += "Options:\n"
+    exp += "         VERSION  Driver/binary version to download.\n"
+    exp += "                   (Otherwise detects the version)\n"
+    exp += "      --revision  The Chromium revision to download.\n"
+    exp += "                   (Otherwise downloads the latest)\n"
+    exp += "    -p OR --path  Also copy driver to /usr/local/bin\n"
+    exp += "Examples:\n"
+    exp += "    sbase get chromedriver\n"
+    exp += "    sbase get geckodriver\n"
+    exp += "    sbase get edgedriver\n"
+    exp += "    sbase get chromedriver 149\n"
+    exp += "    sbase get chromedriver 149.0.7827.155\n"
+    exp += "    sbase get chromedriver stable\n"
+    exp += "    sbase get chromedriver beta\n"
+    exp += "    sbase get chromedriver -p\n"
+    exp += "    sbase get chromium\n"
+    exp += "    sbase get chromium --revision=1639046\n"
+    exp += "    sbase get cft 149\n"
+    exp += "    sbase get chs\n"
+    exp += "Output:\n"
+    exp += "    Downloads driver/binary to seleniumbase/drivers/\n"
+    exp += "    (chromedriver is for Selenium Chrome automation)\n"
+    exp += "    (geckodriver is for Selenium Firefox automation)\n"
+    exp += "    (edgedriver is for Selenium MS__Edge automation)\n"
+    exp += "    (cft is for the `Chrome for Testing` binary exe)\n"
+    exp += "    (chs is for the `Chrome-Headless-Shell` binary.)\n"
     print("")
     raise Exception("%s\n\n%s" % (constants.Warnings.INVALID_RUN_COMMAND, exp))
 
@@ -139,6 +148,8 @@ def get_proxy_info():
                     protocol = "https"
                 elif "socks4" in proxy_string:
                     protocol = "socks4"
+                elif "socks5h" in proxy_string:
+                    protocol = "socks5h"
                 elif "socks5" in proxy_string:
                     protocol = "socks5"
                 proxy_string = proxy_helper.validate_proxy_string(proxy_string)

{seleniumbase-4.50.3 → seleniumbase-4.50.4}/seleniumbase/core/browser_launcher.py

@@ -340,6 +340,8 @@ def requests_get(url, proxy_string=None):
             protocol = "https"
         elif "socks4" in proxy_string:
             protocol = "socks4"
+        elif "socks5h" in proxy_string:
+            protocol = "socks5h"
         elif "socks5" in proxy_string:
             protocol = "socks5"
         proxies = {protocol: proxy_string}
@@ -2901,7 +2903,9 @@ def _set_firefox_options(
         socks_ver = 0
         chunks = proxy_string.split(":")
         if len(chunks) == 3 and (
-            chunks[0] == "socks4" or chunks[0] == "socks5"
+            chunks[0] == "socks4"
+            or chunks[0] == "socks5"
+            or chunks[0] == "socks5h"
         ):
             socks_proxy = True
             socks_ver = int(chunks[0][5])

{seleniumbase-4.50.3 → seleniumbase-4.50.4}/seleniumbase/core/proxy_helper.py

@@ -177,6 +177,8 @@ def validate_proxy_string(proxy_string, keep_scheme=False):
         proxy_scheme = "https"
     elif proxy_string.startswith("socks4://"):
         proxy_scheme = "socks4"
+    elif proxy_string.startswith("socks5h://"):
+        proxy_scheme = "socks5h"
     elif proxy_string.startswith("socks5://"):
         proxy_scheme = "socks5"
     valid = False
@@ -189,8 +191,10 @@ def validate_proxy_string(proxy_string, keep_scheme=False):
         elif proxy_string.startswith("https://"):
             proxy_string = proxy_string.split("https://")[1]
         elif "://" in proxy_string:
-            if not proxy_string.startswith("socks4://") and not (
-                proxy_string.startswith("socks5://")
+            if (
+                not proxy_string.startswith("socks4://")
+                and not proxy_string.startswith("socks5://")
+                and not proxy_string.startswith("socks5h://")
             ):
                 proxy_string = proxy_string.split("://")[1]
         chunks = proxy_string.split(":")
@@ -201,13 +205,9 @@ def validate_proxy_string(proxy_string, keep_scheme=False):
         elif len(chunks) == 3:
             if re.match(r"^\d+$", chunks[2]):
                 if page_utils.is_valid_url("http:" + ":".join(chunks[1:])):
-                    if chunks[0] == "http":
-                        valid = True
-                    elif chunks[0] == "https":
-                        valid = True
-                    elif chunks[0] == "socks4":
-                        valid = True
-                    elif chunks[0] == "socks5":
+                    if chunks[0] in [
+                        "http", "https", "socks4", "socks5", "socks5h"
+                    ]:
                         valid = True
     else:
         proxy_string = val_ip.group()

{seleniumbase-4.50.3 → seleniumbase-4.50.4}/seleniumbase/fixtures/base_case.py

@@ -7776,15 +7776,30 @@ class BaseCase(unittest.TestCase):
         file_path = None
         if page_utils.is_valid_url(pdf):
             downloads_folder = download_helper.get_downloads_folder()
-            if nav:
-                if self.get_current_url() != pdf:
-                    self.open(pdf)
             file_name = pdf.split("/")[-1]
             file_path = os.path.join(downloads_folder, file_name)
-            if not os.path.exists(file_path):
-                self.download_file(pdf)
-            elif override:
-                self.download_file(pdf)
+            if nav and not self.external_pdf:
+                self.open(pdf)
+            if (self.undetectable and self.external_pdf):
+                just_opened = False
+                if (
+                    self.get_current_url() != pdf
+                    and not os.path.exists(
+                        os.path.join(downloads_folder, file_name)
+                    )
+                ):
+                    just_opened = True
+                    self.open(pdf)
+                if self.external_pdf:
+                    self.assert_downloaded_file(file_name, timeout=10)
+                elif self.undetectable and just_opened:
+                    self.sleep(3)
+                    self.save_as_pdf(file_name, folder=downloads_folder)
+                else:
+                    self.save_as_pdf(file_name, folder=downloads_folder)
+            else:
+                if not os.path.exists(file_path) or override:
+                    self.download_file(pdf)
         else:
             if not os.path.exists(pdf):
                 raise Exception("%s is not a valid URL or file path!" % pdf)

{seleniumbase-4.50.3 → seleniumbase-4.50.4}/seleniumbase/undetected/cdp_driver/tab.py

@@ -27,27 +27,25 @@ logger = logging.getLogger(__name__)
 
 class Tab(Connection):
     """
-    :ref:`tab` is the controlling mechanism/connection to a 'target',
-    for most of us 'target' can be read as 'tab'. However it could also
-    be an iframe, serviceworker or background script for example,
-    although there isn't much to control for those.
-    If you open a new window by using
-        :py:meth:`browser.get(..., new_window=True)`
-    Your url will open a new window. This window is a 'tab'.
+    :ref:`tab` is the controlling mechanism/connection to a `target`.
+    The `target` can be read as a `tab`, however, it could also
+    be an iframe, a serviceworker, or a background script (for example).
+    If you open a new window by using `browser.get(..., new_window=True)`,
+    your URL will open a new window. This window is a `tab`.
     When you browse to another page, the tab will be the same (browser view).
-    It's important to keep some reference to tab objects, in case you're
+    It's important to keep some reference to tab objects in case you're
     done interacting with elements and want to operate on the page level again.
 
     Custom CDP commands
     ---------------------------
     Tab object provide many useful and often-used methods. It is also possible
-    to utilize the included cdp classes to to something totally custom.
+    to utilize the included CDP classes to to something totally custom.
 
-    The cdp package is a set of so-called "domains" with each having methods,
+    The CDP package is a set of so-called "domains" with each having methods,
     events and types.
-    To send a cdp method, for example :py:obj:`cdp.page.navigate`,
-    you'll have to check whether the method accepts any parameters
-    and whether they are required or not.
+    To send a CDP method, for example `cdp.page.navigate`,
+    you'll have to check whether the method accepts any
+    parameters and whether they are required or not.
 
     You can use:
 
@@ -936,7 +934,7 @@ class Tab(Connection):
         return await self.set_window_state(state="minimize")
 
     async def fullscreen(self):
-        """Minimize page/tab/window"""
+        """Fullscreen page/tab/window"""
         return await self.set_window_state(state="fullscreen")
 
     async def medimize(self):

{seleniumbase-4.50.3 → seleniumbase-4.50.4/seleniumbase.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.50.3
+Version: 4.50.4
 Summary: SeleniumBase is a framework for web crawling, scraping, and testing. Supports pytest. CDP Mode adds stealth. Includes many tools.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -167,7 +167,7 @@ Requires-Dist: proxy.py==2.4.3; extra == "proxy"
 Provides-Extra: playwright
 Requires-Dist: playwright>=1.60.0; extra == "playwright"
 Requires-Dist: greenlet>=3.2.5; python_version < "3.10" and extra == "playwright"
-Requires-Dist: greenlet>=3.5.1; python_version >= "3.10" and extra == "playwright"
+Requires-Dist: greenlet>=3.5.3; python_version >= "3.10" and extra == "playwright"
 Provides-Extra: pyautogui
 Requires-Dist: PyAutoGUI>=0.9.54; platform_system != "Linux" and extra == "pyautogui"
 Dynamic: author
@@ -949,6 +949,7 @@ pytest test_coffee_cart.py --trace
 --brave  # (Shortcut for "--browser=brave".)
 --comet  # (Shortcut for "--browser=comet".)
 --atlas  # (Shortcut for "--browser=atlas".)
+--chromium  # (Shortcut for using base `Chromium`)
 --settings-file=FILE  # (Override default SeleniumBase settings.)
 --env=ENV  # (Set the test env. Access with "self.env" in tests.)
 --account=STR  # (Set account. Access with "self.account" in tests.)

{seleniumbase-4.50.3 → seleniumbase-4.50.4}/seleniumbase.egg-info/requires.txt

@@ -142,7 +142,7 @@ playwright>=1.60.0
 greenlet>=3.2.5
 
 [playwright:python_version >= "3.10"]
-greenlet>=3.5.1
+greenlet>=3.5.3
 
 [proxy]
 proxy.py==2.4.3

{seleniumbase-4.50.3 → seleniumbase-4.50.4}/setup.py

@@ -301,7 +301,7 @@ setup(
         "playwright": [
             'playwright>=1.60.0',
             'greenlet>=3.2.5;python_version<"3.10"',
-            'greenlet>=3.5.1;python_version>="3.10"',
+            'greenlet>=3.5.3;python_version>="3.10"',
         ],
         # pip install -e .[pyautogui]
         # (Already a required dependency on Linux now.)