a \DfV@sUdZddlmZddlZeeZddlZddlm Z ddl m Z m Z m Z ddlmZe dZe d Zdd ddZd ed <d ZGddde ZGdddZddddddZd ddddddddZdS)!zD Utility functions for helping with operations involving browsers. ) annotationsN)abspath)LiteralProtocolcast)settings)sameZwindowtab)rrr zdict[BrowserTarget, TargetCode] NEW_PARAM)DummyWebBrowserget_browser_controllerviewc@s&eZdZdZd dddddddZd S) BrowserLikez* Interface for browser-like objects. .str TargetCodeboolurlnew autoraisereturncCsdS)Nselfrrrrr_/nfs/NAS7/SABIOD/METHODE/ermites/ermites_venv/lib/python3.9/site-packages/bokeh/util/browser.pyopen6szBrowserLike.openN)..__name__ __module__ __qualname____doc__rrrrrr2src@s&eZdZdZd ddddddd Zd S) r z( A "no-op" web-browser controller. rTrrrrcCsdS)z0 Receive standard arguments and take no action. Trrrrrr=szDummyWebBrowser.openN)rTrrrrrr 9sr z str | None)browserrcCs<t|}|durttt}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)rr#rr webbrowserr get)r# controllerrrrrAs   rr Tr BrowserTargetrNone)locationr#rrrcCsz t|}Wn"ty.td|dYn0|dr@|}n dt|}zt|}|j|||dWntyzYn0dS)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 getLoggerrlogr%os.pathrtypingrrrrr(rr __annotations____all__rr rrrrrrs