o Yha=@sUddlmZddlmZddlmZddlmZmZm Z m Z m Z ddl m Z ddlmZmZddlmZmZmZmZmZddlmZdd lmZmZdd lmZdd lmZ dd l!m"Z"dd l#m$Z$eroddl%Z&ddl'm(Z(e dde)e*e+dfZ,de-d<e e)e*e+dfZ.de-d<e dZ/de-d<eddGdddZ0GdddZ1d3d!d"Z2d4d%d&Z3d5d(d)Z4d6d+d,Z5d7d.d/Z6d8d1d2Z7dS)9) annotations) dataclass)dedent) TYPE_CHECKINGAnyLiteralUnioncast) TypeAlias)OptionSequenceconvert_anything_to_list)Height LayoutConfigWidthvalidate_heightvalidate_width)maybe_raise_label_warnings)LabelVisibility get_label_visibility_proto_value)StreamlitAPIException)Metric)gather_metrics) clean_textN)DeltaGeneratorznp.integer[Any]znp.floating[Any]r ValueDelta)normalinverseoff DeltaColorT)frozenc@seZdZUded<ded<dS)MetricColorAndDirectionz!MetricProto.MetricColor.ValueTypecolorz%MetricProto.MetricDirection.ValueType directionN)__name__ __module__ __qualname____annotations__r(r(Z/var/www/html/Persson_Maskin/env/lib/python3.10/site-packages/streamlit/elements/metric.pyr!4s  r!c @sDeZdZed  d&dddddddd d'd"d#Zed(d$d%ZdS)) MetricMixinmetricNrvisibleFstretchcontentline)helplabel_visibilityborderwidthheight chart_data chart_typelabelstrvaluerdeltar delta_colorrr0 str | Noner1rr2boolr3rr4r r5OptionSequence[Any] | Noner6Literal['line', 'bar', 'area']returnrc Cs.t||t} t|| _t|| _t|| _|| _|dur#t || _ t t dt ||} | j| _| j| _t|| j_| durwg}t| D]%}z |t|WqEtyj}ztd|dt|d|d}~wwt|dkrw| j|t| | _t| ddt|ddt || d }|j!j"d | |d S) u& Display a metric in big bold font, with an optional indicator of how the metric changed. Tip: If you want to display a large number, it may be a good idea to shorten it using packages like `millify `_ or `numerize `_. E.g. ``1234`` can be displayed as ``1.2k`` using ``st.metric("Short number", millify(1234))``. 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, str, or None Value of the metric. None is rendered as a long dash. delta : int, float, str, or None Indicator of how the metric changed, rendered with an arrow below the metric. If delta is negative (int/float) or starts with a minus sign (str), the arrow points down and the text is red; else the arrow points up and the text is green. If None (default), no delta indicator is shown. delta_color : "normal", "inverse", or "off" If "normal" (default), the delta indicator is shown as described above. If "inverse", it is red when positive and green when negative. This is useful when a negative change is considered good, e.g. if cost decreased. If "off", delta is shown in gray regardless of its value. 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. 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. 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 NrzFOnly numeric values are supported for chart data sequence. The value ' ' is of type z" and cannot be converted to float.rT) allow_content)r3r4r+) layout_config)#r MetricProto _parse_valuebody _parse_labelr7 _parse_deltar: show_borderrr0$_determine_delta_color_and_directionr rr"r#rr1r9r appendfloat Exceptionrtypelenr5extend_parse_chart_typer6rrrdg_enqueue)selfr7r9r:r;r0r1r2r3r4r5r6 metric_protocolor_and_direction prepared_datavalexrCr(r(r)r+;sR V           zMetricMixin.metriccCs td|S)Nr)r )rTr(r(r)rR9s zMetricMixin.dg)Nr)r7r8r9rr:rr;rr0r<r1rr2r=r3rr4r r5r>r6r?r@r)r@r)r$r%r&rr+propertyrRr(r(r(r)r*:s ~r*r6r?r@MetricProto.ChartType.ValueTypecCs(|dkrtjjS|dkrtjjStjjS)Nbararea)rD ChartTypeBARAREALINE)r6r(r(r)rQ>s rQr7r8cCs(t|tstd|dt|d|S)N'rAzg, which is not an accepted type. label only accepts: str. Please convert the label to an accepted type.) isinstancer8 TypeErrorrN)r7r(r(r)rGIs rGr9cCs|durdSt|tttfrt|St|dr3zt|ttfr(t|WSWn ty2Ynwtd|dt|d)Nu—itemrbrAz|, which is not an accepted type. value only accepts: int, float, str, or None. Please convert the value to an accepted type.) rcintrLr8hasattrrerMrdrN)r9r(r(r)rERs  rEr:cCsV|dus|dkr dSt|trt|St|ttfrt|Std|dt|d)NrbrAz|, which is not an accepted type. delta only accepts: int, float, str, or None. Please convert the value to an accepted type.)rcr8rrfrLrdrNr:r(r(r)rHhs rHr;cCs|dvr td|d|dus|dkrttjjtjjdSt|r=|dkr+tjj}n |dkr4tjj }ntjj}tjj }n|dkrFtjj }n |dkrOtjj}ntjj}tjj }t||dS)N>rrrrbzS' is not an accepted value. delta_color only accepts: 'normal', 'inverse', or 'off'rh)r"r#rr) rr!rD MetricColorGRAYMetricDirectionNONE_is_negative_deltaREDGREENDOWNUP)r;r:cd_color cd_directionr(r(r)rJvs4      rJr=cCstt|dS)N-)rr8 startswithrir(r(r)rnsrn)r6r?r@r[)r7r8r@r8)r9rr@r8)r:rr@r8)r;rr:rr@r!)r:rr@r=)8 __future__r dataclassesrtextwraprtypingrrrrr typing_extensionsr streamlit.dataframe_utilr r #streamlit.elements.lib.layout_utilsr rrrrstreamlit.elements.lib.policiesrstreamlit.elements.lib.utilsrrstreamlit.errorsrstreamlit.proto.Metric_pb2rrDstreamlit.runtime.metrics_utilrstreamlit.string_utilrnumpynpstreamlit.delta_generatorrrLrfr8rr'rrr!r*rQrGrErHrJrnr(r(r(r)s<            '