&eUdZddlmZddlZddlmZmZddlmZmZm Z m Z ddl m Z m Z mZmZmZmZmZmZmZmZddlmZddlmZmZdd lmZdd lmZdd lm Z dd l!m"Z"dd l#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0ddl1m2Z2ddl3m4Z4ddl5m6Z6ddl7m8Z8ddl9m:Z:ddl;mZ>ddl?m@Z@ddlAmBZBddlCmDZDddlEmFZFe r ddlGmHZHdd lImJZJee e"e$e&e(e*e,e.e0e2e4e6e8e:ee@eBfZKd!eLd"<d#ZMd$eLd%<ed&ZNed'd()ZOee d*fZPd!eLd+<eeQe fZRd!eLd,<ed-ZSd!eLd.<ee eQgeNfZTd!eLd/<eeNge fZUd!eLd0<ed(1Gd2d3eeNZVed(1Gd4d5eeOZWeeXeYeZeQe[fZ\eee ee dd6d7ee\f Z] dIdJd?Z^dKdBZ_dLdEZ`dLdFZadMdHZbdS)NzGFunctions and data structures shared by session_state.py and widgets.py) annotationsN) dataclassfield)datedatetimetime timedelta) TYPE_CHECKINGAnyCallableDictGenericOptionalSequenceTupleTypeVarUnion)Message)Final TypeAlias)util)StreamlitAPIException)Arrow)Button) CameraInput) ChatInput)Checkbox) ColorPicker)ComponentInstance) DateInput)DownloadButton) FileUploader) MultiSelect) NumberInput)Radio) Selectbox)Slider)TextArea) TextInput) TimeInput)ValueFieldName)HASHLIB_KWARGS)ellipsis)NoValuer WidgetProtoz $$WIDGET_IDrGENERATED_WIDGET_ID_PREFIXTT_coT) covariant. WidgetArgs WidgetKwargs).NWidgetCallbackWidgetDeserializerWidgetSerializer)frozenceZdZUdZded<edZded<edZded <d ed <d Zd ed<d Z ded<d Z ded<ddZ d S)WidgetMetadataz4Metadata associated with a single widget. Immutable.stridF)reprzWidgetDeserializer[T] deserializerzWidgetSerializer[T] serializerr+ value_typeNzWidgetCallback | NonecallbackzWidgetArgs | None callback_argszWidgetKwargs | Nonecallback_kwargsreturnc*tj|SN)rrepr_)selfs >lib/python3.11/site-packages/streamlit/runtime/state/common.py__repr__zWidgetMetadata.__repr__{sz$)rEr<) __name__ __module__ __qualname____doc____annotations__rr?r@rBrCrDrKrLrJr;r;ks>> GGG*/%U*;*;*;L;;;;&+e&7&7&7J7777 '+H****'+M+++++/O////      rLr;c@eZdZUdZded<ded<ed d Zd S) RegisterWidgetResultalResult returned by the `register_widget` family of functions/methods. Should be usable by widget code to determine what value to return, and whether to update the UI. Parameters ---------- value : T_co The widget's current value, or, in cases where the true widget value could not be determined, an appropriate fallback value. This value should be returned by the widget call. value_changed : bool True if the widget's value is different from the value most recently returned from the frontend. Implies an update to the frontend is needed. r2valuebool value_changedr?WidgetDeserializer[T_co]rE'RegisterWidgetResult[T_co]'c0||dddS)zThe canonical way to construct a RegisterWidgetResult in cases where the true widget value could not be determined. NF)rUrWrR)clsr?s rJfailurezRegisterWidgetResult.failures%sdB//uEEEErLN)r?rXrErY)rMrNrOrPrQ classmethodr]rRrLrJrTrTs[&KKKFFF[FFFrLrTr.r- element_typer<user_key str | Nonekwargs#SAFE_VALUES | Sequence[SAFE_VALUES]rEc tjdit}||d|D]o\}}|t |d|t |dptd|d|S)aXCompute the widget id for the given widget. This id is stable: a given set of inputs to this function will always produce the same widget id output. Only stable, deterministic values should be used to compute widget ids. Using nondeterministic values as inputs can cause the resulting widget id to change between runs. The widget id includes the user_key so widgets with identical arguments can use it to be distinct. The widget id includes an easily identified prefix, and the user_key as a suffix, to make it easy to identify it and know if a key maps to it. md5zutf-8-)re) hashlibnewr,updateencodeitemsr<r0 hexdigest)r_r`rbhkvs rJcompute_widget_idrps$  ,,^,,AHH\  ) )*** ))1 Qw''((( Qw''((((( E E1;;== E E8 E EErL widget_id Optional[str]cT|ddd}|dkrdn|}|S)aRReturn the user key portion of a widget id, or None if the id does not have a user key. TODO This will incorrectly indicate no user key if the user actually provides "None" as a key, but we can't avoid this kind of problem while storing the string representation of the no-user-key sentinel as part of the widget id. rf)maxsplitNoneN)split)rqr`s rJuser_key_from_widget_idrys6sQ//3H6))ttxH OrLkeyrVc6|tS)zETrue if the given session_state key has the structure of a widget ID.) startswithr0rzs rJ is_widget_idr~s >>4 5 55rLcLt|o|d S)zUTrue if the given session_state key has the structure of a widget ID with a user_key.z-None)r~endswithr}s rJis_keyed_widget_idrs$    :S\\'%:%:!::rLrwcTt|rtdtddS)z4Raise an Exception if the given user_key is invalid.zKeys beginning with z are reserved.N)r~rr0r}s rJrequire_valid_user_keyrs=C # M#= M M M     rLrG)r_r<r`rarbrcrEr<)rqr<rErr)rzr<rErV)rzr<rErw)crP __future__rrg dataclassesrrrrrr typingr r r r rrrrrrgoogle.protobuf.messagertyping_extensionsrr streamlitrstreamlit.errorsrstreamlit.proto.Arrow_pb2rstreamlit.proto.Button_pb2rstreamlit.proto.CameraInput_pb2rstreamlit.proto.ChatInput_pb2rstreamlit.proto.Checkbox_pb2rstreamlit.proto.ColorPicker_pb2rstreamlit.proto.Components_pb2rstreamlit.proto.DateInput_pb2r "streamlit.proto.DownloadButton_pb2r! streamlit.proto.FileUploader_pb2r"streamlit.proto.MultiSelect_pb2r#streamlit.proto.NumberInput_pb2r$streamlit.proto.Radio_pb2r%streamlit.proto.Selectbox_pb2r&streamlit.proto.Slider_pb2r'streamlit.proto.TextArea_pb2r(streamlit.proto.TextInput_pb2r)streamlit.proto.TimeInput_pb2r*streamlit.type_utilr+streamlit.utilr,builtinsr-streamlit.runtime.state.widgetsr.r/rQr0r1r2r4r<r5r6r7r8r;rTfloatintrVbytesPROTO_SCALAR_VALUE SAFE_VALUESrpryr~rrrRrLrJrs6NMM""""""((((((((444444444444                        ,+++++........222222++++++------777777333333111111777777<<<<<<333333======999999777777777777++++++333333------111111333333333333......))))))8!!!!!!777777           # *%21111 GCLLwv&&&c3h ''''sCx. (((($Y///// !)#sQ 77777&sCx00000 $     WQZ   & $FFFFF74=FFFB5#tS%78       FFFFF8    6666 ;;;;       rL