streamlit-nightly 1.39.1.dev20241030__py2.py3-none-any.whl → 1.39.1.dev20241101__py2.py3-none-any.whl

streamlit/elements/widgets/text_widgets.py

@@ -139,8 +139,9 @@ class TextWidgetsMixin:
         label : str
             A short label explaining to the user what this input is for.
             The label can optionally contain GitHub-flavored Markdown of the
-            following types: Bold, Italics, Strikethroughs, Inline Code, and
-            Links.
+            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
@@ -150,9 +151,9 @@ class TextWidgetsMixin:
             See the ``body`` parameter of |st.markdown|_ for additional,
             supported Markdown directives.
 
-            For accessibility reasons, you should never set an empty label (label="")
-            but hide it with label_visibility if needed. In the future, we may disallow
-            empty labels by raising an exception.
+            For accessibility reasons, you should never set an empty label, but
+            you can hide it with ``label_visibility`` if needed. In the future,
+            we may disallow empty labels by raising an exception.
 
             .. |st.markdown| replace:: ``st.markdown``
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
@@ -176,7 +177,9 @@ class TextWidgetsMixin:
             masks the user's typed value). Defaults to "default".
 
         help : str
-            An optional tooltip that gets displayed next to the input.
+            An optional tooltip that gets displayed next to the widget label.
+            Streamlit only displays the tooltip when
+            ``label_visibility="visible"``.
 
         autocomplete : str
             An optional value that will be passed to the <input> element's
@@ -198,14 +201,14 @@ class TextWidgetsMixin:
             no text is displayed.
 
         disabled : bool
-            An optional boolean, which disables the text input if set to True.
-            The default is False.
+            An optional boolean that disables the text input if set to
+            ``True``. The default is ``False``.
 
         label_visibility : "visible", "hidden", or "collapsed"
-            The visibility of the label. If "hidden", the label doesn't show but there
-            is still empty space for it above the widget (equivalent to label="").
-            If "collapsed", both the label and the space are removed. Default is
-            "visible".
+            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 alligned with other widgets.
+            If this is ``"collapsed"``, Streamlit displays no label or spacer.
 
         Returns
         -------
@@ -410,8 +413,9 @@ class TextWidgetsMixin:
         label : str
             A short label explaining to the user what this input is for.
             The label can optionally contain GitHub-flavored Markdown of the
-            following types: Bold, Italics, Strikethroughs, Inline Code, and
-            Links.
+            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
@@ -421,22 +425,22 @@ class TextWidgetsMixin:
             See the ``body`` parameter of |st.markdown|_ for additional,
             supported Markdown directives.
 
-            For accessibility reasons, you should never set an empty label (label="")
-            but hide it with label_visibility if needed. In the future, we may disallow
-            empty labels by raising an exception.
+            For accessibility reasons, you should never set an empty label, but
+            you can hide it with ``label_visibility`` if needed. In the future,
+            we may disallow empty labels by raising an exception.
 
             .. |st.markdown| replace:: ``st.markdown``
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
 
-
         value : object or None
             The text value of this widget when it first renders. This will be
             cast to str internally. If ``None``, will initialize empty and
             return ``None`` until the user provides input. Defaults to empty string.
 
         height : int or None
-            Desired height of the UI element expressed in pixels. If None, a
-            default height is used. Height must be at least 68 pixels (4.25rem).
+            Desired height of the UI element expressed in pixels. If this is
+            ``None`` (default), the widget's initial height fits three lines.
+            The height must be at least 68 pixels, which fits two lines.
 
         max_chars : int or None
             Maximum number of characters allowed in text area.
@@ -447,7 +451,9 @@ class TextWidgetsMixin:
             based on its content. No two widgets may have the same key.
 
         help : str
-            An optional tooltip that gets displayed next to the textarea.
+            An optional tooltip that gets displayed next to the widget label.
+            Streamlit only displays the tooltip when
+            ``label_visibility="visible"``.
 
         on_change : callable
             An optional callback invoked when this text_area's value changes.
@@ -463,14 +469,14 @@ class TextWidgetsMixin:
             no text is displayed.
 
         disabled : bool
-            An optional boolean, which disables the text area if set to True.
-            The default is False.
+            An optional boolean that disables the text area if set to ``True``.
+            The default is ``False``.
 
         label_visibility : "visible", "hidden", or "collapsed"
-            The visibility of the label. If "hidden", the label doesn't show but there
-            is still empty space for it above the widget (equivalent to label="").
-            If "collapsed", both the label and the space are removed. Default is
-            "visible".
+            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 alligned with other widgets.
+            If this is ``"collapsed"``, Streamlit displays no label or spacer.
         Returns
         -------
         str or None

streamlit/elements/widgets/time_widgets.py

@@ -312,8 +312,9 @@ class TimeWidgetsMixin:
         label : str
             A short label explaining to the user what this time input is for.
             The label can optionally contain GitHub-flavored Markdown of the
-            following types: Bold, Italics, Strikethroughs, Inline Code, and
-            Links.
+            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
@@ -323,9 +324,9 @@ class TimeWidgetsMixin:
             See the ``body`` parameter of |st.markdown|_ for additional,
             supported Markdown directives.
 
-            For accessibility reasons, you should never set an empty label (label="")
-            but hide it with label_visibility if needed. In the future, we may disallow
-            empty labels by raising an exception.
+            For accessibility reasons, you should never set an empty label, but
+            you can hide it with ``label_visibility`` if needed. In the future,
+            we may disallow empty labels by raising an exception.
 
             .. |st.markdown| replace:: ``st.markdown``
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
@@ -342,7 +343,9 @@ class TimeWidgetsMixin:
             based on its content. No two widgets may have the same key.
 
         help : str
-            An optional tooltip that gets displayed next to the input.
+            An optional tooltip that gets displayed next to the widget label.
+            Streamlit only displays the tooltip when
+            ``label_visibility="visible"``.
 
         on_change : callable
             An optional callback invoked when this time_input's value changes.
@@ -354,14 +357,14 @@ class TimeWidgetsMixin:
             An optional dict of kwargs to pass to the callback.
 
         disabled : bool
-            An optional boolean, which disables the time input if set to True.
-            The default is False.
+            An optional boolean that disables the time input if set to
+            ``True``. The default is ``False``.
 
         label_visibility : "visible", "hidden", or "collapsed"
-            The visibility of the label. If "hidden", the label doesn't show but there
-            is still empty space for it above the widget (equivalent to label="").
-            If "collapsed", both the label and the space are removed. Default is
-            "visible".
+            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 alligned with other widgets.
+            If this is ``"collapsed"``, Streamlit displays no label or spacer.
 
         step : int or timedelta
             The stepping interval in seconds. Defaults to 900, i.e. 15 minutes.
@@ -534,13 +537,17 @@ class TimeWidgetsMixin:
     ) -> DateWidgetReturn:
         r"""Display a date input widget.
 
+        The first day of the week is determined from the user's locale in their
+        browser.
+
         Parameters
         ----------
         label : str
             A short label explaining to the user what this date input is for.
             The label can optionally contain GitHub-flavored Markdown of the
-            following types: Bold, Italics, Strikethroughs, Inline Code, and
-            Links.
+            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
@@ -550,9 +557,9 @@ class TimeWidgetsMixin:
             See the ``body`` parameter of |st.markdown|_ for additional,
             supported Markdown directives.
 
-            For accessibility reasons, you should never set an empty label (label="")
-            but hide it with label_visibility if needed. In the future, we may disallow
-            empty labels by raising an exception.
+            For accessibility reasons, you should never set an empty label, but
+            you can hide it with ``label_visibility`` if needed. In the future,
+            we may disallow empty labels by raising an exception.
 
             .. |st.markdown| replace:: ``st.markdown``
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
@@ -578,7 +585,9 @@ class TimeWidgetsMixin:
             based on its content. No two widgets may have the same key.
 
         help : str
-            An optional tooltip that gets displayed next to the input.
+            An optional tooltip that gets displayed next to the widget label.
+            Streamlit only displays the tooltip when
+            ``label_visibility="visible"``.
 
         on_change : callable
             An optional callback invoked when this date_input's value changes.
@@ -595,15 +604,14 @@ class TimeWidgetsMixin:
             You may also use a period (.) or hyphen (-) as separators.
 
         disabled : bool
-            An optional boolean, which disables the date input if set to True.
-            The default is False.
+            An optional boolean that disables the date input if set to
+            ``True``. The default is ``False``.
 
         label_visibility : "visible", "hidden", or "collapsed"
-            The visibility of the label. If "hidden", the label doesn't show but there
-            is still empty space for it above the widget (equivalent to label="").
-            If "collapsed", both the label and the space are removed. Default is
-            "visible".
-
+            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 alligned with other widgets.
+            If this is ``"collapsed"``, Streamlit displays no label or spacer.
 
         Returns
         -------

streamlit/hello/{Animation_Demo.py → animation_demo.py}

@@ -57,7 +57,7 @@ def animation_demo() -> None:
             N[M] = i
 
         # Update the image placeholder by calling the image() function on it.
-        image.image(1.0 - (N / N.max()), use_column_width=True)
+        image.image(1.0 - (N / N.max()), use_container_width=True)
 
     # We clear elements by calling empty on them.
     progress_bar.empty()
@@ -66,18 +66,17 @@ def animation_demo() -> None:
     # Streamlit widgets automatically run the script from top to bottom. Since
     # this button is not connected to any other logic, it just causes a plain
     # rerun.
-    st.button("Re-run")
+    st.button("Rerun")
 
 
-st.set_page_config(page_title="Animation Demo", page_icon=":material/animation:")
-st.markdown("# Animation Demo")
-st.sidebar.header("Animation Demo")
+st.set_page_config(page_title="Animation demo", page_icon=":material/animation:")
+st.title("Animation demo")
 st.write(
-    """This app shows how you can use Streamlit to build cool animations.
-It displays an animated fractal based on the the Julia Set. Use the slider
-to tune different parameters."""
+    """
+    This app shows how you can use Streamlit to build cool animations.
+    It displays an animated fractal based on the the Julia Set. Use the slider
+    to tune different parameters.
+    """
 )
-
 animation_demo()
-
 show_code(animation_demo)

streamlit/hello/{Dataframe_Demo.py → dataframe_demo.py}

@@ -38,7 +38,8 @@ def data_frame_demo():
         else:
             data = df.loc[countries]
             data /= 1000000.0
-            st.write("### Gross Agricultural Production ($B)", data.sort_index())
+            st.subheader("Gross agricultural production ($B)")
+            st.dataframe(data.sort_index())
 
             data = data.T.reset_index()
             data = pd.melt(data, id_vars=["index"]).rename(
@@ -55,23 +56,16 @@ def data_frame_demo():
             )
             st.altair_chart(chart, use_container_width=True)
     except URLError as e:
-        st.error(
-            """
-            **This demo requires internet access.**
-            Connection error: %s
-        """
-            % e.reason
-        )
+        st.error(f"This demo requires internet access. Connection error: {e.reason}")
 
 
-st.set_page_config(page_title="DataFrame Demo", page_icon=":material/table:")
-st.markdown("# DataFrame Demo")
-st.sidebar.header("DataFrame Demo")
+st.set_page_config(page_title="DataFrame demo", page_icon=":material/table:")
+st.title("DataFrame demo")
 st.write(
-    """This demo shows how to use `st.write` to visualize Pandas DataFrames.
-(Data courtesy of the [UN Data Explorer](http://data.un.org/Explorer.aspx).)"""
+    """
+    This demo shows how to use `st.dataframe` to visualize a Pandas DataFrame.
+    Data courtesy of the [UN Data Explorer](http://data.un.org/Explorer.aspx).
+    """
 )
-
 data_frame_demo()
-
 show_code(data_frame_demo)

streamlit/hello/{Hello.py → hello.py}

@@ -14,29 +14,24 @@
 
 import streamlit as st
 
-st.set_page_config(
-    page_title="Hello",
-    page_icon=":material/waving_hand:",
-)
-
-st.write("# Welcome to Streamlit! 👋")
-
-st.sidebar.success("Select a demo above.")
-
-st.markdown(
+st.set_page_config(page_title="Hello", page_icon=":material/waving_hand:")
+st.title("Welcome to Streamlit! 👋")
+st.write(
     """
     Streamlit is an open-source app framework built specifically for
-    Machine Learning and Data Science projects.
+    machine learning and data science projects.
     **👈 Select a demo from the sidebar** to see some examples
     of what Streamlit can do!
+
     ### Want to learn more?
     - Check out [streamlit.io](https://streamlit.io)
     - Jump into our [documentation](https://docs.streamlit.io)
     - Ask a question in our [community
       forums](https://discuss.streamlit.io)
+
     ### See more complex demos
     - Use a neural net to [analyze the Udacity Self-driving Car Image
       Dataset](https://github.com/streamlit/demo-self-driving)
     - Explore a [New York City rideshare dataset](https://github.com/streamlit/demo-uber-nyc-pickups)
-"""
+    """
 )

streamlit/hello/{Mapping_Demo.py → mapping_demo.py}

@@ -32,7 +32,7 @@ def mapping_demo():
 
     try:
         ALL_LAYERS = {
-            "Bike Rentals": pdk.Layer(
+            "Bike rentals": pdk.Layer(
                 "HexagonLayer",
                 data=from_data_file("bike_rental_stats.json"),
                 get_position=["lon", "lat"],
@@ -41,7 +41,7 @@ def mapping_demo():
                 elevation_range=[0, 1000],
                 extruded=True,
             ),
-            "Bart Stop Exits": pdk.Layer(
+            "Bart stop exits": pdk.Layer(
                 "ScatterplotLayer",
                 data=from_data_file("bart_stop_stats.json"),
                 get_position=["lon", "lat"],
@@ -49,7 +49,7 @@ def mapping_demo():
                 get_radius="[exits]",
                 radius_scale=0.05,
             ),
-            "Bart Stop Names": pdk.Layer(
+            "Bart stop names": pdk.Layer(
                 "TextLayer",
                 data=from_data_file("bart_stop_stats.json"),
                 get_position=["lon", "lat"],
@@ -58,7 +58,7 @@ def mapping_demo():
                 get_size=10,
                 get_alignment_baseline="'bottom'",
             ),
-            "Outbound Flow": pdk.Layer(
+            "Outbound flow": pdk.Layer(
                 "ArcLayer",
                 data=from_data_file("bart_path_stats.json"),
                 get_source_position=["lon", "lat"],
@@ -72,7 +72,7 @@ def mapping_demo():
                 width_max_pixels=30,
             ),
         }
-        st.sidebar.markdown("### Map Layers")
+        st.sidebar.subheader("Map layers")
         selected_layers = [
             layer
             for layer_name, layer in ALL_LAYERS.items()
@@ -103,15 +103,12 @@ def mapping_demo():
         )
 
 
-st.set_page_config(page_title="Mapping Demo", page_icon=":material/public:")
-st.markdown("# Mapping Demo")
-st.sidebar.header("Mapping Demo")
+st.set_page_config(page_title="Mapping demo", page_icon=":material/public:")
+st.title("Mapping demo")
 st.write(
-    """This demo shows how to use
-[`st.pydeck_chart`](https://docs.streamlit.io/develop/api-reference/charts/st.pydeck_chart)
-to display geospatial data."""
+    """
+    This demo shows how to use `st.pydeck_chart` to display geospatial data.
+    """
 )
-
 mapping_demo()
-
 show_code(mapping_demo)

streamlit/hello/{Plotting_Demo.py → plotting_demo.py}

@@ -28,7 +28,7 @@ def plotting_demo():
 
     for i in range(1, 101):
         new_rows = last_rows[-1, :] + np.random.randn(5, 1).cumsum(axis=0)
-        status_text.text("%i%% Complete" % i)
+        status_text.text(f"{i}% complete")
         chart.add_rows(new_rows)
         progress_bar.progress(i)
         last_rows = new_rows
@@ -39,18 +39,17 @@ def plotting_demo():
     # Streamlit widgets automatically run the script from top to bottom. Since
     # this button is not connected to any other logic, it just causes a plain
     # rerun.
-    st.button("Re-run")
+    st.button("Rerun")
 
 
-st.set_page_config(page_title="Plotting Demo", page_icon=":material/show_chart:")
-st.markdown("# Plotting Demo")
-st.sidebar.header("Plotting Demo")
+st.set_page_config(page_title="Plotting demo", page_icon=":material/show_chart:")
+st.title("Plotting demo")
 st.write(
-    """This demo illustrates a combination of plotting and animation with
-Streamlit. We're generating a bunch of random numbers in a loop for around
-5 seconds. Enjoy!"""
+    """
+    This demo illustrates a combination of plotting and animation with
+    Streamlit. We're generating a bunch of random numbers in a loop for around
+    5 seconds. Enjoy!
+    """
 )
-
 plotting_demo()
-
 show_code(plotting_demo)

streamlit/hello/streamlit_app.py

@@ -19,17 +19,35 @@ import streamlit as st
 dir_path = Path(__file__).parent
 
 
+# Note that this needs to be in a method so we can have an e2e playwright test.
 def run():
     page = st.navigation(
         [
-            st.Page(dir_path / "Hello.py", icon=":material/waving_hand:"),
-            st.Page(dir_path / "Animation_Demo.py", icon=":material/animation:"),
-            st.Page(dir_path / "Plotting_Demo.py", icon=":material/show_chart:"),
-            st.Page(dir_path / "Mapping_Demo.py", icon=":material/public:"),
-            st.Page(dir_path / "Dataframe_Demo.py", icon=":material/table:"),
+            st.Page(
+                dir_path / "hello.py", title="Hello", icon=":material/waving_hand:"
+            ),
+            st.Page(
+                dir_path / "dataframe_demo.py",
+                title="DataFrame demo",
+                icon=":material/table:",
+            ),
+            st.Page(
+                dir_path / "plotting_demo.py",
+                title="Plotting demo",
+                icon=":material/show_chart:",
+            ),
+            st.Page(
+                dir_path / "mapping_demo.py",
+                title="Mapping demo",
+                icon=":material/public:",
+            ),
+            st.Page(
+                dir_path / "animation_demo.py",
+                title="Animation demo",
+                icon=":material/animation:",
+            ),
         ]
     )
-
     page.run()
 
 

streamlit/proto/Image_pb2.pyi

@@ -61,7 +61,7 @@ class ImageList(google.protobuf.message.Message):
     IMGS_FIELD_NUMBER: builtins.int
     WIDTH_FIELD_NUMBER: builtins.int
     width: builtins.int
-    """@see WidthBehaviour on the backend
+    """@see WidthBehavior on the backend
     @see WidthBehavior on the frontend
     The width of each image.
     >0 sets the image width explicitly

streamlit/web/server/server.py

@@ -369,7 +369,12 @@ class Server:
             routes.extend(
                 [
                     (
-                        make_url_path_regex(base, "(.*)", trailing_slash="required"),
+                        # We want to remove paths with a trailing slash, but if the path
+                        # starts with a double slash //, the redirect will point
+                        # the browser to the wrong host.
+                        make_url_path_regex(
+                            base, "(?!/)(.*)", trailing_slash="required"
+                        ),
                         RemoveSlashHandler,
                     ),
                     (

{streamlit_nightly-1.39.1.dev20241030.dist-info → streamlit_nightly-1.39.1.dev20241101.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: streamlit-nightly
-Version: 1.39.1.dev20241030
+Version: 1.39.1.dev20241101
 Summary: A faster way to build and share data apps
 Home-page: https://streamlit.io
 Author: Snowflake Inc