B @\@sdZddlmZmZmZmZddlZeeZ ddl m Z ddl Z ddl m Z dddZd ZGd d d eZdd d ZdddZdS)zD Utility functions for helping with operations involving browsers. )absolute_importdivisionprint_functionunicode_literalsN)abspath)settings)tabwindow)DummyWebBrowserget_browser_controllerviewc@seZdZdZdddZdS)r z( A "no-op" web-browser controller. rTcCsdS)z0 Receive standard arguments and take no action. N)selfurlnew autoraiserr1lib/python3.7/site-packages/bokeh/util/browser.pyopen4szDummyWebBrowser.openN)rT)__name__ __module__ __qualname____doc__rrrrrr 0sr cCs6t|}|dk r.|dkr"t}q2t|}nt}|S)aV Return a browser controller. Args: browser (str or None) : browser name, or ``None`` (default: ``None``) If passed the string ``'none'``, a dummy web browser controller is returned Otherwise, use the value to select an appropriate controller using the ``webbrowser`` standard library module. In the value is ``None`` then a system default is used. .. note:: If the environment variable ``BOKEH_BROWSER`` is set, it will take precedence. Returns: controller : a web browser controller NZnone)rbrowserr webbrowserget)r controllerrrrr 8s  r sameTc Csydddd|}Wn tk r4td|YnX|drF|}n dt|}yt|}|j|||dWn$ttfk rYn YnXd S) a Open a browser to view the specified location. Args: location (str) : Location to open If location does not begin with "http:" it is assumed to be a file path on the local filesystem. browser (str or None) : what browser to use (default: None) If ``None``, use the system default browser. new (str) : How to open the location. Valid values are: ``'same'`` - open in the current tab ``'tab'`` - open a new tab in the current window ``'window'`` - open in a new window autoraise (bool) : Whether to automatically raise the location in a new browser window (default: True) Returns: None rr r)rr r zTinvalid 'new' value passed to view: %r, valid values are: 'same', 'window', or 'tab'Zhttpzfile://)rrN)KeyError RuntimeError startswithrr r SystemExitKeyboardInterrupt)locationrrrrrrrrrXs  r)N)NrT)rZ __future__rrrrZloggingZ getLoggerrlogos.pathrrrZ NEW_PARAM__all__objectr r rrrrr s