streamlit-nightly 1.36.1.dev20240706__py2.py3-none-any.whl → 1.36.1.dev20240708__py2.py3-none-any.whl

streamlit/elements/vega_charts.py

@@ -185,7 +185,9 @@ class VegaLiteState(TypedDict, total=False):
     ...     },
     ... }
     >>>
-    >>> event = st.vega_lite_chart(st.session_state.data, spec, key="vega_chart", on_select="rerun")
+    >>> event = st.vega_lite_chart(
+    ...     st.session_state.data, spec, key="vega_chart", on_select="rerun"
+    ... )
     >>>
     >>> event
 
@@ -682,11 +684,11 @@ class VegaChartsMixin:
         >>> import numpy as np
         >>>
         >>> chart_data = pd.DataFrame(
-        ...    {
-        ...        "col1": np.random.randn(20),
-        ...        "col2": np.random.randn(20),
-        ...        "col3": np.random.choice(["A", "B", "C"], 20),
-        ...    }
+        ...     {
+        ...         "col1": np.random.randn(20),
+        ...         "col2": np.random.randn(20),
+        ...         "col3": np.random.choice(["A", "B", "C"], 20),
+        ...     }
         ... )
         >>>
         >>> st.line_chart(chart_data, x="col1", y="col2", color="col3")
@@ -703,10 +705,15 @@ class VegaChartsMixin:
         >>> import pandas as pd
         >>> import numpy as np
         >>>
-        >>> chart_data = pd.DataFrame(np.random.randn(20, 3), columns=["col1", "col2", "col3"])
+        >>> chart_data = pd.DataFrame(
+        ...     np.random.randn(20, 3), columns=["col1", "col2", "col3"]
+        ... )
         >>>
         >>> st.line_chart(
-        ...    chart_data, x="col1", y=["col2", "col3"], color=["#FF0000", "#0000FF"]  # Optional
+        ...     chart_data,
+        ...     x="col1",
+        ...     y=["col2", "col3"],
+        ...     color=["#FF0000", "#0000FF"],  # Optional
         ... )
 
         .. output::
@@ -875,11 +882,11 @@ class VegaChartsMixin:
         >>> import numpy as np
         >>>
         >>> chart_data = pd.DataFrame(
-        ...    {
-        ...        "col1": np.random.randn(20),
-        ...        "col2": np.random.randn(20),
-        ...        "col3": np.random.choice(["A", "B", "C"], 20),
-        ...    }
+        ...     {
+        ...         "col1": np.random.randn(20),
+        ...         "col2": np.random.randn(20),
+        ...         "col3": np.random.choice(["A", "B", "C"], 20),
+        ...     }
         ... )
         >>>
         >>> st.area_chart(chart_data, x="col1", y="col2", color="col3")
@@ -896,10 +903,15 @@ class VegaChartsMixin:
         >>> import pandas as pd
         >>> import numpy as np
         >>>
-        >>> chart_data = pd.DataFrame(np.random.randn(20, 3), columns=["col1", "col2", "col3"])
+        >>> chart_data = pd.DataFrame(
+        ...     np.random.randn(20, 3), columns=["col1", "col2", "col3"]
+        ... )
         >>>
         >>> st.area_chart(
-        ...    chart_data, x="col1", y=["col2", "col3"], color=["#FF0000", "#0000FF"]  # Optional
+        ...     chart_data,
+        ...     x="col1",
+        ...     y=["col2", "col3"],
+        ...     color=["#FF0000", "#0000FF"],  # Optional
         ... )
 
         .. output::
@@ -1084,11 +1096,11 @@ class VegaChartsMixin:
         >>> import numpy as np
         >>>
         >>> chart_data = pd.DataFrame(
-        ...    {
-        ...        "col1": list(range(20)) * 3,
-        ...        "col2": np.random.randn(60),
-        ...        "col3": ["A"] * 20 + ["B"] * 20 + ["C"] * 20,
-        ...    }
+        ...     {
+        ...         "col1": list(range(20)) * 3,
+        ...         "col2": np.random.randn(60),
+        ...         "col3": ["A"] * 20 + ["B"] * 20 + ["C"] * 20,
+        ...     }
         ... )
         >>>
         >>> st.bar_chart(chart_data, x="col1", y="col2", color="col3")
@@ -1106,11 +1118,18 @@ class VegaChartsMixin:
         >>> import numpy as np
         >>>
         >>> chart_data = pd.DataFrame(
-        ...    {"col1": list(range(20)), "col2": np.random.randn(20), "col3": np.random.randn(20)}
+        ...     {
+        ...         "col1": list(range(20)),
+        ...         "col2": np.random.randn(20),
+        ...         "col3": np.random.randn(20),
+        ...     }
         ... )
         >>>
         >>> st.bar_chart(
-        ...    chart_data, x="col1", y=["col2", "col3"], color=["#FF0000", "#0000FF"]  # Optional
+        ...     chart_data,
+        ...     x="col1",
+        ...     y=["col2", "col3"],
+        ...     color=["#FF0000", "#0000FF"],  # Optional
         ... )
 
         .. output::
@@ -1320,15 +1339,17 @@ class VegaChartsMixin:
         >>> import pandas as pd
         >>> import numpy as np
         >>>
-        >>> chart_data = pd.DataFrame(np.random.randn(20, 3), columns=["col1", "col2", "col3"])
-        >>> chart_data['col4'] = np.random.choice(['A','B','C'], 20)
+        >>> chart_data = pd.DataFrame(
+        ...     np.random.randn(20, 3), columns=["col1", "col2", "col3"]
+        ... )
+        >>> chart_data["col4"] = np.random.choice(["A", "B", "C"], 20)
         >>>
         >>> st.scatter_chart(
         ...     chart_data,
-        ...     x='col1',
-        ...     y='col2',
-        ...     color='col4',
-        ...     size='col3',
+        ...     x="col1",
+        ...     y="col2",
+        ...     color="col4",
+        ...     size="col3",
         ... )
 
         .. output::
@@ -1343,14 +1364,16 @@ class VegaChartsMixin:
         >>> import pandas as pd
         >>> import numpy as np
         >>>
-        >>> chart_data = pd.DataFrame(np.random.randn(20, 4), columns=["col1", "col2", "col3", "col4"])
+        >>> chart_data = pd.DataFrame(
+        ...     np.random.randn(20, 4), columns=["col1", "col2", "col3", "col4"]
+        ... )
         >>>
         >>> st.scatter_chart(
         ...     chart_data,
-        ...     x='col1',
-        ...     y=['col2', 'col3'],
-        ...     size='col4',
-        ...     color=['#FF0000', '#0000FF'],  # Optional
+        ...     x="col1",
+        ...     y=["col2", "col3"],
+        ...     size="col4",
+        ...     color=["#FF0000", "#0000FF"],  # Optional
         ... )
 
         .. output::

streamlit/elements/widgets/button.py

@@ -331,11 +331,11 @@ class ButtonMixin:
         >>>
         >>> with open("flower.png", "rb") as file:
         ...     btn = st.download_button(
-        ...             label="Download image",
-        ...             data=file,
-        ...             file_name="flower.png",
-        ...             mime="image/png"
-        ...           )
+        ...         label="Download image",
+        ...         data=file,
+        ...         file_name="flower.png",
+        ...         mime="image/png",
+        ...     )
 
         .. output::
            https://doc-download-buton.streamlit.app/

streamlit/elements/widgets/file_uploader.py

@@ -359,7 +359,9 @@ class FileUploaderMixin:
 
         >>> import streamlit as st
         >>>
-        >>> uploaded_files = st.file_uploader("Choose a CSV file", accept_multiple_files=True)
+        >>> uploaded_files = st.file_uploader(
+        ...     "Choose a CSV file", accept_multiple_files=True
+        ... )
         >>> for uploaded_file in uploaded_files:
         ...     bytes_data = uploaded_file.read()
         ...     st.write("filename:", uploaded_file.name)

streamlit/elements/widgets/multiselect.py

@@ -241,7 +241,8 @@ class MultiSelectMixin:
         >>> options = st.multiselect(
         ...     "What are your favorite colors",
         ...     ["Green", "Yellow", "Red", "Blue"],
-        ...     ["Yellow", "Red"])
+        ...     ["Yellow", "Red"],
+        ... )
         >>>
         >>> st.write("You selected:", options)
 

streamlit/elements/widgets/number_input.py

@@ -191,7 +191,9 @@ class NumberInputMixin:
         format : str or None
             A printf-style format string controlling how the interface should
             display numbers. Output must be purely numeric. This does not impact
-            the return value. Valid formatters: %d %e %f %g %i %u
+            the return value. Formatting is handled by [sprintf.js](https://github.com/alexei/sprintf.js).
+            This can be used to adjust decimal precision in the displayed result. For example,
+            ``'%0.1f'`` to only show 1 digit after the decimal.
         key : str or int
             An optional string or integer to use as the unique key for the widget.
             If this is omitted, a key will be generated for the widget
@@ -238,7 +240,9 @@ class NumberInputMixin:
 
         >>> import streamlit as st
         >>>
-        >>> number = st.number_input("Insert a number", value=None, placeholder="Type a number...")
+        >>> number = st.number_input(
+        ...     "Insert a number", value=None, placeholder="Type a number..."
+        ... )
         >>> st.write("The current number is ", number)
 
         .. output::

streamlit/elements/widgets/radio.py

@@ -188,7 +188,12 @@ class RadioMixin:
         >>> genre = st.radio(
         ...     "What's your favorite movie genre",
         ...     [":rainbow[Comedy]", "***Drama***", "Documentary :movie_camera:"],
-        ...     captions = ["Laugh out loud.", "Get the popcorn.", "Never stop learning."])
+        ...     captions=[
+        ...         "Laugh out loud.",
+        ...         "Get the popcorn.",
+        ...         "Never stop learning.",
+        ...     ],
+        ... )
         >>>
         >>> if genre == ":rainbow[Comedy]":
         ...     st.write("You selected comedy.")

streamlit/elements/widgets/select_slider.py

@@ -209,7 +209,16 @@ class SelectSliderMixin:
         >>>
         >>> color = st.select_slider(
         ...     "Select a color of the rainbow",
-        ...     options=["red", "orange", "yellow", "green", "blue", "indigo", "violet"])
+        ...     options=[
+        ...         "red",
+        ...         "orange",
+        ...         "yellow",
+        ...         "green",
+        ...         "blue",
+        ...         "indigo",
+        ...         "violet",
+        ...     ],
+        ... )
         >>> st.write("My favorite color is", color)
 
         And here's an example of a range select slider:
@@ -218,8 +227,17 @@ class SelectSliderMixin:
         >>>
         >>> start_color, end_color = st.select_slider(
         ...     "Select a range of color wavelength",
-        ...     options=["red", "orange", "yellow", "green", "blue", "indigo", "violet"],
-        ...     value=("red", "blue"))
+        ...     options=[
+        ...         "red",
+        ...         "orange",
+        ...         "yellow",
+        ...         "green",
+        ...         "blue",
+        ...         "indigo",
+        ...         "violet",
+        ...     ],
+        ...     value=("red", "blue"),
+        ... )
         >>> st.write("You selected wavelengths between", start_color, "and", end_color)
 
         .. output::

streamlit/elements/widgets/selectbox.py

@@ -172,7 +172,8 @@ class SelectboxMixin:
         >>>
         >>> option = st.selectbox(
         ...     "How would you like to be contacted?",
-        ...     ("Email", "Home phone", "Mobile phone"))
+        ...     ("Email", "Home phone", "Mobile phone"),
+        ... )
         >>>
         >>> st.write("You selected:", option)
 
@@ -185,10 +186,10 @@ class SelectboxMixin:
         >>> import streamlit as st
         >>>
         >>> option = st.selectbox(
-        ...    "How would you like to be contacted?",
-        ...    ("Email", "Home phone", "Mobile phone"),
-        ...    index=None,
-        ...    placeholder="Select contact method...",
+        ...     "How would you like to be contacted?",
+        ...     ("Email", "Home phone", "Mobile phone"),
+        ...     index=None,
+        ...     placeholder="Select contact method...",
         ... )
         >>>
         >>> st.write("You selected:", option)

streamlit/elements/widgets/slider.py

@@ -303,9 +303,7 @@ class SliderMixin:
 
         >>> import streamlit as st
         >>>
-        >>> values = st.slider(
-        ...     "Select a range of values",
-        ...     0.0, 100.0, (25.0, 75.0))
+        >>> values = st.slider("Select a range of values", 0.0, 100.0, (25.0, 75.0))
         >>> st.write("Values:", values)
 
         This is a range time slider:
@@ -314,8 +312,8 @@ class SliderMixin:
         >>> from datetime import time
         >>>
         >>> appointment = st.slider(
-        ...     "Schedule your appointment:",
-        ...     value=(time(11, 30), time(12, 45)))
+        ...     "Schedule your appointment:", value=(time(11, 30), time(12, 45))
+        ... )
         >>> st.write("You're scheduled for:", appointment)
 
         Finally, a datetime slider:
@@ -326,7 +324,8 @@ class SliderMixin:
         >>> start_time = st.slider(
         ...     "When do you start?",
         ...     value=datetime(2020, 1, 1, 9, 30),
-        ...     format="MM/DD/YY - hh:mm")
+        ...     format="MM/DD/YY - hh:mm",
+        ... )
         >>> st.write("Start time:", start_time)
 
         .. output::

streamlit/elements/widgets/text_widgets.py

@@ -488,7 +488,7 @@ class TextWidgetsMixin:
         ...     "was the epoch of incredulity, it was the season of Light, it was the "
         ...     "season of Darkness, it was the spring of hope, it was the winter of "
         ...     "despair, (...)",
-        ...     )
+        ... )
         >>>
         >>> st.write(f"You wrote {len(txt)} characters.")
 

streamlit/elements/write.py

@@ -302,7 +302,7 @@ class WriteMixin:
 
         >>> import streamlit as st
         >>>
-        >>> st.write('Hello, *World!* :sunglasses:')
+        >>> st.write("Hello, *World!* :sunglasses:")
 
         ..  output::
             https://doc-write1.streamlit.app/
@@ -315,10 +315,14 @@ class WriteMixin:
         >>> import pandas as pd
         >>>
         >>> st.write(1234)
-        >>> st.write(pd.DataFrame({
-        ...     'first column': [1, 2, 3, 4],
-        ...     'second column': [10, 20, 30, 40],
-        ... }))
+        >>> st.write(
+        ...     pd.DataFrame(
+        ...         {
+        ...             "first column": [1, 2, 3, 4],
+        ...             "second column": [10, 20, 30, 40],
+        ...         }
+        ...     )
+        ... )
 
         ..  output::
             https://doc-write2.streamlit.app/
@@ -328,8 +332,8 @@ class WriteMixin:
 
         >>> import streamlit as st
         >>>
-        >>> st.write('1 + 1 = ', 2)
-        >>> st.write('Below is a DataFrame:', data_frame, 'Above is a dataframe.')
+        >>> st.write("1 + 1 = ", 2)
+        >>> st.write("Below is a DataFrame:", data_frame, "Above is a dataframe.")
 
         ..  output::
             https://doc-write3.streamlit.app/
@@ -342,12 +346,12 @@ class WriteMixin:
         >>> import numpy as np
         >>> import altair as alt
         >>>
-        >>> df = pd.DataFrame(
-        ...     np.random.randn(200, 3),
-        ...     columns=['a', 'b', 'c'])
-        ...
-        >>> c = alt.Chart(df).mark_circle().encode(
-        ...     x='a', y='b', size='c', color='c', tooltip=['a', 'b', 'c'])
+        >>> df = pd.DataFrame(np.random.randn(200, 3), columns=["a", "b", "c"])
+        >>> c = (
+        ...     alt.Chart(df)
+        ...     .mark_circle()
+        ...     .encode(x="a", y="b", size="c", color="c", tooltip=["a", "b", "c"])
+        ... )
         >>>
         >>> st.write(c)
 

streamlit/runtime/caching/cache_data_api.py

@@ -467,7 +467,7 @@ class CacheDataAPI:
         ... def fetch_and_clean_data(url):
         ...     # Fetch data from URL here, and then clean it up.
         ...     return data
-        ...
+        >>>
         >>> d1 = fetch_and_clean_data(DATA_URL_1)
         >>> # Actually executes the function, since this is the first time it was
         >>> # encountered.
@@ -498,7 +498,7 @@ class CacheDataAPI:
         ... def fetch_and_clean_data(_db_connection, num_rows):
         ...     # Fetch data from _db_connection here, and then clean it up.
         ...     return data
-        ...
+        >>>
         >>> connection = make_database_connection()
         >>> d1 = fetch_and_clean_data(connection, num_rows=10)
         >>> # Actually executes the function, since this is the first time it was
@@ -518,7 +518,7 @@ class CacheDataAPI:
         ... def fetch_and_clean_data(_db_connection, num_rows):
         ...     # Fetch data from _db_connection here, and then clean it up.
         ...     return data
-        ...
+        >>>
         >>> fetch_and_clean_data.clear(_db_connection, 50)
         >>> # Clear the cached entry for the arguments provided.
         >>>

streamlit/runtime/caching/cache_resource_api.py

@@ -339,7 +339,7 @@ class CacheResourceAPI:
         ... def get_database_session(url):
         ...     # Create a database session object that points to the URL.
         ...     return session
-        ...
+        >>>
         >>> s1 = get_database_session(SESSION_URL_1)
         >>> # Actually executes the function, since this is the first time it was
         >>> # encountered.
@@ -361,7 +361,7 @@ class CacheResourceAPI:
         ... def get_database_session(_sessionmaker, url):
         ...     # Create a database connection object that points to the URL.
         ...     return connection
-        ...
+        >>>
         >>> s1 = get_database_session(create_sessionmaker(), DATA_URL_1)
         >>> # Actually executes the function, since this is the first time it was
         >>> # encountered.
@@ -379,7 +379,7 @@ class CacheResourceAPI:
         ... def get_database_session(_sessionmaker, url):
         ...     # Create a database connection object that points to the URL.
         ...     return connection
-        ...
+        >>>
         >>> fetch_and_clean_data.clear(_sessionmaker, "https://streamlit.io/")
         >>> # Clear the cached entry for the arguments provided.
         >>>

streamlit/runtime/caching/legacy_cache_api.py

@@ -90,7 +90,7 @@ def cache(
     ... def fetch_and_clean_data(url):
     ...     # Fetch data from URL here, and then clean it up.
     ...     return data
-    ...
+    >>>
     >>> d1 = fetch_and_clean_data(DATA_URL_1)
     >>> # Actually executes the function, since this is the first time it was
     >>> # encountered.

streamlit/runtime/connection_factory.py

@@ -252,21 +252,27 @@ def connection_factory(
     file.
 
     >>> import streamlit as st
-    >>> conn = st.connection("sql") # Config section defined in [connections.sql] in secrets.toml.
+    >>> conn = st.connection("sql")  # [connections.sql] section in secrets.toml.
 
     Creating a SQLConnection with a custom name requires you to explicitly specify the
     type. If type is not passed as a kwarg, it must be set in the appropriate section of
     ``secrets.toml``.
 
     >>> import streamlit as st
-    >>> conn1 = st.connection("my_sql_connection", type="sql") # Config section defined in [connections.my_sql_connection].
-    >>> conn2 = st.connection("my_other_sql_connection") # type must be set in [connections.my_other_sql_connection].
+    >>> conn1 = st.connection(
+    ...     "my_sql_connection", type="sql"
+    ... )  # Config section defined in [connections.my_sql_connection].
+    >>> conn2 = st.connection(
+    ...     "my_other_sql_connection"
+    ... )  # type must be set in [connections.my_other_sql_connection].
 
     Passing the full module path to the connection class that you want to use can be
     useful, especially when working with a custom connection:
 
     >>> import streamlit as st
-    >>> conn = st.connection("my_sql_connection", type="streamlit.connections.SQLConnection")
+    >>> conn = st.connection(
+    ...     "my_sql_connection", type="streamlit.connections.SQLConnection"
+    ... )
 
     Finally, you can pass the connection class to use directly to this function. Doing
     so allows static type checking tools such as ``mypy`` to infer the exact return

streamlit/static/asset-manifest.json

@@ -1,11 +1,11 @@
 {
   "files": {
     "main.css": "./static/css/main.29bca1b5.css",
-    "main.js": "./static/js/main.28e3c6e9.js",
+    "main.js": "./static/js/main.8729b772.js",
     "static/js/9336.3e046ad7.chunk.js": "./static/js/9336.3e046ad7.chunk.js",
     "static/js/9330.2b4c99e0.chunk.js": "./static/js/9330.2b4c99e0.chunk.js",
-    "static/js/2736.4336e2b9.chunk.js": "./static/js/2736.4336e2b9.chunk.js",
-    "static/js/3301.1d1b10bb.chunk.js": "./static/js/3301.1d1b10bb.chunk.js",
+    "static/js/2736.7d516fcc.chunk.js": "./static/js/2736.7d516fcc.chunk.js",
+    "static/js/3301.0cd98943.chunk.js": "./static/js/3301.0cd98943.chunk.js",
     "static/css/8148.49dfd2ce.chunk.css": "./static/css/8148.49dfd2ce.chunk.css",
     "static/js/8148.1b2c085e.chunk.js": "./static/js/8148.1b2c085e.chunk.js",
     "static/css/5441.e3b876c5.chunk.css": "./static/css/5441.e3b876c5.chunk.css",
@@ -38,7 +38,7 @@
     "static/js/3599.565b1eba.chunk.js": "./static/js/3599.565b1eba.chunk.js",
     "static/js/8691.cb9c04cf.chunk.js": "./static/js/8691.cb9c04cf.chunk.js",
     "static/js/6718.2e6586ef.chunk.js": "./static/js/6718.2e6586ef.chunk.js",
-    "static/js/7175.8f4014ec.chunk.js": "./static/js/7175.8f4014ec.chunk.js",
+    "static/js/7175.4cdaec13.chunk.js": "./static/js/7175.4cdaec13.chunk.js",
     "static/js/5345.73d26e5d.chunk.js": "./static/js/5345.73d26e5d.chunk.js",
     "static/js/9865.fd93213d.chunk.js": "./static/js/9865.fd93213d.chunk.js",
     "static/js/6405.ac5a6f23.chunk.js": "./static/js/6405.ac5a6f23.chunk.js",
@@ -151,6 +151,6 @@
   },
   "entrypoints": [
     "static/css/main.29bca1b5.css",
-    "static/js/main.28e3c6e9.js"
+    "static/js/main.8729b772.js"
   ]
 }

streamlit/static/index.html

@@ -1 +1 @@
-<!doctype html><html lang="en"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width,initial-scale=1,shrink-to-fit=no"/><link rel="shortcut icon" href="./favicon.png"/><link rel="preload" href="./static/media/SourceSansPro-Regular.0d69e5ff5e92ac64a0c9.woff2" as="font" type="font/woff2" crossorigin><link rel="preload" href="./static/media/SourceSansPro-SemiBold.abed79cd0df1827e18cf.woff2" as="font" type="font/woff2" crossorigin><link rel="preload" href="./static/media/SourceSansPro-Bold.118dea98980e20a81ced.woff2" as="font" type="font/woff2" crossorigin><title>Streamlit</title><script>window.prerenderReady=!1</script><script defer="defer" src="./static/js/main.28e3c6e9.js"></script><link href="./static/css/main.29bca1b5.css" rel="stylesheet"></head><body><noscript>You need to enable JavaScript to run this app.</noscript><div id="root"></div></body></html>
+<!doctype html><html lang="en"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width,initial-scale=1,shrink-to-fit=no"/><link rel="shortcut icon" href="./favicon.png"/><link rel="preload" href="./static/media/SourceSansPro-Regular.0d69e5ff5e92ac64a0c9.woff2" as="font" type="font/woff2" crossorigin><link rel="preload" href="./static/media/SourceSansPro-SemiBold.abed79cd0df1827e18cf.woff2" as="font" type="font/woff2" crossorigin><link rel="preload" href="./static/media/SourceSansPro-Bold.118dea98980e20a81ced.woff2" as="font" type="font/woff2" crossorigin><title>Streamlit</title><script>window.prerenderReady=!1</script><script defer="defer" src="./static/js/main.8729b772.js"></script><link href="./static/css/main.29bca1b5.css" rel="stylesheet"></head><body><noscript>You need to enable JavaScript to run this app.</noscript><div id="root"></div></body></html>