U ARdV@s.UdZddlZddlZddlZddlZddlmZddlmZm Z m Z m Z m Z ddl Z ddlmZddlmZmZmZmZmZddlmZddlmZed d Ze eefed <eZeZe eefed <da e e eefed <dZ!dZ"dZ#e!feeeddddZ$eeddddZ%eedddZ&ee eefdddZ'eeddddZ(ddd d!d ddded f ee ee ee)ee)e ee ee ee*e)ed" d#d$Z+eddd%d&Z,e(d'd(e+d)d*d e)d+e+d,d-d.e)d+e+d/d0e)d1e)d2d3d4Z-e+d5d6d.d7d8d9d:e+d;dd?d0d e)d=e+d@dAd0dBe.d=e+dCdDd0dEe/d=e+dFdGdHed+e(dIdJe+d9edKed2dLdMZ0e+dNedKed2dOdPZ1e+dQdRd d0e)d.dSe(dTdUe+dVdWd.e)d.dXe+dYdZd.e)d.dXe+d[d\d.e)d.dXe+d]d^d_ed.dXe(d`dae+dbdcd.e)d+e+ddded e)d+e+dfdgd.e)d+e+dhdid.e)d+e+djdkd.e)d+e+dldmd e)d+e(dndoe+dpdqgdre+dsdtd_ed+e+dued.dvej2ed2dwdxZ3e+dye)dKe)d2dzd{Z4e+d|d}d e)d+e+d~dd0d.e)d=e+de ed2ddZ5e+ddde/d+e+dd0dd e)de+ddded+e+ddd.e)d+e+ddd.e)d+e+ddde/d+e+ddde/d+e+ddd e)d+e+ddd e)d+e(dde+ddded+e+ddd.e)d+e+de/dKe/d2ddZ6dgZ7e+dde7dde+dde7dde(dde+ddd e)d0de+ddd e)d0de(dde+dddd.de(dde+ddd.d.e)dde+ddd.d.e)d.ddde+ddd.d.e)dÍe(ddŃe+ddde+ddde+ddde+ddde+ddde+dddeedddӄZ8ee)dԜddքZ9ee)dԜdd؄Z:dd2ddڄZ;eeedddd܄ZeedddZ?eedddZ@eddZAeBdeCdgZDde e eefe eefdddZEdd2ddZFdd2ddZGde gdfe ge)fdddZHeHeFd.deHeGdS)zLoads the configuration data.N) OrderedDict)AnyCallableDictOptionalcast)Signal) config_util developmentenv_util file_utilutil) ConfigOption)StreamlitAPIExceptionz.Special test section just used for unit tests.)_test_section_descriptions_config_options_template_config_optionszz-command-line argument or environment variablezenvironment variable)keyvalue where_definedreturnc Cs&ttt|||W5QRXdS)aSet config option. Run `streamlit config show` in the terminal to see all available options. This is an internal API. The public `st.set_option` API is implemented in `set_user_option`. Parameters ---------- key : str The config option key of the form "section.optionName". To see all available options, run `streamlit config show` on a terminal. value The new value to assign to this config option. where_defined : str Tells the config system where this was set. N) _config_lockget_config_options _set_option)rrrr4/tmp/pip-unpacked-wheel-b9et7o5g/streamlit/config.py set_optionBsr)rrrc Csjz t|}Wn4tk r@}ztdj|d|W5d}~XYnX|jrVt||dStdj|ddS)aUSet config option. Currently, only the following config options can be set within the script itself: * client.caching * client.displayEnabled * deprecation.* Calling with any other options will raise StreamlitAPIException. Run `streamlit config show` in the terminal to see all available options. Parameters ---------- key : str The config option key of the form "section.optionName". To see all available options, run `streamlit config show` on a terminal. value The new value to assign to this config option. z!Unrecognized config option: {key}rNz|{key} cannot be set on the fly. Set as command line option, e.g. streamlit run script.py --{key}, or in config.toml instead.)rKeyErrorrformat scriptabler)rroptZkerrrset_user_option\s    r#)rrc Cs@t2t}||kr td|||jW5QRSQRXdS)aNReturn the current value of a given Streamlit config option. Run `streamlit config show` in the terminal to see all available options. Parameters ---------- key : str The config option key of the form "section.optionName". To see all available options, run `streamlit config show` on a terminal. Config key "%s" not defined.N)rr RuntimeErrorrrconfig_optionsrrr get_options  r()sectionrc CsNt@t}i}|D]}|j|kr|j||j<q|W5QRSQRXdS)aGet all of the config options for the given section. Run `streamlit config show` in the terminal to see all available options. Parameters ---------- section : str The name of the config section to fetch options for. Returns ------- Dict[str, Any] A dict mapping the names of the options in the given section (without the section name as a prefix) to their values. N)rrvaluesr)rname)r)r'Zoptions_for_sectionoptionrrrget_options_for_sections  r-)r) descriptionrcCs |tkstd||t|<dS)z=Create a config section and store it globally in this module.z!Cannot define section "%s" twice.N)rAssertionError)r)r.rrr_create_sections r0FZvisible) rr. default_valr! visibility deprecateddeprecation_textexpiration_date replaced_bytype_ sensitiverc Csdt|||||||||| | d } | jtksDtd| jdtf|tksXtd|| t|<| S)aCreate a ConfigOption and store it globally in this module. There are two ways to create a ConfigOption: (1) Simple, constant config options are created as follows: _create_option('section.optionName', description = 'Put the description here.', default_val = 12345) (2) More complex, programmable config options use decorator syntax to resolve their values at runtime: @_create_option('section.optionName') def _section_option_name(): """Put the description here.""" return 12345 To achieve this sugar, _create_option() returns a *callable object* of type ConfigObject, which then decorates the function. NOTE: ConfigObjects call their evaluation functions *every time* the option is requested. To prevent this, use the `streamlit.util.memoize` decorator as follows: @_create_option('section.memoizedOptionName') @util.memoize def _section_memoized_option_name(): """Put the description here.""" (This function is only called once.) """ return 12345 ) r.r1r!r2r3r4r5r6r7r8zSection "%s" must be one of %s.z, z Cannot define option "%s" twice.)rr)rr/joinkeysr) rr.r1r!r2r3r4r5r6r7r8r,rrr_create_options.0 r;cCs8zt|=ttttft|=Wntk r2YnXdS)zVRemove a ConfigOption by key from the global store. Only for use in testing. N)rrrstrrr Exceptionrrrr_delete_options r>globalz2Global options that apply across all of Streamlit.zglobal.disableWatchdogWarninga| By default, Streamlit checks if the Python watchdog module is available and, if not, prints a warning asking for you to install it. The watchdog module is not required, but highly recommended. It improves Streamlit's ability to detect changes to files in your filesystem. If you'd like to turn off this warning, set this to True. )r.r1r7z#global.showWarningOnDirectExecutionzy If True, will show a warning when you run a Streamlit-enabled script via "python my_script.py". Tglobal.developmentModehidden)r2r7)rcCs"t o dtko dtko dtkS)zzAre we in development mode. This option defaults to True if and only if Streamlit wasn't installed normally. z site-packagesz dist-packagesZ__pypackages__)r Zis_pex__file__rrrr_global_development_mode+s rCglobal.logLevelSLevel of logging: 'error', 'warning', 'info', or 'debug'. Default: 'info' z3global.logLevel has been replaced with logger.levelz 2020-11-30z logger.level)r.r3r4r5r6zglobal.unitTestzAre we in a unit test?)r.r2r1r7z"global.suppressDeprecationWarningsz/Hide deprecation warnings in the streamlit app.zglobal.minCachedMessageSizezNOnly cache ForwardMsgs that are greater than or equal to this minimum.g@zglobal.maxCachedMessageAgezExpire cached ForwardMsgs whose age is greater than this value. A message's age is defined by how many times its script has finished running since the message has been accessed.zglobal.dataFrameSerializationa DataFrame serialization. Acceptable values: - 'legacy': Serialize DataFrames using Streamlit's custom format. Slow but battle-tested. - 'arrow': Serialize DataFrames using Apache Arrow. Much faster and versatile.Zarrowloggerz-Settings to customize Streamlit log messages.)r7cCs(tdrttdStdr dSdSdS)rErDr@debuginfoN)r(r<rrrr_logger_log_level{s  rJzlogger.messageFormatcCs tdrddlm}|SdSdS)a?String format for logging messages. If logger.datetimeFormat is set, logger messages will default to `%(asctime)s.%(msecs)03d %(message)s`. See [Python's documentation](https://docs.python.org/2.6/library/logging.html#formatter-objects) for available attributes. Default: "%(asctime)s %(message)s" r@rDEFAULT_LOG_MESSAGEz%(asctime)s %(message)sN)r(streamlit.loggerrLrKrrr_logger_message_formats  rNzlogger.enableRichay Controls whether uncaught app exceptions are logged via the rich library. If True and if rich is installed, exception tracebacks will be logged with syntax highlighting and formatting. Rich tracebacks are easier to read and show more code than standard Python tracebacks. If set to False, the default Python traceback formatting will be used.)r.r1r2r7r!clientz(Settings for scripts that use Streamlit.zclient.cachingzWhether to enable st.cache.)r.r1r7r!zclient.displayEnabledzJIf false, makes your Streamlit script not draw to a Streamlit app.zclient.showErrorDetailsa Controls whether uncaught app exceptions and deprecation warnings are displayed in the browser. By default, this is set to True and Streamlit displays app exceptions and associated tracebacks, and deprecation warnings, in the browser. If set to False, an exception or deprecation warning will result in a generic message being shown in the browser, and exceptions, tracebacks, and deprecation warnings will be printed to the console only.zclient.toolbarModeaf Change the visibility of items in the toolbar, options menu, and settings dialog (top right of the app). Allowed values: * "auto" : Show the developer options if the app is accessed through localhost and hide them otherwise. * "developer" : Show the developer options. * "viewer" : Hide the developer options. * "minimal" : Show only options set externally (e.g. through Streamlit Community Cloud) or through st.set_page_config. If there are no options left, hide the menu. autorunnerz/Settings for how Streamlit executes your scriptzrunner.magicEnabledz Allows you to type a variable or string by itself in a single line of Python code to write it to the app. zrunner.installTracerz Install a Python tracer to allow you to stop or pause your script at any point and introspect it. As a side-effect, this slows down your script's execution. zrunner.fixMatplotlibzv Sets the MPLBACKEND environment variable to Agg inside Streamlit to prevent Python crashing. zrunner.postScriptGCz Run the Python Garbage Collector after each script execution. This can help avoid excess memory use in Streamlit apps, but could introduce delay in rerunning the app script for high-memory-use applications. zrunner.fastRerunsaZ Handle script rerun requests immediately, rather than waiting for script execution to reach a yield point. This makes Streamlit much more responsive to user interaction, but it can lead to race conditions in apps that mutate session_state data outside of explicit session_state assignment statements. z&runner.enforceSerializableSessionStateaE Raise an exception after adding unserializable data to Session State. Some execution environments may require serializing all data in Session State, so it may be useful to detect incompatibility during development, or when the execution environment will stop supporting it in the future. serverz!Settings for the Streamlit serverzserver.folderWatchBlacklistzList of folders that should not be watched for changes. This impacts both "Run on Save" and @st.cache. Relative paths will be taken as relative to the current working directory. Example: ['/home/user1/env', 'relative/path/to/folder'] )r.r1zserver.fileWatcherTypea Change the type of file watcher used by Streamlit, or turn it off completely. Allowed values: * "auto" : Streamlit will attempt to use the watchdog module, and falls back to polling if watchdog is not available. * "watchdog" : Force Streamlit to use the watchdog module. * "poll" : Force Streamlit to always use polling. * "none" : Streamlit will not watch files. zserver.cookieSecret)r7r8cCstS)zSymmetric key used to produce signed cookies. If deploying on multiple replicas, this should be set to the same value across all replicas to ensure they all share the same secret. Default: randomly generated secret key. )secretsZ token_hexrrrr_server_cookie_secretLsrTzserver.headlesscCs*tjrtdsdStddk r&dSdS)zIf false, will attempt to open a browser window on start. Default: false unless (1) we are on a Linux box where DISPLAY is unset, or (2) we are running in the Streamlit Atom plugin. ZDISPLAYTZ%IS_RUNNING_IN_STREAMLIT_EDITOR_PLUGINNF)r ZIS_LINUX_OR_BSDosgetenvrrrr_server_headlessWs rWzserver.runOnSavezO Automatically rerun script when the file is modified on disk. zserver.allowRunOnSavezJ Allows users to automatically rerun when app is updated. zserver.addresscCsdS)aThe address where the server will listen for client and browser connections. Use this if you want to bind the server to a specific address. If set, the server will only be accessible from this address, and not from any aliases (like localhost). Default: (unset) Nrrrrr_server_address}s rX server.portzG The port where the server will listen for browser connections.i5!zserver.scriptHealthCheckEnableda Flag for enabling the script health check endpoint. It used for checking if a script loads successfully. On success, the endpoint will return a 200 HTTP status code. On failure, the endpoint will return a 503 HTTP status code. Note: This is an experimental Streamlit internal API. The API is subject to change anytime so this should be used at your own risk )r2r.r1r7zserver.baseUrlPathzR The base path for the URL where Streamlit should be served from. server.enableCORSa Enables support for Cross-Origin Resource Sharing (CORS) protection, for added security. Due to conflicts between CORS and XSRF, if `server.enableXsrfProtection` is on and `server.enableCORS` is off at the same time, we will prioritize `server.enableXsrfProtection`. server.enableXsrfProtectiona* Enables support for Cross-Site Request Forgery (XSRF) protection, for added security. Due to conflicts between CORS and XSRF, if `server.enableXsrfProtection` is on and `server.enableCORS` is off at the same time, we will prioritize `server.enableXsrfProtection`. zserver.maxUploadSizezT Max size, in megabytes, for files uploaded with the file_uploader. zserver.maxMessageSizezd Max size, in megabytes, of messages that can be sent via the WebSocket connection. z!server.enableWebsocketCompressionz< Enables support for websocket compression. zserver.enableStaticServingz` Enable serving files from a `static` directory in the running app's directory. Zbrowserz(Configuration of non-UI browser options.zbrowser.serverAddressa; Internet address where users should point their browsers in order to connect to the app. Can be IP address or DNS name and path. This is used to: - Set the correct URL for CORS and XSRF protection purposes. - Show the URL on the terminal - Open the browser localhostzbrowser.gatherUsageStatsz@ Whether to send usage statistics to Streamlit. browser.serverPortcCs ttdS)aPort where users should point their browsers in order to connect to the app. This is used to: - Set the correct URL for CORS and XSRF protection purposes. - Show the URL on the terminal - Open the browser Default: whatever value is set in server.port. rY)intr(rrrr_browser_server_ports razDO NOT USE THIS OPTION IN A PRODUCTION ENVIRONMENT. It has not gone through security audits or performance tests. For the production environment, we recommend performing SSL termination by the load balancer or the reverse proxy.zserver.sslCertFilez Server certificate file for connecting via HTTPS. Must be set at the same time as "server.sslKeyFile". z )r.zserver.sslKeyFilez Cryptographic key file for connecting via HTTPS. Must be set at the same time as "server.sslCertFile". uiz6Configuration of UI elements displayed in the browser.z ui.hideTopBarz Flag to hide most of the UI elements found at the top of a Streamlit app. NOTE: This does *not* hide the hamburger menu in the top-right of an app. )r.r1r7r2zui.hideSidebarNavz3Flag to hide the sidebar page navigation component.Zmapboxz2Mapbox configuration that is being used by DeckGL.z mapbox.tokenzConfigure Streamlit to use a custom Mapbox token for elements like st.pydeck_chart and st.map. To get a token for yourself, create an account at https://mapbox.com. It's free (for moderate usage levels)!)r.r1r8 deprecationz3Configuration to show or hide deprecation warnings.z$deprecation.showfileUploaderEncodingzOSet to false to disable the deprecation warning for the file uploader encoding.z 2021-01-06)r.r1r!r7r5zdeprecation.showImageFormatzOSet to false to disable the deprecation warning for the image format parameter.z3The format parameter for st.image has been removed.z 2021-03-24)r.r1r!r7r3r4r5zdeprecation.showPyplotGlobalUsezUSet to false to disable the deprecation warning for using the global pyplot instance.)r.r1r!r7Zthemez9Settings to define a custom theme for your Streamlit app.z theme.basez^The preset Streamlit theme that your custom theme inherits from. One of "light" or "dark".ztheme.primaryColorz.Primary accent color for interactive elements.ztheme.backgroundColorz+Background color for the main content area.ztheme.secondaryBackgroundColorzCBackground color used for the sidebar and most interactive widgets.ztheme.textColorzColor used for almost all text.z theme.fontzx Font family for all text in the app, except code blocks. One of "sans serif", "serif", or "monospace". c Cs@t2t}||kr td|||jW5QRSQRXdS)zIndicate where (e.g. in which file) this option was defined. Parameters ---------- key : str The config option key of the form "section.optionName" r$N)rrr%rr&rrrget_where_defineds  rd) option_namercCst|tjkS)zCheck if a given option has not been set by the user. Parameters ---------- option_name : str The option to check Returns ------- bool True if the option has not been set by the user. )rdrDEFAULT_DEFINITIONrerrr _is_unsetsrhcCst|tjtjfkS)zCheck if a given option was actually defined by the user. Parameters ---------- option_name : str The option to check Returns ------- bool True if the option has been set by the user. )rdrrfZSTREAMLIT_DEFINITIONrgrrris_manually_setsric Cs.t ttttttftW5QRXdS)z)Print all config options to the terminal.N) rr show_configrrrr<rrrrrrrjs rjcCsTtdk std|tkr@ddlm}|t}|d|dnt|||dS)aSet a config option by key / value pair. This function assumes that the _config_options dictionary has already been populated and thus should only be used within this file and by tests. Parameters ---------- key : str The key of the option, like "logger.level". value The value of the option. where_defined : str Tells the config system where this was set. Nz0_config_options should always be populated here.r get_logger"zg" is not a valid config option. If you previously had this config option set, it may have been removed.)rr/rMrl__name__warning set_value)rrrrlLOGGERrrrrs  r)r'cCsB|D]4\}}|jsqtj|j}|dkr0qt||tqdS)z{Update the config system by parsing the environment variable. This should only be called from get_config_options. N)itemsr8rUenvirongetenv_varr_DEFINED_BY_ENV_VAR)r'opt_nameopt_valZ env_var_valuerrr%_update_config_with_sensitive_env_var sry)raw_tomlrrcCsPt|}|D]8\}}|D]&\}}t|}t|d|||q"qdS)a)Update the config system by parsing this string. This should only be called from get_config_options. Parameters ---------- raw_toml : str The TOML file to parse to update the config values. where_defined : str Tells the config system where this was set. .N)tomlloadsrr_maybe_read_env_variabler)rzrZparsed_config_filer)optionsr+rrrr_update_config_with_tomls r)rrcCsht|trd|drd|tdd}tj|}|dkr\ddlm}|t }| d|nt |S|S)aUIf value is "env:foo", return value of environment variable "foo". If value is not in the shape above, returns the value right back. Parameters ---------- value : any The value to check Returns ------- any Either returns value right back, or the value of the environment variable. zenv:Nrrkz!No environment variable called %s) isinstancer< startswithlenrUrsrtrMrlrnerror_maybe_convert_to_number)rvar_namerurlrqrrrr~.s  r~)vrcCsDz t|WStk rYnXz t|WStk r>YnX|S)z-Convert v to int or float, or leave it as is.)r`r=float)rrrrrPs  rz'Emitted when the config file is parsed.)docz config.toml)options_from_flagsrc Cs|si}t}|r|s|Sttr6|s6tW5QRSt}ttatD]>}tj|sZqHt |ddd}| }W5QRXt ||qHt t| D]\}}t||tq|rt|trddlm} | t} | dttW5QRSQRXdS)aCreate and return a dict mapping config option names to their values, returning a cached dict if possible. Config option values are sourced from the following locations. Values set in locations further down the list overwrite those set earlier. 1. default values defined in this file 2. the global `~/.streamlit/config.toml` file 3. per-project `$CWD/.streamlit/config.toml` files 4. environment variables such as `STREAMLIT_SERVER_PORT` 5. command line flags passed to `streamlit run` Parameters ---------- force_reparse : bool Force config files to be parsed so that we pick up any changes to them. options_from_flags : Optional[Dict[str, any] Config options that we received via CLI flag. Returns ------- Dict[str, ConfigOption] An ordered dict that maps config option names to their values. rzutf-8)encodingrrkz{An update to the [server] config option section was detected. To have these changes be reflected, please restart streamlit.N)rrcopydeepcopyrCONFIG_FILENAMESrUpathexistsopenreadrryrrr_DEFINED_BY_FLAGr Zserver_option_changedrMrlrnro_on_config_parsedsend) Z force_reparserr'Z old_optionsfilenameinput file_contentsrwrxrlrqrrrris<    rcCsbddlm}|t}tdrserver.port does not work when global.developmentMode is true.r_zEbrowser.serverPort does not work when global.developmentMode is true.r\r[a Warning: the config option 'server.enableCORS=false' is not compatible with 'server.enableXsrfProtection=true'. As a result, 'server.enableCORS' is being overridden to 'true'. More information: In order to protect against CSRF attacks, we send a cookie with each request. To do so, we must specify allowable origins, which places a restriction on cross-origin resource sharing. If cross origin resource sharing is required, please disable server.enableXsrfProtection. )rMrlrnr(rhr/ro)rlrqrrr_check_conflictss  rcCstdt_dS)Nr@)r(r Zis_development_moderrrr_set_development_modesr)funcrcsHfddfdd}fdd|s.ts>tjddn|S) aSWait for the config file to be parsed then call func. If the config file has already been parsed, just calls func immediately unless force_connect is set. Parameters ---------- func : Callable[[], None] A function to run on config parse. force_connect : bool Wait until the next config file parse to run func, even if config files have already been parsed. lock : bool If set, grab _config_lock before running func. Returns ------- Callable[[], bool] A function that the caller can use to deregister func. csSNr)_)func_with_lockrrz"on_config_parsed..cs tSr)r disconnectr)receiverrrrsz$on_config_parsed..disconnectc s&rt W5QRXndSr)rr)rlockrrrsz(on_config_parsed..func_with_lockF)Zweak)rrconnect)rZ force_connectrrr)rrrrron_config_parseds  r)r)FN)FF)I__doc__rrUrS threading collectionsrtypingrrrrrr|ZblinkerrZ streamlitr r r r r Zstreamlit.config_optionrZstreamlit.errorsrrr<__annotations__RLockrrrZ _USER_DEFINEDrrvrr#r(r-r0booltyper;r>rCrr`rJrNmemoizerTrWrXraZ_SSL_PRODUCTION_WARNINGrdrhrirjrryrr~rrZget_streamlit_file_pathZget_project_streamlit_file_pathrrrrrrrrrs(    '  H                                             !"  N(  7