o hE@stddlmZddlmZmZmZddlmZmZddl m Z ddl m Z er,ddl mZGdddeeefZd S) ) annotations)IterableIteratorMutableMapping) TYPE_CHECKINGoverload)gather_metrics)get_session_state)SupportsKeysAndGetItemc@s<eZdZdZd@ddZdAddZdBd d Zed dCddZdDddZ eddEddZ eddCddZ dDddZ e dFd d!Ze dGd$d!Ze dHd%d!ZdId'd!Zed(dEd)d*Zed+dJd-d.Zed/dKd0d1Zed2dLd4d5Ze dMd6d7Ze dNd8d7Zed9d:d7ZedCd;d<ZedCd=d>Zd?S)OQueryParamsProxyz A stateless singleton that proxies ``st.query_params`` interactions to the current script thread's QueryParams instance. return Iterator[str]cC6t }t|WdS1swYdSN)r query_paramsiterselfqpr^/var/www/vscode/kcb/lib/python3.10/site-packages/streamlit/runtime/state/query_params_proxy.py__iter__! $zQueryParamsProxy.__iter__intcCrr)r rlenrrrr__len__%rzQueryParamsProxy.__len__strcCrr)r rrrrrr__str__)rzQueryParamsProxy.__str__zquery_params.get_itemkeyc CsVt}z ||WWdSty t||w1s$wYdSr)r rKeyErrormissing_key_error_messagerrrrrr __getitem__-  zQueryParamsProxy.__getitem__NonecCs6t }||=WddS1swYdSrr rr!rrr __delitem__5s "zQueryParamsProxy.__delitem__zquery_params.set_itemvaluestr | Iterable[str]cC8t }|||<WddS1swYdSrr%rrr'rrrr __setitem__9  "zQueryParamsProxy.__setitem__zquery_params.get_attrc CsVt}z ||WWdSty t||w1s$wYdSr)r rrAttributeErrormissing_attr_error_messager!rrr __getattr__>r#zQueryParamsProxy.__getattr__c CsXt}z||=Wntyt||wWddS1s%wYdSr)r rrr-r r!rrr __delattr__Fs   "zQueryParamsProxy.__delattr__mapping0SupportsKeysAndGetItem[str, str | Iterable[str]]kwdscKdSrr)rr1r3rrrupdateMzQueryParamsProxy.updatekeys_and_values)Iterable[tuple[str, str | Iterable[str]]]cKr4rr)rr7r3rrrr5Rr6cKr4rr)rr3rrrr5WsrcKsBt}|j|fi|WddS1swYdS)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 rr5)rotherr3rrrrr5Zs "zquery_params.set_attrcCr)rr%r*rrr __setattr__kr,zQueryParamsProxy.__setattr__zquery_params.get_all list[str]cC8t }||WdS1swYdS)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!rrrr=ps $zQueryParamsProxy.get_allzquery_params.clearcCs8t }|WddS1swYdS)zs Clear all query parameters from the URL of the app. Returns ------- None N)r rclearrrrrr>s "zQueryParamsProxy.clearzquery_params.to_dictdict[str, str]cCs6t }|WdS1swYdS)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_dictrrrrr@s $zQueryParamsProxy.to_dictcCr4rr)rr7rrr from_dictr6zQueryParamsProxy.from_dictcCr4rr)rr1rrrrAr6zquery_params.from_dictcCr<)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 rrA)rparamsrrrrrAs $cC d|dS)Nzst.query_params has no key "".rrrrrr  z*QueryParamsProxy.missing_key_error_messagecCrC)Nz"st.query_params has no attribute "rDrrErrrr.rFz+QueryParamsProxy.missing_attr_error_messageN)r r )r r)r r)rrr r)rrr r$)rrr'r(r r$)r1r2r3rr r$)r7r8r3rr r$)r3r(r r$)r)rrr r;)r r$)r r?)r7r8r r$)r1r2r r$)__name__ __module__ __qualname____doc__rrrrr"r&r+r/r0rr5r:r=r>r@rA staticmethodr r.rrrrr sL                   " r N) __future__rcollections.abcrrrtypingrrstreamlit.runtime.metrics_utilr+streamlit.runtime.state.session_state_proxyr _typeshedr rr rrrrs