streamlit-nightly 1.43.2.dev20250307__py3-none-any.whl

streamlit/git_util.py

@@ -0,0 +1,173 @@
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+import os
+import re
+from typing import Any
+
+from streamlit import util
+
+# Github has two URLs, one that is https and one that is ssh
+GITHUB_HTTP_URL = r"^https://(www\.)?github.com/(.+)/(.+)(?:.git)?$"
+GITHUB_SSH_URL = r"^git@github.com:(.+)/(.+)(?:.git)?$"
+
+# We don't support git < 2.7, because we can't get repo info without
+# talking to the remote server, which results in the user being prompted
+# for credentials.
+MIN_GIT_VERSION = (2, 7, 0)
+
+
+class GitRepo:
+    def __init__(self, path):
+        # If we have a valid repo, git_version will be a tuple of 3+ ints:
+        # (major, minor, patch, possible_additional_patch_number)
+        self.git_version: tuple[int, ...] | None = None
+
+        try:
+            import git
+
+            # GitPython is not fully typed, and mypy is outputting inconsistent
+            # type errors on Mac and Linux. We bypass type checking entirely
+            # by re-declaring the `git` import as an "Any".
+            git_package: Any = git
+            self.repo = git_package.Repo(path, search_parent_directories=True)
+            self.git_version = self.repo.git.version_info
+
+            if self.git_version >= MIN_GIT_VERSION:
+                git_root = self.repo.git.rev_parse("--show-toplevel")
+                self.module = os.path.relpath(path, git_root)
+        except Exception:
+            # The git repo must be invalid for the following reasons:
+            #  * git binary or GitPython not installed
+            #  * No .git folder
+            #  * Corrupted .git folder
+            #  * Path is invalid
+            self.repo = None
+
+    def __repr__(self) -> str:
+        return util.repr_(self)
+
+    def is_valid(self) -> bool:
+        """True if there's a git repo here, and git.version >= MIN_GIT_VERSION."""
+        return (
+            self.repo is not None
+            and self.git_version is not None
+            and self.git_version >= MIN_GIT_VERSION
+        )
+
+    @property
+    def tracking_branch(self):
+        if not self.is_valid():
+            return None
+
+        if self.is_head_detached:
+            return None
+
+        return self.repo.active_branch.tracking_branch()
+
+    @property
+    def untracked_files(self):
+        if not self.is_valid():
+            return None
+
+        return self.repo.untracked_files
+
+    @property
+    def is_head_detached(self):
+        if not self.is_valid():
+            return False
+
+        return self.repo.head.is_detached
+
+    @property
+    def uncommitted_files(self):
+        if not self.is_valid():
+            return None
+
+        return [item.a_path for item in self.repo.index.diff(None)]
+
+    @property
+    def ahead_commits(self):
+        if not self.is_valid():
+            return None
+
+        try:
+            remote, branch_name = self.get_tracking_branch_remote()
+            remote_branch = f"{remote.name}/{branch_name}"
+
+            return list(self.repo.iter_commits(f"{remote_branch}..{branch_name}"))
+        except Exception:
+            return []
+
+    def get_tracking_branch_remote(self):
+        if not self.is_valid():
+            return None
+
+        tracking_branch = self.tracking_branch
+
+        if tracking_branch is None:
+            return None
+
+        remote_name, *branch = tracking_branch.name.split("/")
+        branch_name = "/".join(branch)
+
+        return self.repo.remote(remote_name), branch_name
+
+    def is_github_repo(self) -> bool:
+        if not self.is_valid():
+            return False
+
+        remote_info = self.get_tracking_branch_remote()
+        if remote_info is None:
+            return False
+
+        remote, _branch = remote_info
+
+        for url in remote.urls:
+            if (
+                re.match(GITHUB_HTTP_URL, url) is not None
+                or re.match(GITHUB_SSH_URL, url) is not None
+            ):
+                return True
+
+        return False
+
+    def get_repo_info(self):
+        if not self.is_valid():
+            return None
+
+        remote_info = self.get_tracking_branch_remote()
+        if remote_info is None:
+            return None
+
+        remote, branch = remote_info
+
+        repo = None
+        for url in remote.urls:
+            https_matches = re.match(GITHUB_HTTP_URL, url)
+            ssh_matches = re.match(GITHUB_SSH_URL, url)
+            if https_matches is not None:
+                repo = f"{https_matches.group(2)}/{https_matches.group(3)}"
+                break
+
+            if ssh_matches is not None:
+                repo = f"{ssh_matches.group(1)}/{ssh_matches.group(2)}"
+                break
+
+        if repo is None:
+            return None
+
+        return repo, branch, self.module

streamlit/hello/__init__.py

@@ -0,0 +1,13 @@
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.

streamlit/hello/animation_demo.py

@@ -0,0 +1,82 @@
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from typing import Any
+
+import numpy as np
+
+import streamlit as st
+from streamlit.hello.utils import show_code
+
+
+def animation_demo() -> None:
+    # Interactive Streamlit elements, like these sliders, return their value.
+    # This gives you an extremely simple interaction model.
+    iterations = st.sidebar.slider("Level of detail", 2, 20, 10, 1)
+    separation = st.sidebar.slider("Separation", 0.7, 2.0, 0.7885)
+
+    # Non-interactive elements return a placeholder to their location
+    # in the app. Here we're storing progress_bar to update it later.
+    progress_bar = st.sidebar.progress(0)
+
+    # These two elements will be filled in later, so we create a placeholder
+    # for them using st.empty()
+    frame_text = st.sidebar.empty()
+    image = st.empty()
+
+    m, n, s = 960, 640, 400
+    x = np.linspace(-m / s, m / s, num=m).reshape((1, m))
+    y = np.linspace(-n / s, n / s, num=n).reshape((n, 1))
+
+    for frame_num, a in enumerate(np.linspace(0.0, 4 * np.pi, 100)):
+        # Here were setting value for these two elements.
+        progress_bar.progress(frame_num)
+        frame_text.text("Frame %i/100" % (frame_num + 1))
+
+        # Performing some fractal wizardry.
+        c = separation * np.exp(1j * a)
+        Z = np.tile(x, (n, 1)) + 1j * np.tile(y, (1, m))
+        C = np.full((n, m), c)
+        M: Any = np.full((n, m), True, dtype=bool)
+        N = np.zeros((n, m))
+
+        for i in range(iterations):
+            Z[M] = Z[M] * Z[M] + C[M]
+            M[np.abs(Z) > 2] = False
+            N[M] = i
+
+        # Update the image placeholder by calling the image() function on it.
+        image.image(1.0 - (N / N.max()), use_container_width=True)
+
+    # We clear elements by calling empty on them.
+    progress_bar.empty()
+    frame_text.empty()
+
+    # 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("Rerun")
+
+
+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 Julia Set. Use the slider
+    to tune different parameters.
+    """
+)
+animation_demo()
+show_code(animation_demo)

streamlit/hello/dataframe_demo.py

@@ -0,0 +1,71 @@
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from urllib.error import URLError
+
+import altair as alt
+import pandas as pd
+
+import streamlit as st
+from streamlit.hello.utils import show_code
+
+
+def data_frame_demo():
+    @st.cache_data
+    def get_UN_data():
+        AWS_BUCKET_URL = "https://streamlit-demo-data.s3-us-west-2.amazonaws.com"
+        df = pd.read_csv(AWS_BUCKET_URL + "/agri.csv.gz")
+        return df.set_index("Region")
+
+    try:
+        df = get_UN_data()
+        countries = st.multiselect(
+            "Choose countries", list(df.index), ["China", "United States of America"]
+        )
+        if not countries:
+            st.error("Please select at least one country.")
+        else:
+            data = df.loc[countries]
+            data /= 1000000.0
+            st.subheader("Gross agricultural production ($B)")
+            st.dataframe(data.sort_index())
+
+            data = data.T.reset_index()
+            data = pd.melt(data, id_vars=["index"]).rename(
+                columns={"index": "year", "value": "Gross Agricultural Product ($B)"}
+            )
+            chart = (
+                alt.Chart(data)
+                .mark_area(opacity=0.3)
+                .encode(
+                    x="year:T",
+                    y=alt.Y("Gross Agricultural Product ($B):Q", stack=None),
+                    color="Region:N",
+                )
+            )
+            st.altair_chart(chart, use_container_width=True)
+    except URLError as e:
+        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.title("DataFrame demo")
+st.write(
+    """
+    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

@@ -0,0 +1,37 @@
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import streamlit as st
+
+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.
+    **👈 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

@@ -0,0 +1,114 @@
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from urllib.error import URLError
+
+import pandas as pd
+import pydeck as pdk
+
+import streamlit as st
+from streamlit.hello.utils import show_code
+
+
+def mapping_demo():
+    @st.cache_data
+    def from_data_file(filename):
+        url = (
+            "https://raw.githubusercontent.com/streamlit/"
+            "example-data/master/hello/v1/%s" % filename
+        )
+        return pd.read_json(url)
+
+    try:
+        ALL_LAYERS = {
+            "Bike rentals": pdk.Layer(
+                "HexagonLayer",
+                data=from_data_file("bike_rental_stats.json"),
+                get_position=["lon", "lat"],
+                radius=200,
+                elevation_scale=4,
+                elevation_range=[0, 1000],
+                extruded=True,
+            ),
+            "Bart stop exits": pdk.Layer(
+                "ScatterplotLayer",
+                data=from_data_file("bart_stop_stats.json"),
+                get_position=["lon", "lat"],
+                get_color=[200, 30, 0, 160],
+                get_radius="[exits]",
+                radius_scale=0.05,
+            ),
+            "Bart stop names": pdk.Layer(
+                "TextLayer",
+                data=from_data_file("bart_stop_stats.json"),
+                get_position=["lon", "lat"],
+                get_text="name",
+                get_color=[0, 0, 0, 200],
+                get_size=10,
+                get_alignment_baseline="'bottom'",
+            ),
+            "Outbound flow": pdk.Layer(
+                "ArcLayer",
+                data=from_data_file("bart_path_stats.json"),
+                get_source_position=["lon", "lat"],
+                get_target_position=["lon2", "lat2"],
+                get_source_color=[200, 30, 0, 160],
+                get_target_color=[200, 30, 0, 160],
+                auto_highlight=True,
+                width_scale=0.0001,
+                get_width="outbound",
+                width_min_pixels=3,
+                width_max_pixels=30,
+            ),
+        }
+        st.sidebar.subheader("Map layers")
+        selected_layers = [
+            layer
+            for layer_name, layer in ALL_LAYERS.items()
+            if st.sidebar.checkbox(layer_name, True)
+        ]
+        if selected_layers:
+            st.pydeck_chart(
+                pdk.Deck(
+                    map_style=None,
+                    initial_view_state={
+                        "latitude": 37.76,
+                        "longitude": -122.4,
+                        "zoom": 11,
+                        "pitch": 50,
+                    },
+                    layers=selected_layers,
+                )
+            )
+        else:
+            st.error("Please choose at least one layer above.")
+    except URLError as e:
+        st.error(
+            """
+            **This demo requires internet access.**
+            Connection error: %s
+        """
+            % e.reason
+        )
+
+
+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` to display geospatial data.
+    """
+)
+mapping_demo()
+show_code(mapping_demo)

streamlit/hello/plotting_demo.py

@@ -0,0 +1,55 @@
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import time
+
+import numpy as np
+
+import streamlit as st
+from streamlit.hello.utils import show_code
+
+
+def plotting_demo():
+    progress_bar = st.sidebar.progress(0)
+    status_text = st.sidebar.empty()
+    last_rows = np.random.randn(1, 1)
+    chart = st.line_chart(last_rows)
+
+    for i in range(1, 101):
+        new_rows = last_rows[-1, :] + np.random.randn(5, 1).cumsum(axis=0)
+        status_text.text(f"{i}% complete")
+        chart.add_rows(new_rows)
+        progress_bar.progress(i)
+        last_rows = new_rows
+        time.sleep(0.05)
+
+    progress_bar.empty()
+
+    # 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("Rerun")
+
+
+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!
+    """
+)
+plotting_demo()
+show_code(plotting_demo)

streamlit/hello/streamlit_app.py

@@ -0,0 +1,55 @@
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from pathlib import Path
+
+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", 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()
+
+
+if __name__ == "__main__":
+    run()

streamlit/hello/utils.py

@@ -0,0 +1,28 @@
+# Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import textwrap
+
+import streamlit as st
+
+
+def show_code(demo):
+    """Showing the code of the demo."""
+    show_code = st.sidebar.checkbox("Show code", True)
+    if show_code:
+        # Showing the code of the demo.
+        st.markdown("## Code")
+        sourcelines, _ = inspect.getsourcelines(demo)
+        st.code(textwrap.dedent("".join(sourcelines[1:])))