U /e0@sdZddlmZddlZeeZddlZddlZddl Z ddl Z ddl Z ddl m Z mZmZddlmZddlmZmZmZmZdZd!d d d d d dZdZd"d dddddZd#ddddddZejd$ddd dddd ZdS)%zD Provide utility functions for implementing the ``bokeh`` command. ) annotationsN)DictIteratorList) Application)DirectoryHandlerHandlerNotebookHandler ScriptHandler) build_single_handler_application!build_single_handler_applicationsdiereport_server_init_errorsstrintNone)messagestatusreturncCst|tjdt|dS)a  Print an error message and exit. This function will call ``sys.exit`` with the given ``status`` and the process will terminate. Args: message (str) : error message to print status (int) : the exit status to pass to ``sys.exit`` )fileN)printsysstderrexit)rrr6/tmp/pip-unpacked-wheel-f5fndrjf/bokeh/command/util.pyr 6s r a9 It looks like you might be running the main.py of a directory app directly. If this is the case, to enable the features of directory style apps, you must call "bokeh serve" on the directory instead. For example: bokeh serve my_app_dir/ If this is not the case, renaming main.py will suppress this warning. zList[str] | Noner)pathargvrcCs|pg}tj|}tj|r.t||d}njtj|r|drRt||d}q|dr~|drpt t t ||d}qt d|n t d||j rtd||j|jft|}|S)a; Return a Bokeh application built using a single handler for a script, notebook, or directory. In general a Bokeh :class:`~bokeh.application.application.Application` may have any number of handlers to initialize |Document| objects for new client sessions. However, in many cases only a single handler is needed. This function examines the ``path`` provided, and returns an ``Application`` initialized with one of the following handlers: * :class:`~bokeh.application.handlers.script.ScriptHandler` when ``path`` is to a ``.py`` script. * :class:`~bokeh.application.handlers.notebook.NotebookHandler` when ``path`` is to an ``.ipynb`` Jupyter notebook. * :class:`~bokeh.application.handlers.directory.DirectoryHandler` when ``path`` is to a directory containing a ``main.py`` script. Args: path (str) : path to a file or directory for creating a Bokeh application. argv (seq[str], optional) : command line arguments to pass to the application handler Returns: :class:`~bokeh.application.application.Application` Raises: RuntimeError Notes: If ``path`` ends with a file ``main.py`` then a warning will be printed regarding running directory-style apps by passing the directory instead. )filenamerz.ipynbz.pyzmain.pyz7Expected a '.py' script or '.ipynb' notebook, got: '%s'z4Path for Bokeh server application does not exist: %szError loading %s: %s %s )osrabspathisdirrisfileendswithr warningswarnDIRSTYLE_MAIN_WARNINGr ValueErrorfailed RuntimeErrorerrorZ error_detailr)rrhandler applicationrrrr Os"%        r z List[str]zDict[str, List[str]] | NonezDict[str, Application])pathsargvsrcCs^i}|p i}|D]H}t|||g}|jd}|sPd|krLtd|d}|||<q|S)a{ Return a dictionary mapping routes to Bokeh applications built using single handlers, for specified files or directories. This function iterates over ``paths`` and ``argvs`` and calls :func:`~bokeh.command.util.build_single_handler_application` on each to generate the mapping. Args: paths (seq[str]) : paths to files or directories for creating Bokeh applications. argvs (dict[str, list[str]], optional) : mapping of paths to command line arguments to pass to the handler for each path Returns: dict[str, Application] Raises: RuntimeError r/z%Don't know the URL path to use for %s)r gethandlersZurl_pathr*)r.r/Z applicationsrr-Zrouterrrr s  r z str | Nonez int | NonezIterator[None])addressportkwargsrc ksz dVWnztk r}z\|jtjkr6td|n4|jtjkrPtd|ntj|j}td||tdW5d}~XYnXdS)a A context manager to help print more informative error messages when a ``Server`` cannot be started due to a network problem. Args: address (str) : network address that the server will be listening on port (int) : network address that the server will be listening on Example: .. code-block:: python with report_server_init_errors(**server_kwargs): server = Server(applications, **server_kwargs) If there are any errors (e.g. port or address in already in use) then a critical error will be logged and the process will terminate with a call to ``sys.exit(1)`` Nz4Cannot start Bokeh server, port %s is already in usez5Cannot start Bokeh server, address '%s' not availablez"Cannot start Bokeh server [%s]: %rr) OSErrorerrnoZ EADDRINUSElogcriticalZ EADDRNOTAVAIL errorcoderr)r3r4r5ecodenamerrrrs    r)r)N)N)NN)__doc__ __future__rlogging getLogger__name__r8 contextlibr7r rr%typingrrrZbokeh.applicationrZbokeh.application.handlersrrr r __all__r r'r r contextmanagerrrrrrs$      A'