1 #! /usr/bin/env python 2 """Interfaces for launching and remotely controlling Web browsers.""" 3 # Maintained by Georg Brandl. 4 5 import os 6 import shlex 7 import sys 8 import stat 9 import subprocess 10 import time 11 12 __all__ = ["Error", "open", "open_new", "open_new_tab", "get", "register"] 13 14 class Error(Exception): 15 pass 16 17 _browsers = {} # Dictionary of available browser controllers 18 _tryorder = [] # Preference order of available browsers 19 20 def register(name, klass, instance=None, update_tryorder=1): 21 """Register a browser connector and, optionally, connection.""" 22 _browsers[name.lower()] = [klass, instance] 23 if update_tryorder > 0: 24 _tryorder.append(name) 25 elif update_tryorder < 0: 26 _tryorder.insert(0, name) 27 28 def get(using=None): 29 """Return a browser launcher instance appropriate for the environment.""" 30 if using is not None: 31 alternatives = [using] 32 else: 33 alternatives = _tryorder 34 for browser in alternatives: 35 if '%s' in browser: 36 # User gave us a command line, split it into name and args 37 browser = shlex.split(browser) 38 if browser[-1] == '&': 39 return BackgroundBrowser(browser[:-1]) 40 else: 41 return GenericBrowser(browser) 42 else: 43 # User gave us a browser name or path. 44 try: 45 command = _browsers[browser.lower()] 46 except KeyError: 47 command = _synthesize(browser) 48 if command[1] is not None: 49 return command[1] 50 elif command[0] is not None: 51 return command[0]() 52 raise Error("could not locate runnable browser") 53 54 # Please note: the following definition hides a builtin function. 55 # It is recommended one does "import webbrowser" and uses webbrowser.open(url) 56 # instead of "from webbrowser import *". 57 58 def open(url, new=0, autoraise=True): 59 for name in _tryorder: 60 browser = get(name) 61 if browser.open(url, new, autoraise): 62 return True 63 return False 64 65 def open_new(url): 66 return open(url, 1) 67 68 def open_new_tab(url): 69 return open(url, 2) 70 71 72 def _synthesize(browser, update_tryorder=1): 73 """Attempt to synthesize a controller base on existing controllers. 74 75 This is useful to create a controller when a user specifies a path to 76 an entry in the BROWSER environment variable -- we can copy a general 77 controller to operate using a specific installation of the desired 78 browser in this way. 79 80 If we can't create a controller in this way, or if there is no 81 executable for the requested browser, return [None, None]. 82 83 """ 84 cmd = browser.split()[0] 85 if not _iscommand(cmd): 86 return [None, None] 87 name = os.path.basename(cmd) 88 try: 89 command = _browsers[name.lower()] 90 except KeyError: 91 return [None, None] 92 # now attempt to clone to fit the new name: 93 controller = command[1] 94 if controller and name.lower() == controller.basename: 95 import copy 96 controller = copy.copy(controller) 97 controller.name = browser 98 controller.basename = os.path.basename(browser) 99 register(browser, None, controller, update_tryorder) 100 return [None, controller] 101 return [None, None] 102 103 104 if sys.platform[:3] == "win": 105 def _isexecutable(cmd): 106 cmd = cmd.lower() 107 if os.path.isfile(cmd) and cmd.endswith((".exe", ".bat")): 108 return True 109 for ext in ".exe", ".bat": 110 if os.path.isfile(cmd + ext): 111 return True 112 return False 113 else: 114 def _isexecutable(cmd): 115 if os.path.isfile(cmd): 116 mode = os.stat(cmd)[stat.ST_MODE] 117 if mode & stat.S_IXUSR or mode & stat.S_IXGRP or mode & stat.S_IXOTH: 118 return True 119 return False 120 121 def _iscommand(cmd): 122 """Return True if cmd is executable or can be found on the executable 123 search path.""" 124 if _isexecutable(cmd): 125 return True 126 path = os.environ.get("PATH") 127 if not path: 128 return False 129 for d in path.split(os.pathsep): 130 exe = os.path.join(d, cmd) 131 if _isexecutable(exe): 132 return True 133 return False 134 135 136 # General parent classes 137 138 class BaseBrowser(object): 139 """Parent class for all browsers. Do not use directly.""" 140 141 args = ['%s'] 142 143 def __init__(self, name=""): 144 self.name = name 145 self.basename = name 146 147 def open(self, url, new=0, autoraise=True): 148 raise NotImplementedError 149 150 def open_new(self, url): 151 return self.open(url, 1) 152 153 def open_new_tab(self, url): 154 return self.open(url, 2) 155 156 157 class GenericBrowser(BaseBrowser): 158 """Class for all browsers started with a command 159 and without remote functionality.""" 160 161 def __init__(self, name): 162 if isinstance(name, basestring): 163 self.name = name 164 self.args = ["%s"] 165 else: 166 # name should be a list with arguments 167 self.name = name[0] 168 self.args = name[1:] 169 self.basename = os.path.basename(self.name) 170 171 def open(self, url, new=0, autoraise=True): 172 cmdline = [self.name] + [arg.replace("%s", url) 173 for arg in self.args] 174 try: 175 if sys.platform[:3] == 'win': 176 p = subprocess.Popen(cmdline) 177 else: 178 p = subprocess.Popen(cmdline, close_fds=True) 179 return not p.wait() 180 except OSError: 181 return False 182 183 184 class BackgroundBrowser(GenericBrowser): 185 """Class for all browsers which are to be started in the 186 background.""" 187 188 def open(self, url, new=0, autoraise=True): 189 cmdline = [self.name] + [arg.replace("%s", url) 190 for arg in self.args] 191 try: 192 if sys.platform[:3] == 'win': 193 p = subprocess.Popen(cmdline) 194 else: 195 setsid = getattr(os, 'setsid', None) 196 if not setsid: 197 setsid = getattr(os, 'setpgrp', None) 198 p = subprocess.Popen(cmdline, close_fds=True, preexec_fn=setsid) 199 return (p.poll() is None) 200 except OSError: 201 return False 202 203 204 class UnixBrowser(BaseBrowser): 205 """Parent class for all Unix browsers with remote functionality.""" 206 207 raise_opts = None 208 remote_args = ['%action', '%s'] 209 remote_action = None 210 remote_action_newwin = None 211 remote_action_newtab = None 212 background = False 213 redirect_stdout = True 214 215 def _invoke(self, args, remote, autoraise): 216 raise_opt = [] 217 if remote and self.raise_opts: 218 # use autoraise argument only for remote invocation 219 autoraise = int(autoraise) 220 opt = self.raise_opts[autoraise] 221 if opt: raise_opt = [opt] 222 223 cmdline = [self.name] + raise_opt + args 224 225 if remote or self.background: 226 inout = file(os.devnull, "r+") 227 else: 228 # for TTY browsers, we need stdin/out 229 inout = None 230 # if possible, put browser in separate process group, so 231 # keyboard interrupts don't affect browser as well as Python 232 setsid = getattr(os, 'setsid', None) 233 if not setsid: 234 setsid = getattr(os, 'setpgrp', None) 235 236 p = subprocess.Popen(cmdline, close_fds=True, stdin=inout, 237 stdout=(self.redirect_stdout and inout or None), 238 stderr=inout, preexec_fn=setsid) 239 if remote: 240 # wait five seconds. If the subprocess is not finished, the 241 # remote invocation has (hopefully) started a new instance. 242 time.sleep(1) 243 rc = p.poll() 244 if rc is None: 245 time.sleep(4) 246 rc = p.poll() 247 if rc is None: 248 return True 249 # if remote call failed, open() will try direct invocation 250 return not rc 251 elif self.background: 252 if p.poll() is None: 253 return True 254 else: 255 return False 256 else: 257 return not p.wait() 258 259 def open(self, url, new=0, autoraise=True): 260 if new == 0: 261 action = self.remote_action 262 elif new == 1: 263 action = self.remote_action_newwin 264 elif new == 2: 265 if self.remote_action_newtab is None: 266 action = self.remote_action_newwin 267 else: 268 action = self.remote_action_newtab 269 else: 270 raise Error("Bad 'new' parameter to open(); " + 271 "expected 0, 1, or 2, got %s" % new) 272 273 args = [arg.replace("%s", url).replace("%action", action) 274 for arg in self.remote_args] 275 success = self._invoke(args, True, autoraise) 276 if not success: 277 # remote invocation failed, try straight way 278 args = [arg.replace("%s", url) for arg in self.args] 279 return self._invoke(args, False, False) 280 else: 281 return True 282 283 284 class Mozilla(UnixBrowser): 285 """Launcher class for Mozilla/Netscape browsers.""" 286 287 raise_opts = ["-noraise", "-raise"] 288 remote_args = ['-remote', 'openURL(%s%action)'] 289 remote_action = "" 290 remote_action_newwin = ",new-window" 291 remote_action_newtab = ",new-tab" 292 background = True 293 294 Netscape = Mozilla 295 296 297 class Galeon(UnixBrowser): 298 """Launcher class for Galeon/Epiphany browsers.""" 299 300 raise_opts = ["-noraise", ""] 301 remote_args = ['%action', '%s'] 302 remote_action = "-n" 303 remote_action_newwin = "-w" 304 background = True 305 306 307 class Chrome(UnixBrowser): 308 "Launcher class for Google Chrome browser." 309 310 remote_args = ['%action', '%s'] 311 remote_action = "" 312 remote_action_newwin = "--new-window" 313 remote_action_newtab = "" 314 background = True 315 316 Chromium = Chrome 317 318 319 class Opera(UnixBrowser): 320 "Launcher class for Opera browser." 321 322 raise_opts = ["-noraise", ""] 323 remote_args = ['-remote', 'openURL(%s%action)'] 324 remote_action = "" 325 remote_action_newwin = ",new-window" 326 remote_action_newtab = ",new-page" 327 background = True 328 329 330 class Elinks(UnixBrowser): 331 "Launcher class for Elinks browsers." 332 333 remote_args = ['-remote', 'openURL(%s%action)'] 334 remote_action = "" 335 remote_action_newwin = ",new-window" 336 remote_action_newtab = ",new-tab" 337 background = False 338 339 # elinks doesn't like its stdout to be redirected - 340 # it uses redirected stdout as a signal to do -dump 341 redirect_stdout = False 342 343 344 class Konqueror(BaseBrowser): 345 """Controller for the KDE File Manager (kfm, or Konqueror). 346 347 See the output of ``kfmclient --commands`` 348 for more information on the Konqueror remote-control interface. 349 """ 350 351 def open(self, url, new=0, autoraise=True): 352 # XXX Currently I know no way to prevent KFM from opening a new win. 353 if new == 2: 354 action = "newTab" 355 else: 356 action = "openURL" 357 358 devnull = file(os.devnull, "r+") 359 # if possible, put browser in separate process group, so 360 # keyboard interrupts don't affect browser as well as Python 361 setsid = getattr(os, 'setsid', None) 362 if not setsid: 363 setsid = getattr(os, 'setpgrp', None) 364 365 try: 366 p = subprocess.Popen(["kfmclient", action, url], 367 close_fds=True, stdin=devnull, 368 stdout=devnull, stderr=devnull) 369 except OSError: 370 # fall through to next variant 371 pass 372 else: 373 p.wait() 374 # kfmclient's return code unfortunately has no meaning as it seems 375 return True 376 377 try: 378 p = subprocess.Popen(["konqueror", "--silent", url], 379 close_fds=True, stdin=devnull, 380 stdout=devnull, stderr=devnull, 381 preexec_fn=setsid) 382 except OSError: 383 # fall through to next variant 384 pass 385 else: 386 if p.poll() is None: 387 # Should be running now. 388 return True 389 390 try: 391 p = subprocess.Popen(["kfm", "-d", url], 392 close_fds=True, stdin=devnull, 393 stdout=devnull, stderr=devnull, 394 preexec_fn=setsid) 395 except OSError: 396 return False 397 else: 398 return (p.poll() is None) 399 400 401 class Grail(BaseBrowser): 402 # There should be a way to maintain a connection to Grail, but the 403 # Grail remote control protocol doesn't really allow that at this 404 # point. It probably never will! 405 def _find_grail_rc(self): 406 import glob 407 import pwd 408 import socket 409 import tempfile 410 tempdir = os.path.join(tempfile.gettempdir(), 411 ".grail-unix") 412 user = pwd.getpwuid(os.getuid())[0] 413 filename = os.path.join(tempdir, user + "-*") 414 maybes = glob.glob(filename) 415 if not maybes: 416 return None 417 s = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM) 418 for fn in maybes: 419 # need to PING each one until we find one that's live 420 try: 421 s.connect(fn) 422 except socket.error: 423 # no good; attempt to clean it out, but don't fail: 424 try: 425 os.unlink(fn) 426 except IOError: 427 pass 428 else: 429 return s 430 431 def _remote(self, action): 432 s = self._find_grail_rc() 433 if not s: 434 return 0 435 s.send(action) 436 s.close() 437 return 1 438 439 def open(self, url, new=0, autoraise=True): 440 if new: 441 ok = self._remote("LOADNEW " + url) 442 else: 443 ok = self._remote("LOAD " + url) 444 return ok 445 446 447 # 448 # Platform support for Unix 449 # 450 451 # These are the right tests because all these Unix browsers require either 452 # a console terminal or an X display to run. 453 454 def register_X_browsers(): 455 456 # use xdg-open if around 457 if _iscommand("xdg-open"): 458 register("xdg-open", None, BackgroundBrowser("xdg-open")) 459 460 # The default GNOME3 browser 461 if "GNOME_DESKTOP_SESSION_ID" in os.environ and _iscommand("gvfs-open"): 462 register("gvfs-open", None, BackgroundBrowser("gvfs-open")) 463 464 # The default GNOME browser 465 if "GNOME_DESKTOP_SESSION_ID" in os.environ and _iscommand("gnome-open"): 466 register("gnome-open", None, BackgroundBrowser("gnome-open")) 467 468 # The default KDE browser 469 if "KDE_FULL_SESSION" in os.environ and _iscommand("kfmclient"): 470 register("kfmclient", Konqueror, Konqueror("kfmclient")) 471 472 if _iscommand("x-www-browser"): 473 register("x-www-browser", None, BackgroundBrowser("x-www-browser")) 474 475 # The Mozilla/Netscape browsers 476 for browser in ("mozilla-firefox", "firefox", 477 "mozilla-firebird", "firebird", 478 "iceweasel", "iceape", 479 "seamonkey", "mozilla", "netscape"): 480 if _iscommand(browser): 481 register(browser, None, Mozilla(browser)) 482 483 # Konqueror/kfm, the KDE browser. 484 if _iscommand("kfm"): 485 register("kfm", Konqueror, Konqueror("kfm")) 486 elif _iscommand("konqueror"): 487 register("konqueror", Konqueror, Konqueror("konqueror")) 488 489 # Gnome's Galeon and Epiphany 490 for browser in ("galeon", "epiphany"): 491 if _iscommand(browser): 492 register(browser, None, Galeon(browser)) 493 494 # Skipstone, another Gtk/Mozilla based browser 495 if _iscommand("skipstone"): 496 register("skipstone", None, BackgroundBrowser("skipstone")) 497 498 # Google Chrome/Chromium browsers 499 for browser in ("google-chrome", "chrome", "chromium", "chromium-browser"): 500 if _iscommand(browser): 501 register(browser, None, Chrome(browser)) 502 503 # Opera, quite popular 504 if _iscommand("opera"): 505 register("opera", None, Opera("opera")) 506 507 # Next, Mosaic -- old but still in use. 508 if _iscommand("mosaic"): 509 register("mosaic", None, BackgroundBrowser("mosaic")) 510 511 # Grail, the Python browser. Does anybody still use it? 512 if _iscommand("grail"): 513 register("grail", Grail, None) 514 515 # Prefer X browsers if present 516 if os.environ.get("DISPLAY"): 517 register_X_browsers() 518 519 # Also try console browsers 520 if os.environ.get("TERM"): 521 if _iscommand("www-browser"): 522 register("www-browser", None, GenericBrowser("www-browser")) 523 # The Links/elinks browsers <http://artax.karlin.mff.cuni.cz/~mikulas/links/> 524 if _iscommand("links"): 525 register("links", None, GenericBrowser("links")) 526 if _iscommand("elinks"): 527 register("elinks", None, Elinks("elinks")) 528 # The Lynx browser <http://lynx.isc.org/>, <http://lynx.browser.org/> 529 if _iscommand("lynx"): 530 register("lynx", None, GenericBrowser("lynx")) 531 # The w3m browser <http://w3m.sourceforge.net/> 532 if _iscommand("w3m"): 533 register("w3m", None, GenericBrowser("w3m")) 534 535 # 536 # Platform support for Windows 537 # 538 539 if sys.platform[:3] == "win": 540 class WindowsDefault(BaseBrowser): 541 def open(self, url, new=0, autoraise=True): 542 try: 543 os.startfile(url) 544 except WindowsError: 545 # [Error 22] No application is associated with the specified 546 # file for this operation: '<URL>' 547 return False 548 else: 549 return True 550 551 _tryorder = [] 552 _browsers = {} 553 554 # First try to use the default Windows browser 555 register("windows-default", WindowsDefault) 556 557 # Detect some common Windows browsers, fallback to IE 558 iexplore = os.path.join(os.environ.get("PROGRAMFILES", "C:\\Program Files"), 559 "Internet Explorer\\IEXPLORE.EXE") 560 for browser in ("firefox", "firebird", "seamonkey", "mozilla", 561 "netscape", "opera", iexplore): 562 if _iscommand(browser): 563 register(browser, None, BackgroundBrowser(browser)) 564 565 # 566 # Platform support for MacOS 567 # 568 569 if sys.platform == 'darwin': 570 # Adapted from patch submitted to SourceForge by Steven J. Burr 571 class MacOSX(BaseBrowser): 572 """Launcher class for Aqua browsers on Mac OS X 573 574 Optionally specify a browser name on instantiation. Note that this 575 will not work for Aqua browsers if the user has moved the application 576 package after installation. 577 578 If no browser is specified, the default browser, as specified in the 579 Internet System Preferences panel, will be used. 580 """ 581 def __init__(self, name): 582 self.name = name 583 584 def open(self, url, new=0, autoraise=True): 585 assert "'" not in url 586 # hack for local urls 587 if not ':' in url: 588 url = 'file:'+url 589 590 # new must be 0 or 1 591 new = int(bool(new)) 592 if self.name == "default": 593 # User called open, open_new or get without a browser parameter 594 script = 'open location "%s"' % url.replace('"', '%22') # opens in default browser 595 else: 596 # User called get and chose a browser 597 if self.name == "OmniWeb": 598 toWindow = "" 599 else: 600 # Include toWindow parameter of OpenURL command for browsers 601 # that support it. 0 == new window; -1 == existing 602 toWindow = "toWindow %d" % (new - 1) 603 cmd = 'OpenURL "%s"' % url.replace('"', '%22') 604 script = '''tell application "%s" 605 activate 606 %s %s 607 end tell''' % (self.name, cmd, toWindow) 608 # Open pipe to AppleScript through osascript command 609 osapipe = os.popen("osascript", "w") 610 if osapipe is None: 611 return False 612 # Write script to osascript's stdin 613 osapipe.write(script) 614 rc = osapipe.close() 615 return not rc 616 617 class MacOSXOSAScript(BaseBrowser): 618 def __init__(self, name): 619 self._name = name 620 621 def open(self, url, new=0, autoraise=True): 622 if self._name == 'default': 623 script = 'open location "%s"' % url.replace('"', '%22') # opens in default browser 624 else: 625 script = ''' 626 tell application "%s" 627 activate 628 open location "%s" 629 end 630 '''%(self._name, url.replace('"', '%22')) 631 632 osapipe = os.popen("osascript", "w") 633 if osapipe is None: 634 return False 635 636 osapipe.write(script) 637 rc = osapipe.close() 638 return not rc 639 640 641 # Don't clear _tryorder or _browsers since OS X can use above Unix support 642 # (but we prefer using the OS X specific stuff) 643 register("safari", None, MacOSXOSAScript('safari'), -1) 644 register("firefox", None, MacOSXOSAScript('firefox'), -1) 645 register("chrome", None, MacOSXOSAScript('chrome'), -1) 646 register("MacOSX", None, MacOSXOSAScript('default'), -1) 647 648 649 # 650 # Platform support for OS/2 651 # 652 653 if sys.platform[:3] == "os2" and _iscommand("netscape"): 654 _tryorder = [] 655 _browsers = {} 656 register("os2netscape", None, 657 GenericBrowser(["start", "netscape", "%s"]), -1) 658 659 660 # OK, now that we know what the default preference orders for each 661 # platform are, allow user to override them with the BROWSER variable. 662 if "BROWSER" in os.environ: 663 _userchoices = os.environ["BROWSER"].split(os.pathsep) 664 _userchoices.reverse() 665 666 # Treat choices in same way as if passed into get() but do register 667 # and prepend to _tryorder 668 for cmdline in _userchoices: 669 if cmdline != '': 670 cmd = _synthesize(cmdline, -1) 671 if cmd[1] is None: 672 register(cmdline, None, GenericBrowser(cmdline), -1) 673 cmdline = None # to make del work if _userchoices was empty 674 del cmdline 675 del _userchoices 676 677 # what to do if _tryorder is now empty? 678 679 680 def main(): 681 import getopt 682 usage = """Usage: %s [-n | -t] url 683 -n: open new window 684 -t: open new tab""" % sys.argv[0] 685 try: 686 opts, args = getopt.getopt(sys.argv[1:], 'ntd') 687 except getopt.error, msg: 688 print >>sys.stderr, msg 689 print >>sys.stderr, usage 690 sys.exit(1) 691 new_win = 0 692 for o, a in opts: 693 if o == '-n': new_win = 1 694 elif o == '-t': new_win = 2 695 if len(args) != 1: 696 print >>sys.stderr, usage 697 sys.exit(1) 698 699 url = args[0] 700 open(url, new_win) 701 702 print "\a" 703 704 if __name__ == "__main__": 705 main() 706