U /e@sUdZddlmZddlZeeZddlZddlm Z ddl m Z m Z ddl mZmZddlmZed Zed Zdd dd Zd ed <dZGdddeZGdddZd dddddZd!ddddddddZdS)"zD Utility functions for helping with operations involving browsers. ) annotationsN)abspath)Dictcast)LiteralProtocol)settings)sameZwindowtab)rrr zDict[BrowserTarget, TargetCode] NEW_PARAM)DummyWebBrowserget_browser_controllerviewc@s&eZdZdZd dddddddZd S) BrowserLikez* Interface for browser-like objects. .str TargetCodeboolurlnew autoraisereturncCsdS)Nselfrrrrr6/tmp/pip-unpacked-wheel-f5fndrjf/bokeh/util/browser.pyopen9szBrowserLike.openN)..__name__ __module__ __qualname____doc__rrrrrr5src@s&eZdZdZd ddddddd Zd S) rz( A "no-op" web-browser controller. rTrrrrcCsdS)z0 Receive standard arguments and take no action. Trrrrrr@szDummyWebBrowser.openN)rTrrrrrr<srz str | None)browserrcCs<t|}|dkrttt}n|dkr.t}n t|}|S)a 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 :doc:`webbrowser ` standard library module. If the value is ``None``, a system default is used. Returns: controller : a web browser controller Nnone)r r$rr webbrowserrget)r$ controllerrrrrDs   rr Tr BrowserTargetrNone)locationr$rrrcCsz t|}Wn$tk r0td|dYnX|drB|}n dt|}zt|}|j|||dWntk r~YnXdS)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 z$invalid 'new' value passed to view: z., valid values are: 'same', 'window', or 'tab'httpzfile://)rrN)r KeyError RuntimeError startswithrrr Exception)r+r$rrZnew_idrr(rrrr_s   r)N)Nr T)r# __future__rlogging getLoggerr logr&os.pathrtypingrrZtyping_extensionsrrr r)rr __annotations____all__rrrrrrrrs