mxi!P UddlmZddlmZddlmZddlmZmZm Z m Z m Z m Z ddl mZmZddlmZmZmZmZmZddlmZddlmZmZdd lmZmZdd lmZ dd l!m"Z"dd l#m$Z$m%Z%m&Z&er dd l'm(Z(ddl)m*Z*e$e+zdzZ,de-d<e$e+zdzZ.de-d<e dZ/de-d<e dZ0de-d<e jbjde jbjfe jbjhe jbjje jbjle jbjne jbjpe jbjpe jbjrd Z:de-d<dddhe:jwZ d,d%Z?d-d&Z@d.d'ZAd/d(ZBd0d)ZC d1d*ZDd2d+ZEy)3) annotations) dataclass)dedent) TYPE_CHECKINGAnyFinalLiteral TypeAliascast)OptionSequenceconvert_anything_to_list)Height LayoutConfigWidthvalidate_heightvalidate_width)maybe_raise_label_warnings)LabelVisibility get_label_visibility_proto_value)StreamlitAPIExceptionStreamlitValueError)Metric)gather_metrics) AnyNumber clean_text from_number)DeltaGenerator) NumberFormatNr ValueDelta) normalinverseoffredorangeyellowgreenbluevioletgraygreyprimary DeltaColorautoupdownr# DeltaArrow) r$r%r&r'r(r)r*r+r,z3Final[dict[str, MetricProto.MetricColor.ValueType]]_DELTA_COLOR_TO_PROTOr!r"r#zFinal[set[str]]_VALID_DELTA_COLORST)frozenc"eZdZUded<ded<y)MetricColorAndDirectionz!MetricProto.MetricColor.ValueTypecolorz%MetricProto.MetricDirection.ValueType directionN)__name__ __module__ __qualname____annotations__P/home/htdocs/ttos/venv/lib/python3.12/site-packages/streamlit/elements/metric.pyr7r7Ts ,,44r?r7c eZdZed d dddddddddd d d Zedd Zy) MetricMixinmetricNvisibleFstretchcontentliner/) helplabel_visibilityborderwidthheight chart_data chart_type delta_arrowformatc ^t||t}t||_t ||_t ||_||_|t||_ ttdt||}|j|_|j|_t!tdt| }|dk7rn|dk(r tj"j$|_nI|dk(r tj"j&|_n$|dk(rtj"j(|_t+||j,_| Vg}t1| D]} |j3t5|t=|d kDr|j>jA|tC| |_"| | |_#tI| d tK|d tM|| }|jNjQd||S#t6$r!}t9d|d t;|d |d}~wwxYw)u-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. Display unsupported elements as literal characters by backslash-escaping them. E.g., ``"1\. Not an ordered list"``. 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. 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-r2r/r#r0r1zFOnly numeric values are supported for chart data sequence. The value ' ' is of type z" and cannot be converted to float.rT) allow_content)rKrLrC) layout_config))r MetricProto _parse_valuebody _parse_labellabel _parse_deltadelta show_borderrrH$_determine_delta_color_and_directionr rr8r9_parse_delta_arrowMetricDirectionNONEUPDOWNrrIvaluer appendfloat ExceptionrtypelenrMextend_parse_chart_typerNrPrrrdg_enqueue)selfrYrcr[ delta_colorrHrIrJrKrLrMrNrOrP metric_protocolor_and_directionparsed_delta_arrow prepared_datavalexrTs r@rCzMetricMixin.metric[sX #5*:;"} (/ )%0 )%0 #)    &t L B z+6 7 166 !4!>!> / z+6 7   '!U*)4)D)D)I)I &#t+)4)D)D)G)G &#v-)4)D)D)I)I &.N / %%+  !)+M/ ; !((s4 =!A%''..}="3J"?   "(L d3uD1$5@ ww,mTT%!/""%mDI;?88 sH H, H''H,ctd|S)Nr)r )rms r@rkzMetricMixin.dgs$d++r?)Nr!)rYstrrcrr[r rnr-rHz str | NonerIrrJboolrKrrLrrMzOptionSequence[Any] | NonerNLiteral['line', 'bar', 'area']rOr2rPzstr | NumberFormat | Nonereturnr)ryr)r:r;r<rrCpropertyrkr>r?r@rBrBZsH "* @U ,5 "155;"(,0@U@U@U @U  @U@U*@U@U@U@U/@U3@U @U*@U !@U@UD ,,r?rBc|dk(rtjjS|dk(rtjjStjjS)Nbararea)rU ChartTypeBARAREALINE)rNs r@rjrjsJU$$(((V$$)))  % %%r?c*|dvrtdgd|S)N>r0r#r/r1rOr.)r)rOs 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.) isinstancerv TypeErrorrg)rYs r@rXrXs= eS !wmDK=1V V   Lr?cB|yt|tr|St|S)Nu—)rrvr)rcs r@rVrVs$ }% u r?c^||dk(ryt|tr t|St|S)N)rrvrrr[s r@rZrZs/ } %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)r8r9r!r")r4rr7rU MetricColorGRAYr_r`_is_negative_deltarbrar3REDGREEN)rnr[ cd_direction is_negativecd_colors r@r]r]s[--# }C C   } &))..!1166   e $ ##((  ( ( + +++&' 4"  +"="="B"BBKh  # # ' '((..   !  # # ) )((,,  **// " r?cHtt|jdS)N-)rrv startswithrs r@rrs #e*  ( ( --r?)rNrxryzMetricProto.ChartType.ValueType)rOr2ryr2)rYrvryrv)rcrryrv)r[r ryrv)rnr-r[r ryr7)r[r ryrw)F __future__r dataclassesrtextwraprtypingrrrr r r streamlit.dataframe_utilr r #streamlit.elements.lib.layout_utilsrrrrrstreamlit.elements.lib.policiesrstreamlit.elements.lib.utilsrrstreamlit.errorsrrstreamlit.proto.Metric_pb2rrUstreamlit.runtime.metrics_utilrstreamlit.string_utilrrrstreamlit.delta_generatorr#streamlit.elements.lib.column_typesrrvrr=r r-r2rrORANGEYELLOWrBLUEVIOLETrPRIMARYr3keysr4r7rBrjr^rXrVrZr]rr>r?r@rs#!FFMGH<9DD8@s?T)y)s?T)y)   I  ;< I<  " " & &%%,,%%,,  $ $ * *  # # ( (%%,,  # # ( (  # # ( (&&.. NJ    (! (_ $555 F,F,R &.&$& 33 33l.r?