seleniumbase 4.24.10__py3-none-any.whl → 4.33.15__py3-none-any.whl

seleniumbase/plugins/selenium_plugin.py

@@ -1,5 +1,6 @@
 """Selenium Plugin for SeleniumBase tests that run with pynose / nosetests"""
 import sys
+from contextlib import suppress
 from nose.plugins import Plugin
 from seleniumbase import config as sb_config
 from seleniumbase.config import settings
@@ -40,11 +41,14 @@ class SeleniumBrowser(Plugin):
     --binary-location=PATH  (Set path of the Chromium browser binary to use.)
     --driver-version=VER  (Set the chromedriver or uc_driver version to use.)
     --sjw  (Skip JS Waits for readyState to be "complete" or Angular to load.)
+    --wfa  (Wait for AngularJS to be done loading after specific web actions.)
     --pls=PLS  (Set pageLoadStrategy on Chrome: "normal", "eager", or "none".)
-    --headless  (Run tests in headless mode. The default arg on Linux OS.)
-    --headless2  (Use the new headless mode, which supports extensions.)
+    --headless  (The default headless mode. Linux uses this mode by default.)
+    --headless1  (Use Chrome's old headless mode. Fast, but has limitations.)
+    --headless2  (Use Chrome's new headless mode, which supports extensions.)
     --headed  (Run tests in headed/GUI mode on Linux OS, where not default.)
     --xvfb  (Run tests using the Xvfb virtual display server on Linux OS.)
+    --xvfb-metrics=STRING  (Set Xvfb display size on Linux: "Width,Height".)
     --locale=LOCALE_CODE  (Set the Language Locale Code for the web browser.)
     --interval=SECONDS  (The autoplay interval for presentations & tour steps)
     --start-page=URL  (The starting URL for the web browser when tests begin.)
@@ -60,10 +64,12 @@ class SeleniumBrowser(Plugin):
     --block-images  (Block images from loading during tests.)
     --do-not-track  (Indicate to websites that you don't want to be tracked.)
     --verify-delay=SECONDS  (The delay before MasterQA verification checks.)
+    --ee / --esc-end  (Lets the user end the current test via the ESC key.)
     --recorder  (Enables the Recorder for turning browser actions into code.)
     --rec-behave  (Same as Recorder Mode, but also generates behave-gherkin.)
     --rec-sleep  (If the Recorder is enabled, also records self.sleep calls.)
     --rec-print  (If the Recorder is enabled, prints output after tests end.)
+    --disable-cookies  (Disable Cookies on websites. Pages might break!)
     --disable-js  (Disable JavaScript on websites. Pages might break!)
     --disable-csp  (Disable the Content Security Policy of websites.)
     --disable-ws  (Disable Web Security on Chromium-based browsers.)
@@ -80,6 +86,7 @@ class SeleniumBrowser(Plugin):
     --dark  (Enable Chrome's Dark mode.)
     --devtools  (Open Chrome's DevTools when the browser opens.)
     --disable-beforeunload  (Disable the "beforeunload" event on Chrome.)
+    --window-position=X,Y  (Set the browser's starting window position.)
     --window-size=WIDTH,HEIGHT  (Set the browser's starting window size.)
     --maximize  (Start tests with the browser window maximized.)
     --screenshot  (Save a screenshot at the end of each test.)
@@ -177,6 +184,17 @@ class SeleniumBrowser(Plugin):
                     and wait_for_angularjs(), which are part of many
                     SeleniumBase methods for improving reliability.""",
         )
+        parser.addoption(
+            "--wfa",
+            "--wait_for_angularjs",
+            "--wait-for-angularjs",
+            action="store_true",
+            dest="wait_for_angularjs",
+            default=False,
+            help="""Add waiting for AngularJS. (The default setting
+                    was changed to no longer wait for AngularJS to
+                    finish loading as an extra JavaScript call.)""",
+        )
         parser.addoption(
             "--protocol",
             action="store",
@@ -421,6 +439,15 @@ class SeleniumBrowser(Plugin):
                 UNLESS using a virtual display with Xvfb.
                 Default: False on Mac/Windows. True on Linux.""",
         )
+        parser.addoption(
+            "--headless1",
+            action="store_true",
+            dest="headless1",
+            default=False,
+            help="""This option activates the old headless mode,
+                    which is faster, but has limitations.
+                    (May be phased out by Chrome in the future.)""",
+        )
         parser.addoption(
             "--headless2",
             action="store_true",
@@ -452,6 +479,17 @@ class SeleniumBrowser(Plugin):
                     will no longer be enabled by default on Linux.
                     Default: False. (Linux-ONLY!)""",
         )
+        parser.addoption(
+            "--xvfb-metrics",
+            "--xvfb_metrics",
+            action="store",
+            dest="xvfb_metrics",
+            default=None,
+            help="""Customize the Xvfb metrics (Width,Height) on Linux.
+                    Format: A comma-separated string with the 2 values.
+                    Examples: "1920,1080" or "1366,768" or "1024,768".
+                    Default: None. (None: "1366,768". Min: "1024,768".)""",
+        )
         parser.addoption(
             "--locale_code",
             "--locale-code",
@@ -613,6 +651,16 @@ class SeleniumBrowser(Plugin):
             help="""Setting this overrides the default wait time
                     before each MasterQA verification pop-up.""",
         )
+        parser.addoption(
+            "--esc-end",
+            "--esc_end",
+            "--ee",
+            action="store_true",
+            dest="esc_end",
+            default=False,
+            help="""End the current test early via the ESC key.
+                    The test will be marked as skipped.""",
+        )
         parser.addoption(
             "--recorder",
             "--record",
@@ -663,6 +711,15 @@ class SeleniumBrowser(Plugin):
             help="""The option to disable JavaScript on web pages.
                     Warning: Most web pages will stop working!""",
         )
+        parser.addoption(
+            "--disable_cookies",
+            "--disable-cookies",
+            action="store_true",
+            dest="disable_cookies",
+            default=False,
+            help="""The option to disable Cookies on web pages.
+                    Warning: Several pages may stop working!""",
+        )
         parser.addoption(
             "--disable_csp",
             "--disable-csp",
@@ -682,6 +739,7 @@ class SeleniumBrowser(Plugin):
         parser.addoption(
             "--disable_ws",
             "--disable-ws",
+            "--dws",
             "--disable-web-security",
             action="store_true",
             dest="disable_ws",
@@ -863,6 +921,17 @@ class SeleniumBrowser(Plugin):
                     on Chromium browsers (Chrome or Edge).
                     This is already the default Firefox option.""",
         )
+        parser.addoption(
+            "--window-position",
+            "--window_position",
+            action="store",
+            dest="window_position",
+            default=None,
+            help="""The option to set the starting window x,y position.
+                    Format: A comma-separated string with the 2 values.
+                    Example: "55,66"
+                    Default: None. (Will use default values if None)""",
+        )
         parser.addoption(
             "--window-size",
             "--window_size",
@@ -961,6 +1030,7 @@ class SeleniumBrowser(Plugin):
         browser = self.options.browser
         test.test.browser = browser
         test.test.headless = None
+        test.test.headless1 = None
         test.test.headless2 = None
         # As a shortcut, you can use "--edge" instead of "--browser=edge", etc,
         # but you can only specify one default browser. (Default: chrome)
@@ -1037,6 +1107,29 @@ class SeleniumBrowser(Plugin):
                 '\n  (Your browser choice was: "%s")\n' % browser
             )
             raise Exception(message)
+        window_position = self.options.window_position
+        if 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
         window_size = self.options.window_size
         if window_size:
             if window_size.count(",") != 1:
@@ -1076,9 +1169,13 @@ class SeleniumBrowser(Plugin):
         test.test.cap_file = self.options.cap_file
         test.test.cap_string = self.options.cap_string
         test.test.headless = self.options.headless
+        test.test.headless1 = self.options.headless1
+        if test.test.headless1:
+            test.test.headless = True
         test.test.headless2 = self.options.headless2
         if test.test.headless and test.test.browser == "safari":
             test.test.headless = False  # Safari doesn't use headless
+            test.test.headless1 = False
         if test.test.headless2 and test.test.browser == "firefox":
             test.test.headless2 = False  # Only for Chromium browsers
             test.test.headless = True  # Firefox has regular headless
@@ -1089,11 +1186,14 @@ class SeleniumBrowser(Plugin):
             self.options.headless2 = False
         test.test.headed = self.options.headed
         test.test.xvfb = self.options.xvfb
+        test.test.xvfb_metrics = self.options.xvfb_metrics
         test.test.locale_code = self.options.locale_code
         test.test.interval = self.options.interval
         test.test.start_page = self.options.start_page
         if self.options.skip_js_waits:
             settings.SKIP_JS_WAITS = True
+        if self.options.wait_for_angularjs:
+            settings.WAIT_FOR_ANGULARJS = True
         test.test.protocol = self.options.protocol
         test.test.servername = self.options.servername
         test.test.port = self.options.port
@@ -1126,6 +1226,7 @@ class SeleniumBrowser(Plugin):
         test.test.block_images = self.options.block_images
         test.test.do_not_track = self.options.do_not_track
         test.test.verify_delay = self.options.verify_delay  # MasterQA
+        test.test.esc_end = self.options.esc_end
         test.test.recorder_mode = self.options.recorder_mode
         test.test.recorder_ext = self.options.recorder_mode  # Again
         test.test.rec_behave = self.options.rec_behave
@@ -1140,6 +1241,7 @@ class SeleniumBrowser(Plugin):
         elif self.options.record_sleep:
             test.test.recorder_mode = True
             test.test.recorder_ext = True
+        test.test.disable_cookies = self.options.disable_cookies
         test.test.disable_js = self.options.disable_js
         test.test.disable_csp = self.options.disable_csp
         test.test.disable_ws = self.options.disable_ws
@@ -1166,6 +1268,7 @@ class SeleniumBrowser(Plugin):
         test.test.dark_mode = self.options.dark_mode
         test.test.devtools = self.options.devtools
         test.test._disable_beforeunload = self.options._disable_beforeunload
+        test.test.window_position = self.options.window_position
         test.test.window_size = self.options.window_size
         test.test.maximize_option = self.options.maximize_option
         if self.options.save_screenshot and self.options.no_screenshot:
@@ -1192,15 +1295,19 @@ class SeleniumBrowser(Plugin):
             and not self.options.headless2
             and not self.options.xvfb
         ):
-            print(
-                "(Linux uses --headless by default. "
-                "To override, use --headed / --gui. "
-                "For Xvfb mode instead, use --xvfb. "
-                "Or you can hide this info by using "
-                "--headless / --headless2.)"
-            )
-            self.options.headless = True
-            test.test.headless = True
+            if not self.options.undetectable:
+                print(
+                    "(Linux uses --headless by default. "
+                    "To override, use --headed / --gui. "
+                    "For Xvfb mode instead, use --xvfb. "
+                    "Or you can hide this info by using "
+                    "--headless / --headless2 / --uc.)"
+                )
+                self.options.headless = True
+                test.test.headless = True
+            else:
+                self.options.xvfb = True
+                test.test.xvfb = True
         if self.options.use_wire and self.options.undetectable:
             print(
                 "\n"
@@ -1214,8 +1321,10 @@ class SeleniumBrowser(Plugin):
         # Recorder Mode can still optimize scripts in --headless2 mode.
         if self.options.recorder_mode and self.options.headless:
             self.options.headless = False
+            self.options.headless1 = False
             self.options.headless2 = True
             test.test.headless = False
+            test.test.headless1 = False
             test.test.headless2 = True
         if not self.options.headless and not self.options.headless2:
             self.options.headed = True
@@ -1229,7 +1338,7 @@ class SeleniumBrowser(Plugin):
         ):
             width = settings.HEADLESS_START_WIDTH
             height = settings.HEADLESS_START_HEIGHT
-            try:
+            with suppress(Exception):
                 from sbvirtualdisplay import Display
 
                 self._xvfb_display = Display(visible=0, size=(width, height))
@@ -1237,8 +1346,6 @@ class SeleniumBrowser(Plugin):
                 sb_config._virtual_display = self._xvfb_display
                 self.headless_active = True
                 sb_config.headless_active = True
-            except Exception:
-                pass
         sb_config._is_timeout_changed = False
         sb_config._SMALL_TIMEOUT = settings.SMALL_TIMEOUT
         sb_config._LARGE_TIMEOUT = settings.LARGE_TIMEOUT
@@ -1271,7 +1378,7 @@ class SeleniumBrowser(Plugin):
             pass
         except Exception:
             pass
-        try:
+        with suppress(Exception):
             if (
                 hasattr(self, "_xvfb_display")
                 and self._xvfb_display
@@ -1288,5 +1395,3 @@ class SeleniumBrowser(Plugin):
             ):
                 sb_config._virtual_display.stop()
                 sb_config._virtual_display = None
-        except Exception:
-            pass

seleniumbase/translate/translator.py

@@ -267,13 +267,6 @@ def process_test_file(code_lines, new_lang):
 
 
 def main():
-    if (
-        "win32" in sys.platform
-        and hasattr(colorama, "just_fix_windows_console")
-    ):
-        colorama.just_fix_windows_console()
-    else:
-        colorama.init(autoreset=True)
     c1 = colorama.Fore.BLUE + colorama.Back.LIGHTCYAN_EX
     c2 = colorama.Fore.BLUE + colorama.Back.LIGHTYELLOW_EX
     c3 = colorama.Fore.RED + colorama.Back.LIGHTGREEN_EX

seleniumbase/undetected/__init__.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
 import logging
 import os
 import re
@@ -10,6 +9,7 @@ import selenium.webdriver.chrome.service
 import selenium.webdriver.chrome.webdriver
 import selenium.webdriver.common.service
 import selenium.webdriver.remote.command
+from contextlib import suppress
 from .cdp import CDP
 from .cdp import PageElement
 from .dprocess import start_detached
@@ -132,8 +132,11 @@ class Chrome(selenium.webdriver.chrome.webdriver.WebDriver):
             options = ChromeOptions()
         try:
             if hasattr(options, "_session") and options._session is not None:
-                # Prevent reuse of options
-                raise RuntimeError("You cannot reuse the ChromeOptions object")
+                # Prevent reuse of options.
+                # (Probably a port overlap. Quit existing driver and continue.)
+                logger.debug("You cannot reuse the ChromeOptions object")
+                with suppress(Exception):
+                    options._session.quit()
         except AttributeError:
             pass
         options._session = self
@@ -201,11 +204,9 @@ class Chrome(selenium.webdriver.chrome.webdriver.WebDriver):
                 # Create a temporary folder for the user-data profile.
                 options.add_argument(arg)
         if not language:
-            try:
+            with suppress(Exception):
                 import locale
                 language = locale.getlocale()[0].replace("_", "-")
-            except Exception:
-                pass
             if (
                 not language
                 or "English" in language
@@ -234,6 +235,7 @@ class Chrome(selenium.webdriver.chrome.webdriver.WebDriver):
                     "--no-first-run",
                     "--no-service-autorun",
                     "--password-store=basic",
+                    "--profile-directory=Default",
                 ]
             )
         options.add_argument(
@@ -242,7 +244,7 @@ class Chrome(selenium.webdriver.chrome.webdriver.WebDriver):
         )
         if hasattr(options, 'handle_prefs'):
             options.handle_prefs(user_data_dir)
-        try:
+        with suppress(Exception):
             import json
             with open(
                 os.path.join(
@@ -263,8 +265,6 @@ class Chrome(selenium.webdriver.chrome.webdriver.WebDriver):
                 fs.seek(0, 0)
                 fs.truncate()
                 json.dump(config, fs)
-        except Exception:
-            pass
         creationflags = 0
         if "win32" in sys.platform:
             creationflags = subprocess.CREATE_NO_WINDOW
@@ -278,19 +278,21 @@ class Chrome(selenium.webdriver.chrome.webdriver.WebDriver):
                     options.binary_location, *options.arguments
                 )
             else:
-                browser = subprocess.Popen(
-                    [options.binary_location, *options.arguments],
-                    stdin=subprocess.PIPE,
-                    stdout=subprocess.PIPE,
-                    stderr=subprocess.PIPE,
-                    close_fds=IS_POSIX,
-                    creationflags=creationflags,
+                gui_lock = fasteners.InterProcessLock(
+                    constants.MultiBrowser.PYAUTOGUILOCK
                 )
-                self.browser_pid = browser.pid
+                with gui_lock:
+                    browser = subprocess.Popen(
+                        [options.binary_location, *options.arguments],
+                        stdin=subprocess.PIPE,
+                        stdout=subprocess.PIPE,
+                        stderr=subprocess.PIPE,
+                        close_fds=IS_POSIX,
+                        creationflags=creationflags,
+                    )
+                    self.browser_pid = browser.pid
             service_ = None
             log_output = subprocess.PIPE
-            if sys.version_info < (3, 8):
-                log_output = os.devnull
             if patch_driver:
                 service_ = selenium.webdriver.chrome.service.Service(
                     executable_path=self.patcher.executable_path,
@@ -338,7 +340,7 @@ class Chrome(selenium.webdriver.chrome.webdriver.WebDriver):
 
     def _get_cdc_props(self):
         cdc_props = []
-        try:
+        with suppress(Exception):
             cdc_props = self.execute_script(
                 """
                 let objectToInspect = window,
@@ -351,8 +353,6 @@ class Chrome(selenium.webdriver.chrome.webdriver.WebDriver):
                 return result.filter(i => i.match(/^[a-z]{3}_[a-z]{22}_.*/i))
                 """
             )
-        except Exception:
-            pass
         return cdc_props
 
     def _hook_remove_cdc_props(self, cdc_props):
@@ -423,46 +423,57 @@ class Chrome(selenium.webdriver.chrome.webdriver.WebDriver):
         - Starts the chromedriver service that runs in the background.
         - Recreates the session."""
         if hasattr(self, "service"):
-            try:
-                self.service.stop()
-            except Exception:
-                pass
+            with suppress(Exception):
+                if self.service.is_connectable():
+                    self.stop_client()
+                    self.service.stop()
             if isinstance(timeout, str):
                 if timeout.lower() == "breakpoint":
                     breakpoint()  # To continue:
                     pass  # Type "c" & press ENTER!
             else:
                 time.sleep(timeout)
-            try:
+            with suppress(Exception):
                 self.service.start()
-            except Exception:
-                pass
-        try:
+        with suppress(Exception):
             self.start_session()
-        except Exception:
-            pass
+        with suppress(Exception):
+            if self.current_url.startswith("chrome-extension://"):
+                self.close()
+                if self.service.is_connectable():
+                    self.stop_client()
+                    self.service.stop()
+                self.service.start()
+                self.start_session()
+        self._is_connected = True
 
     def disconnect(self):
         """Stops the chromedriver service that runs in the background.
         To use driver methods again, you MUST call driver.connect()"""
         if hasattr(self, "service"):
-            try:
-                self.service.stop()
-            except Exception:
-                pass
+            with suppress(Exception):
+                if self.service.is_connectable():
+                    self.stop_client()
+                    self.service.stop()
+        self._is_connected = False
 
     def connect(self):
         """Starts the chromedriver service that runs in the background
         and recreates the session."""
         if hasattr(self, "service"):
-            try:
+            with suppress(Exception):
                 self.service.start()
-            except Exception:
-                pass
-        try:
+        with suppress(Exception):
             self.start_session()
-        except Exception:
-            pass
+        with suppress(Exception):
+            if self.current_url.startswith("chrome-extension://"):
+                self.close()
+                if self.service.is_connectable():
+                    self.stop_client()
+                    self.service.stop()
+                self.service.start()
+                self.start_session()
+        self._is_connected = True
 
     def start_session(self, capabilities=None):
         if not capabilities:
@@ -486,13 +497,13 @@ class Chrome(selenium.webdriver.chrome.webdriver.WebDriver):
             pass
         if hasattr(self, "service") and getattr(self.service, "process", None):
             logger.debug("Stopping webdriver service")
-            self.service.stop()
-        try:
+            with suppress(Exception):
+                self.stop_client()
+                self.service.stop()
+        with suppress(Exception):
             if self.reactor and isinstance(self.reactor, Reactor):
                 logger.debug("Shutting down Reactor")
                 self.reactor.event.set()
-        except Exception:
-            pass
         if (
             hasattr(self, "keep_user_data_dir")
             and hasattr(self, "user_data_dir")
@@ -521,18 +532,14 @@ class Chrome(selenium.webdriver.chrome.webdriver.WebDriver):
         self.patcher = None
 
     def __del__(self):
-        try:
+        with suppress(Exception):
             if "win32" in sys.platform:
                 self.stop_client()
                 self.command_executor.close()
             else:
                 super().quit()
-        except Exception:
-            pass
-        try:
+        with suppress(Exception):
             self.quit()
-        except Exception:
-            pass
 
     def __enter__(self):
         return self

seleniumbase/undetected/cdp.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
 import fasteners
 import json
 import logging

seleniumbase/undetected/cdp_driver/__init__.py

@@ -0,0 +1 @@
+from seleniumbase.undetected.cdp_driver import cdp_util  # noqa

seleniumbase/undetected/cdp_driver/_contradict.py

@@ -0,0 +1,110 @@
+import warnings as _warnings
+from collections.abc import Mapping as _Mapping, Sequence as _Sequence
+import logging
+
+__logger__ = logging.getLogger(__name__)
+__all__ = ["cdict", "ContraDict"]
+
+
+def cdict(*args, **kwargs):
+    """Factory function"""
+    return ContraDict(*args, **kwargs)
+
+
+class ContraDict(dict):
+    """
+    Directly inherited from dict.
+    Accessible by attribute. o.x == o['x']
+    This works also for all corner cases.
+    Native json.dumps and json.loads work with it.
+
+    Names like "keys", "update", "values" etc won't overwrite the methods,
+    but will just be available using dict lookup notation obj['items']
+    instead of obj.items.
+
+    All key names are converted to snake_case.
+    Hyphen's (-), dot's (.) or whitespaces are replaced by underscore (_).
+    Autocomplete works even if the objects comes from a list.
+    Recursive action. Dict assignments will be converted too.
+    """
+    __module__ = None
+
+    def __init__(self, *args, **kwargs):
+        super().__init__()
+        # silent = kwargs.pop("silent", False)
+        _ = dict(*args, **kwargs)
+
+        super().__setattr__("__dict__", self)
+        for k, v in _.items():
+            _check_key(k, self, False, True)
+            super().__setitem__(k, _wrap(self.__class__, v))
+
+    def __setitem__(self, key, value):
+        super().__setitem__(key, _wrap(self.__class__, value))
+
+    def __setattr__(self, key, value):
+        super().__setitem__(key, _wrap(self.__class__, value))
+
+    def __getattribute__(self, attribute):
+        if attribute in self:
+            return self[attribute]
+        if not _check_key(attribute, self, True, silent=True):
+            return getattr(super(), attribute)
+        return object.__getattribute__(self, attribute)
+
+
+def _wrap(cls, v):
+    if isinstance(v, _Mapping):
+        v = cls(v)
+    elif isinstance(v, _Sequence) and not isinstance(
+        v, (str, bytes, bytearray, set, tuple)
+    ):
+        v = list([_wrap(cls, x) for x in v])
+    return v
+
+
+_warning_names = (
+    "items",
+    "keys",
+    "values",
+    "update",
+    "clear",
+    "copy",
+    "fromkeys",
+    "get",
+    "items",
+    "keys",
+    "pop",
+    "popitem",
+    "setdefault",
+    "update",
+    "values",
+    "class",
+)
+
+_warning_names_message = """\n\
+    While creating a ContraDict object, a key offending key name '{0}'
+    has been found, which might behave unexpected.
+    You will only be able to look it up using key,
+    eg. myobject['{0}']. myobject.{0} will not work with that name."""
+
+
+def _check_key(
+    key: str, mapping: _Mapping, boolean: bool = False, silent=True
+):
+    """Checks `key` and warns if needed.
+    :param key:
+    :param boolean: return True or False instead of passthrough
+    """
+    e = None
+    if not isinstance(key, (str,)):
+        if boolean:
+            return True
+        return key
+    if key.lower() in _warning_names or any(_ in key for _ in ("-", ".")):
+        if not silent:
+            _warnings.warn(_warning_names_message.format(key))
+        e = True
+    if not boolean:
+        return key
+    return not e