EiR UddlmZddlmZddlmZddlmZmZm Z m Z m Z m Z ddl mZmZddlmZddlmZddlmZmZdd lmZmZdd lmZdd lmZdd lm Z m!Z!m"Z"erdd l#m$Z$ddl%m&Z&ddlm'Z'm(Z(e e)zdzZ*de+d<e e)zdzZ,de+d<e dZ-de+d<e dZ.de+d<ej^j`ej^jbej^jdej^jfej^jhej^jjej^jlej^jlej^jnd Z8de+d<dddhe8jsZ:de+d<ejvjxejvjzejvj|d Z?d!e+d"<ed#$Gd%d&Z@Gd'd(ZA d0d)ZBd1d*ZCd2d+ZDd3d,ZEd4d-ZF d5d.ZGd6d/ZHy)7) annotations) dataclass)dedent) TYPE_CHECKINGAnyFinalLiteral TypeAliascast)OptionSequenceconvert_anything_to_list)create_layout_config)maybe_raise_label_warnings)LabelVisibility get_label_visibility_proto_value)StreamlitAPIExceptionStreamlitValueError)Metric)gather_metrics) AnyNumber clean_text from_number)DeltaGenerator) NumberFormat)HeightWidthNr ValueDelta) normalinverseoffredorangeyellowgreenbluevioletgraygreyprimary DeltaColorautoupdownr! DeltaArrow) r"r#r$r%r&r'r(r)r*z3Final[dict[str, MetricProto.MetricColor.ValueType]]_DELTA_COLOR_TO_PROTOrr r!zFinal[set[str]]_VALID_DELTA_COLORS)r!r.r/z7Final[dict[str, MetricProto.MetricDirection.ValueType]]_DELTA_ARROW_TO_PROTOT)frozenc"eZdZUded<ded<y)MetricColorAndDirectionz!MetricProto.MetricColor.ValueTypecolorz%MetricProto.MetricDirection.ValueType directionN)__name__ __module__ __qualname____annotations__[/var/www/pod-logistic/pod-ai/venv/lib/python3.12/site-packages/streamlit/elements/metric.pyr6r6Vs ,,44r>r6c eZdZed d ddddddddddd d d Zedd Zy) MetricMixinmetricNvisibleFstretchcontentliner-) helplabel_visibilityborderwidthheight chart_data chart_type delta_arrowformatdelta_descriptionc t||t}t||_t ||_t ||_||_|t||_ ttdt||}|j|_|j|_t!tdt| }|t"vrt"||_t%||j&_| Vg}t+| D]} |j-t/|t7|dkDr|j8j;|t=| |_| | |_ |||_!tE|| dd }|jFjId || S#t0$r!}t3d|dt5|d|d}~wwxYw) ur/Display a metric in big bold font, with an optional indicator of how the metric changed. Parameters ---------- label : str The header or title for the metric. The label can optionally contain GitHub-flavored Markdown of the following types: Bold, Italics, Strikethroughs, Inline Code, Links, and Images. Images display like icons, with a max height equal to the font height. Unsupported Markdown elements are unwrapped so only their children (text contents) render. Common block-level Markdown (headings, lists, blockquotes) is automatically escaped and displays as literal text in labels. See the ``body`` parameter of |st.markdown|_ for additional, supported Markdown directives. .. |st.markdown| replace:: ``st.markdown`` .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown value : int, float, decimal.Decimal, str, or None Value of the metric. ``None`` is rendered as a long dash. The value can optionally contain GitHub-flavored Markdown, subject to the same limitations described in the ``label`` parameter. delta : int, float, decimal.Decimal, str, or None Amount or indicator of change in the metric. An arrow is shown next to the delta, oriented according to its sign: - If the delta is ``None`` or an empty string, no arrow is shown. - If the delta is a negative number or starts with a minus sign, the arrow points down and the delta is red. - Otherwise, the arrow points up and the delta is green. You can modify the display, color, and orientation of the arrow using the ``delta_color`` and ``delta_arrow`` parameters. The delta can optionally contain GitHub-flavored Markdown, subject to the same limitations described in the ``label`` parameter. delta_color : str The color of the delta and chart. This can be one of the following: - ``"normal"`` (default): The color is red when the delta is negative and green otherwise. - ``"inverse"``: The color is green when the delta is negative and red otherwise. This is useful when a negative change is considered good, like a decrease in cost. - ``"off"``: The color is gray regardless of the delta. - A named color from the basic palette: The chart and delta are the specified color regardless of their value. This can be one of the following: ``"red"``, ``"orange"``, ``"yellow"``, ``"green"``, ``"blue"``, ``"violet"``, ``"gray"``/``"grey"``, or ``"primary"``. help : str or None A tooltip that gets displayed next to the metric label. Streamlit only displays the tooltip when ``label_visibility="visible"``. If this is ``None`` (default), no tooltip is displayed. The tooltip can optionally contain GitHub-flavored Markdown, including the Markdown directives described in the ``body`` parameter of ``st.markdown``. label_visibility : "visible", "hidden", or "collapsed" The visibility of the label. The default is ``"visible"``. If this is ``"hidden"``, Streamlit displays an empty spacer instead of the label, which can help keep the widget aligned with other widgets. If this is ``"collapsed"``, Streamlit displays no label or spacer. border : bool Whether to show a border around the metric container. If this is ``False`` (default), no border is shown. If this is ``True``, a border is shown. height : "content", "stretch", or int The height of the metric element. This can be one of the following: - ``"content"`` (default): The height of the element matches the height of its content. - ``"stretch"``: The height of the element matches the height of its content or the height of the parent container, whichever is larger. If the element is not in a parent container, the height of the element matches the height of its content. - An integer specifying the height in pixels: The element has a fixed height. If the content is larger than the specified height, scrolling is enabled. width : "stretch", "content", or int The width of the metric element. This can be one of the following: - ``"stretch"`` (default): The width of the element matches the width of the parent container. - ``"content"``: The width of the element matches the width of its content, but doesn't exceed the width of the parent container. - An integer specifying the width in pixels: The element has a fixed width. If the specified width is greater than the width of the parent container, the width of the element matches the width of the parent container. chart_data : Iterable or None A sequence of numeric values to display as a sparkline chart. If this is ``None`` (default), no chart is displayed. The sequence can be anything supported by ``st.dataframe``, including a ``list`` or ``set``. If the sequence is dataframe-like, the first column will be used. Each value will be cast to ``float`` internally by default. The chart uses the color of the delta indicator, which can be modified using the ``delta_color`` parameter. chart_type : "line", "bar", or "area" The type of sparkline chart to display. This can be one of the following: - ``"line"`` (default): A simple sparkline. - ``"area"``: A sparkline with area shading. - ``"bar"``: A bar chart. delta_arrow : "auto", "up", "down", or "off" Controls the direction of the delta indicator arrow. This can be one of the following strings: - ``"auto"`` (default): The arrow direction follows the sign of ``delta``. - ``"up"`` or ``"down"``: The arrow is forced to point in the specified direction. - ``"off"``: No arrow is shown, but the delta value remains visible. format : str or None A format string controlling how numbers are displayed for ``value`` and ``delta``. The format is only applied if the value or delta is numeric. If the value or delta is a string with non-numeric characters, the format is ignored. The format can be one of the following values: - ``None`` (default): No formatting is applied. - ``"plain"``: Show the full number without any formatting (e.g. "1234.567"). - ``"localized"``: Show the number in the default locale format (e.g. "1,234.567"). - ``"percent"``: Show the number as a percentage (e.g. "123456.70%"). - ``"dollar"``: Show the number as a dollar amount (e.g. "$1,234.57"). - ``"euro"``: Show the number as a euro amount (e.g. "€1,234.57"). - ``"yen"``: Show the number as a yen amount (e.g. "¥1,235"). - ``"accounting"``: Show the number in an accounting format (e.g. "1,234.00"). - ``"bytes"``: Show the number in a byte format (e.g. "1.2KB"). - ``"compact"``: Show the number in a compact format (e.g. "1.2K"). - ``"scientific"``: Show the number in scientific notation (e.g. "1.235E3"). - ``"engineering"``: Show the number in engineering notation (e.g. "1.235E3"). - printf-style format string: Format the number with a printf specifier, like ``"%d"`` to show a signed integer (e.g. "1234") or ``"%.2f"`` to show a float with 2 decimal places. Use ``,`` for thousand separators (e.g. ``"%,d"`` yields ``"1,234"``). delta_description : str or None A short description displayed next to the delta value, such as ``"month over month"`` or ``"vs. last quarter"``. If this is ``None`` (default), no description is shown. The description is displayed in a smaller, muted font style similar to ``st.caption``. Examples -------- **Example 1: Show a metric** >>> import streamlit as st >>> >>> st.metric(label="Temperature", value="70 °F", delta="1.2 °F") .. output:: https://doc-metric-example1.streamlit.app/ height: 210px **Example 2: Create a row of metrics** ``st.metric`` looks especially nice in combination with ``st.columns``. >>> import streamlit as st >>> >>> col1, col2, col3 = st.columns(3) >>> col1.metric("Temperature", "70 °F", "1.2 °F") >>> col2.metric("Wind", "9 mph", "-8%") >>> col3.metric("Humidity", "86%", "4%") .. output:: https://doc-metric-example2.streamlit.app/ height: 210px **Example 3: Modify the delta indicator** The delta indicator color can also be inverted or turned off. >>> import streamlit as st >>> >>> st.metric( ... label="Gas price", value=4, delta=-0.5, delta_color="inverse" ... ) >>> >>> st.metric( ... label="Active developers", ... value=123, ... delta=123, ... delta_color="off", ... ) .. output:: https://doc-metric-example3.streamlit.app/ height: 320px **Example 4: Create a grid of metric cards** Add borders to your metrics to create a dashboard look. >>> import streamlit as st >>> >>> a, b = st.columns(2) >>> c, d = st.columns(2) >>> >>> a.metric("Temperature", "30°F", "-9°F", border=True) >>> b.metric("Wind", "4 mph", "2 mph", border=True) >>> >>> c.metric("Humidity", "77%", "5%", border=True) >>> d.metric("Pressure", "30.34 inHg", "-2 inHg", border=True) .. output:: https://doc-metric-example4.streamlit.app/ height: 350px **Example 5: Show sparklines** To show trends over time, add sparklines. >>> import streamlit as st >>> from numpy.random import default_rng as rng >>> >>> changes = list(rng(4).standard_normal(20)) >>> data = [sum(changes[:i]) for i in range(20)] >>> delta = round(data[-1], 2) >>> >>> row = st.container(horizontal=True) >>> with row: >>> st.metric( ... "Line", 10, delta, chart_data=data, chart_type="line", border=True ... ) >>> st.metric( ... "Area", 10, delta, chart_data=data, chart_type="area", border=True ... ) >>> st.metric( ... "Bar", 10, delta, chart_data=data, chart_type="bar", border=True ... ) .. output:: https://doc-metric-example5.streamlit.app/ height: 300px Nr+r0zFOnly numeric values are supported for chart data sequence. The value ' ' is of type z" and cannot be converted to float.rT)rJrKallow_content_widthallow_content_heightrB) layout_config)%r MetricProto _parse_valuebody _parse_labellabel _parse_deltadelta show_borderrrG$_determine_delta_color_and_directionr rr7r8_parse_delta_arrowr3rrHvaluer appendfloat ExceptionrtypelenrLextend_parse_chart_typerMrOrPrdg_enqueue)selfrZr`r\ delta_colorrGrHrIrJrKrLrMrNrOrP metric_protocolor_and_directionparsed_delta_arrow prepared_datavalexrUs r?rBzMetricMixin.metric]sh #5*:;"} (/ )%0 )%0 #)    &t L B z+6 7 166 !4!>!> / z+6 7  !6 6%:;M%NL ".N / %%+  !)+M/ ; !((s4 =!A%''..}="3J"?   "(L   (->L *, $!%  ww,mTT1!/""%mDI;?88 sF GF;;Gctd|S)Nr)r )rjs r?rhzMetricMixin.dgs$d++r>)Nr)rZstrr`rr\rrkr+rG str | NonerHrrIboolrJrrKrrLzOptionSequence[Any] | NonerMLiteral['line', 'bar', 'area']rNr0rOzstr | NumberFormat | NonerPrtreturnr)rwr)r9r:r;rrBpropertyrhr=r>r?rArA\sH "* IU ,5 "155;"(,0(,!IUIUIU IU  IUIU*IUIUIUIU/IU3IU IU*IU &!IU" #IUIUV ,,r>rAc|dk(rtjjS|dk(rtjjStjjS)Nbararea)rV ChartTypeBARAREALINE)rMs r?rgrgsJU$$(((V$$)))  % %%r>c*|dvrtdgd|S)N>r.r!r-r/rNr,)r)rNs r?r_r_s77!-1NOO r>c\t|tstd|dt|d|S)N'rRzg, which is not an accepted type. label only accepts: str. Please convert the label to an accepted type.) isinstancers TypeErrorrd)rZs r?rYrYs= eS !wmDK=1V V   Lr>cB|yt|tr|St|S)Nu—)rrsr)r`s r?rWrWs$ }% u r>c^||dk(ryt|tr t|St|S)N)rrsrrr\s r?r[r[s/ } %e} u r>c|tvrtd|d||dk(r=ttjj tj jSt|rtj jntj j}|tvrtt||S|tj jk(}|dk(r7|rtjjntjj}nV|dk(r7|rtjjntjj}ntjj }t||S)Nrz' is not an accepted value. delta_color only accepts: 'normal', 'inverse', 'off', or a color name ('red', 'orange', 'yellow', 'green', 'blue', 'violet', 'gray'/'grey', 'primary')r)r7r8rr )r2rr6rV MetricColorGRAYMetricDirectionNONE_is_negative_deltaDOWNUPr1REDGREEN)rkr\ cd_direction is_negativecd_colors r?r^r^s[--# }C C   } &))..!1166   e $ ##((  ( ( + +++&' 4"  +"="="B"BBKh  # # ' '((..   !  # # ) )((,,  **// " r>cHtt|jdS)N-)rrs startswithrs r?rrs #e*  ( ( --r>)rMrvrwzMetricProto.ChartType.ValueType)rNr0rwr0)rZrsrwrs)r`rrwrs)r\rrwrs)rkr+r\rrwr6)r\rrwru)I __future__r dataclassesrtextwraprtypingrrrr r r streamlit.dataframe_utilr r #streamlit.elements.lib.layout_utilsrstreamlit.elements.lib.policiesrstreamlit.elements.lib.utilsrrstreamlit.errorsrrstreamlit.proto.Metric_pb2rrVstreamlit.runtime.metrics_utilrstreamlit.string_utilrrrstreamlit.delta_generatorr#streamlit.elements.lib.column_typesrrrrsrr<rr+r0rrORANGEYELLOWrBLUEVIOLETrPRIMARYr1keysr2rrrrr3r6rArgr_rYrWr[r^rr=r>r?rs#!FFMDFH<9DD8@As?T)y)s?T)y)   I  ;< I<  " " & &%%,,%%,,  $ $ * *  # # ( (%%,,  # # ( (  # # ( (&&.. NJ    (! (_  & & + +  % % ( (  ' ' , ,RN $555 O,O,d &.&$& 33 33l.r>