| """Interfaces for launching and remotely controlling web browsers.""" | |
| import builtins # because we override open | |
| import os | |
| lazy import plistlib | |
| import shlex | |
| import shutil | |
| import sys | |
| import subprocess | |
| import threading | |
| __all__ = ["Error", "open", "open_new", "open_new_tab", "get", "register"] | |
| class Error(Exception): | |
| pass | |
| _lock = threading.RLock() | |
| _browsers = {} # Dictionary of available browser controllers | |
| _tryorder = None # Preference order of available browsers | |
| _os_preferred_browser = None # The preferred browser | |
| def register(name, klass, instance=None, *, preferred=False): | |
| """Register a browser connector.""" | |
| with _lock: | |
| if _tryorder is None: | |
| register_standard_browsers() | |
| _browsers[name.lower()] = [klass, instance] | |
| # Preferred browsers go to the front of the list. | |
| # Need to match to the default browser returned by xdg-settings, which | |
| # may be of the form e.g. "firefox.desktop". | |
| if preferred or (_os_preferred_browser and f'{name}.desktop' == _os_preferred_browser): | |
| _tryorder.insert(0, name) | |
| else: | |
| _tryorder.append(name) | |
| def get(using=None): | |
| """Return a browser launcher instance appropriate for the environment.""" | |
| if _tryorder is None: | |
| with _lock: | |
| if _tryorder is None: | |
| register_standard_browsers() | |
| if using is not None: | |
| alternatives = [using] | |
| else: | |
| alternatives = _tryorder | |
| for browser in alternatives: | |
| if '%s' in browser: | |
| # User gave us a command line, split it into name and args | |
| browser = shlex.split(browser) | |
| if browser[-1] == '&': | |
| return BackgroundBrowser(browser[:-1]) | |
| else: | |
| return GenericBrowser(browser) | |
| else: | |
| # User gave us a browser name or path. | |
| try: | |
| command = _browsers[browser.lower()] | |
| except KeyError: | |
| command = _synthesize(browser) | |
| if command[1] is not None: | |
| return command[1] | |
| elif command[0] is not None: | |
| return command[0]() | |
| raise Error("could not locate runnable browser") | |
| # Please note: the following definition hides a builtin function. | |
| # It is recommended one does "import webbrowser" and uses webbrowser.open(url) | |
| # instead of "from webbrowser import *". | |
| def open(url, new=0, autoraise=True): | |
| """Display url using the default browser. | |
| If possible, open url in a location determined by new. | |
| - 0: the same browser window (the default). | |
| - 1: a new browser window. | |
| - 2: a new browser page ("tab"). | |
| If possible, autoraise raises the window (the default) or not. | |
| If opening the browser succeeds, return True. | |
| If there is a problem, return False. | |
| """ | |
| if _tryorder is None: | |
| with _lock: | |
| if _tryorder is None: | |
| register_standard_browsers() | |
| for name in _tryorder: | |
| browser = get(name) | |
| if browser.open(url, new, autoraise): | |
| return True | |
| return False | |
| def open_new(url): | |
| """Open url in a new window of the default browser. | |
| If not possible, then open url in the only browser window. | |
| """ | |
| return open(url, 1) | |
| def open_new_tab(url): | |
| """Open url in a new page ("tab") of the default browser. | |
| If not possible, then the behavior becomes equivalent to open_new(). | |
| """ | |
| return open(url, 2) | |
| def _synthesize(browser, *, preferred=False): | |
| """Attempt to synthesize a controller based on existing controllers. | |
| This is useful to create a controller when a user specifies a path to | |
| an entry in the BROWSER environment variable -- we can copy a general | |
| controller to operate using a specific installation of the desired | |
| browser in this way. | |
| If we can't create a controller in this way, or if there is no | |
| executable for the requested browser, return [None, None]. | |
| """ | |
| cmd = browser.split()[0] | |
| if not shutil.which(cmd): | |
| return [None, None] | |
| name = os.path.basename(cmd) | |
| try: | |
| command = _browsers[name.lower()] | |
| except KeyError: | |
| return [None, None] | |
| # now attempt to clone to fit the new name: | |
| controller = command[1] | |
| if controller and name.lower() == controller.basename: | |
| import copy | |
| controller = copy.copy(controller) | |
| controller.name = browser | |
| controller.basename = os.path.basename(browser) | |
| register(browser, None, instance=controller, preferred=preferred) | |
| return [None, controller] | |
| return [None, None] | |
| # General parent classes | |
| class BaseBrowser: | |
| """Parent class for all browsers. Do not use directly.""" | |
| args = ['%s'] | |
| def __init__(self, name=""): | |
| self.name = name | |
| self.basename = name | |
| def open(self, url, new=0, autoraise=True): | |
| raise NotImplementedError | |
| def open_new(self, url): | |
| return self.open(url, 1) | |
| def open_new_tab(self, url): | |
| return self.open(url, 2) | |
| @staticmethod | |
| def _check_url(url): | |
| """Ensures that the URL is safe to pass to subprocesses as a parameter""" | |
| if url and url.lstrip().startswith("-"): | |
| raise ValueError(f"Invalid URL (leading dash disallowed): {url!r}") | |
| class GenericBrowser(BaseBrowser): | |
| """Class for all browsers started with a command | |
| and without remote functionality.""" | |
| def __init__(self, name): | |
| if isinstance(name, str): | |
| self.name = name | |
| self.args = ["%s"] | |
| else: | |
| # name should be a list with arguments | |
| self.name = name[0] | |
| self.args = name[1:] | |
| self.basename = os.path.basename(self.name) | |
| def open(self, url, new=0, autoraise=True): | |
| sys.audit("webbrowser.open", url) | |
| self._check_url(url) | |
| cmdline = [self.name] + [arg.replace("%s", url) | |
| for arg in self.args] | |
| try: | |
| if sys.platform[:3] == 'win': | |
| p = subprocess.Popen(cmdline) | |
| else: | |
| p = subprocess.Popen(cmdline, close_fds=True) | |
| return not p.wait() | |
| except OSError: | |
| return False | |
| class BackgroundBrowser(GenericBrowser): | |
| """Class for all browsers which are to be started in the | |
| background.""" | |
| def open(self, url, new=0, autoraise=True): | |
| cmdline = [self.name] + [arg.replace("%s", url) | |
| for arg in self.args] | |
| sys.audit("webbrowser.open", url) | |
| self._check_url(url) | |
| try: | |
| if sys.platform[:3] == 'win': | |
| p = subprocess.Popen(cmdline) | |
| else: | |
| p = subprocess.Popen(cmdline, close_fds=True, | |
| start_new_session=True) | |
| return p.poll() is None | |
| except OSError: | |
| return False | |
| class UnixBrowser(BaseBrowser): | |
| """Parent class for all Unix browsers with remote functionality.""" | |
| raise_opts = None | |
| background = False | |
| redirect_stdout = True | |
| # In remote_args, %s will be replaced with the requested URL. %action will | |
| # be replaced depending on the value of 'new' passed to open. | |
| # remote_action is used for new=0 (open). If newwin is not None, it is | |
| # used for new=1 (open_new). If newtab is not None, it is used for | |
| # new=3 (open_new_tab). After both substitutions are made, any empty | |
| # strings in the transformed remote_args list will be removed. | |
| remote_args = ['%action', '%s'] | |
| remote_action = None | |
| remote_action_newwin = None | |
| remote_action_newtab = None | |
| def _invoke(self, args, remote, autoraise, url=None): | |
| raise_opt = [] | |
| if remote and self.raise_opts: | |
| # use autoraise argument only for remote invocation | |
| autoraise = int(autoraise) | |
| opt = self.raise_opts[autoraise] | |
| if opt: | |
| raise_opt = [opt] | |
| cmdline = [self.name] + raise_opt + args | |
| if remote or self.background: | |
| inout = subprocess.DEVNULL | |
| else: | |
| # for TTY browsers, we need stdin/out | |
| inout = None | |
| p = subprocess.Popen(cmdline, close_fds=True, stdin=inout, | |
| stdout=(self.redirect_stdout and inout or None), | |
| stderr=inout, start_new_session=True) | |
| if remote: | |
| # wait at most five seconds. If the subprocess is not finished, the | |
| # remote invocation has (hopefully) started a new instance. | |
| try: | |
| rc = p.wait(5) | |
| # if remote call failed, open() will try direct invocation | |
| return not rc | |
| except subprocess.TimeoutExpired: | |
| return True | |
| elif self.background: | |
| if p.poll() is None: | |
| return True | |
| else: | |
| return False | |
| else: | |
| return not p.wait() | |
| def open(self, url, new=0, autoraise=True): | |
| sys.audit("webbrowser.open", url) | |
| if new == 0: | |
| action = self.remote_action | |
| elif new == 1: | |
| action = self.remote_action_newwin | |
| elif new == 2: | |
| if self.remote_action_newtab is None: | |
| action = self.remote_action_newwin | |
| else: | |
| action = self.remote_action_newtab | |
| else: | |
| raise Error("Bad 'new' parameter to open(); " | |
| f"expected 0, 1, or 2, got {new}") | |
| self._check_url(url.replace("%action", action)) | |
| args = [arg.replace("%action", action).replace("%s", url) | |
| for arg in self.remote_args] | |
| args = [arg for arg in args if arg] | |
| success = self._invoke(args, True, autoraise, url) | |
| if not success: | |
| # remote invocation failed, try straight way | |
| args = [arg.replace("%s", url) for arg in self.args] | |
| return self._invoke(args, False, False) | |
| else: | |
| return True | |
| class Mozilla(UnixBrowser): | |
| """Launcher class for Mozilla browsers.""" | |
| remote_args = ['%action', '%s'] | |
| remote_action = "" | |
| remote_action_newwin = "-new-window" | |
| remote_action_newtab = "-new-tab" | |
| background = True | |
| class Epiphany(UnixBrowser): | |
| """Launcher class for Epiphany browser.""" | |
| raise_opts = ["-noraise", ""] | |
| remote_args = ['%action', '%s'] | |
| remote_action = "-n" | |
| remote_action_newwin = "-w" | |
| background = True | |
| class Chrome(UnixBrowser): | |
| """Launcher class for Google Chrome browser.""" | |
| remote_args = ['%action', '%s'] | |
| remote_action = "" | |
| remote_action_newwin = "--new-window" | |
| remote_action_newtab = "" | |
| background = True | |
| Chromium = Chrome | |
| class Opera(UnixBrowser): | |
| """Launcher class for Opera browser.""" | |
| remote_args = ['%action', '%s'] | |
| remote_action = "" | |
| remote_action_newwin = "--new-window" | |
| remote_action_newtab = "" | |
| background = True | |
| class Elinks(UnixBrowser): | |
| """Launcher class for Elinks browsers.""" | |
| remote_args = ['-remote', 'openURL(%s%action)'] | |
| remote_action = "" | |
| remote_action_newwin = ",new-window" | |
| remote_action_newtab = ",new-tab" | |
| background = False | |
| # elinks doesn't like its stdout to be redirected - | |
| # it uses redirected stdout as a signal to do -dump | |
| redirect_stdout = False | |
| class Konqueror(BaseBrowser): | |
| """Controller for the KDE File Manager (kfm, or Konqueror). | |
| See the output of ``kfmclient --commands`` | |
| for more information on the Konqueror remote-control interface. | |
| """ | |
| def open(self, url, new=0, autoraise=True): | |
| sys.audit("webbrowser.open", url) | |
| self._check_url(url) | |
| # XXX Currently I know no way to prevent KFM from opening a new win. | |
| if new == 2: | |
| action = "newTab" | |
| else: | |
| action = "openURL" | |
| devnull = subprocess.DEVNULL | |
| try: | |
| p = subprocess.Popen(["kfmclient", action, url], | |
| close_fds=True, stdin=devnull, | |
| stdout=devnull, stderr=devnull) | |
| except OSError: | |
| # fall through to next variant | |
| pass | |
| else: | |
| p.wait() | |
| # kfmclient's return code unfortunately has no meaning as it seems | |
| return True | |
| try: | |
| p = subprocess.Popen(["konqueror", "--silent", url], | |
| close_fds=True, stdin=devnull, | |
| stdout=devnull, stderr=devnull, | |
| start_new_session=True) | |
| except OSError: | |
| # fall through to next variant | |
| pass | |
| else: | |
| if p.poll() is None: | |
| # Should be running now. | |
| return True | |
| try: | |
| p = subprocess.Popen(["kfm", "-d", url], | |
| close_fds=True, stdin=devnull, | |
| stdout=devnull, stderr=devnull, | |
| start_new_session=True) | |
| except OSError: | |
| return False | |
| else: | |
| return p.poll() is None | |
| class Edge(UnixBrowser): | |
| """Launcher class for Microsoft Edge browser.""" | |
| remote_args = ['%action', '%s'] | |
| remote_action = "" | |
| remote_action_newwin = "--new-window" | |
| remote_action_newtab = "" | |
| background = True | |
| # | |
| # Platform support for Unix | |
| # | |
| # These are the right tests because all these Unix browsers require either | |
| # a console terminal or an X display to run. | |
| def register_X_browsers(): | |
| # use xdg-open if around | |
| if shutil.which("xdg-open"): | |
| register("xdg-open", None, BackgroundBrowser("xdg-open")) | |
| # Opens an appropriate browser for the URL scheme according to | |
| # freedesktop.org settings (GNOME, KDE, XFCE, etc.) | |
| if shutil.which("gio"): | |
| register("gio", None, BackgroundBrowser(["gio", "open", "--", "%s"])) | |
| xdg_desktop = os.getenv("XDG_CURRENT_DESKTOP", "").split(":") | |
| # The default GNOME3 browser | |
| if (("GNOME" in xdg_desktop or | |
| "GNOME_DESKTOP_SESSION_ID" in os.environ) and | |
| shutil.which("gvfs-open")): | |
| register("gvfs-open", None, BackgroundBrowser("gvfs-open")) | |
| # The default KDE browser | |
| if (("KDE" in xdg_desktop or | |
| "KDE_FULL_SESSION" in os.environ) and | |
| shutil.which("kfmclient")): | |
| register("kfmclient", Konqueror, Konqueror("kfmclient")) | |
| # Common symbolic link for the default X11 browser | |
| if shutil.which("x-www-browser"): | |
| register("x-www-browser", None, BackgroundBrowser("x-www-browser")) | |
| # The Mozilla browsers | |
| for browser in ("firefox", "iceweasel", "seamonkey", "mozilla-firefox", | |
| "mozilla"): | |
| if shutil.which(browser): | |
| register(browser, None, Mozilla(browser)) | |
| # Konqueror/kfm, the KDE browser. | |
| if shutil.which("kfm"): | |
| register("kfm", Konqueror, Konqueror("kfm")) | |
| elif shutil.which("konqueror"): | |
| register("konqueror", Konqueror, Konqueror("konqueror")) | |
| # Gnome's Epiphany | |
| if shutil.which("epiphany"): | |
| register("epiphany", None, Epiphany("epiphany")) | |
| # Google Chrome/Chromium browsers | |
| for browser in ("google-chrome", "chrome", "chromium", "chromium-browser"): | |
| if shutil.which(browser): | |
| register(browser, None, Chrome(browser)) | |
| # Opera, quite popular | |
| if shutil.which("opera"): | |
| register("opera", None, Opera("opera")) | |
| if shutil.which("microsoft-edge"): | |
| register("microsoft-edge", None, Edge("microsoft-edge")) | |
| def register_standard_browsers(): | |
| global _tryorder | |
| _tryorder = [] | |
| if sys.platform == 'darwin': | |
| register("MacOS", None, MacOS('default')) | |
| register("MacOSX", None, MacOS('default')) # backward compat alias | |
| register("chrome", None, MacOS('google chrome')) | |
| register("chromium", None, MacOS('chromium')) | |
| register("firefox", None, MacOS('firefox')) | |
| register("safari", None, MacOS('safari')) | |
| register("opera", None, MacOS('opera')) | |
| register("microsoft-edge", None, MacOS('microsoft edge')) | |
| register("brave", None, MacOS('brave browser')) | |
| # macOS can use below Unix support (but we prefer using the macOS | |
| # specific stuff) | |
| if sys.platform == "ios": | |
| register("iosbrowser", None, IOSBrowser(), preferred=True) | |
| if sys.platform == "serenityos": | |
| # SerenityOS webbrowser, simply called "Browser". | |
| register("Browser", None, BackgroundBrowser("Browser")) | |
| if sys.platform[:3] == "win": | |
| # First try to use the default Windows browser | |
| register("windows-default", WindowsDefault) | |
| # Detect some common Windows browsers, fallback to Microsoft Edge | |
| # location in 64-bit Windows | |
| edge64 = os.path.join(os.environ.get("PROGRAMFILES(x86)", "C:\\Program Files (x86)"), | |
| "Microsoft\\Edge\\Application\\msedge.exe") | |
| # location in 32-bit Windows | |
| edge32 = os.path.join(os.environ.get("PROGRAMFILES", "C:\\Program Files"), | |
| "Microsoft\\Edge\\Application\\msedge.exe") | |
| for browser in ("firefox", "seamonkey", "mozilla", "chrome", | |
| "opera", edge64, edge32): | |
| if shutil.which(browser): | |
| register(browser, None, BackgroundBrowser(browser)) | |
| if shutil.which("MicrosoftEdge.exe"): | |
| register("microsoft-edge", None, Edge("MicrosoftEdge.exe")) | |
| else: | |
| # Prefer X browsers if present | |
| # | |
| # NOTE: Do not check for X11 browser on macOS, | |
| # XQuartz installation sets a DISPLAY environment variable and will | |
| # autostart when someone tries to access the display. Mac users in | |
| # general don't need an X11 browser. | |
| if sys.platform != "darwin" and (os.environ.get("DISPLAY") or os.environ.get("WAYLAND_DISPLAY")): | |
| try: | |
| cmd = "xdg-settings get default-web-browser".split() | |
| raw_result = subprocess.check_output(cmd, stderr=subprocess.DEVNULL) | |
| result = raw_result.decode().strip() | |
| except (FileNotFoundError, subprocess.CalledProcessError, | |
| PermissionError, NotADirectoryError): | |
| pass | |
| else: | |
| global _os_preferred_browser | |
| _os_preferred_browser = result | |
| register_X_browsers() | |
| # Also try console browsers | |
| if os.environ.get("TERM"): | |
| # Common symbolic link for the default text-based browser | |
| if shutil.which("www-browser"): | |
| register("www-browser", None, GenericBrowser("www-browser")) | |
| # The Links/elinks browsers <http://links.twibright.com/> | |
| if shutil.which("links"): | |
| register("links", None, GenericBrowser("links")) | |
| if shutil.which("elinks"): | |
| register("elinks", None, Elinks("elinks")) | |
| # The Lynx browser <https://lynx.invisible-island.net/>, <http://lynx.browser.org/> | |
| if shutil.which("lynx"): | |
| register("lynx", None, GenericBrowser("lynx")) | |
| # The w3m browser <http://w3m.sourceforge.net/> | |
| if shutil.which("w3m"): | |
| register("w3m", None, GenericBrowser("w3m")) | |
| # OK, now that we know what the default preference orders for each | |
| # platform are, allow user to override them with the BROWSER variable. | |
| if "BROWSER" in os.environ: | |
| userchoices = os.environ["BROWSER"].split(os.pathsep) | |
| userchoices.reverse() | |
| # Treat choices in same way as if passed into get() but do register | |
| # and prepend to _tryorder | |
| for cmdline in userchoices: | |
| if all(x not in cmdline for x in " \t"): | |
| # Assume this is the name of a registered command, use | |
| # that unless it is a GenericBrowser. | |
| try: | |
| command = _browsers[cmdline.lower()] | |
| except KeyError: | |
| pass | |
| else: | |
| if not isinstance(command[1], GenericBrowser): | |
| _tryorder.insert(0, cmdline.lower()) | |
| continue | |
| if cmdline != '': | |
| cmd = _synthesize(cmdline, preferred=True) | |
| if cmd[1] is None: | |
| register(cmdline, None, GenericBrowser(cmdline), preferred=True) | |
| # what to do if _tryorder is now empty? | |
| # | |
| # Platform support for Windows | |
| # | |
| if sys.platform[:3] == "win": | |
| class WindowsDefault(BaseBrowser): | |
| def open(self, url, new=0, autoraise=True): | |
| sys.audit("webbrowser.open", url) | |
| self._check_url(url) | |
| try: | |
| os.startfile(url) | |
| except OSError: | |
| # [Error 22] No application is associated with the specified | |
| # file for this operation: '<URL>' | |
| return False | |
| else: | |
| return True | |
| # | |
| # Platform support for macOS | |
| # | |
| if sys.platform == 'darwin': | |
| def _macos_default_browser_bundle_id(): | |
| """Return the bundle ID of the default web browser. | |
| Reads the LaunchServices preferences file that macOS maintains | |
| when the user sets a default browser. Returns 'com.apple.Safari' | |
| if the file is absent or no https handler is recorded, because on | |
| a fresh macOS installation Safari is the default browser and the | |
| LaunchServices plist is not written until the user explicitly | |
| changes their default browser. | |
| """ | |
| plist = os.path.expanduser( | |
| '~/Library/Preferences/com.apple.LaunchServices/' | |
| 'com.apple.launchservices.secure.plist' | |
| ) | |
| try: | |
| with builtins.open(plist, 'rb') as f: | |
| data = plistlib.load(f) | |
| for handler in data.get('LSHandlers', []): | |
| if handler.get('LSHandlerURLScheme') == 'https': | |
| return (handler.get('LSHandlerRoleAll') | |
| or handler.get('LSHandlerRoleViewer')) | |
| except (OSError, KeyError, ValueError): | |
| pass | |
| return 'com.apple.Safari' | |
| class MacOS(BaseBrowser): | |
| """Launcher class for macOS browsers, using /usr/bin/open. | |
| For http/https URLs with the default browser, /usr/bin/open is called | |
| directly; macOS routes these to the registered browser. | |
| For all other URL schemes (e.g. file://) and for named browsers, | |
| /usr/bin/open -b <bundle-id> is used so that the URL is always passed | |
| to a browser application rather than dispatched by the OS file handler. | |
| This prevents file injection attacks where a file:// URL pointing to an | |
| executable bundle could otherwise be launched by the OS. | |
| Named browsers with known bundle IDs use -b; unknown names fall back | |
| to -a. | |
| """ | |
| _BUNDLE_IDS = { | |
| 'google chrome': 'com.google.Chrome', | |
| 'firefox': 'org.mozilla.firefox', | |
| 'safari': 'com.apple.Safari', | |
| 'chromium': 'org.chromium.Chromium', | |
| 'opera': 'com.operasoftware.Opera', | |
| 'microsoft edge': 'com.microsoft.edgemac', | |
| 'brave browser': 'com.brave.Browser', | |
| } | |
| def open(self, url, new=0, autoraise=True): | |
| sys.audit("webbrowser.open", url) | |
| self._check_url(url) | |
| if self.name == 'default': | |
| proto, sep, _ = url.partition(':') | |
| if sep and proto.lower() in {'http', 'https'}: | |
| cmd = ['/usr/bin/open', url] | |
| else: | |
| bundle_id = _macos_default_browser_bundle_id() | |
| cmd = ['/usr/bin/open', '-b', bundle_id, url] | |
| else: | |
| bundle_id = self._BUNDLE_IDS.get(self.name.lower()) | |
| if bundle_id: | |
| cmd = ['/usr/bin/open', '-b', bundle_id, url] | |
| else: | |
| cmd = ['/usr/bin/open', '-a', self.name, url] | |
| proc = subprocess.run(cmd, stderr=subprocess.DEVNULL) | |
| return proc.returncode == 0 | |
| class MacOSXOSAScript(BaseBrowser): | |
| def __init__(self, name='default'): | |
| import warnings | |
| warnings._deprecated("webbrowser.MacOSXOSAScript", remove=(3, 17)) | |
| super().__init__(name) | |
| def open(self, url, new=0, autoraise=True): | |
| sys.audit("webbrowser.open", url) | |
| self._check_url(url) | |
| url = url.replace('"', '%22') | |
| if self.name == 'default': | |
| proto, _sep, _rest = url.partition(":") | |
| if _sep and proto.lower() in {"http", "https"}: | |
| # default web URL, don't need to lookup browser | |
| script = f'open location "{url}"' | |
| else: | |
| # if not a web URL, need to lookup default browser to ensure a browser is launched | |
| # this should always work, but is overkill to lookup http handler | |
| # before launching http | |
| script = f""" | |
| use framework "AppKit" | |
| use AppleScript version "2.4" | |
| use scripting additions | |
| property NSWorkspace : a reference to current application's NSWorkspace | |
| property NSURL : a reference to current application's NSURL | |
| set http_url to NSURL's URLWithString:"https://python.org" | |
| set browser_url to (NSWorkspace's sharedWorkspace)'s ¬ | |
| URLForApplicationToOpenURL:http_url | |
| set app_path to browser_url's relativePath as text -- NSURL to absolute path '/Applications/Safari.app' | |
| tell application app_path | |
| activate | |
| open location "{url}" | |
| end tell | |
| """ | |
| else: | |
| script = f''' | |
| tell application "{self.name}" | |
| activate | |
| open location "{url}" | |
| end | |
| ''' | |
| osapipe = os.popen("/usr/bin/osascript", "w") | |
| if osapipe is None: | |
| return False | |
| osapipe.write(script) | |
| rc = osapipe.close() | |
| return not rc | |
| # | |
| # Platform support for iOS | |
| # | |
| if sys.platform == "ios": | |
| from _ios_support import objc | |
| if objc: | |
| # If objc exists, we know ctypes is also importable. | |
| from ctypes import c_void_p, c_char_p, c_ulong | |
| class IOSBrowser(BaseBrowser): | |
| def open(self, url, new=0, autoraise=True): | |
| sys.audit("webbrowser.open", url) | |
| self._check_url(url) | |
| # If ctypes isn't available, we can't open a browser | |
| if objc is None: | |
| return False | |
| # All the messages in this call return object references. | |
| objc.objc_msgSend.restype = c_void_p | |
| # This is the equivalent of: | |
| # NSString url_string = | |
| # [NSString stringWithCString:url.encode("utf-8") | |
| # encoding:NSUTF8StringEncoding]; | |
| NSString = objc.objc_getClass(b"NSString") | |
| constructor = objc.sel_registerName(b"stringWithCString:encoding:") | |
| objc.objc_msgSend.argtypes = [c_void_p, c_void_p, c_char_p, c_ulong] | |
| url_string = objc.objc_msgSend( | |
| NSString, | |
| constructor, | |
| url.encode("utf-8"), | |
| 4, # NSUTF8StringEncoding = 4 | |
| ) | |
| # Create an NSURL object representing the URL | |
| # This is the equivalent of: | |
| # NSURL *nsurl = [NSURL URLWithString:url]; | |
| NSURL = objc.objc_getClass(b"NSURL") | |
| urlWithString_ = objc.sel_registerName(b"URLWithString:") | |
| objc.objc_msgSend.argtypes = [c_void_p, c_void_p, c_void_p] | |
| ns_url = objc.objc_msgSend(NSURL, urlWithString_, url_string) | |
| # Get the shared UIApplication instance | |
| # This code is the equivalent of: | |
| # UIApplication shared_app = [UIApplication sharedApplication] | |
| UIApplication = objc.objc_getClass(b"UIApplication") | |
| sharedApplication = objc.sel_registerName(b"sharedApplication") | |
| objc.objc_msgSend.argtypes = [c_void_p, c_void_p] | |
| shared_app = objc.objc_msgSend(UIApplication, sharedApplication) | |
| # Open the URL on the shared application | |
| # This code is the equivalent of: | |
| # [shared_app openURL:ns_url | |
| # options:NIL | |
| # completionHandler:NIL]; | |
| openURL_ = objc.sel_registerName(b"openURL:options:completionHandler:") | |
| objc.objc_msgSend.argtypes = [ | |
| c_void_p, c_void_p, c_void_p, c_void_p, c_void_p | |
| ] | |
| # Method returns void | |
| objc.objc_msgSend.restype = None | |
| objc.objc_msgSend(shared_app, openURL_, ns_url, None, None) | |
| return True | |
| def parse_args(arg_list: list[str] | None): | |
| import argparse | |
| parser = argparse.ArgumentParser( | |
| description="Open URL in a web browser.", | |
| ) | |
| parser.add_argument("url", help="URL to open") | |
| group = parser.add_mutually_exclusive_group() | |
| group.add_argument("-n", "--new-window", action="store_const", | |
| const=1, default=0, dest="new_win", | |
| help="open new window") | |
| group.add_argument("-t", "--new-tab", action="store_const", | |
| const=2, default=0, dest="new_win", | |
| help="open new tab") | |
| args = parser.parse_args(arg_list) | |
| return args | |
| def main(arg_list: list[str] | None = None): | |
| args = parse_args(arg_list) | |
| open(args.url, args.new_win) | |
| print("\a") | |
| if __name__ == "__main__": | |
| main() |