mxi2ddlmZddlmZmZmZddlmZmZm Z ddl m Z ddl m Z erddlmZGddeeefZy ) ) annotations)IterableIteratorMutableMapping) TYPE_CHECKINGAnyoverload)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)d*dZedd%dZedd+dZedd*dZedd,dZe d-dZe d.dZed d/dZed#dZed#dZy)0QueryParamsProxyz A stateless singleton that proxies ``st.query_params`` interactions to the current script thread's QueryParams instance. cttj5}t|cdddS#1swYyxYwN)r query_paramsiterselfqps a/home/htdocs/ttos/venv/lib/python3.12/site-packages/streamlit/runtime/state/query_params_proxy.py__iter__zQueryParamsProxy.__iter__!s/  - - / 28    .7cttj5}t|cdddS#1swYyxYwr)r rlenrs r__len__zQueryParamsProxy.__len__%/  - - / 2r7   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__-sh  - - / D2 D#w D D Dt==cBCC D D DA)$A  AAcdtj5}||=dddy#1swYyxYwrr rr#s r __delitem__zQueryParamsProxy.__delitem__5s/  - - / 23   s&/zquery_params.set_itemchtj5}|||<dddy#1swYyxYwrr(rr$valuers r __setitem__zQueryParamsProxy.__setitem__91  - - / 2BsG   (1zquery_params.get_attrctj5} ||cdddS#t$rt|j |wxYw#1swYyxYwr)r rr!AttributeErrormissing_attr_error_messager#s r __getattr__zQueryParamsProxy.__getattr__>sh  - - / K2 K#w K K K$T%D%DS%IJJ K K Kr&ctj5} ||= dddy#t$rt|j |wxYw#1swYyxYwr)r rr!r1r"r#s r __delattr__zQueryParamsProxy.__delattr__Fsh  - - / J2 JsG J J J$T%C%CC%HII J J JsA($A  AAc yrrparamskwdss rupdatezQueryParamsProxy.updateMc yrr7r8s rr;zQueryParamsProxy.updateRr<r=c yrr7)rr:s rr;zQueryParamsProxy.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 rr;)rr9r:rs rr;zQueryParamsProxy.updateZs= - - / &2 BIIf % % & & &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_allps5( - - / #2::c? # # #4=zquery_params.clearc~tj5}|jdddy#1swYyxYw)zs Clear all query parameters from the URL of the app. Returns ------- None N)r rclearrs rrGzQueryParamsProxy.clears3 - - / 2 HHJ   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 parameters in the app's URL. N)r rto_dictrs rrIzQueryParamsProxy.to_dicts3" - - / 2::<   s3<cyrr7rr9s r from_dictzQueryParamsProxy.from_dictsTWr=cyrr7rKs rrLzQueryParamsProxy.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 rrL)rr9rs rrLzQueryParamsProxy.from_dicts7H - - / (2<<' ( ( (rEcd|dS)z3Returns a formatted error message for missing keys.zst.query_params has no key "".r7r$s rr"z*QueryParamsProxy.missing_key_error_messages.cU"55r=cd|dS)z9Returns a formatted error message for missing attributes.z"st.query_params has no attribute "rPr7rQs rr2z+QueryParamsProxy.missing_attr_error_messages4C5;;r=N)returnz Iterator[str])rSint)rSr)r$rrSr)r$rrSNone)r$rr,rrSrU)r90SupportsKeysAndGetItem[str, str | Iterable[str]]r:rrSrU)r9)Iterable[tuple[str, str | Iterable[str]]]r:rrSrU)r:zstr | Iterable[str]rSrU)r7)rSrU)r$rrSz list[str])rSzdict[str, str])r9rWrSrU)r9rVrSrU)r9z\SupportsKeysAndGetItem[str, str | Iterable[str]] | Iterable[tuple[str, str | Iterable[str]]]rSrU)__name__ __module__ __qualname____doc__rrrr r%r)r-r3r5r r;rBrDrGrIrL staticmethodr"r2r7r=rrrs +,D-D+,-+,K-KJFSV ?LO >>&"+,-*+#,#,() * *+ , &WW F ,-$(4$(  $(.$(L66<rcs9#>>//9I0C<~c3h/C