gE|ddlmZddlmZmZmZddlmZmZddl m Z ddl m Z erddl mZGddeeefZy ) ) annotations)IterableIteratorMutableMapping) TYPE_CHECKINGoverload)gather_metrics)get_session_state)SupportsKeysAndGetItemceZdZdZd dZd!dZd"dZedd#dZd$dZ edd%d Z ed d#d Z d$d Z e d&d Ze d'dZe d(dZd)dZedd%dZedd*dZedd+dZedd,dZe d-dZe d.dZeddZed#dZed#dZy)/QueryParamsProxyz A stateless singleton that proxies ``st.query_params`` interactions to the current script thread's QueryParams instance. cttj5}t|cdddS#1swYyxYwN)r query_paramsiterselfqps _/var/www/openai/venv/lib/python3.12/site-packages/streamlit/runtime/state/query_params_proxy.py__iter__zQueryParamsProxy.__iter__!s&  - - /280 / / .7cttj5}t|cdddS#1swYyxYwr)r rlenrs r__len__zQueryParamsProxy.__len__%&  - - /2r70 / /rcttj5}t|cdddS#1swYyxYwr)r rstrrs r__str__zQueryParamsProxy.__str__)rrzquery_params.get_itemctj5} ||cdddS#t$rt|j|wxYw#1swYyxYwr)r rKeyErrormissing_key_error_messagerkeyrs r __getitem__zQueryParamsProxy.__getitem__-sZ  - - /2 D#w0 / Dt==cBCC D0 /A)$A  AAcdtj5}||=dddy#1swYyxYwrr rr"s r __delitem__zQueryParamsProxy.__delitem__5s&  - - /230 / /s&/zquery_params.set_itemchtj5}|||<dddy#1swYyxYwrr'rr#valuers r __setitem__zQueryParamsProxy.__setitem__9(  - - /2BsG0 / /(1zquery_params.get_attrctj5} ||cdddS#t$rt|j |wxYw#1swYyxYwr)r rr AttributeErrormissing_attr_error_messager"s r __getattr__zQueryParamsProxy.__getattr__>sZ  - - /2 K#w0 / K$T%D%DS%IJJ K0 /r%ctj5} ||= dddy#t$rt|j |wxYw#1swYyxYwr)r rr r0r!r"s r __delattr__zQueryParamsProxy.__delattr__FsZ  - - /2 JsG0 / J$T%C%CC%HII J0 /sA($A  AAc yr)rmappingkwdss rupdatezQueryParamsProxy.updateMc yrr6)rkeys_and_valuesr8s rr9zQueryParamsProxy.updateRr:r;c yrr6)rr8s rr9zQueryParamsProxy.updateWs;>r;c tj5}|j|fi|dddy#1swYyxYw)a Update one or more values in query_params at once from a dictionary or dictionary-like object. See `Mapping.update()` from Python's `collections` library. Parameters ---------- other: SupportsKeysAndGetItem[str, str] | Iterable[tuple[str, str]] A dictionary or mapping of strings to strings. **kwds: str Additional key/value pairs to update passed as keyword arguments. N)r rr9)rotherr8rs rr9zQueryParamsProxy.updateZs4 - - /2 BIIe $t $0 / /s6?zquery_params.set_attrchtj5}|||<dddy#1swYyxYwrr'r*s r __setattr__zQueryParamsProxy.__setattr__kr-r.zquery_params.get_allctj5}|j|cdddS#1swYyxYw)aK Get a list of all query parameter values associated to a given key. When a key is repeated as a query parameter within the URL, this method allows all values to be obtained. In contrast, dict-like methods only retrieve the last value when a key is repeated in the URL. Parameters ---------- key: str The label of the query parameter in the URL. Returns ------- List[str] A list of values associated to the given key. May return zero, one, or multiple values. N)r rget_allr"s rrDzQueryParamsProxy.get_allps,( - - /2::c?0 / /4=zquery_params.clearc~tj5}|jdddy#1swYyxYw)zs Clear all query parameters from the URL of the app. Returns ------- None N)r rclearrs rrGzQueryParamsProxy.clears* - - /2 HHJ0 / /s3<zquery_params.to_dictc~tj5}|jcdddS#1swYyxYw)a Get all query parameters as a dictionary. This method primarily exists for internal use and is not needed for most cases. ``st.query_params`` returns an object that inherits from ``dict`` by default. When a key is repeated as a query parameter within the URL, this method will return only the last value of each unique key. Returns ------- Dict[str,str] A dictionary of the current query paramters in the app's URL. N)r rto_dictrs rrIzQueryParamsProxy.to_dicts*" - - /2::<0 / /s3<cyrr6)rr=s r from_dictzQueryParamsProxy.from_dictr:r;cyrr6)rr7s rrKzQueryParamsProxy.from_dictr:r;zquery_params.from_dictctj5}|j|cdddS#1swYyxYw)a Set all of the query parameters from a dictionary or dictionary-like object. This method primarily exists for advanced users who want to control multiple query parameters in a single update. To set individual query parameters, use key or attribute notation instead. This method inherits limitations from ``st.query_params`` and can't be used to set embedding options as described in `Embed your app `_. To handle repeated keys, the value in a key-value pair should be a list. .. note:: ``.from_dict()`` is not a direct inverse of ``.to_dict()`` if you are working with repeated keys. A true inverse operation is ``{key: st.query_params.get_all(key) for key in st.query_params}``. Parameters ---------- params: dict A dictionary used to replace the current query parameters. Example ------- >>> import streamlit as st >>> >>> st.query_params.from_dict({"foo": "bar", "baz": [1, "two"]}) N)r rrK)rparamsrs rrKzQueryParamsProxy.from_dicts.@ - - /2<<'0 / /rEcd|dS)Nzst.query_params has no key "".r6r#s rr!z*QueryParamsProxy.missing_key_error_messages-cU"55r;cd|dS)Nz"st.query_params has no attribute "rPr6rQs rr1z+QueryParamsProxy.missing_attr_error_messages3C5;;r;N)returnz Iterator[str])rSint)rSr)r#rrSr)r#rrSNone)r#rr+str | Iterable[str]rSrU)r70SupportsKeysAndGetItem[str, str | Iterable[str]]r8rrSrU)r=)Iterable[tuple[str, str | Iterable[str]]]r8rrSrU)r8rVrSrU)r6)r#rrSz list[str])rSrU)rSzdict[str, str])r=rXrSrU)r7rWrSrU)__name__ __module__ __qualname____doc__rrrr r$r(r,r2r4rr9rBrDrGrIrK staticmethodr!r1r6r;rr r s +,D-D+,-+,K-KJGTW HUX >>%"+,-*+#,#,() * *+ , &H G ,- (. (D66<rds6#>>*9I0<~c3h/