streamlit 1.50.0__py3-none-any.whl → 1.52.0__py3-none-any.whl

streamlit/errors.py

@@ -41,6 +41,17 @@ class CustomComponentError(Error):
     pass
 
 
+class StreamlitComponentRegistryError(Error):
+    """Exceptions raised while discovering or registering Streamlit components.
+
+    These errors occur during Streamlit startup when scanning installed
+    distributions for component metadata and registering them with the component
+    registry.
+    """
+
+    pass
+
+
 class DeprecationError(Error):
     pass
 
@@ -274,6 +285,17 @@ class StreamlitInvalidHorizontalAlignmentError(LocalizableStreamlitException):
         )
 
 
+class StreamlitInvalidTextAlignmentError(LocalizableStreamlitException):
+    """Exception raised when an invalid text_alignment value is provided."""
+
+    def __init__(self, text_alignment: Any) -> None:
+        super().__init__(
+            'Invalid text_alignment value: "{text_alignment}". '
+            'Valid values are: `"left"`, `"center"`, `"right"`, or `"justify"`.',
+            text_alignment=text_alignment,
+        )
+
+
 # st.multiselect
 class StreamlitSelectionCountExceedsMaxError(LocalizableStreamlitException):
     """Exception raised when there are more default selections specified than the max allowable selections."""
@@ -399,6 +421,17 @@ class StreamlitMissingPageLabelError(LocalizableStreamlitException):
         )
 
 
+class StreamlitQueryParamDictValueError(LocalizableStreamlitException):
+    """Exception raised when a query param value is a dictionary."""
+
+    def __init__(self, key: str) -> None:
+        super().__init__(
+            "Query param value for `{key}` cannot be set to a dictionary. "
+            "Provide a string or iterable of strings instead.",
+            key=key,
+        )
+
+
 class StreamlitPageNotFoundError(LocalizableStreamlitException):
     """Exception raised the linked page can not be found."""
 
@@ -428,6 +461,67 @@ class StreamlitPageNotFoundError(LocalizableStreamlitException):
         )
 
 
+# Bidirectional Components
+class BidiComponentInvalidIdError(LocalizableStreamlitException):
+    """Exception raised when an invalid ID component is provided."""
+
+    def __init__(self, part: str, delimiter: str) -> None:
+        super().__init__(
+            "The `{part}` of a bidirectional component's ID must not contain "
+            "the delimiter sequence `{delimiter}`.",
+            part=part,
+            delimiter=delimiter,
+        )
+
+
+class BidiComponentMissingContentError(LocalizableStreamlitException):
+    """Exception raised when a component is missing required content."""
+
+    def __init__(self, component_name: str) -> None:
+        super().__init__(
+            "Component `{component_name}` must have either JavaScript content "
+            "(`js_content` or `js_url`) or HTML content (`html_content`), or both. "
+            "Please ensure the component definition includes at least one of these.",
+            component_name=component_name,
+        )
+
+
+class BidiComponentInvalidCallbackNameError(LocalizableStreamlitException):
+    """Exception raised when a callback with an invalid name is provided."""
+
+    def __init__(self, callback_name: str) -> None:
+        super().__init__(
+            "The callback name `'{callback_name}'` is not allowed. "
+            "Callback names must follow the pattern `on_{{event_name}}_change` "
+            "where `event_name` is not empty.",
+            callback_name=callback_name,
+        )
+
+
+class BidiComponentInvalidDefaultKeyError(LocalizableStreamlitException):
+    """Exception raised when an invalid key is provided in the default dict."""
+
+    def __init__(self, state_key: str, available_keys: list[str]) -> None:
+        super().__init__(
+            "Key `'{state_key}'` in `default` is not a valid state name. "
+            "Valid state names are those with corresponding `on_{{state_name}}_change` "
+            "callbacks. Available state names: `{available_keys}`",
+            state_key=state_key,
+            available_keys=available_keys or "none",
+        )
+
+
+class BidiComponentUnserializableDataError(LocalizableStreamlitException):
+    """Exception raised when data provided to a bidirectional component cannot be serialized."""
+
+    def __init__(self) -> None:
+        super().__init__(
+            "The `data` provided to the bidirectional component could not be serialized. "
+            "Please ensure the data is JSON-serializable, or is a supported data structure "
+            "like a pandas DataFrame."
+        )
+
+
 # policies
 class StreamlitFragmentWidgetsNotAllowedOutsideError(LocalizableStreamlitException):
     """Exception raised when the fragment attempts to write to an element outside of its container."""
@@ -519,6 +613,17 @@ class StreamlitInvalidHeightError(LocalizableStreamlitException):
         )
 
 
+class StreamlitInvalidSizeError(LocalizableStreamlitException):
+    """Exception raised when an invalid size value is provided."""
+
+    def __init__(self, size: Any) -> None:
+        super().__init__(
+            "Invalid size value: {size}. Size must be either an integer (pixels), "
+            "'stretch', 'small', 'medium', or 'large'.",
+            size=repr(size),
+        )
+
+
 class StreamlitValueError(LocalizableStreamlitException):
     """Exception raised when a value is not valid for a parameter."""
 
@@ -528,3 +633,35 @@ class StreamlitValueError(LocalizableStreamlitException):
             parameter=parameter,
             valid_values=", ".join(valid_values),
         )
+
+
+# config
+class StreamlitInvalidThemeError(LocalizableStreamlitException):
+    """Exception raised for general theme errors."""
+
+    def __init__(self, message: str) -> None:
+        super().__init__(
+            message,
+        )
+
+
+class StreamlitInvalidThemeOptionError(LocalizableStreamlitException):
+    """Exception raised when an invalid theme config option is provided."""
+
+    def __init__(self, message: str) -> None:
+        super().__init__(
+            message,
+        )
+
+
+class StreamlitInvalidThemeSectionError(LocalizableStreamlitException):
+    """Exception raised when an invalid theme section is provided."""
+
+    def __init__(self, option_name: str, file_path_or_url: str = "config.toml") -> None:
+        super().__init__(
+            "Invalid theme section: `{option_name}` found in {file_path_or_url}. "
+            "Valid sections are: `theme`, `theme.light`, `theme.dark`, `theme.sidebar`, `theme.light.sidebar`, "
+            "and `theme.dark.sidebar`.",
+            option_name=option_name,
+            file_path_or_url=file_path_or_url,
+        )

streamlit/git_util.py

@@ -79,7 +79,7 @@ class GitRepo:
 
             if self.git_version is not None and self.git_version >= _MIN_GIT_VERSION:
                 git_root = self.repo.git.rev_parse("--show-toplevel")
-                self.module = os.path.relpath(path, git_root)
+                self.module = str(os.path.relpath(path, git_root))
         except Exception:
             _LOGGER.debug(
                 "Did not find a git repo at %s. This is expected if this isn't a git repo, but could "

streamlit/hello/hello.py

@@ -36,3 +36,11 @@ st.write(
     - Explore a [New York City rideshare dataset](https://github.com/streamlit/demo-uber-nyc-pickups)
     """
 )
+
+# Preload Python modules that take a while to compile in a new venv.
+# Otherwise, when users switch to another page, it seems that Streamlit
+# is slow, when in reality this is just an artifact of loading/compiling
+# large modules from zero.
+with st.spinner("Preloading Python modules for other pages..."):
+    import numpy  # noqa: ICN001 F401
+    import pandas  # noqa: ICN001 F401

streamlit/hello/utils.py

@@ -14,7 +14,8 @@
 
 import inspect
 import textwrap
-from typing import Any, Callable
+from collections.abc import Callable
+from typing import Any
 
 import streamlit as st