Eiy.8UddlmZddlmZmZmZmZmZddlm Z ddl m Z m Z ddl mZddlmZmZmZmZddlmZddlmZdd lmZdd lmZdd lmZerdd lm Z dd lm!Z!m"Z"m#Z#dZ$de%d<dZ&de%d<dZ'de%d<ddZ( ddZ)GddZ*GddZ+y)) annotations) TYPE_CHECKINGFinalLiteralcastoverload)current_form_id)Widthcreate_layout_config)check_widget_policies)Keycompute_and_register_element_idsave_for_app_testingto_key)StreamlitAPIException)Feedback)gather_metrics)get_script_run_ctx)register_widget)DeltaGenerator) WidgetArgsWidgetCallback WidgetKwargsr_NUM_THUMBS_OPTIONS_NUM_FACES_OPTIONS_NUM_STARS_OPTIONSc:|dk(rtS|dk(rtStS)z6Get the number of options for the given feedback type.thumbsfaces)rrr feedback_types e/var/www/pod-logistic/pod-ai/venv/lib/python3.12/site-packages/streamlit/elements/widgets/feedback.py_get_num_optionsr%:s$ ""!! c|dk(rtjjS|dk(rtjjStjjS)z7Convert a feedback type string to the proto enum value.r r!) FeedbackProto FeedbackTypeTHUMBSFACESSTARSr"s r$_feedback_type_to_protor-CsJ ))000))///  % % + ++r&c*eZdZdZdddZddZd dZy) FeedbackSerdeaSerializer/deserializer for feedback widget values. Uses string as the wire format to distinguish three states: - None (field not set): No UI interaction yet -> use default_value - "" (empty string): User explicitly cleared -> return None - "2" (string with value): User selected -> return int value This allows clearing to work correctly even when a default is set. The session state and return values are always int | None. Nc||_yN default_value)selfr3s r$__init__zFeedbackSerde.__init__Zs *r&c |dSt|S)z.Serialize int value to string for wire format.)str)r4values r$ serializezFeedbackSerde.serialize]s]r2E 2r&c@| |jS|dk(ryt|S)z1Deserialize string wire format back to int value.Nr7)r3int)r4ui_values r$ deserializezFeedbackSerde.deserializeas(  %% % r>8}r&r1)r3 int | None)r9r?returnr8)r=z str | Noner@r?)__name__ __module__ __qualname____doc__r5r:r>r&r$r/r/Ns +3r&r/c eZdZe d dddddddd d dZe d dddddddd d dZed d dddddddd ddZedd Zy) FeedbackMixinNFcontent)keydefaultdisabled on_changeargskwargswidthcyr1rE r4optionsrIrJrKrLrMrNrOs r$feedbackzFeedbackMixin.feedbackks #r&cyr1rErQs r$rSzFeedbackMixin.feedbackys),r&rSc |dvrtd|dt|} |!|dks|| k\rtd|d| dz d |t|}t|d } t |j ||| t } t|j } td |dh|j |||} t}| |_ t||_ ||_ | |_|||_t!| }t#|j||||j$|j&| d}|j(r$|j*|j*|_d |_| r t/| | d|j j1d || |j*S)aDisplay a feedback widget. A feedback widget is an icon-based button group available in three styles, as described in ``options``. It is commonly used in chat and AI apps to allow users to rate responses. Parameters ---------- options : "thumbs", "faces", or "stars" The feedback options displayed to the user. ``options`` can be one of the following: - ``"thumbs"`` (default): Streamlit displays a thumb-up and thumb-down button group. - ``"faces"``: Streamlit displays a row of five buttons with facial expressions depicting increasing satisfaction from left to right. - ``"stars"``: Streamlit displays a row of star icons, allowing the user to select a rating from one to five stars. key : str, int, or None An optional string or integer to use as the unique key for the widget. If this is ``None`` (default), a key will be generated for the widget based on the values of the other parameters. No two widgets may have the same key. Assigning a key stabilizes the widget's identity and preserves its state across reruns even when other parameters change. .. note:: Changing ``options`` resets the widget even when a key is provided. A key lets you read or update the widget's value via ``st.session_state[key]``. For more details, see `Widget behavior `_. Additionally, if ``key`` is provided, it will be used as a CSS class name prefixed with ``st-key-``. default : int or None Default feedback value. This must be consistent with the feedback type in ``options``: - 0 or 1 if ``options="thumbs"``. - Between 0 and 4, inclusive, if ``options="faces"`` or ``options="stars"``. disabled : bool An optional boolean that disables the feedback widget if set to ``True``. The default is ``False``. on_change : callable An optional callback invoked when this feedback widget's value changes. args : list or tuple An optional list or tuple of args to pass to the callback. kwargs : dict An optional dict of kwargs to pass to the callback. width : "content", "stretch", or int The width of the feedback widget. This can be one of the following: - ``"content"`` (default): The width of the widget matches the width of its content, but doesn't exceed the width of the parent container. - ``"stretch"``: The width of the widget matches the width of the parent container. - An integer specifying the width in pixels: The widget has a fixed width. If the specified width is greater than the width of the parent container, the width of the widget matches the width of the parent container. Returns ------- int or None An integer indicating the user's selection, where ``0`` is the lowest feedback. Higher values indicate more positive feedback. If no option was selected, the widget returns ``None``. - For ``options="thumbs"``, a return value of ``0`` indicates thumbs-down, and ``1`` indicates thumbs-up. - For ``options="faces"`` and ``options="stars"``, return values range from ``0`` (least satisfied) to ``4`` (most satisfied). Examples -------- Display a feedback widget with stars, and show the selected sentiment: >>> import streamlit as st >>> >>> sentiment_mapping = ["one", "two", "three", "four", "five"] >>> selected = st.feedback("stars") >>> if selected is not None: >>> st.markdown(f"You selected {sentiment_mapping[selected]} star(s).") .. output:: https://doc-feedback-stars.streamlit.app/ height: 200px Display a feedback widget with thumbs, and show the selected sentiment: >>> import streamlit as st >>> >>> sentiment_mapping = [":material/thumb_down:", ":material/thumb_up:"] >>> selected = st.feedback("thumbs") >>> if selected is not None: >>> st.markdown(f"You selected: {sentiment_mapping[selected]}") .. output:: https://doc-feedback-thumbs.streamlit.app/ height: 200px >r!starsr zjThe options argument to st.feedback must be one of ['thumbs', 'faces', 'stars']. The argument passed was 'z'.NrzThe default value in 'z!' must be a number between 0 and z. The passed default value is T)rOallow_content_widthr2rSrR)user_keykey_as_main_identitydgrRrJrO string_value)on_change_handlerrMrN deserializer serializerctx value_type) layout_config)rr%rr r r[rr rr(idr-typerKform_idrJr/rr>r: value_changedr9 set_valuer_enqueue)r4rRrIrJrKrLrMrNrO num_optionsrbr`re element_idprotoserde widget_states r$rSzFeedbackMixin.feedbacks@ 6 6',,39B8  'w/  GaK7k3I'( 1RS^abSbRcd007y:  Sk,5dS dggsIWM "!$''*4 "+ww ,W5 !  #EMG4& HH'**%    % %!!-*00 "EO  j$ 7 U-H!!!r&ctd|S)zGet our DeltaGenerator.r)r)r4s r$r[zFeedbackMixin.dgKs$d++r&).)rRzLiteral['thumbs']rI Key | NonerJr?rKboolrLWidgetCallback | NonerMWidgetArgs | NonerNWidgetKwargs | NonerOr r@zLiteral[0, 1] | None)rRzLiteral['faces', 'stars']rIrorJr?rKrprLrqrMrrrNrsrOr r@zLiteral[0, 1, 2, 3, 4] | None)r )rR#Literal['thumbs', 'faces', 'stars']rIrorJr?rKrprLrqrMrrrNrsrOr r@r?)r@r)rArBrCrrSrpropertyr[rEr&r$rGrGjs &) #"+/"&&*  #" # #  #  #) #  #$ # #  # #.1 ,"+/"&&*  ,* , ,  ,  ,) ,  ,$ , , ' , ,J8@A""+/"&&* A"4A" A"  A"  A")A" A"$A"A" A" A"F,,r&rGN)r#rtr@r<)r#rtr@z$FeedbackProto.FeedbackType.ValueType), __future__rtypingrrrrr!streamlit.elements.lib.form_utilsr #streamlit.elements.lib.layout_utilsr r streamlit.elements.lib.policiesr streamlit.elements.lib.utilsr rrrstreamlit.errorsrstreamlit.proto.Feedback_pb2rr(streamlit.runtime.metrics_utilr7streamlit.runtime.scriptrunner_utils.script_run_contextrstreamlit.runtime.staterstreamlit.delta_generatorrrrrr__annotations__rrr%r-r/rGrEr&r$rs#>B 3B9V38UEE,6,),8d,d,r&