streamlit-nightly 1.36.1.dev20240707__py2.py3-none-any.whl → 1.36.1.dev20240709__py2.py3-none-any.whl

streamlit/elements/media.py

@@ -288,7 +288,7 @@ class MediaMixin:
         -------
         >>> import streamlit as st
         >>>
-        >>> video_file = open('myvideo.mp4', 'rb')
+        >>> video_file = open("myvideo.mp4", "rb")
         >>> video_bytes = video_file.read()
         >>>
         >>> st.video(video_bytes)
@@ -376,7 +376,7 @@ def _reshape_youtube_url(url: str) -> str | None:
 
     Example
     -------
-    >>> print(_reshape_youtube_url('https://youtu.be/_T8LGqJtuGc'))
+    >>> print(_reshape_youtube_url("https://youtu.be/_T8LGqJtuGc"))
 
     .. output::
         https://www.youtube.com/embed/_T8LGqJtuGc

streamlit/elements/metric.py

@@ -141,11 +141,11 @@ class MetricMixin:
 
         >>> import streamlit as st
         >>>
-        >>> st.metric(label="Gas price", value=4, delta=-0.5,
-        ...     delta_color="inverse")
+        >>> 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")
+        >>> st.metric(
+        ...     label="Active developers", value=123, delta=123, delta_color="off"
+        ... )
 
         .. output::
             https://doc-metric-example3.streamlit.app/

streamlit/elements/spinner.py

@@ -39,7 +39,7 @@ def spinner(text: str = "In progress...", *, _cache: bool = False) -> Iterator[N
     >>>
     >>> with st.spinner('Wait for it...'):
     >>>     time.sleep(5)
-    >>> st.success('Done!')
+    >>> st.success("Done!")
 
     """
     from streamlit.proto.Spinner_pb2 import Spinner as SpinnerProto

streamlit/elements/text.py

@@ -47,7 +47,7 @@ class TextMixin:
         -------
         >>> import streamlit as st
         >>>
-        >>> st.text('This is some text.')
+        >>> st.text("This is some text.")
 
         """
         text_proto = TextProto()

streamlit/elements/vega_charts.py

@@ -42,6 +42,7 @@ from streamlit.elements.lib.built_in_chart_utils import (
     ChartStackType,
     ChartType,
     generate_chart,
+    maybe_raise_stack_warning,
 )
 from streamlit.elements.lib.event_utils import AttributeDictionary
 from streamlit.elements.lib.policies import check_widget_policies
@@ -185,7 +186,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 +685,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 +706,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::
@@ -747,6 +755,7 @@ class VegaChartsMixin:
         x_label: str | None = None,
         y_label: str | None = None,
         color: str | Color | list[Color] | None = None,
+        stack: bool | ChartStackType | None = None,
         width: int | None = None,
         height: int | None = None,
         use_container_width: bool = True,
@@ -830,6 +839,13 @@ class VegaChartsMixin:
               as the number of y values (e.g. ``color=["#fd0", "#f0f", "#04f"]``
               for three lines).
 
+        stack : bool, "normalize", "center", or None
+            Whether to stack the areas. If this is ``None`` (default), uses
+            Vega's default. If ``True``, stacks the areas on top of one another.
+            If ``False``, overlays the areas without stacking. If "normalize",
+            the areas are stacked and normalized to 100%. If "center", the areas
+            are stacked and shifted to center their baseline (produces steamgraph).
+
         width : int or None
             Desired width of the chart expressed in pixels. If ``width`` is
             ``None`` (default), Streamlit sets the width of the chart to fit
@@ -875,11 +891,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 +912,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::
@@ -908,6 +929,18 @@ class VegaChartsMixin:
 
         """
 
+        # Check that the stack parameter is valid, raise more informative error message if not
+        maybe_raise_stack_warning(
+            stack,
+            "st.area_chart",
+            "https://docs.streamlit.io/develop/api-reference/charts/st.area_chart",
+        )
+
+        # st.area_chart's stack=False option translates to a "layered" area chart for vega. We reserve stack=False for
+        # grouped/non-stacked bar charts, so we need to translate False to "layered" here.
+        if stack is False:
+            stack = "layered"
+
         chart, add_rows_metadata = generate_chart(
             chart_type=ChartType.AREA,
             data=data,
@@ -919,6 +952,7 @@ class VegaChartsMixin:
             size_from_user=None,
             width=width,
             height=height,
+            stack=stack,
         )
         return cast(
             "DeltaGenerator",
@@ -1033,8 +1067,8 @@ class VegaChartsMixin:
 
         stack : bool, "normalize", "center", "layered", or None
             Whether to stack the bars. If this is ``None`` (default), uses Vega's
-            default. If this is ``True``, the bars are stacked on top of each other.
-            If this is ``False``, the bars are displayed side by side. If "normalize",
+            default. If ``True``, the bars are stacked on top of each other.
+            If ``False``, the bars are displayed side by side. If "normalize",
             the bars are stacked and normalized to 100%. If "center", the bars are
             stacked around a central axis. If "layered", the bars are stacked on top
             of one another.
@@ -1084,11 +1118,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 +1140,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::
@@ -1132,20 +1173,19 @@ class VegaChartsMixin:
 
         """
 
+        # Check that the stack parameter is valid, raise more informative error message if not
+        maybe_raise_stack_warning(
+            stack,
+            "st.bar_chart",
+            "https://docs.streamlit.io/develop/api-reference/charts/st.bar_chart",
+        )
+
         # Offset encodings (used for non-stacked/grouped bar charts) are not supported in Altair < 5.0.0
         if type_util.is_altair_version_less_than("5.0.0") and stack is False:
             raise StreamlitAPIException(
                 "Streamlit does not support non-stacked (grouped) bar charts with Altair 4.x. Please upgrade to Version 5."
             )
 
-        # Check that the stack parameter is valid, raise more informative error message if not
-        VALID_STACK_TYPES = (None, True, False, "normalize", "center", "layered")
-        if stack not in VALID_STACK_TYPES:
-            raise StreamlitAPIException(
-                f'Invalid value for stack parameter: {stack}. Stack must be one of True, False, "normalize", "center", "layered" or None. '
-                "See documentation for `st.bar_chart` [here](https://docs.streamlit.io/develop/api-reference/charts/st.bar_chart) for more information."
-            )
-
         bar_chart_type = (
             ChartType.HORIZONTAL_BAR if horizontal else ChartType.VERTICAL_BAR
         )
@@ -1320,15 +1360,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 +1385,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