streamlit-nightly 1.43.3.dev20250311__py3-none-any.whl → 1.43.3.dev20250313__py3-none-any.whl

streamlit/testing/v1/element_tree.py

@@ -86,7 +86,7 @@ T = TypeVar("T")
 
 @dataclass
 class InitialValue:
-    """This class is used to represent the initial value of a widget."""
+    """Used to represent the initial value of a widget."""
 
     pass
 
@@ -136,7 +136,7 @@ class Element(ABC):
         ...
 
     def __getattr__(self, name: str) -> Any:
-        """Fallback attempt to get an attribute from the proto"""
+        """Fallback attempt to get an attribute from the proto."""
         return getattr(self.proto, name)
 
     def run(self, *, timeout: float | None = None) -> AppTest:
@@ -323,7 +323,7 @@ class Button(Widget):
 
     @property
     def value(self) -> bool:
-        """The value of the button. (bool)"""
+        """The value of the button. (bool)"""  # noqa: D400
         if self._value:
             return self._value
         else:
@@ -368,7 +368,7 @@ class ChatInput(Widget):
 
     @property
     def value(self) -> str | None:
-        """The value of the widget. (str)"""
+        """The value of the widget. (str)"""  # noqa: D400
         if self._value:
             return self._value
         else:
@@ -401,7 +401,7 @@ class Checkbox(Widget):
 
     @property
     def value(self) -> bool:
-        """The value of the widget. (bool)"""
+        """The value of the widget. (bool)"""  # noqa: D400
         if self._value is not None:
             return self._value
         else:
@@ -441,7 +441,7 @@ class Code(Element):
 
     @property
     def value(self) -> str:
-        """The value of the element. (str)"""
+        """The value of the element. (str)"""  # noqa: D400
         return self.proto.code_text
 
 
@@ -462,7 +462,7 @@ class ColorPicker(Widget):
 
     @property
     def value(self) -> str:
-        """The currently selected value as a hex string. (str)"""
+        """The currently selected value as a hex string. (str)"""  # noqa: D400
         if self._value is not None:
             return self._value
         else:
@@ -548,7 +548,7 @@ class DateInput(Widget):
 
     @property
     def value(self) -> DateWidgetReturn:
-        """The value of the widget. (date or Tuple of date)"""
+        """The value of the widget. (date or Tuple of date)"""  # noqa: D400
         if not isinstance(self._value, InitialValue):
             parsed, _ = _parse_date_value(self._value)
             return tuple(parsed) if parsed is not None else None  # type: ignore
@@ -721,7 +721,7 @@ class ButtonGroup(Widget, Generic[T]):
 
     @property
     def value(self) -> list[T]:
-        """The currently selected values from the options. (list)"""
+        """The currently selected values from the options. (list)"""  # noqa: D400
         if self._value is not None:
             return self._value
         else:
@@ -731,17 +731,17 @@ class ButtonGroup(Widget, Generic[T]):
 
     @property
     def indices(self) -> Sequence[int]:
-        """The indices of the currently selected values from the options. (list)"""
+        """The indices of the currently selected values from the options. (list)"""  # noqa: D400
         return [self.options.index(self.format_func(v)) for v in self.value]
 
     @property
     def format_func(self) -> Callable[[Any], Any]:
-        """The widget's formatting function for displaying options. (callable)"""
+        """The widget's formatting function for displaying options. (callable)"""  # noqa: D400
         ss = self.root.session_state
         return cast(Callable[[Any], Any], ss[TESTING_KEY][self.id])
 
     def set_value(self, v: list[T]) -> ButtonGroup[T]:
-        """Set the value of the multiselect widget. (list)"""
+        """Set the value of the multiselect widget. (list)"""  # noqa: D400
 
         self._value = v
         return self
@@ -809,7 +809,7 @@ class Multiselect(Widget, Generic[T]):
 
     @property
     def value(self) -> list[T]:
-        """The currently selected values from the options. (list)"""
+        """The currently selected values from the options. (list)"""  # noqa: D400
         if self._value is not None:
             return self._value
         else:
@@ -819,17 +819,17 @@ class Multiselect(Widget, Generic[T]):
 
     @property
     def indices(self) -> Sequence[int]:
-        """The indices of the currently selected values from the options. (list)"""
+        """The indices of the currently selected values from the options. (list)"""  # noqa: D400
         return [self.options.index(self.format_func(v)) for v in self.value]
 
     @property
     def format_func(self) -> Callable[[Any], Any]:
-        """The widget's formatting function for displaying options. (callable)"""
+        """The widget's formatting function for displaying options. (callable)"""  # noqa: D400
         ss = self.root.session_state
         return cast(Callable[[Any], Any], ss[TESTING_KEY][self.id])
 
     def set_value(self, v: list[T]) -> Multiselect[T]:
-        """Set the value of the multiselect widget. (list)"""
+        """Set the value of the multiselect widget. (list)"""  # noqa: D400
 
         self._value = v
         return self
@@ -952,14 +952,14 @@ class Radio(Widget, Generic[T]):
 
     @property
     def index(self) -> int | None:
-        """The index of the current selection. (int)"""
+        """The index of the current selection. (int)"""  # noqa: D400
         if self.value is None:
             return None
         return self.options.index(self.format_func(self.value))
 
     @property
     def value(self) -> T | None:
-        """The currently selected value from the options. (Any)"""
+        """The currently selected value from the options. (Any)"""  # noqa: D400
         if not isinstance(self._value, InitialValue):
             return self._value
         else:
@@ -969,7 +969,7 @@ class Radio(Widget, Generic[T]):
 
     @property
     def format_func(self) -> Callable[[Any], Any]:
-        """The widget's formatting function for displaying options. (callable)"""
+        """The widget's formatting function for displaying options. (callable)"""  # noqa: D400
         ss = self.root.session_state
         return cast(Callable[[Any], Any], ss[TESTING_KEY][self.id])
 
@@ -1011,7 +1011,7 @@ class Selectbox(Widget, Generic[T]):
 
     @property
     def index(self) -> int | None:
-        """The index of the current selection. (int)"""
+        """The index of the current selection. (int)"""  # noqa: D400
         if self.value is None:
             return None
 
@@ -1021,7 +1021,7 @@ class Selectbox(Widget, Generic[T]):
 
     @property
     def value(self) -> T | None:
-        """The currently selected value from the options. (Any)"""
+        """The currently selected value from the options. (Any)"""  # noqa: D400
         if not isinstance(self._value, InitialValue):
             return self._value
         else:
@@ -1031,7 +1031,7 @@ class Selectbox(Widget, Generic[T]):
 
     @property
     def format_func(self) -> Callable[[Any], Any]:
-        """The widget's formatting function for displaying options. (callable)"""
+        """The widget's formatting function for displaying options. (callable)"""  # noqa: D400
         ss = self.root.session_state
         return cast(Callable[[Any], Any], ss[TESTING_KEY][self.id])
 
@@ -1104,7 +1104,7 @@ class SelectSlider(Widget, Generic[T]):
 
     @property
     def value(self) -> T | Sequence[T]:
-        """The currently selected value or range. (Any or Sequence of Any)"""
+        """The currently selected value or range. (Any or Sequence of Any)"""  # noqa: D400
         if self._value is not None:
             return self._value
         else:
@@ -1115,7 +1115,7 @@ class SelectSlider(Widget, Generic[T]):
 
     @property
     def format_func(self) -> Callable[[Any], Any]:
-        """The widget's formatting function for displaying options. (callable)"""
+        """The widget's formatting function for displaying options. (callable)"""  # noqa: D400
         ss = self.root.session_state
         return cast(Callable[[Any], Any], ss[TESTING_KEY][self.id])
 
@@ -1163,7 +1163,7 @@ class Slider(Widget, Generic[SliderValueT]):
 
     @property
     def value(self) -> SliderValueT | Sequence[SliderValueT]:
-        """The currently selected value or range. (Any or Sequence of Any)"""
+        """The currently selected value or range. (Any or Sequence of Any)"""  # noqa: D400
         if self._value is not None:
             return self._value
         else:
@@ -1207,7 +1207,7 @@ class Text(Element):
 
     @property
     def value(self) -> str:
-        """The value of the element. (str)"""
+        """The value of the element. (str)"""  # noqa: D400
         return self.proto.body
 
 
@@ -1244,7 +1244,7 @@ class TextArea(Widget):
 
     @property
     def value(self) -> str | None:
-        """The current value of the widget. (str)"""
+        """The current value of the widget. (str)"""  # noqa: D400
         if not isinstance(self._value, InitialValue):
             return self._value
         else:
@@ -1297,7 +1297,7 @@ class TextInput(Widget):
 
     @property
     def value(self) -> str | None:
-        """The current value of the widget. (str)"""
+        """The current value of the widget. (str)"""  # noqa: D400
         if not isinstance(self._value, InitialValue):
             return self._value
         else:
@@ -1354,7 +1354,7 @@ class TimeInput(Widget):
 
     @property
     def value(self) -> time | None:
-        """The current value of the widget. (time)"""
+        """The current value of the widget. (time)"""  # noqa: D400
         if not isinstance(self._value, InitialValue):
             v = self._value
             v = v.time() if isinstance(v, datetime) else v
@@ -1420,7 +1420,7 @@ class Toggle(Widget):
 
     @property
     def value(self) -> bool:
-        """The current value of the widget. (bool)"""
+        """The current value of the widget. (bool)"""  # noqa: D400
         if self._value is not None:
             return self._value
         else:

streamlit/testing/v1/util.py

@@ -25,7 +25,8 @@ def patch_config_options(config_overrides: dict[str, Any]):
     """A context manager that overrides config options. It can
     also be used as a function decorator.
 
-    Examples:
+    Examples
+    --------
     >>> with patch_config_options({"server.headless": True}):
     ...     assert config.get_option("server.headless") is True
     ...     # Other test code that relies on these options

streamlit/time_util.py

@@ -51,9 +51,7 @@ def time_to_seconds(t: float | timedelta | str | None) -> float: ...
 def time_to_seconds(
     t: float | timedelta | str | None, *, coerce_none_to_inf: bool = True
 ) -> float | None:
-    """
-    Convert a time string value to a float representing "number of seconds".
-    """
+    """Convert a time string value to a float representing "number of seconds"."""
     if coerce_none_to_inf and t is None:
         return math.inf
     if isinstance(t, timedelta):

streamlit/type_util.py

@@ -386,7 +386,8 @@ def is_list_like(obj: object) -> TypeGuard[Sequence[Any]]:
 def check_python_comparable(seq: Sequence[Any]) -> None:
     """Check if the sequence elements support "python comparison".
     That means that the equality operator (==) returns a boolean value.
-    Which is not True for e.g. numpy arrays and pandas series."""
+    Which is not True for e.g. numpy arrays and pandas series.
+    """
     try:
         bool(seq[0] == seq[0])
     except LookupError:

streamlit/user_info.py

@@ -130,7 +130,6 @@ def login(provider: str | None = None) -> None:
 
     Examples
     --------
-
     **Example 1: Use an unnamed default identity provider**
 
     If you do not specify a name for your provider, specify all settings within

streamlit/watcher/event_based_path_watcher.py

@@ -66,7 +66,7 @@ def _get_abs_folder_path(path: str) -> str:
 
 
 class EventBasedPathWatcher:
-    """Watches a single path on disk using watchdog"""
+    """Watches a single path on disk using watchdog."""
 
     @staticmethod
     def close_all() -> None:

streamlit/web/bootstrap.py

@@ -137,7 +137,9 @@ def _on_server_start(server: Server) -> None:
 
 
 def _fix_pydeck_mapbox_api_warning() -> None:
-    """Sets MAPBOX_API_KEY environment variable needed for PyDeck otherwise it will throw an exception"""
+    """Sets MAPBOX_API_KEY environment variable needed for PyDeck otherwise it
+    will throw an exception.
+    """
 
     os.environ["MAPBOX_API_KEY"] = config.get_option("mapbox.token")
 

streamlit/web/cache_storage_manager_config.py

@@ -27,7 +27,7 @@ if TYPE_CHECKING:
 def create_default_cache_storage_manager() -> CacheStorageManager:
     """
     Get the cache storage manager.
-    It would be used both in server.py and in cli.py to have unified cache storage
+    It would be used both in server.py and in cli.py to have unified cache storage.
 
     Returns
     -------

streamlit/web/cli.py

@@ -110,7 +110,7 @@ def configurator_options(func: F) -> F:
 
 
 def _download_remote(main_script_path: str, url_path: str) -> None:
-    """Fetch remote file at url_path to main_script_path"""
+    """Fetch remote file at url_path to main_script_path."""
     import requests
 
     with open(main_script_path, "wb") as fp:
@@ -133,7 +133,7 @@ def main(log_level="info"):
     Or use the line below to run your own script:
 
         $ streamlit run your_script.py
-    """
+    """  # noqa: D400
 
     if log_level:
         from streamlit.logger import get_logger
@@ -365,5 +365,47 @@ def test_prog_name():
     assert parent.command_path == "streamlit test"
 
 
+@main.command("init")
+@click.argument("directory", required=False)
+def main_init(directory: str | None = None):
+    """Initialize a new Streamlit project.
+
+    If DIRECTORY is specified, create it and initialize the project there.
+    Otherwise use the current directory.
+    """
+    from pathlib import Path
+
+    project_dir = Path(directory) if directory else Path.cwd()
+
+    try:
+        project_dir.mkdir(exist_ok=True, parents=True)
+    except OSError as e:
+        raise click.ClickException(f"Failed to create directory: {e}")
+
+    # Create requirements.txt
+    (project_dir / "requirements.txt").write_text("streamlit\n")
+
+    # Create streamlit_app.py
+    (project_dir / "streamlit_app.py").write_text("""import streamlit as st
+
+st.title("🎈 My new app")
+st.write(
+    "Let's start building! For help and inspiration, head over to [docs.streamlit.io](https://docs.streamlit.io/)."
+)
+""")
+
+    rel_path_str = str(directory) if directory else "."
+
+    click.secho("✨ Created new Streamlit app in ", nl=False)
+    click.secho(f"{rel_path_str}", fg="blue")
+    click.echo("🚀 Run it with: ", nl=False)
+    click.secho(f"streamlit run {rel_path_str}/streamlit_app.py", fg="blue")
+
+    if click.confirm("❓ Run the app now?", default=True):
+        app_path = project_dir / "streamlit_app.py"
+        click.echo("\nStarting Streamlit...")
+        _main_run(str(app_path))
+
+
 if __name__ == "__main__":
     main()

streamlit/web/server/authlib_tornado_integration.py

@@ -40,7 +40,7 @@ class TornadoIntegration(FrameworkIntegration):  # type: ignore[misc]
         oauth: TornadoOAuth, name: str, params: Sequence[str]
     ) -> dict[str, Any]:
         """Configure Authlib integration with provider parameters
-        specified in secrets.toml
+        specified in secrets.toml.
         """
 
         # oauth.config here is an auth section from secrets.toml

streamlit/web/server/browser_websocket_handler.py

@@ -47,7 +47,7 @@ _LOGGER: Final = get_logger(__name__)
 
 
 class BrowserWebSocketHandler(WebSocketHandler, SessionClient):
-    """Handles a WebSocket connection from the browser"""
+    """Handles a WebSocket connection from the browser."""
 
     def initialize(self, runtime: Runtime) -> None:
         self._runtime = runtime
@@ -69,6 +69,7 @@ class BrowserWebSocketHandler(WebSocketHandler, SessionClient):
     ) -> bytes | None:
         """Get a signed cookie from the request. Added for compatibility with
         Tornado < 6.3.0.
+
         See release notes: https://www.tornadoweb.org/en/stable/releases/v6.3.0.html#deprecation-notices
         """
         try:

streamlit/web/server/routes.py

@@ -141,7 +141,7 @@ class _SpecialRequestHandler(tornado.web.RequestHandler):
 
 class HealthHandler(_SpecialRequestHandler):
     def initialize(self, callback):
-        """Initialize the handler
+        """Initialize the handler.
 
         Parameters
         ----------
@@ -242,7 +242,7 @@ class HostConfigHandler(_SpecialRequestHandler):
 
 
 class MessageCacheHandler(tornado.web.RequestHandler):
-    """Returns ForwardMsgs from our MessageCache"""
+    """Returns ForwardMsgs from our MessageCache."""
 
     def initialize(self, cache):
         """Initializes the handler.

streamlit/web/server/server_util.py

@@ -12,7 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-"""Server related utility functions"""
+"""Server related utility functions."""
 
 from __future__ import annotations
 
@@ -153,9 +153,7 @@ def _get_browser_address_bar_port() -> int:
 
 
 def emit_endpoint_deprecation_notice(handler: RequestHandler, new_path: str) -> None:
-    """
-    Emits the warning about deprecation of HTTP endpoint in the HTTP header.
-    """
+    """Emits the warning about deprecation of HTTP endpoint in the HTTP header."""
     handler.set_header("Deprecation", True)
     new_url = urljoin(f"{handler.request.protocol}://{handler.request.host}", new_path)
     handler.set_header("Link", f'<{new_url}>; rel="alternate"')

{streamlit_nightly-1.43.3.dev20250311.dist-info → streamlit_nightly-1.43.3.dev20250313.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: streamlit-nightly
-Version: 1.43.3.dev20250311
+Version: 1.43.3.dev20250313
 Summary: A faster way to build and share data apps
 Home-page: https://streamlit.io
 Author: Snowflake Inc