pybiolib 0.2.951__py3-none-any.whl → 1.2.1890__py3-none-any.whl

biolib/pyppeteer/pyppeteer/launcher.py

@@ -1,683 +0,0 @@
-import asyncio
-import atexit
-import json
-import logging
-import os
-import re
-import subprocess
-import sys
-import tempfile
-import time
-from contextlib import suppress
-from pathlib import Path
-from signal import SIG_DFL, SIGINT, SIGTERM, signal
-from typing import Any, Dict, List, Optional, Sequence, Set, Tuple, Union
-from urllib.error import URLError
-from urllib.request import urlopen
-
-from biolib.pyppeteer.pyppeteer import __chromium_revision__
-from biolib.pyppeteer.pyppeteer.browser import Browser
-from biolib.pyppeteer.pyppeteer.browser_fetcher import BrowserFetcher
-from biolib.pyppeteer.pyppeteer.connection import Connection
-from biolib.pyppeteer.pyppeteer.errors import BrowserError
-from biolib.pyppeteer.pyppeteer.models import BrowserOptions, ChromeArgOptions, LaunchOptions, Protocol
-from biolib.pyppeteer.pyppeteer.util import get_free_port
-from biolib.pyppeteer.pyppeteer.websocket_transport import WebsocketTransport
-
-if not sys.platform.startswith('win'):
-    from signal import SIGHUP
-
-if sys.version_info < (3, 8):
-    pass
-else:
-    pass
-
-logger = logging.getLogger(__name__)
-
-
-class BrowserRunner:
-    def __init__(
-        self, executable_path: str, process_args: Sequence[str], temp_dir: tempfile.TemporaryDirectory = None,
-    ):
-        self.executable_path = executable_path
-        self.process_args = process_args or []
-        self.temp_dir = temp_dir
-
-        self.proc: Optional[subprocess.Popen] = None
-        self.connection: Optional[Connection] = None
-
-        self._altered_sighandlers: Set[int] = set()
-        self._closed = True
-
-    def start(self, **kwargs: LaunchOptions) -> None:
-        process_opts = {}
-        if kwargs.get('pipe'):
-            raise NotImplementedError('Communication via pipe not supported')
-        if kwargs.get('env'):
-            process_opts['env'] = kwargs['env']
-
-        if not kwargs.get('dumpio'):
-            # we read stdout to check it for the ws endpoint
-            process_opts['stdout'] = subprocess.PIPE
-            process_opts['stderr'] = subprocess.STDOUT
-        else:
-            # todo: dumpio. See: https://pptr.dev/#?product=Puppeteer&version=v2.1.1&show=api-puppeteerlaunchoptions
-            # we need to tee proc stdout to both PIPE (so we can read it) and stdout (so users can see dumped IO)
-            # see these SO threads:
-            # https://stackoverflow.com/q/2996887/
-            # https://stackoverflow.com/q/17190221/
-            raise NotImplementedError(f'dumpio argument currently  not implemented')
-
-        assert self.proc is None, 'This process has previously been started'
-
-        logger.debug(f'Calling process: {self.executable_path} {" ".join(self.process_args)}')
-        self.proc = subprocess.Popen([str(self.executable_path), *self.process_args], **process_opts)
-        self._closed = False
-
-        # ignore args from signals
-        def close_proc_wrapper(*_: Any) -> None:
-            asyncio.get_event_loop().run_until_complete(self._close_proc())
-
-        if kwargs.get('autoClose'):
-            atexit.register(close_proc_wrapper)
-        if kwargs.get('handleSIGINT'):
-            signal(SIGINT, close_proc_wrapper)
-            self._altered_sighandlers.add(SIGINT)
-        if kwargs.get('handleSIGTERM'):
-            signal(SIGTERM, close_proc_wrapper)
-            self._altered_sighandlers.add(SIGTERM)
-        if kwargs.get('handleSIGHUP'):
-            # SIGHUP is not defined on windows
-            if not sys.platform.startswith('win'):
-                signal(SIGHUP, close_proc_wrapper)
-                self._altered_sighandlers.add(SIGHUP)
-            else:
-                logger.warning(f'SIGHUP is not available on win32')
-
-    async def _close_proc(self) -> None:
-        if not self._closed:
-            if self.connection and self.connection._connected:
-                await self.connection.send('Browser.close')
-                await self.connection.dispose()
-            if self.temp_dir:
-                self._wait_for_proc_to_close()
-                self.temp_dir.cleanup()
-
-    def _wait_for_proc_to_close(self) -> None:
-        if self.proc is not None and self.proc.poll() is None and not self._closed:
-            try:
-                self.proc.terminate()
-                self.proc.wait()
-            except Exception as e:
-                logger.warning(f'error occurred on proc close: {e}')
-
-    async def close(self) -> None:
-        if not self._closed:
-            self._restore_default_signal_handlers()
-            if self.temp_dir:
-                self.kill()
-            elif self.connection:
-                try:
-                    await self.connection.send('Browser.close')
-                except Exception as e:
-                    logger.error(f'An exception occurred: {e}')
-                    self.kill()
-        return await self._close_proc()
-
-    def kill(self) -> None:
-        if self.proc and not self._closed and self.proc.returncode is not None:
-            self._restore_default_signal_handlers()
-            try:
-                self.proc.kill()
-                if sys.platform.startswith('win'):
-                    subprocess.Popen(['taskkill', '/PID', str(self.proc.pid), '/F'], shell=True).communicate()
-
-            except Exception as e:
-                logger.warning(f'Exception occurred while killing process {e}')
-        try:
-            if self.temp_dir:
-                self.temp_dir.cleanup()
-        except Exception as e:
-            logger.warning(f'Failed to cleanup {self.temp_dir}: {e}')
-
-    def _restore_default_signal_handlers(self) -> None:
-        """
-        Restores the signals that were previously altered. This is contrary to
-        restoring all handlers, which panics in multithreaded applications
-        """
-        for signum in self._altered_sighandlers:
-            signal(signum, SIG_DFL)
-        self._altered_sighandlers = set()
-
-    async def setupConnection(
-        self, usePipe: bool = None, timeout: float = None, slowMo: float = 0, preferredRevision: str = None,
-    ) -> Connection:
-
-        if usePipe:
-            raise NotImplementedError('Communication via pipe not supported at this time')
-            # not currently support as we have no implementation for piping the stdout
-            # while also dumping to console
-            # may need to transition to asyncio.subprocess
-            # transport = PipeTransport(write_stream, read_stream)
-            # self.connection = Connection('', transport, delay=slowMo)
-        if self.proc is None:
-            raise RuntimeError('class process not initialized (self.proc = None)')
-        browser_ws_endpoint = waitForWSEndpoint(self.proc, timeout, preferredRevision)
-        transport = await WebsocketTransport.create(uri=browser_ws_endpoint)
-        self.connection = Connection(url=browser_ws_endpoint, transport=transport, delay=slowMo)
-        return self.connection
-
-
-class BaseBrowserLauncher:
-    """
-    Implements common BrowserLauncher operations
-    """
-
-    def __init__(self, projectRoot: Union[Path, str] = None, preferredRevision: str = None):
-        self.projectRoot = Path(projectRoot) if projectRoot else None
-        self.preferredRevision = preferredRevision
-
-    async def connect(
-        self,
-        browserWSEndpoint: str = None,
-        browserURL: str = None,
-        transport: WebsocketTransport = None,
-        ignoreHTTPSErrors: bool = False,
-        slowMo: float = 0,
-        defaultViewport: Protocol.Page.Viewport = None,
-    ) -> Browser:
-        if defaultViewport is None:
-            defaultViewport = {'width': 800, 'height': 600}
-
-        assert (
-            len([x for x in (browserWSEndpoint, browserURL, transport) if x]) == 1
-        ), 'exactly one of browserWSEndpoint, browserURL, and transport must be specified'
-
-        if transport:
-            connection = Connection('', transport, slowMo)
-        else:
-            if browserURL:
-                browserWSEndpoint = getWSEndpoint(browserURL)
-            transport = await WebsocketTransport.create(uri=browserWSEndpoint)
-            connection = Connection(browserWSEndpoint, transport=transport, delay=slowMo)
-
-        async def close_callback() -> None:
-            await connection.send('Browser.close')
-
-        context_ids = await connection.send('Target.getBrowserContexts')
-        return await Browser.create(
-            connection=connection,
-            contextIds=context_ids,
-            ignoreHTTPSErrors=ignoreHTTPSErrors,
-            defaultViewport=defaultViewport,
-            process=None,
-            closeCallback=close_callback,
-        )
-
-
-class ChromeLauncher(BaseBrowserLauncher):
-    DEFAULT_ARGS = [
-        '--disable-background-networking',
-        '--enable-features=NetworkService,NetworkServiceInProcess',
-        '--disable-background-timer-throttling',
-        '--disable-backgrounding-occluded-windows',
-        '--disable-breakpad',
-        '--disable-client-side-phishing-detection',
-        '--disable-component-extensions-with-background-pages',
-        '--disable-default-apps',
-        '--disable-dev-shm-usage',
-        '--disable-extensions',
-        '--disable-features=TranslateUI',
-        '--disable-hang-monitor',
-        '--disable-ipc-flooding-protection',
-        '--disable-popup-blocking',
-        '--disable-prompt-on-repost',
-        '--disable-renderer-backgrounding',
-        '--disable-sync',
-        '--force-color-profile=srgb',
-        '--metrics-recording-only',
-        '--no-first-run',
-        '--enable-automation',
-        '--password-store=basic',
-        '--use-mock-keychain',
-    ]
-    product = 'chrome'
-
-    def __init__(self, projectRoot: str = None, preferredRevision: str = None):
-        if not preferredRevision:
-            preferredRevision = __chromium_revision__
-        super().__init__(projectRoot, preferredRevision)
-
-    @property
-    def executable_path(self) -> Optional[str]:
-        return resolveExecutablePath(self.projectRoot, self.preferredRevision)[0]
-
-    async def launch(self, **kwargs: Union[LaunchOptions, ChromeArgOptions, BrowserOptions]) -> Browser:
-        ignoreDefaultArgs = kwargs.get('ignoreDefaultArgs', False)
-        args: Sequence[str] = kwargs.get('args', [])
-        dumpio = kwargs.get('dumpio', False)
-        executablePath = kwargs.get('executablePath', None)
-        env = kwargs.get('env', os.environ)
-        handleSIGINT = kwargs.get('handleSIGINT', True)
-        handleSIGTERM = kwargs.get('handleSIGTERM', True)
-        handleSIGHUP = kwargs.get('handleSIGHUP', not sys.platform.startswith('win'))
-        ignoreHTTPSErrors = kwargs.get('ignoreHTTPSErrors', False)
-        defaultViewport = kwargs.get('defaultViewport', {'width': 800, 'height': 600})
-        slowMo = kwargs.get('slowMo', 0)
-        timeout = kwargs.get('timeout', 30_000)
-        profile_path = None
-
-        chrome_args = []
-        if not ignoreDefaultArgs:
-            chrome_args.extend(self.default_args(**kwargs))
-        elif isinstance(ignoreDefaultArgs, list):
-            chrome_args.extend([x for x in self.default_args(**kwargs) if x not in ignoreDefaultArgs])
-        else:
-            chrome_args.extend(args)
-
-        if not any(x.startswith('--remote-debugging-') for x in chrome_args):
-            chrome_args.append(f'--remote-debugging-port={get_free_port()}')
-        if not any(x.startswith(f'--user-data-dir') for x in chrome_args):
-            profile_path = tempfile.TemporaryDirectory(prefix='pyppeteer_chrome_profile_')
-            chrome_args.append(f'--user-data-dir={profile_path.name}')
-
-        if not executablePath:
-            chrome_executable, missing_text = resolveExecutablePath(self.projectRoot, self.preferredRevision)
-            if missing_text:
-                raise RuntimeError(missing_text)
-        else:
-            chrome_executable = executablePath
-
-        usePipe = '--remote-debugging-pipe' in chrome_args
-
-        runner = BrowserRunner(chrome_executable, chrome_args, profile_path)
-        runner.start(
-            handleSIGINT=handleSIGINT, handleSIGHUP=handleSIGHUP, handleSIGTERM=handleSIGTERM, env=env, dumpio=dumpio, autoClose=kwargs.get('autoClose')
-        )
-
-        try:
-            connection = await runner.setupConnection(
-                usePipe=usePipe, timeout=timeout, slowMo=slowMo, preferredRevision=self.preferredRevision,
-            )
-            browser = await Browser.create(
-                connection=connection,
-                contextIds=[],
-                ignoreHTTPSErrors=ignoreHTTPSErrors,
-                defaultViewport=defaultViewport,
-                process=runner.proc,
-                closeCallback=runner.close,
-            )
-            await browser.waitForTarget(lambda x: x.type == 'page')
-            return browser
-        except Exception as original_exception:
-            logger.error(f'error occurred while trying to launch browser: {original_exception}')
-            with suppress(Exception):
-                runner.kill()
-            raise original_exception
-
-    def default_args(
-        self,
-        args: Sequence[str] = None,
-        devtools: bool = False,
-        headless: bool = None,
-        userDataDir: str = None,
-        **_: Any,
-    ) -> List[str]:
-        if headless is None:
-            headless = not devtools
-        if args is None:
-            args = []
-        chrome_args = self.DEFAULT_ARGS[:]
-        if isinstance(args, Sequence):
-            chrome_args.extend(args)
-        if userDataDir:
-            chrome_args.append(f'--user-data-dir={userDataDir}')
-        if devtools:
-            chrome_args.append('--auto-open-devtools-for-tabs')
-        if headless:
-            chrome_args.extend(('--headless', '--hide-scrollbars', '--mute-audio'))
-        if all(x.startswith('-') for x in args):
-            chrome_args.append('about:blank')
-        return chrome_args
-
-
-class FirefoxLauncher(BaseBrowserLauncher):
-    DEFAULT_ARGS = [
-        '--remote-debugging-port=0',
-        '--no-remote',
-        '--foreground',
-    ]
-    _server = 'dummy.test'
-    DEFAULT_PROFILE_PREFS = {
-        # Make sure Shield doesn't hit the network.
-        'app.normandy.api_url': '',
-        # Disable Firefox old build background check
-        'app.update.checkInstallTime': False,
-        # Disable automatically upgrading Firefox
-        'app.update.disabledForTesting': True,
-        # Increase the APZ content response timeout to 2 minute
-        'apz.content_response_timeout': 60000,
-        # Prevent various error message on the console
-        # jest-puppeteer asserts that no error message is emitted by the console
-        'browser.contentblocking.features.standard': '-tp,tpPrivate,cookieBehavior0,-cm,-fp',
-        # Enable the dump function: which sends messages to the system
-        # console
-        # https://bugzilla.mozilla.org/show_bug.cgi?id=1543115
-        'browser.dom.window.dump.enabled': True,
-        # Disable topstories
-        'browser.newtabpage.activity-stream.feeds.section.topstories': False,
-        # Always display a blank page
-        'browser.newtabpage.enabled': False,
-        # Background thumbnails in particular cause grief: and disabling
-        # thumbnails in general cannot hurt
-        'browser.pagethumbnails.capturing_disabled': True,
-        # Disable safebrowsing components.
-        'browser.safebrowsing.blockedURIs.enabled': False,
-        'browser.safebrowsing.downloads.enabled': False,
-        'browser.safebrowsing.malware.enabled': False,
-        'browser.safebrowsing.passwords.enabled': False,
-        'browser.safebrowsing.phishing.enabled': False,
-        # Disable updates to search engines.
-        'browser.search.update': False,
-        # Do not restore the last open set of tabs if the browser has crashed
-        'browser.sessionstore.resume_from_crash': False,
-        # Skip check for default browser on startup
-        'browser.shell.checkDefaultBrowser': False,
-        # Disable newtabpage
-        'browser.startup.homepage': 'about:blank',
-        # Do not redirect user when a milstone upgrade of Firefox is detected
-        'browser.startup.homepage_override.mstone': 'ignore',
-        # Start with a blank page about:blank
-        'browser.startup.page': 0,
-        # Do not allow background tabs to be zombified on Android: otherwise for
-        # tests that open additional tabs: the test harness tab itself might get
-        # unloaded
-        'browser.tabs.disableBackgroundZombification': False,
-        # Do not warn when closing all other open tabs
-        'browser.tabs.warnOnCloseOtherTabs': False,
-        # Do not warn when multiple tabs will be opened
-        'browser.tabs.warnOnOpen': False,
-        # Disable the UI tour.
-        'browser.uitour.enabled': False,
-        # Turn off search suggestions in the location bar so as not to trigger
-        # network connections.
-        'browser.urlbar.suggest.searches': False,
-        # Disable first run splash page on Windows 10
-        'browser.usedOnWindows10.introURL': '',
-        # Do not warn on quitting Firefox
-        'browser.warnOnQuit': False,
-        # Do not show datareporting policy notifications which can
-        # interfere with tests
-        'datareporting.healthreport.about.reportUrl': f'http://{_server}/dummy/abouthealthreport/',
-        'datareporting.healthreport.documentServerURI': f'http://{_server}/dummy/healthreport/',
-        'datareporting.healthreport.logging.consoleEnabled': False,
-        'datareporting.healthreport.service.enabled': False,
-        'datareporting.healthreport.service.firstRun': False,
-        'datareporting.healthreport.uploadEnabled': False,
-        'datareporting.policy.dataSubmissionEnabled': False,
-        'datareporting.policy.dataSubmissionPolicyAccepted': False,
-        'datareporting.policy.dataSubmissionPolicyBypassNotification': True,
-        # DevTools JSONViewer sometimes fails to load dependencies with its require.js.
-        # This doesn't affect Puppeteer but spams console (Bug 1424372)
-        'devtools.jsonview.enabled': False,
-        # Disable popup-blocker
-        'dom.disable_open_during_load': False,
-        # Enable the support for File object creation in the content process
-        # Required for |Page.setFileInputFiles| protocol method.
-        'dom.file.createInChild': True,
-        # Disable the ProcessHangMonitor
-        'dom.ipc.reportProcessHangs': False,
-        # Disable slow script dialogues
-        'dom.max_chrome_script_run_time': 0,
-        'dom.max_script_run_time': 0,
-        # Only load extensions from the application and user profile
-        # AddonManager.SCOPE_PROFILE + AddonManager.SCOPE_APPLICATION
-        'extensions.autoDisableScopes': 0,
-        'extensions.enabledScopes': 5,
-        # Disable metadata caching for installed add-ons by default
-        'extensions.getAddons.cache.enabled': False,
-        # Disable installing any distribution extensions or add-ons.
-        'extensions.installDistroAddons': False,
-        # Disabled screenshots extension
-        'extensions.screenshots.disabled': True,
-        # Turn off extension updates so they do not bother tests
-        'extensions.update.enabled': False,
-        # Turn off extension updates so they do not bother tests
-        'extensions.update.notifyUser': False,
-        # Make sure opening about:addons will not hit the network
-        'extensions.webservice.discoverURL': f'http://{_server}/dummy/discoveryURL',
-        # Allow the application to have focus even it runs in the background
-        'focusmanager.testmode': True,
-        # Disable useragent updates
-        'general.useragent.updates.enabled': False,
-        # Always use network provider for geolocation tests so we bypass the
-        # macOS dialog raised by the corelocation provider
-        'geo.provider.testing': True,
-        # Do not scan Wifi
-        'geo.wifi.scan': False,
-        # No hang monitor
-        'hangmonitor.timeout': 0,
-        # Show chrome errors and warnings in the error console
-        'javascript.options.showInConsole': True,
-        # Disable download and usage of OpenH264: and Widevine plugins
-        'media.gmp-manager.updateEnabled': False,
-        # Prevent various error message on the console
-        # jest-puppeteer asserts that no error message is emitted by the console
-        'network.cookie.cookieBehavior': 0,
-        # Do not prompt for temporary redirects
-        'network.http.prompt-temp-redirect': False,
-        # Disable speculative connections so they are not reported as leaking
-        # when they are hanging around
-        'network.http.speculative-parallel-limit': 0,
-        # Do not automatically switch between offline and online
-        'network.manage-offline-status': False,
-        # Make sure SNTP requests do not hit the network
-        'network.sntp.pools': _server,
-        # Disable Flash.
-        'plugin.state.flash': 0,
-        'privacy.trackingprotection.enabled': False,
-        # Enable Remote Agent
-        # https://bugzilla.mozilla.org/show_bug.cgi?id=1544393
-        'remote.enabled': True,
-        # Don't do network connections for mitm priming
-        'security.certerrors.mitm.priming.enabled': False,
-        # Local documents have access to all other local documents,
-        # including directory listings
-        'security.fileuri.strict_origin_policy': False,
-        # Do not wait for the notification button security delay
-        'security.notification_enable_delay': 0,
-        # Ensure blocklist updates do not hit the network
-        'services.settings.server': f'http://{_server}/dummy/blocklist/',
-        # Do not automatically fill sign-in forms with known usernames and
-        # passwords
-        'signon.autofillForms': False,
-        # Disable password capture, so that tests that include forms are not
-        # influenced by the presence of the persistent doorhanger notification
-        'signon.rememberSignons': False,
-        # Disable first-run welcome page
-        'startup.homepage_welcome_url': 'about:blank',
-        # Disable first-run welcome page
-        'startup.homepage_welcome_url.additional': '',
-        # Disable browser animations (tabs, fullscreen, sliding alerts)
-        'toolkit.cosmeticAnimations.enabled': False,
-        # We want to collect telemetry, but we don't want to send in the results
-        'toolkit.telemetry.server': f'https://{_server}/dummy/telemetry/',
-        # Prevent starting into safe mode after application crashes
-        'toolkit.startup.max_resumed_crashes': -1,
-    }
-    product = 'firefox'
-
-    def __init__(self, projectRoot: str = None, preferredRevision: str = None):
-        super().__init__(projectRoot, preferredRevision)
-
-    @property
-    def executablePath(self) -> Optional[Path]:
-        raise NotImplementedError('executablePath method not implemented')
-
-    async def launch(self, **kwargs: Union[LaunchOptions, ChromeArgOptions, BrowserOptions]) -> Browser:
-        ignoreDefaultArgs = kwargs.get('ignoreDefaultArgs', False)
-        args: Sequence[str] = kwargs.get('args', [])
-        dumpio = kwargs.get('dumpio', False)
-        executablePath = kwargs.get('executablePath', None)
-        pipe = kwargs.get('pipe', False)
-        env = kwargs.get('env', os.environ)
-        handleSIGINT = kwargs.get('handleSIGINT', True)
-        handleSIGTERM = kwargs.get('handleSIGTERM', True)
-        handleSIGHUP = kwargs.get('handleSIGHUP', not sys.platform.startswith('win'))
-        ignoreHTTPSErrors = kwargs.get('ignoreHTTPSErrors', False)
-        defaultViewport = kwargs.get('defaultViewport', {'width': 800, 'height': 600})
-        slowMo = kwargs.get('slowMo', 0)
-        timeout = kwargs.get('timeout', 30_000)
-        profile_path = None
-
-        firefox_args = []
-        if not ignoreDefaultArgs:
-            firefox_args.extend(self.default_args(**kwargs))
-        elif isinstance(ignoreDefaultArgs, Sequence):
-            firefox_args.extend([x for x in self.default_args()])
-        else:
-            firefox_args.extend(args)
-
-        if '-profile' not in firefox_args and '--profile' not in firefox_args:
-            profile_path = tempfile.TemporaryDirectory('pyppyeteer2_firefox_profile_')
-            firefox_args.extend(('--profile', profile_path.name))
-
-        if not executablePath:
-            missing_text, executablePath = resolveExecutablePath(self.projectRoot, self.preferredRevision)
-            if missing_text:
-                raise RuntimeError(missing_text)
-
-        runner = BrowserRunner(executable_path=executablePath, process_args=firefox_args, temp_dir=profile_path)
-        runner.start(
-            handleSIGHUP=handleSIGHUP,
-            handleSIGTERM=handleSIGTERM,
-            handleSIGINT=handleSIGINT,
-            dumpio=dumpio,
-            env=env,
-            pipe=pipe,
-        )
-
-        try:
-            connection = await runner.setupConnection(
-                usePipe=pipe, timeout=timeout, slowMo=slowMo, preferredRevision=self.preferredRevision,
-            )
-            browser = await Browser.create(
-                connection=connection,
-                contextIds=[],
-                ignoreHTTPSErrors=ignoreHTTPSErrors,
-                defaultViewport=defaultViewport,
-                process=runner.proc,
-                closeCallback=runner.close,
-            )
-            await browser.waitForTarget(lambda t: t.type == 'page')
-            return browser
-        except Exception as original_exception:
-            logger.error(f'error occurred while trying to launch browser: {original_exception}')
-            with suppress(Exception):
-                runner.kill()
-            raise original_exception
-
-    def default_args(
-        self,
-        args: Sequence[str] = None,
-        devtools: bool = False,
-        headless: bool = None,
-        userDataDir: str = None,
-        **_: Any,
-    ) -> List[str]:
-        if headless is None:
-            headless = not devtools
-        proc_args = self.DEFAULT_ARGS[:]
-        if isinstance(args, Sequence):
-            proc_args.extend(args)
-        if userDataDir:
-            proc_args.extend(['--profile', userDataDir])
-        if headless:
-            proc_args.append('--headless')
-        if devtools:
-            proc_args.append('--devtools')
-        if all(x.startswith('-') for x in proc_args):
-            proc_args.append('about:blank')
-
-        return proc_args
-
-    def _create_profile(self, extra_prefs: Dict[str, Any]) -> tempfile.TemporaryDirectory:
-        profile_path = tempfile.TemporaryDirectory(prefix='pyppeteer_firefox_profile')
-        prefs = {**self.DEFAULT_PROFILE_PREFS, **extra_prefs}
-        serialized_prefs = [f'user_pref({json.dumps(key)}, {json.dumps(val)}' for key, val in prefs.items()]
-        with open(Path(profile_path.name).joinpath('user.js'), 'w') as user:
-            user.write('\n'.join(serialized_prefs))
-        return profile_path
-
-
-def waitForWSEndpoint(proc: subprocess.Popen, timeout: Optional[float], preferredRevision: Optional[str]) -> str:
-    assert proc.stdout is not None, 'process STDOUT wasn\'t piped'
-    start = time.perf_counter()
-    buffer = ''
-    for line in iter(proc.stdout.readline, b''):
-        line = line.decode()
-        buffer += '\n' + line
-        if timeout and (start - time.perf_counter()) > timeout:
-            raise TimeoutError(
-                f'Timed out after {timeout * 1000:.0f}ms while trying to connect to the browser! '
-                f'Only Chrome at revision {preferredRevision} is guaranteed to work.'
-            )
-        potential_match = re.match(r'DevTools listening on (ws://[\w.:/-]*)+', line)
-        if potential_match:
-            return potential_match.group(1)
-    raise RuntimeError(
-        buffer + '\nProcess ended before WebSockets endpoint could be found.'
-        f'Only Chrome at revision {preferredRevision} is guaranteed to work.'
-    )
-
-
-def getWSEndpoint(url: str) -> str:
-    url += '/json/version'
-    timeout = time.perf_counter() + 30
-    while True:
-        if time.perf_counter() > timeout:
-            raise BrowserError('Browser closed unexpectedly:\n')
-        try:
-            with urlopen(url) as f:
-                data = json.loads(f.read().decode())
-            break
-        except URLError:
-            time.sleep(0.1)
-    try:
-        return data['webSocketDebuggerUrl']
-    except KeyError:
-        raise RuntimeError(f'webSocketDebuggerUrl not found')
-
-
-def resolveExecutablePath(projectRoot: Path, preferred_revision: str) -> Tuple[Optional[Path], Optional[str]]:
-    missing_text = None
-    exec_path_env_var = 'PYPPETEER_EXECUTABLE_PATH'
-    revision_env_var = 'PYPPETEER_CHROMIUM_REVISION'
-    executable = os.environ.get(exec_path_env_var)
-    if executable:
-        if not Path(executable).is_file():
-            missing_text = f'Tried to use env variable ({exec_path_env_var}) to launch browser, but no executable was found at {executable}'
-            return None, missing_text
-    browser_fetcher = BrowserFetcher(projectRoot)
-    revision = os.environ.get(revision_env_var)
-    if revision:
-        revision_info = browser_fetcher.revision_info(revision)
-        if not revision_info['local']:
-            missing_text = f'Tried to use env variables ({revision_env_var}) to launch browser, but did not find executable at {revision_info["executablePath"]}'
-            return None, missing_text
-    revision_info = browser_fetcher.revision_info(preferred_revision)
-    if not revision_info['local']:
-        missing_text = 'Browser is not downloaded. Try running pyppeteer-install'
-    return revision_info['executablePath'], missing_text
-
-
-def launcher(
-    projectRoot: str = None, preferredRevision: str = None, product: str = None
-) -> Union[FirefoxLauncher, ChromeLauncher]:
-    """Returns the appropriate browser launcher class instance"""
-    product = product or os.environ.get('PYPPETEER_PRODUCT') or 'chrome'
-    if product == 'firefox':
-        return FirefoxLauncher(projectRoot, preferredRevision)
-    elif product in ('chrome', 'chromium'):
-        return ChromeLauncher(projectRoot, preferredRevision)
-    raise ValueError(f'Support for {product} has not been implemented')