solara 1.24.0__py2.py3-none-any.whl → 1.25.1__py2.py3-none-any.whl

solara/website/pages/api/chat.py

@@ -0,0 +1,109 @@
+"""
+# Chat Components
+
+These are the components available in Solara to build chat interfaces.
+Although they can be used together to create a pre-built chat interface, inserting custom components is also possible.
+For an example of how to use a custom message component, see the bottom of the page.
+
+Also check out the [Chatbot](/examples/ai/chatbot) example.
+
+# ChatBox
+"""
+import solara
+from solara.website.utils import apidoc
+
+from . import NoPage
+
+title = "Chat Components"
+
+
+__doc__ += apidoc(solara.lab.components.chat.ChatBox.f)  # type: ignore
+__doc__ += "# ChatInput"
+__doc__ += apidoc(solara.lab.components.chat.ChatInput.f)  # type: ignore
+__doc__ += "# ChatMessage"
+__doc__ += apidoc(solara.lab.components.chat.ChatMessage.f)  # type: ignore
+__doc__ += """## Different Message Styles
+
+The `ChatMessage` component has a few different styles available. These are shown below.
+
+```solara
+import solara
+
+@solara.component
+def Page():
+    with solara.Column():
+        solara.lab.ChatMessage(["Default"])
+        solara.lab.ChatMessage(["`color`"], color="#ff991f")
+        solara.lab.ChatMessage(["`avatar_background_color`"], avatar_background_color="success")
+        solara.lab.ChatMessage(["`border_radius='20px'`"], border_radius="20px")
+        solara.lab.ChatMessage(["`notch=True`"], notch=True)
+```
+"""
+
+__doc__ += """
+# A Basic Example
+
+
+```solara
+import solara
+
+messages = solara.use_reactive([])
+name = solara.use_reactive("User")
+
+def send(new_message):
+    messages.set([
+        *messages.value,
+        {"user": True, "name": name.value, "message": new_message,},
+    ])
+
+@solara.component
+def Page():
+    solara.InputText("username", value=name)
+    with solara.Column(style={"min-height": "50vh"}):
+        with solara.lab.ChatBox():
+            for item in messages.value:
+                with solara.lab.ChatMessage(
+                    user=item["user"],
+                    name=item["name"],
+                ):
+                    solara.Markdown(item["message"])
+        solara.lab.ChatInput(send_callback=send)
+```
+
+# A Custom Message Component
+
+```solara
+import solara
+
+messages = solara.use_reactive([])
+
+def send(new_message):
+    messages.set([
+        *messages.value,
+        {"name": "User", "message": new_message},
+    ])
+
+@solara.component
+def CustomMessage(
+    message,
+    name = "User",
+):
+    with solara.Column(gap=0):
+        with solara.Row():
+            solara.Markdown(f"**{name}**: {message}")
+        solara.v.Divider(style_="margin: 0;")
+
+@solara.component
+def Page():
+    with solara.Column(style={"min-height": "50vh"}):
+        with solara.lab.ChatBox():
+            for item in messages.value:
+                CustomMessage(
+                    message=item["message"],
+                    name=item["name"],
+                )
+        solara.lab.ChatInput(send_callback=send)
+```
+"""
+
+Page = NoPage

solara/website/pages/apps/jupyter-dashboard-1.py

@@ -0,0 +1,116 @@
+from pathlib import Path
+
+import folium
+import folium.plugins
+import matplotlib.pyplot as plt
+import pandas as pd
+
+import solara
+
+districts = solara.reactive(
+    ["Bayview", "Northern"],
+)
+categories = solara.reactive(["Vandalism", "Assault", "Robbery"])
+limit = solara.reactive(100)
+
+
+ROOT = Path(solara.__file__).parent / "website" / "pages" / "docs" / "content" / "04-tutorial"
+path = ROOT / Path("SF_crime_sample.csv.gz")
+url = "https://raw.githubusercontent.com/widgetti/solara/master/solara/website/pages/docs/content/04-tutorial/SF_crime_sample.csv"
+
+if path.exists():
+    df_crime = pd.read_csv(path)
+else:
+    df_crime = pd.read_csv(url)
+
+df_crime
+
+
+df_crime["Category"] = df_crime["Category"].str.title()
+df_crime["PdDistrict"] = df_crime["PdDistrict"].str.title()
+
+
+def crime_filter(df, district_values, category_values):
+    df_dist = df.loc[df["PdDistrict"].isin(district_values)]
+    df_category = df_dist.loc[df_dist["Category"].isin(category_values)]
+    return df_category
+
+
+def crime_charts(df):
+    cat_unique = df["Category"].value_counts()
+    cat_unique = cat_unique.reset_index()
+
+    dist_unique = df["PdDistrict"].value_counts()
+    dist_unique = dist_unique.reset_index()
+
+    fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(20, 10))
+
+    ax1.bar(cat_unique["Category"], cat_unique["count"])
+    ax1.set_title("Amount of Criminal Case Based on Category")
+    ax2.bar(dist_unique["PdDistrict"], dist_unique["count"])
+    ax2.set_title("Amount of Criminal Case in Selected District")
+
+    # this does not work on solara yet: https://github.com/widgetti/solara/issues/399
+    # display(fig)
+    # plt.close(fig)
+    solara.FigureMatplotlib(fig)
+
+
+def crime_map(df):
+    latitude = 37.77
+    longitude = -122.42
+
+    sanfran_map = folium.Map(location=[latitude, longitude], zoom_start=12)
+
+    incidents = folium.plugins.MarkerCluster().add_to(sanfran_map)
+
+    # loop through the dataframe and add each data point to the mark cluster
+    for (
+        lat,
+        lng,
+        label,
+    ) in zip(df.Y, df.X, df.Category):
+        folium.Marker(
+            location=[lat, lng],
+            icon=None,
+            popup=label,
+        ).add_to(incidents)
+
+    # show map
+    solara.display(sanfran_map)
+
+
+@solara.component
+def View():
+    dff = crime_filter(df_crime, districts.value, categories.value)
+    row_count = len(dff)
+    if row_count > limit.value:
+        solara.Warning(f"Only showing the first {limit.value} of {row_count:,} crimes on map")
+    with solara.Column(style={"max-height": "400px"}):
+        crime_map(dff.iloc[: limit.value])
+    if row_count > 0:
+        crime_charts(dff)
+    else:
+        solara.Warning("You filtered out all the data, no charts shown")
+
+
+@solara.component
+def Controls():
+    solara.SelectMultiple("District", all_values=[str(k) for k in df_crime["PdDistrict"].unique().tolist()], values=districts)  # type: ignore
+    solara.SelectMultiple("Category", all_values=[str(k) for k in df_crime["Category"].unique().tolist()], values=categories)  # type: ignore
+    solara.Text("Maximum number of rows to show on map")
+    solara.SliderInt("", value=limit, min=1, max=1000)
+
+
+@solara.component
+def Page():
+    with solara.Sidebar():
+        Controls()
+    View()
+
+
+# only needed on the solara website itself
+@solara.component
+def Layout(children):
+    route, routes = solara.use_route()
+    return solara.AppLayout(children=children)

solara/website/pages/apps/scatter.py

@@ -28,10 +28,10 @@ class State:
 
     @staticmethod
     def load_sample():
-        State.x.value = str("gdpPercap")
-        State.y.value = str("lifeExp")
-        State.size.value = str("pop")
-        State.color.value = str("continent")
+        State.x.value = "gdpPercap"
+        State.y.value = "lifeExp"
+        State.size.value = "pop"
+        State.color.value = "continent"
         State.logx.value = True
         State.df.value = df_sample
 

solara/website/pages/doc_use_download.py

@@ -20,7 +20,7 @@ def DownloadFile(file_path=file_path, url=url, expected_size=expected_size, on_d
         status = "Done 🎉"
     else:
         MEGABYTES = 2.0**20.0
-        status = "Downloading %s... (%6.2f/%6.2f MB)" % (file_path, downloaded_size / MEGABYTES, expected_size / MEGABYTES)
+        status = "Downloading {}... ({:6.2f}/{:6.2f} MB)".format(file_path, downloaded_size / MEGABYTES, expected_size / MEGABYTES)
     # status = "hi"
     # return MarkdownIt(f'{status}')
     assert download.progress is not None

solara/website/pages/docs/content/04-tutorial/00-overview.md

@@ -2,6 +2,7 @@
 
 Instead of having one tutorial, we have tutorials for different audiences.
 
+  * [Jupyter Dashboard](/docs/tutorial/jupyter-dashboard-part1): Learn to create a dashboard in the Jupyter notebook.
   * [Data science](/docs/tutorial/data-science): In this tutorial, we will introduce Solara from the perspective of a data scientist or when you are thinking of using Solara for a data science app.
   * [Web app](/docs/tutorial/web-app): You are not a data scientist, but you are interested in using Solara to create a web app using Pure Python.
   * [IPywidgets user](/docs/tutorial/ipywidgets): If you are already using [ipywidgets](/docs/understanding/ipywidgets) you will learn how to use the [Solara server](/docs/understanding/solara-server) to render your regular ipywidget applications.

solara/website/pages/docs/content/04-tutorial/60-jupyter-dashboard-part1.py

@@ -32,9 +32,26 @@ def Page():
     ]
     solara.Meta(name="keywords", content=", ".join(tags))
 
-    Notebook(Path(HERE / "_jupyter_dashboard_1.ipynb"), show_last_expressions=True)
+    Notebook(
+        Path(HERE / "_jupyter_dashboard_1.ipynb"),
+        show_last_expressions=True,
+        execute=False,
+        outputs={
+            "a7d17a84": None,  # empty output (7)
+            "82f1d2f7": solara.Image("https://github.com/widgetti/solara/assets/1765949/e844acdb-c77d-4df4-ba4c-a629f92f18a3"),  # map (11)
+            "3e7ea361": None,  # (13)
+            "56055643": solara.Image("https://github.com/widgetti/solara/assets/1765949/daaa3a46-61f5-431f-8003-b42b5915da4b"),  # View (15)
+            "c78010ec": solara.Image("https://github.com/widgetti/solara/assets/1765949/2f4daf0f-b7d8-4f70-b04a-c27542cffdb0"),  # Page (20)
+            "18290364": solara.Image("https://github.com/widgetti/solara/assets/1765949/a691d9f1-f07b-4e06-b21b-20980476ad64"),  # Controls
+            "0ca68fe8": None,
+            "fef5d187": None,
+            "af686391": solara.Image("https://github.com/widgetti/solara/assets/1765949/f0075ad1-808d-458c-8797-e460ce4dc06d"),  # Full app
+        },
+    )
     solara.Markdown(
         """
+        Explore this app live at [solara.dev](/apps/jupyter-dashboard-1).
+
         Don’t miss the next tutorial and stay updated with the latest techniques and insights by subscribing to our newsletter.
     """
     )