o Yh-@sldZddlmZddlZddlZddlZddlmZmZddl m Z ddl m Z GdddZ dd dZdS)z6Class to store a key-value pair for the config system.) annotationsN)AnyCallable) to_snake_caserepr_c @seZdZdZdZdZddddddddeddf d-ddZd.ddZd/d d!Z e d0d#d$Z d1d2d'd(Z d3d)d*Z e d.d+d,ZdS)4 ConfigOptiona:Stores a Streamlit configuration option. A configuration option, like 'browser.serverPort', which indicates which port to use when connecting to the proxy. There are two ways to create a ConfigOption: Simple ConfigOptions are created as follows: ConfigOption('browser.serverPort', description = 'Connect to the proxy at this port.', default_val = 8501) More complex config options resolve their values at runtime as follows: @ConfigOption('browser.serverPort') def _proxy_port(): """Connect to the proxy at this port. Defaults to 8501. """ return 8501 NOTE: For complex config options, the function is called each time the option.value is evaluated! Attributes ---------- key : str The fully qualified section.name value : any The value for this option. If this is a complex config option then the callback is called EACH TIME value is evaluated. section : str The section of this option. Example: 'global'. name : str See __init__. description : str See __init__. where_defined : str Indicates which file set this config option. ConfigOption.DEFAULT_DEFINITION means this file. is_default: bool True if the config value is equal to its default value. visibility : {"visible", "hidden"} See __init__. scriptable : bool See __init__. deprecated: bool See __init__. deprecation_text : str or None See __init__. expiration_date : str or None See __init__. replaced_by : str or None See __init__. sensitive : bool See __init__. env_var: str The name of the environment variable that can be used to set the option. z z NvisibleFkeystr description str | None default_val Any | None visibility scriptablebool deprecateddeprecation_textexpiration_date replaced_bytype_type sensitivemultiplereturnNonec Cs||_d} t| |j}|durtd|jd|d|d|_|_||_||_||_ ||_ ||_ | |_ d|_ d|_tj|_| |_| |_| |_|j r\d|_ |dur\d|j d }|j rt|setd |sktd ||_t||_||dS) aCreate a ConfigOption with the given name. Parameters ---------- key : str Should be of the form "section.optionName" Examples: server.name, deprecation.v1_0_featureName description : str Like a comment for the config option. default_val : any The value for this config option. visibility : {"visible", "hidden"} Whether this option should be shown to users. scriptable : bool Whether this config option can be set within a user script. deprecated: bool Whether this config option is deprecated. deprecation_text : str or None Required if deprecated == True. Set this to a string explaining what to use instead. expiration_date : str or None Required if deprecated == True. set this to the date at which it will no longer be accepted. Format: 'YYYY-MM-DD'. replaced_by : str or None If this is option has been deprecated in favor or another option, set this to the path to the new option. Example: 'server.runOnSave'. If this is set, the 'deprecated' option will automatically be set to True, and deprecation_text will have a meaningful default (unless you override it). type_ : one of str, int, float or bool Useful to cast the config params sent by cmd option parameter. sensitive: bool Sensitive configuration options cannot be set by CLI parameter. multiple: bool Whether this config option can have multiple values. zU(?P
\_?[a-z][a-zA-Z0-9]*(\.[a-z][a-zA-Z0-9]*)*)\.(?P[a-z][a-zA-Z0-9]*)$NzKey "z" has invalid format.sectionnameTz Replaced by .z1expiration_date is required for deprecated items.z2deprecation_text is required for deprecated items.)r rematch ValueErrorgrouprrr rrrrr is_default _get_val_funcrDEFAULT_DEFINITION where_definedrrrrtextwrapdedentr set_value)selfr r rrrrrrrrrr key_formatr!r-X/var/www/html/Persson_Maskin/env/lib/python3.10/site-packages/streamlit/config_option.py__init__bs>4 zConfigOption.__init__cCst|SNrr+r-r-r.__repr__szConfigOption.__repr__ get_val_funcCallable[[], Any]cCs$|jdur td|j|_||_|S)aAssign a function to compute the value for this option. This method is called when ConfigOption is used as a decorator. Parameters ---------- get_val_func : function A function which will be called to get the value of this parameter. We will use its docString as the description. Returns ------- ConfigOption Returns self, which makes testing easier. See config_test.py. NzAComplex config options require doc strings for their description.)__doc__ RuntimeErrorr r%)r+r3r-r-r.__call__s zConfigOption.__call__rcCs|jdurdS|S)z$Get the value of this config option.N)r%r1r-r-r.values zConfigOption.valuer8r'c sfdd|_|durtj|_n||_|jk|_|jrh|jtjkrj|rEddlm }|t  t d|jd|jd|jd dSddlm }|t t d |jd |jd |jd |jd dSdSdS)zSet the value of this option. Parameters ---------- value The new value for this parameter. where_defined : str New value to remember where this parameter was set. csSr0r-r-r8r-r.sz(ConfigOption.set_value..Nr) get_loggeru ════════════════════════════════════════════════ z. IS NO LONGER SUPPORTED. z$ Please update u. ════════════════════════════════════════════════ us ════════════════════════════════════════════════ z$ IS DEPRECATED. z> This option will be removed on or after z%. Please update )r%rr&r'rr$r is_expiredstreamlit.loggerr;__name__errorr(r)r rwarningr)r+r8r'r;r-r9r.r*sD     zConfigOption.set_valuecCs&|jsdSt|j}tj}||kS)z/Returns true if expiration_date is in the past.F)r_parse_yyyymmdd_strrdatetimenow)r+rrCr-r-r.r<*s   zConfigOption.is_expiredcCs |jdd}dt|S)zLGet the name of the environment variable that can be used to set the option.r_ STREAMLIT_)r replacerupper)r+rr-r-r.env_var3szConfigOption.env_var)r r r r rrrr rrrrrr rr rr rrrrrrrr)rr )r3r4rr)rrr0)r8rr'r rr)rr)r> __module__ __qualname__r5r&STREAMLIT_DEFINITIONr r/r2r7propertyr8r*r<rHr-r-r-r.rs0? l    9 rdate_strr rdatetime.datetimecCs*dd|ddD\}}}t|||S)Ncss|]}t|VqdSr0)int).0tokenr-r-r. ;sz&_parse_yyyymmdd_str..-)splitrB)rMyearmonthdayr-r-r.rA:srA)rMr rrN)r5 __future__rrBr r(typingrrstreamlit.string_utilrstreamlit.utilrrrAr-r-r-r.s