streamlit 1.45.0__py3-none-any.whl → 1.46.0__py3-none-any.whl

streamlit/commands/page_config.py

@@ -52,34 +52,10 @@ _About: TypeAlias = Literal["About", "about"]
 MenuKey: TypeAlias = Literal[_GetHelp, _ReportABug, _About]
 MenuItems: TypeAlias = Mapping[MenuKey, Union[str, None]]
 
-# Emojis recommended by https://share.streamlit.io/rensdimmendaal/emoji-recommender/main/app/streamlit.py
-# for the term "streamlit". Watch out for zero-width joiners,
-# as they won't parse correctly in the list() call!
 RANDOM_EMOJIS: Final = list(
     "🔥™🎉🚀🌌💣✨🌙🎆🎇💥🤩🤙🌛🤘⬆💡🤪🥂⚡💨🌠🎊🍿😛🔮🤟🌃🍃🍾💫▪🌴🎈🎬🌀🎄😝☔⛽🍂💃😎🍸🎨🥳☀😍🅱🌞😻🌟😜💦💅🦄😋😉👻🍁🤤👯🌻‼🌈👌🎃💛😚🔫🙌👽🍬🌅☁🍷👭☕🌚💁👅🥰🍜😌🎥🕺❕🧡☄💕🍻✅🌸🚬🤓🍹®☺💪😙☘🤠✊🤗🍵🤞😂💯😏📻🎂💗💜🌊❣🌝😘💆🤑🌿🦋😈⛄🚿😊🌹🥴😽💋😭🖤🙆👐⚪💟☃🙈🍭💻🥀🚗🤧🍝💎💓🤝💄💖🔞⁉⏰🕊🎧☠♥🌳🏾🙉⭐💊🍳🌎🙊💸❤🔪😆🌾✈📚💀🏠✌🏃🌵🚨💂🤫🤭😗😄🍒👏🙃🖖💞😅🎅🍄🆓👉💩🔊🤷⌚👸😇🚮💏👳🏽💘💿💉👠🎼🎶🎤👗❄🔐🎵🤒🍰👓🏄🌲🎮🙂📈🚙📍😵🗣❗🌺🙄👄🚘🥺🌍🏡♦💍🌱👑👙☑👾🍩🥶📣🏼🤣☯👵🍫➡🎀😃✋🍞🙇😹🙏👼🐝⚫🎁🍪🔨🌼👆👀😳🌏📖👃🎸👧💇🔒💙😞⛅🏻🍴😼🗿🍗♠🦁✔🤖☮🐢🐎💤😀🍺😁😴📺☹😲👍🎭💚🍆🍋🔵🏁🔴🔔🧐👰☎🏆🤡🐠📲🙋📌🐬✍🔑📱💰🐱💧🎓🍕👟🐣👫🍑😸🍦👁🆗🎯📢🚶🦅🐧💢🏀🚫💑🐟🌽🏊🍟💝💲🐍🍥🐸☝♣👊⚓❌🐯🏈📰🌧👿🐳💷🐺📞🆒🍀🤐🚲🍔👹🙍🌷🙎🐥💵🔝📸⚠❓🎩✂🍼😑⬇⚾🍎💔🐔⚽💭🏌🐷🍍✖🍇📝🍊🐙👋🤔🥊🗽🐑🐘🐰💐🐴♀🐦🍓✏👂🏴👇🆘😡🏉👩💌😺✝🐼🐒🐶👺🖕👬🍉🐻🐾⬅⏬▶👮🍌♂🔸👶🐮👪⛳🐐🎾🐕👴🐨🐊🔹©🎣👦👣👨👈💬⭕📹📷"
 )
 
-# Also pick out some vanity emojis.
-ENG_EMOJIS: Final = [
-    "🎈",  # st.balloons 🎈🎈
-    "🤓",  # Abhi
-    "🏈",  # Amey
-    "🚲",  # Thiago
-    "🐧",  # Matteo
-    "🦒",  # Ken
-    "🐳",  # Karrie
-    "🕹️",  # Jonathan
-    "🇦🇲",  # Henrikh
-    "🎸",  # Guido
-    "🦈",  # Austin
-    "💎",  # Emiliano
-    "👩‍🎤",  # Naomi
-    "🧙‍♂️",  # Jon
-    "🐻",  # Brandon
-    "🎎",  # James
-    # TODO: Solicit emojis from the rest of Streamlit
-]
-
 
 def _lower_clean_dict_keys(dict: MenuItems) -> dict[str, Any]:
     return {str(k).lower().strip(): v for k, v in dict.items()}
@@ -134,26 +110,34 @@ def _get_favicon_string(page_icon: PageIcon) -> str:
 def set_page_config(
     page_title: str | None = None,
     page_icon: PageIcon | None = None,
-    layout: Layout = "centered",
-    initial_sidebar_state: InitialSideBarState = "auto",
+    layout: Layout | None = None,
+    initial_sidebar_state: InitialSideBarState | None = None,
     menu_items: MenuItems | None = None,
 ) -> None:
     """
-    Configures the default settings of the page.
+    Configure the default settings of the page.
 
-    .. note::
-        This must be the first Streamlit command used on an app page, and must only
-        be set once per page.
+    This command can be called multiple times in a script run to dynamically
+    change the page configuration. The calls are additive, with each successive
+    call overriding only the parameters that are specified.
 
     Parameters
     ----------
     page_title: str or None
-        The page title, shown in the browser tab. If None, defaults to the
-        filename of the script ("app.py" would show "app • Streamlit").
+        The page title, shown in the browser tab. If this is ``None``
+        (default), the page title is inherited from the previous call of
+        ``st.set_page_config``. If this is ``None`` and no previous call
+        exists, the page title is inferred from the page source.
+
+        If a page source is a Python file, its inferred title is derived from
+        the filename. If a page source is a callable object, its inferred title
+        is derived from the callable's name.
 
     page_icon : Anything supported by st.image (except list), str, or None
-        The page favicon. If ``page_icon`` is ``None`` (default), the favicon
-        will be a monochrome Streamlit logo.
+        The page favicon. If ``page_icon`` is ``None`` (default), the page icon
+        is inherited from the previous call of ``st.set_page_config``. If this
+        is ``None`` and no previous call exists, the favicon is a monochrome
+        Streamlit logo.
 
         In addition to the types supported by |st.image|_ (except list), the
         following strings are valid:
@@ -184,17 +168,29 @@ def set_page_config(
         .. |st.image| replace:: ``st.image``
         .. _st.image: https://docs.streamlit.io/develop/api-reference/media/st.image
 
-    layout: "centered" or "wide"
-        How the page content should be laid out. Defaults to "centered",
-        which constrains the elements into a centered column of fixed width;
-        "wide" uses the entire screen.
+    layout: "centered", "wide", or None
+        How the page content should be laid out. If this is ``None`` (default),
+        the page layout is inherited from the previous call of
+        ``st.set_page_config``. If this is ``None`` and no previous call
+        exists, the page layout is ``"centered"``.
+
+        ``"centered"`` constrains the elements into a centered column of fixed
+        width. ``"wide"`` uses the entire screen.
+
+    initial_sidebar_state: "auto", "expanded", "collapsed", or None
+        How the sidebar should start out. If this is ``None`` (default), the
+        sidebar state is inherited from the previous call of
+        ``st.set_page_config``. If no previous call exists, the sidebar state
+        is ``"auto"``.
 
-    initial_sidebar_state: "auto", "expanded", or "collapsed"
-        How the sidebar should start out. Defaults to "auto",
-        which hides the sidebar on small devices and shows it otherwise.
-        "expanded" shows the sidebar initially; "collapsed" hides it.
-        In most cases, you should just use "auto", otherwise the app will
-        look bad when embedded and viewed on mobile.
+        The folowing states are supported:
+
+        - ``"auto"``: The sidebar is hidden on small devices and shown otherwise.
+        - ``"expanded"``: The sidebar is shown initially.
+        - ``"collapsed"``: The sidebar is hidden initially.
+
+        In most cases, ``"auto"`` provides the best user experience across
+        devices of different sizes.
 
     menu_items: dict
         Configure the menu that appears on the top-right side of this app.
@@ -211,6 +207,8 @@ def set_page_config(
             If None, only shows Streamlit's default About text.
 
         The URL may also refer to an email address e.g. ``mailto:john@example.com``.
+        To remove an item that was specified in a previous call to
+        ``st.set_page_config``, set its value to ``None`` in the dictionary.
 
     Example
     -------
@@ -242,7 +240,11 @@ def set_page_config(
         pb_layout = PageConfigProto.CENTERED
     elif layout == "wide":
         pb_layout = PageConfigProto.WIDE
+    elif layout is None:
+        # Allows for multiple (additive) calls to set_page_config
+        pb_layout = PageConfigProto.LAYOUT_UNSET
     else:
+        # Note: Pylance incorrectly notes this error as unreachable
         raise StreamlitInvalidPageLayoutError(layout=layout)
 
     msg.page_config_changed.layout = pb_layout
@@ -254,7 +256,11 @@ def set_page_config(
         pb_sidebar_state = PageConfigProto.EXPANDED
     elif initial_sidebar_state == "collapsed":
         pb_sidebar_state = PageConfigProto.COLLAPSED
+    elif initial_sidebar_state is None:
+        # Allows for multiple (additive) calls to set_page_config
+        pb_sidebar_state = PageConfigProto.SIDEBAR_UNSET
     else:
+        # Note: Pylance incorrectly notes this error as unreachable
         raise StreamlitInvalidSidebarStateError(
             initial_sidebar_state=initial_sidebar_state
         )
@@ -274,12 +280,13 @@ def set_page_config(
 
 
 def get_random_emoji() -> str:
-    # Weigh our emojis 10x, cuz we're awesome!
     # TODO: fix the random seed with a hash of the user's app code, for stability?
-    return random.choice(RANDOM_EMOJIS + 10 * ENG_EMOJIS)
+    return random.choice(RANDOM_EMOJIS)  # noqa: S311
 
 
-def set_menu_items_proto(lowercase_menu_items, menu_items_proto) -> None:
+def set_menu_items_proto(
+    lowercase_menu_items: MenuItems, menu_items_proto: PageConfigProto.MenuItems
+) -> None:
     if GET_HELP_KEY in lowercase_menu_items:
         if lowercase_menu_items[GET_HELP_KEY] is not None:
             menu_items_proto.get_help_url = lowercase_menu_items[GET_HELP_KEY]
@@ -295,6 +302,9 @@ def set_menu_items_proto(lowercase_menu_items, menu_items_proto) -> None:
     if ABOUT_KEY in lowercase_menu_items:
         if lowercase_menu_items[ABOUT_KEY] is not None:
             menu_items_proto.about_section_md = dedent(lowercase_menu_items[ABOUT_KEY])
+        else:
+            # For multiple calls to set_page_config, clears previously set about markdown
+            menu_items_proto.clear_about_md = True
 
 
 def validate_menu_items(menu_items: MenuItems) -> None:

streamlit/components/types/base_custom_component.py

@@ -40,7 +40,7 @@ class BaseCustomComponent(ABC):
         path: str | None = None,
         url: str | None = None,
         module_name: str | None = None,
-    ):
+    ) -> None:
         if (path is None and url is None) or (path is not None and url is not None):
             raise StreamlitAPIException(
                 "Either 'path' or 'url' must be set, but not both."
@@ -56,12 +56,12 @@ class BaseCustomComponent(ABC):
 
     def __call__(
         self,
-        *args,
+        *args: Any,
         default: Any = None,
         key: str | None = None,
         on_change: WidgetCallback | None = None,
         tab_index: int | None = None,
-        **kwargs,
+        **kwargs: Any,
     ) -> Any:
         """An alias for create_instance."""
         return self.create_instance(
@@ -99,24 +99,24 @@ class BaseCustomComponent(ABC):
         return f"'{self.name}': {self.path if self.path is not None else self.url}"
 
     @abstractmethod
-    def __eq__(self, other) -> bool:
+    def __eq__(self, other: object) -> bool:
         """Equality operator."""
         return NotImplemented
 
     @abstractmethod
-    def __ne__(self, other) -> bool:
+    def __ne__(self, other: object) -> bool:
         """Inequality operator."""
         return NotImplemented
 
     @abstractmethod
     def create_instance(
         self,
-        *args,
+        *args: Any,
         default: Any = None,
         key: str | None = None,
         on_change: WidgetCallback | None = None,
         tab_index: int | None = None,
-        **kwargs,
+        **kwargs: Any,
     ) -> Any:
         """Create a new instance of the component.
 

streamlit/components/v1/component_registry.py

@@ -33,7 +33,8 @@ def _get_module_name(caller_frame: FrameType) -> str:
     # Get the caller's module name. `__name__` gives us the module's
     # fully-qualified name, which includes its package.
     module = inspect.getmodule(caller_frame)
-    assert module is not None
+    if module is None:
+        raise RuntimeError("module is None. This should never happen.")
     module_name = module.__name__
 
     # If the caller was the main module that was executed (that is, if the
@@ -96,10 +97,13 @@ def declare_component(
 
     # Get our stack frame.
     current_frame: FrameType | None = inspect.currentframe()
-    assert current_frame is not None
+    if current_frame is None:
+        raise RuntimeError("current_frame is None. This should never happen.")
     # Get the stack frame of our calling function.
     caller_frame = current_frame.f_back
-    assert caller_frame is not None
+    if caller_frame is None:
+        raise RuntimeError("caller_frame is None. This should never happen.")
+
     module_name = _get_module_name(caller_frame)
 
     # Build the component name.

streamlit/components/v1/components.py

@@ -32,7 +32,7 @@ from streamlit.runtime.state import register_widget
 
 __all__ = [
     "CustomComponent",
-    "declare_component",
     "MarshallComponentException",
+    "declare_component",
     "register_widget",
 ]

streamlit/components/v1/custom_component.py

@@ -48,12 +48,12 @@ class CustomComponent(BaseCustomComponent):
 
     def __call__(
         self,
-        *args,
+        *args: Any,
         default: Any = None,
         key: str | None = None,
         on_change: WidgetCallback | None = None,
         tab_index: int | None = None,
-        **kwargs,
+        **kwargs: Any,
     ) -> Any:
         """An alias for create_instance."""
         return self.create_instance(
@@ -68,12 +68,12 @@ class CustomComponent(BaseCustomComponent):
     @gather_metrics("create_instance")
     def create_instance(
         self,
-        *args,
+        *args: Any,
         default: Any = None,
         key: str | None = None,
         on_change: WidgetCallback | None = None,
         tab_index: int | None = None,
-        **kwargs,
+        **kwargs: Any,
     ) -> Any:
         """Create a new instance of the component.
 
@@ -183,7 +183,7 @@ And if you're using Streamlit Cloud, add "pyarrow" to your requirements.txt."""
             # other arguments change, and the component's iframe won't be
             # remounted on the frontend.
 
-            def marshall_element_args():
+            def marshall_element_args() -> None:
                 element.component_instance.json_args = serialized_json_args
                 element.component_instance.special_args.extend(special_args)
 
@@ -210,7 +210,7 @@ And if you're using Streamlit Cloud, add "pyarrow" to your requirements.txt."""
                 )
             element.component_instance.id = computed_id
 
-            def deserialize_component(ui_value, widget_id=""):
+            def deserialize_component(ui_value: Any) -> Any:
                 # ui_value is an object from json, an ArrowTable proto, or a bytearray
                 return ui_value
 
@@ -243,7 +243,7 @@ And if you're using Streamlit Cloud, add "pyarrow" to your requirements.txt."""
         dg._enqueue("component_instance", element.component_instance)
         return return_value
 
-    def __eq__(self, other) -> bool:
+    def __eq__(self, other: object) -> bool:
         """Equality operator."""
         return (
             isinstance(other, CustomComponent)
@@ -253,7 +253,7 @@ And if you're using Streamlit Cloud, add "pyarrow" to your requirements.txt."""
             and self.module_name == other.module_name
         )
 
-    def __ne__(self, other) -> bool:
+    def __ne__(self, other: object) -> bool:
         """Inequality operator."""
 
         # we have to use "not X == Y"" here because if we use "X != Y"