-ejbUdZddlmZddlZejeZddlZddlm Z m Z m Z ddl m Z mZmZmZmZmZmZmZmZddlZddlmZmZe rddlmZdd lmZdd lmZd Z d5dZ!d6dZ"d7dZ#edZ$de%d<ee&dfZ'de%d<ej(ej)ej*ej+ej,dddZ-d8dZ.edZ/d9d!Z0d5d"Z1Gd#d$Z2ed%Z3ee3e4e2fZ5de%d&<d:d'Z6Gd(d)ee3Z7e e d*d+d,fZ8d-e%d.<Gd/d0Z9e9Z:e:;Zm?Z?e?d3[m?Z?e?d4dSdSdS);a Control global configuration options with environment variables. A global settings object that other parts of Bokeh can refer to. Defined Settings ~~~~~~~~~~~~~~~~ Settings are accessible on the ``bokeh.settings.settings`` instance, via accessor methods. For instance: .. code-block:: python settings.minified() Bokeh provides the following defined settings: .. bokeh-settings:: settings :module: bokeh.settings Precedence ~~~~~~~~~~ Setting values are always looked up in the following prescribed order: immediately supplied values These are values that are passed to the setting: .. code-block:: python settings.minified(minified_val) If ``minified_val`` is not None, then it will be returned, as-is. Otherwise, if None is passed, then the setting will continute to look down the search order for a value. This is useful for passing optional function paramters that are None by default. If the parameter is passed to the function, then it will take precedence. previously user-set values If the value is set explicity in code: .. code-block:: python settings.minified = False Then this value will take precedence over other sources. Applications may use this ability to set values supplied on the command line, so that they take precedence over environment variables. user-specified config override file Values from a YAML configuration file that is explicitly loaded: .. code-block:: python settings.load_config("/path/to/bokeh.yaml) Any values from ``bokeh.yaml`` will take precedence over the sources below. Applications may offer command line arguments to load such a file. e.g. ``bokeh serve --use-config myconf.yaml`` environment variable Values found in the associated environment variables: .. code-block:: sh BOKEH_MINIFIED=no bokeh serve app.py local user config file Bokeh will look for a YAML configuration file in the current user's home directory ``${HOME}/.bokeh/bokeh.yaml``. global system configuration (not yet implemented) Future support is planned to load Bokeh settings from global system configurations. local defaults These are default values defined when accessing the setting: .. code-block:: python settings.resources(default="server") Local defaults have lower precendence than every other setting mechanism except global defaults. global defaults These are default values defined by the setting declarations. They have lower precedence than every other setting mechanism. If no value is obtained after searching all of these locations, then a RuntimeError will be raised. API ~~~ There are a few methods on the ``settings`` object: .. autoclass:: Settings :members: ) annotationsN)abspath expanduserjoin) TYPE_CHECKINGAnyCallableGenericLiteralSequenceTypeVarUnioncast) bokehjsdir serverdir) TypeAlias)PathLike) ResourcesMode)settingsvaluestrreturnc|S)z Return a string as-is. rs .lib/python3.11/site-packages/bokeh/settings.py convert_strrs  L bool | strboolct|tr|S|}|dvrdS|dvrdStd|d)an Convert a string to True or False. If a boolean is passed in, it is returned as-is. Otherwise the function maps the following strings, ignoring case: * "yes", "1", "on" -> True * "no", "0", "off" -> False Args: value (str): A string value to convert to bool Returns: bool Raises: ValueError )yes1ontrueTrueT)no0offfalseFalseFCannot convert z to boolean value) isinstancer!lower ValueError)rvals r convert_boolr2sd(% ++--C 000t 222u ?u??? @ @@rlist[str] | str list[str]ct|ttfr|S |dS#t$rt d|dwxYw)z Convert a string to a list of strings. If a list or tuple is passed in, it is returned as-is. Args: value (seq[str] or str) : A string to convert to a list of strings Returns list[str] ,r-z to list value)r.listtuplesplit Exceptionr0rs rconvert_str_seqr;sp%$'' B{{3 BBB@5@@@AAABs 5A)tracedebuginfowarnerrorfatalrLogLevel PyLogLevel )CRITICALERRORWARNINGINFODEBUGTRACENONE str | intc4|t|tr+|ttvr|Sn*|}|tvr t|St d|ddt)aConvert a string to a Python logging level If a log level is passed in, it is returned as-is. Otherwise the function understands the following strings, ignoring case: * "critical" * "error" * "warning" * "info" * "debug" * "trace" * "none" Args: value (str): A string value to convert to a logging level Returns: int or None Raises: ValueError Nr-z! to log level, valid values are: z, )r.intset _log_levelsvaluesupperr0rrs rconvert_loggingrSs2 } 5#..} C **,,-- - -L .  K  u% % guggtyyYdOeOegg h hhr)noneerrorsallstr | ValidationLevelValidationLevelchd}|}||vrtt|Std|d|)aConvert a string to a validation level If a validation level is passed in, it is returned as-is. Args: value (str): A string value to convert to a validation level Returns: string Raises: ValueError >rVrTrUr-z( to validation level, valid values are: )r/rrXr0)r VALID_LEVELSlowereds rconvert_validationr\sW -,,LkkmmG,OW--- huhhXdhh i iirc|}|dkrdS|dkrttddS|dkrttddS|dst d|d |S) zConvert a string to an .ico path Args: value (str): A string value to convert to a .ico path Returns: string Raises: ValueError rTdefaultviewsz bokeh.ico default-devz bokeh-dev.icoz.icor-z to valid .ico path)r/rrendswithr0)rr[s rconvert_ico_pathrb'skkmmG&v)IKK+666-IKK/::: >>& ! !IG5GGGHHH LrceZdZdS)_UnsetN)__name__ __module__ __qualname__rrrrdrdFsrrdTUnsetc\ttjddS)N BOKEH_DEVF)r2osenvirongetrrris_devroLs  {E:: ; ;;rceZdZUdZded<ded<deeddfd*dZdefd+dZd,dZd-d Z d.d!Z d/d"Z d0d#Z e d1d$Ze d2d%Ze d2d&Ze d3d'Ze d3d(Ze d3d)ZdS)4PrioritizedSettinga Return a value for a global setting according to configuration precedence. The following methods are searched in order for the setting: 7. immediately supplied values 6. previously user-set values (e.g. set from command line) 5. user-specified config override file 4. environment variable 3. local user config file 2. global system config file (not yet implemented) 1. local defaults 0. global defaults Ref: https://stackoverflow.com/a/11077282/3406693 If a value cannot be determined, a ValueError is raised. The ``env_var`` argument specifies the name of an environment to check for setting values, e.g. ``"BOKEH_LOG_LEVEL"``. The optional ``default`` argument specified an implicit default value for the setting that is returned if no other methods provide a value. A ``convert`` agument may be provided to convert values before they are returned. For instance to concert log levels in environment variables to ``logging`` module values. zSettings | None_parentzUnset[str | T] _user_valueNnamerenv_var str | Noner^Unset[T] dev_defaultconvertCallable[[T | str], T] | NonehelprNonec|r|nt|_||_||_||_||_||_d|_t|_ dSN) r_convert_default _dev_default_env_var_help_namerrrdrs)selfrurvr^ryrzr|s r__init__zPrioritizedSetting.__init__osK#*;   '    !rrT | str | Nonerhc|||S|jtur||jS|jr=|j|jjvr*||jj|jS|jr=|jtjvr*|tj|jS|jr=|j|jj vr*||jj |jS|jr=|j|jj vr*||jj |jStr(|j tur||j S|tur||S|j tur||j Std|j)aReturn the setting value according to the standard precedence. Args: value (any, optional): An optional immediate value. If not None, the value will be converted, then returned. default (any, optional): An optional default value that only takes precendence over implicit default values specified on the property itself. Returns: str or int or float Raises: RuntimeError Nz&No configured value found for setting )rrsrdrrrconfig_overriderrlrm config_user config_systemrorr RuntimeError)rrr^s r__call__zPrioritizedSetting.__call__zs(  =='' '  6 ) )==!122 2 < KDJ$,*FFF==!=dj!IJJ J = =. . .%% =, , ,:=)))r)rurrvrwr^rxryrxrzr{r|rrr})rrr^rxrrh)rrrrrr)rrrrrr})rrrr})rrrr}rr})rrw)rrxrr)rerfrg__doc____annotations__rdrrrrrrrpropertyrvr^ryrur|rrrrrqrqOs88Zd?ed:<e d@dAedBd7dCDZd9ed@<e dEdFddGZdedE<e dHdIedBdJKZd9edL<e dMdNd7dBdOZd9edM<e dPdQdd=edR3ZdSedP<e dTdUdVdWdXZ dYedT<e dZd[dd\Z!d]edZ<e d^d_d`daZ"d4ed^<e dbdcdddeZ#dfedb<e dgdhddiZ$dedg<e djdkd7dlZ%d9edj<e dmdndBedoZ&d9edm<e dpdqddrZ'dedp<e dsdtdduZ(deds<e dvdwddxZ)dedv<e dydzde*d{Z+d|edy<e d}d~d7edZ,d9ed}<ddZ-ddZ.ddZ/ddZ0ddZ1ddZ2dS)Settingsz dict[str, Any]_config_override _config_user_config_systemrr}ci|_|t|_i|_|jjD]}t|tr||_ dSr) r_try_load_configrrr __class____dict__rQr.rqrr)rxs rrzSettings.__init__sn " 112HII (//11 ! !A!/00 !   ! !rc*t|jSr)dictrrs rrzSettings.config_systemsD'(((rc*t|jSr)rrrs rrzSettings.config_usersD%&&&rc*t|jSr)rrrs rrzSettings.config_overridesD)***rr!ctSr)rors rdevz Settings.devs xxrallowed_ws_originBOKEH_ALLOW_WS_ORIGINz\ A comma-separated list of allowed websocket origins for Bokeh server applications. )r^rzr|zPrioritizedSetting[list[str]] auth_moduleBOKEH_AUTH_MODULENz A path to a Python modules that implements user authentication functions for the Bokeh server. .. warning:: The contents of this module will be executed! )r^r|zPrioritizedSetting[str | None]browser BOKEH_BROWSERrTz The default browser that Bokeh should use to show documents with. Valid values are any of the predefined browser names understood by the Python standard library :doc:`webbrowser ` module. )r^ryr|versionBOKEH_CDN_VERSIONz What version of BokehJS to use with CDN resources. See the :class:`~bokeh.resources.Resources` class reference for full details. cdn_versionchromedriver_pathBOKEH_CHROMEDRIVER_PATHaX The name of or full path to chromedriver's executable. This is used to allow ``bokeh.io.export`` to work on systems that use a different name for ``chromedriver``, like ``chromedriver-binary`` or ``chromium.chromedriver`` (or its variant, which is used for example by Snap package manager; see https://snapcraft.io/). cookie_secretBOKEH_COOKIE_SECRETz Configure the ``cookie_secret`` setting in Tornado. This value is required if you use ``get_secure_cookie`` or ``set_secure_cookie``. It should be a long, random sequence of bytes docs_cdnBOKEH_DOCS_CDNaZ The version of BokehJS that should be use for loading CDN resources when building the docs. To build and display the docs using a locally built BokehJS, use ``local``. For example: .. code-block:: sh BOKEH_DOCS_CDN=local make clean serve Will build a fresh copy of the docs using the locally built BokehJS and open a new browser tab to view them. Otherwise, the value is interpreted a version for CDN. For example: .. code-block:: sh BOKEH_DOCS_CDN=1.4.0rc1 make clean will build docs that use BokehJS version ``1.4.0rc1`` from CDN. docs_versionBOKEH_DOCS_VERSIONz The Bokeh version to stipulate when building the docs. This setting is necessary to re-deploy existing versions of docs with new fixes or changes. ico_pathBOKEH_ICO_PATHr^r`a8 Configure the file path to a .ico file for the Bokeh server to use as a favicon.ico file. The value should be the full path to a .ico file, or one the following special values: - ``default`` to use the default project .ico file - ``none`` to turn off favicon.ico support entirely )r^ryrzr|zPrioritizedSetting[str]ignore_filenameBOKEH_IGNORE_FILENAMEFzR Whether to ignore the current script filename when saving Bokeh content. zPrioritizedSetting[bool] log_levelBOKEH_LOG_LEVELr>r=z Set the log level for JavaScript BokehJS code. Valid values are, in order of increasing severity: - ``trace`` - ``debug`` - ``info`` - ``warn`` - ``error`` - ``fatal`` zPrioritizedSetting[LogLevel]minifiedBOKEH_MINIFIEDTz> Whether Bokeh should use minified BokehJS resources. )rzr^ryr| nodejs_pathBOKEH_NODEJS_PATHaW Path to the Node executable. NodeJS is an optional dependency that is required for PNG and SVG export, and for compiling custom extensions. Bokeh will try to automatically locate an installed Node executable. Use this environment variable to override the location Bokeh finds, or to point to a non-standard location. validate_docBOKEH_VALIDATE_DOCz whether Bokeh should perform validation checks on documents. Setting this value to False may afford a small performance improvement. )rzr^r|perform_document_validationpretty BOKEH_PRETTYz8 Whether JSON strings should be pretty-printed. py_log_levelBOKEH_PY_LOG_LEVELz The log level for Python Bokeh code. Valid values are, in order of increasing severity: - ``trace`` - ``debug`` - ``info`` - ``warn`` - ``error`` - ``fatal`` - ``none`` zPrioritizedSetting[PyLogLevel] resourcesBOKEH_RESOURCEScdnz absolute-devz What kind of BokehJS resources to configure, e.g ``inline`` or ``cdn`` See the :class:`~bokeh.resources.Resources` class reference for full details. z!PrioritizedSetting[ResourcesMode]rootdir BOKEH_ROOTDIRz Root directory to use with ``relative`` resources See the :class:`~bokeh.resources.Resources` class reference for full details. z#PrioritizedSetting[PathLike | None]default_server_hostBOKEH_DEFAULT_SERVER_HOST localhostzQ Allows to define the default host used by Bokeh's server and resources. default_server_portBOKEH_DEFAULT_SERVER_PORTizQ Allows to define the default port used by Bokeh's server and resources. zPrioritizedSetting[int] secret_keyBOKEH_SECRET_KEYzO A long, cryptographically-random secret unique to a Bokeh deployment. sign_sessionsBOKEH_SIGN_SESSIONSz Whether the Boeh server should only allow sessions signed with a secret key. If True, ``BOKEH_SECRET_KEY`` must also be set. simple_idsBOKEH_SIMPLE_IDSz Whether Bokeh should use simple integers for model IDs (starting at 1000). If False, Bokeh will use UUIDs for object identifiers. This might be needed, e.g., if multiple processes are contributing to a single Bokeh Document. ssl_certfileBOKEH_SSL_CERTFILEz= The path to a certificate file for SSL termination. ssl_keyfileBOKEH_SSL_KEYFILEz= The path to a private key file for SSL termination. ssl_passwordBOKEH_SSL_PASSWORDz> A password to decrypt the SSL keyfile, if necessary. validation_levelBOKEH_VALIDATION_LEVELa" Whether validation checks should log or raise exceptions on errors and warnings. Valid values are: - ``none``: no exceptions raised (default). - ``errors``: exception raised on errors (but not on warnings) - ``all``: exception raised on both errors and warnings z#PrioritizedSetting[ValidationLevel] xsrf_cookiesBOKEH_XSRF_COOKIESa Whether to enable Tornado XSRF cookie protection on the Bokeh server. This is only applicable when also using an auth module or custom handlers. See https://www.tornadoweb.org/en/stable/guide/security.html#cross-site-request-forgery-protection for more information about XSRF protection in Tornado. All PUT, POST, and DELETE handlers will need to be appropriately instrumented when this setting is active. rc*t|jS)z3 The location of the BokehJS source tree. )rrrs rrzSettings.bokehjsdirs$(###rr4cg}tj|D]C\}}}|D]:}|dr#|t ||;D|S)z2 The CSS files in the BokehJS directory. z.cssrlwalkrraappendr)r css_filesroot_filesfnames rrzSettings.css_filess "  gdoo&7&788 8 8ND!U 8 8>>&))8$$T$%6%6777 8rcg}tj|D]C\}}}|D]:}|dr#|t ||;D|S)z1 The JS files in the BokehJS directory. z.jsr)rjs_filesrrrr s rr zSettings.js_filess~! gdoo&7&788 7 7ND!U 7 7>>%((7OODu$5$5666 7rlocationc tjtt|tj|_dS#t $rtd|wxYw)z{ Load a user-specified override config file. The file should be a YAML format with ``key: value`` lines. Loaderz"Could not load Bokeh config file: N)yamlloadopenr SafeLoaderrr:r)rr s r load_configzSettings.load_configsm  P$(Id783D3D.E.Edo$^$^$^D ! ! ! P P PNHNNOO O Ps ?AA  bytes | Nonect|ds8|}|d|_n|d|_|jS)z@ Return the secret_key, converted to bytes and cached. _secret_key_bytesNzutf-8)hasattrrrencode)rkeys rsecret_key_byteszSettings.secret_key_bytessSt011 =//##C{)-&&),G)<)<&%%r locationsrc|D]A} tjt|tjcS#t$rY>wxYwiS)Nr)rrrrr:)rrr s rrzSettings._try_load_config*s^!  H yhHHHHHH     s,5 AAr)rrrr!r)rr4)r rrr})rr)rrrr)3rerfrgrrrrrrrrrqr;rrrrrrrrrbrr2rrrrrrrSrrrrrrrrrrrr\rrrrr rrrrrrrrsL%$$$    """"!!!!)))X)'''X'+++X+X8J7IJ]_vACM\c8 8 8     3E2D]Tgqu}3 3 3 K    /A.@Oeiw}E/ / / G    3E2DYPcmqy3 3 3 K    9K8JK^`yDHO9 9 9     5G4FXmw{C5 5 5 M    0B/A*N^hlt0 0 0 H    .4F3EnVjtx@4 4 4 L    );(::GW}>N V ) ) ) H     1C0BCTVmw|GSZ1 1 1 O    /A.@N_io~E L / / / I     *<);JHXbnx|KPW* * * H    3E2D]Tgqu}3 3 3 K    =O+=lL^hlwCJ, , , J    4F3EnVjtx@4 4 4 L    3E2D]Tgqu}3 3 3 K    4F3EnVjtx@4 4 4 L    =Or.sbbbN#"""""g!! ----------                       .-------)++++++$$$$$$((((((   AAAA>BBBB,PQQQQQc4i( ((((! !i!i!i!iF12jjjj0> GCLLDL)))))<<<<h*h*h*h*h*h*h*h*V DC(L11)ssssssssz 8::!!## ss;//"44######D ABBB O 3 3 5 5 =######D MNNNNNOO = =r