o ,&]i>@sUddlmZddlmZddlmZddlmZmZm Z m Z m Z ddl m Z mZddlmZmZmZmZmZddlmZddlmZmZdd lmZmZdd lmZdd l m!Z!dd l"m#Z#m$Z$m%Z%erkdd l&m'Z'e#e(BdBZ)de*d<e#e(BdBZ+de*d<e dZ,de*d<e dZ-de*d<eddGdddZ.GdddZ/d5d d!Z0d6d#d$Z1d7d'd(Z2d8d*d+Z3d9d-d.Z4d:d0d1Z5d;d3d4Z6dS)<) annotations) dataclass)dedent) TYPE_CHECKINGAnyLiteral 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)DeltaGeneratorNrValueDelta)normalinverseoff DeltaColorautoupdownr DeltaArrowT)frozenc@seZdZUded<ded<dS)MetricColorAndDirectionz!MetricProto.MetricColor.ValueTypecolorz%MetricProto.MetricDirection.ValueType directionN)__name__ __module__ __qualname____annotations__r/r/W/var/www/html/IGF-ODF-V3/venv/lib/python3.10/site-packages/streamlit/elements/metric.pyr(1s  r(c @sFeZdZed  d)dddddddd d d*d%d&Zed+d'd(ZdS), MetricMixinmetricNrvisibleFstretchcontentliner#)helplabel_visibilityborderwidthheight chart_data chart_type delta_arrowlabelstrvaluerdeltar delta_colorr!r7 str | Noner8rr9boolr:rr;r r<OptionSequence[Any] | Noner=Literal['line', 'bar', 'area']r>r&returnrc Cst||t} t|| _t|| _t|| _|| _|dur#t || _ t t dt ||}|j| _|j| _tt dt | }|dkr_|dkrLtjj| _n|dkrVtjj| _n |dkr_tjj| _t|| j_| durg}t| D]%}z |t|Wqoty}ztd|d t|d |d}~wwt|d kr| j |t!| | _"t#| d d t$|d d t%|| d}|j&j'd| |dS)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, decimal.Decimal, str, or None Value of the metric. ``None`` is rendered as a long dash. delta : int, float, decimal.Decimal, 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. 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. 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!r&r#r r$r%zFOnly numeric values are supported for chart data sequence. The value ' ' is of type z" and cannot be converted to float.rT) allow_content)r:r;r2) layout_config)(r MetricProto _parse_valuebody _parse_labelr? _parse_deltarB show_borderrr7$_determine_delta_color_and_directionr rr)r*_parse_delta_arrowMetricDirectionNONEUPDOWNrr8rAr appendfloat Exceptionrtypelenr<extend_parse_chart_typer=rrr dg_enqueue)selfr?rArBrCr7r8r9r:r;r<r=r> metric_protocolor_and_directionparsed_delta_arrow prepared_datavalexrKr/r/r0r28sf b               zMetricMixin.metriccCs td|S)Nr)r )rar/r/r0r_Ms zMetricMixin.dg)Nr)r?r@rArrBrrCr!r7rDr8rr9rEr:rr;r r<rFr=rGr>r&rHr)rHr)r+r,r-rr2propertyr_r/r/r/r0r17s$r1r=rGrHMetricProto.ChartType.ValueTypecCs(|dkrtjjS|dkrtjjStjjS)Nbararea)rL ChartTypeBARAREALINE)r=r/r/r0r^Rs r^r>cCs|dvr tdgd|S)N>r$r r#r%r>r")r)r>r/r/r0rS]srSr?r@cCs(t|tstd|dt|d|S)N'rIzg, which is not an accepted type. label only accepts: str. Please convert the label to an accepted type.) isinstancer@ TypeErrorr[)r?r/r/r0rOcs rOrAcCs"|durdSt|tr |St|S)Nu—)rqr@r)rAr/r/r0rMls  rMrBcCs.|dus|dkr dSt|trt|St|S)N)rqr@rrrBr/r/r0rPts  rPrCcCs|dvr td|d|dus|dkrttjjtjjdSt|r=|dkr+tjj}n |dkr4tjj }ntjj}tjj }n|dkrFtjj }n |dkrOtjj}ntjj}tjj }t||dS)N>r rrrpzS' is not an accepted value. delta_color only accepts: 'normal', 'inverse', or 'off'rs)r)r*rr) rr(rL MetricColorGRAYrTrU_is_negative_deltaREDGREENrWrV)rCrBcd_color cd_directionr/r/r0rR|s4      rRrEcCstt|dS)N-)rr@ startswithrtr/r/r0rwsrw)r=rGrHri)r>r&rHr&)r?r@rHr@)rArrHr@)rBrrHr@)rCr!rBrrHr()rBrrHrE)7 __future__r dataclassesrtextwraprtypingrrrrr streamlit.dataframe_utilr r #streamlit.elements.lib.layout_utilsr r rrrstreamlit.elements.lib.policiesrstreamlit.elements.lib.utilsrrstreamlit.errorsrrstreamlit.proto.Metric_pb2rrLstreamlit.runtime.metrics_utilrstreamlit.string_utilrrrstreamlit.delta_generatorrr@rr.rr!r&r(r1r^rSrOrMrPrRrwr/r/r/r0s<          '