/_i>UddlmZddlmZddlmZddlmZmZm Z m Z m Z ddl m Z mZddlmZmZmZmZmZddlmZddlmZmZdd lmZmZdd lmZdd l m!Z!dd l"m#Z#m$Z$m%Z%erdd l&m'Z'e#e(zdzZ)de*d<e#e(zdzZ+de*d<e dZ,de*d<e dZ-de*d<edGddZ.GddZ/ d#dZ0d$dZ1d%dZ2d&dZ3d'd Z4 d(d!Z5d)d"Z6y)*) 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)DeltaGeneratorNr ValueDelta)normalinverseoff DeltaColorautoupdownr! DeltaArrowT)frozenc"eZdZUded<ded<y)MetricColorAndDirectionz!MetricProto.MetricColor.ValueTypecolorz%MetricProto.MetricDirection.ValueType directionN)__name__ __module__ __qualname____annotations__X/var/www/html/land_sniper/venv/lib/python3.12/site-packages/streamlit/elements/metric.pyr*r*1s ,,44r2r*c eZdZed d ddddddddd  d d Zedd Zy) MetricMixinmetricNvisibleFstretchcontentliner$)helplabel_visibilityborderwidthheight chart_data chart_type delta_arrowc Lt||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| | _"tG| d tI|d tK|| }|jLjOd| |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. 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?r6) layout_config)(r MetricProto _parse_valuebody _parse_labellabel _parse_deltadelta show_borderrr;$_determine_delta_color_and_directionr rr+r,_parse_delta_arrowMetricDirectionNONEUPDOWNrr<valuer appendfloat Exceptionrtypelenr@extend_parse_chart_typerArrrdg_enqueue)selfrKrUrM delta_colorr;r<r=r>r?r@rArB metric_protocolor_and_directionparsed_delta_arrow prepared_datavalexrFs r3r6zMetricMixin.metric8sB #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"? d3uD1$5@ ww,mTT!/""%mDI;?88 sG99 H#HH#ctd|S)Nr)r )r_s r3r]zMetricMixin.dgMs$d++r2)Nr)rKstrrUrrMrr`r"r;z str | Noner<rr=boolr>rr?r r@zOptionSequence[Any] | NonerALiteral['line', 'bar', 'area']rBr'returnr)rkr)r-r.r/rr6propertyr]r1r2r3r5r57sH "* RU ,5 "155;"(RURURU RU  RURU*RURURURU/RU3RU RU RURUh,,r2r5c|dk(rtjjS|dk(rtjjStjjS)Nbararea)rG ChartTypeBARAREALINE)rAs r3r\r\RsJU$$(((V$$)))  % %%r2c*|dvrtdgd|S)N>r%r!r$r&rBr#)r)rBs r3rPrP]s77!-1NOO r2c\t|tstd|dt|d|S)N'rDzg, which is not an accepted type. label only accepts: str. Please convert the label to an accepted type.) isinstancerh TypeErrorrY)rKs r3rJrJcs= eS !wmDK=1V V   Lr2cB|yt|tr|St|S)Nu—)rwrhr)rUs r3rHrHls$ }% u r2c^||dk(ryt|tr t|St|S)N)rwrhrrrMs r3rLrLts/ } %e} u r2c|dvrtd|d||dk(r=ttjjtj j St|ru|dk(rtjj}n:|dk(rtjj}ntjj}tj j}nt|dk(rtjj}n:|dk(rtjj}ntjj}tj j}t||S)N>r!rr rvzS' is not an accepted value. delta_color only accepts: 'normal', 'inverse', or 'off'r{)r+r,rr ) rr*rG MetricColorGRAYrQrR_is_negative_deltaREDGREENrTrS)r`rMcd_color cd_directions r3rOrO|s(66# }, ,   } &))..!1166  % ( ""..22H I %"..44H"..33H"2277 ( ""..44H I %"..22H"..33H"2255 " r2cHtt|jdS)N-)rrh startswithr|s r3rrs #e*  ( ( --r2)rArjrkzMetricProto.ChartType.ValueType)rBr'rkr')rKrhrkrh)rUrrkrh)rMrrkrh)r`r"rMrrkr*)rMrrkri)7 __future__r dataclassesrtextwraprtypingrrrr r streamlit.dataframe_utilr r #streamlit.elements.lib.layout_utilsr rrrrstreamlit.elements.lib.policiesrstreamlit.elements.lib.utilsrrstreamlit.errorsrrstreamlit.proto.Metric_pb2rrGstreamlit.runtime.metrics_utilrstreamlit.string_utilrrrstreamlit.delta_generatorrrhrr0rr"r'r*r5r\rPrJrHrLrOrr1r2r3rs#!??MGH<9DD8s?T)y)s?T)y) :; I; ;< I< $555 X,X,v&.&$& $$ $$N.r2