solara-ui 1.31.0__py2.py3-none-any.whl

solara/website/pages/documentation/components/status/warning.py

@@ -0,0 +1,47 @@
+"""# Warning
+
+Solara has 4 types of alerts:
+
+ * [Success](/documentation/components/status/success)
+ * [Info](/documentation/components/status/info)
+ * Warning (this page)
+ * [Error](/documentation/components/status/error)
+
+
+
+"""
+
+import solara
+from solara.website.utils import apidoc
+
+
+@solara.component
+def Page():
+    icon, set_icon = solara.use_state(True)
+    dense, set_dense = solara.use_state(False)
+    outlined, set_outlined = solara.use_state(True)
+    text, set_text = solara.use_state(True)
+    with solara.VBox() as main:
+        with solara.GridFixed(4):
+            solara.Checkbox(label="Use icon", value=icon, on_value=set_icon)
+            solara.Checkbox(label="Show dense", value=dense, on_value=set_dense)
+            solara.Checkbox(label="Show as text", value=text, on_value=set_text)
+            solara.Checkbox(label="Show outlined", value=outlined, on_value=set_outlined)
+        solara.Warning(
+            f"This is solara.Warning(label='...', text={text}, dense={dense}, outlined={outlined}, icon={icon})",
+            text=text,
+            dense=dense,
+            outlined=outlined,
+            icon=icon,
+        )
+        solara.Warning(
+            f"This is solara.Warning(label='...', text={text}, dense={dense}, outlined={outlined}, icon={icon})",
+            text=text,
+            dense=dense,
+            outlined=outlined,
+            icon=icon,
+        )
+    return main
+
+
+__doc__ += apidoc(solara.Warning.f)  # type: ignore

solara/website/pages/documentation/components/viz/__init__.py

@@ -0,0 +1,9 @@
+import solara
+from solara.website.components import NoPage, SubCategoryLayout
+
+Page = NoPage
+
+
+@solara.component
+def Layout(children=[]):
+    SubCategoryLayout(children=children)

solara/website/pages/documentation/components/viz/altair.py

@@ -0,0 +1,42 @@
+"""# FigureAltair"""
+
+import altair as alt
+import pandas as pd
+
+import solara
+from solara.website.utils import apidoc
+
+title = "FigureAltair"
+
+df = pd.DataFrame({"a": ["A", "B", "C", "D", "E", "F", "G", "H", "I"], "b": [28, 55, 43, 91, 81, 53, 19, 87, 52]})
+
+
+@solara.component
+def Page():
+    click_data, set_click_data = solara.use_state(None)
+    hover_data, set_hover_data = solara.use_state(None)
+
+    chart = alt.Chart(df).mark_bar().encode(x="a", y="b")
+
+    with solara.Div() as main:
+        solara.AltairChart(chart, on_click=set_click_data, on_hover=set_hover_data)
+
+        solara.Markdown(
+            f"""
+Click data:
+
+```
+{click_data}
+```
+
+Hover data:
+```
+{hover_data}
+```
+            """
+        )
+
+    return main
+
+
+__doc__ += apidoc(solara.FigureAltair.f)  # type: ignore

solara/website/pages/documentation/components/viz/echarts.py

@@ -0,0 +1,75 @@
+"""# Echarts"""
+
+import solara
+from solara.website.utils import apidoc
+
+options = {
+    "bars": {
+        "title": {"text": "ECharts Getting Started Example"},
+        "tooltip": {},
+        "legend": {"data": ["sales"]},
+        "xAxis": {"type": "category"},
+        "yAxis": {},
+        "emphasis": {"itemStyle": {"shadowBlur": 10, "shadowOffsetX": 0, "shadowColor": "rgba(0, 0, 0, 0.5)"}},
+        "series": [
+            {
+                "name": "sales",
+                "type": "bar",
+                "data": [
+                    {"name": "Shirts", "value": 5},
+                    {"name": "Cardigans", "value": 20},
+                    {"name": "Chiffons", "value": 36},
+                    {"name": "Pants", "value": 10},
+                    {"name": "Heels", "value": 10},
+                    {"name": "Socks", "value": 20},
+                ],
+                "universalTransition": True,
+            }
+        ],
+    },
+    "pie": {
+        "title": {"text": "ECharts Getting Started Example"},
+        "tooltip": {},
+        "legend": {"data": ["sales"]},
+        "series": [
+            {
+                "name": "sales",
+                "type": "pie",
+                "radius": [0, "50%"],
+                "data": [
+                    {"name": "Shirts", "value": 5},
+                    {"name": "Cardigans", "value": 20},
+                    {"name": "Chiffons", "value": 36},
+                    {"name": "Pants", "value": 10},
+                    {"name": "Heels", "value": 10},
+                    {"name": "Socks", "value": 20},
+                ],
+                "universalTransition": True,
+            }
+        ],
+    },
+}
+
+
+@solara.component
+def Page():
+    option, set_option = solara.use_state("bars")
+    click_data, set_click_data = solara.use_state(None)
+    mouseover_data, set_mouseover_data = solara.use_state(None)
+    mouseout_data, set_mouseout_data = solara.use_state(None)
+
+    with solara.VBox() as main:
+        with solara.Card("Echarts"):
+            with solara.ToggleButtonsSingle("bars", on_value=set_option):
+                solara.Button("bars")
+                solara.Button("pie")
+            solara.FigureEcharts(option=options[option], on_click=set_click_data, on_mouseover=set_mouseover_data, on_mouseout=set_mouseout_data)
+        with solara.Card("Event data"):
+            solara.Markdown(f"**Click data**: {click_data}")
+            solara.Markdown(f"**Mouseover data**: {mouseover_data}")
+            solara.Markdown(f"**Mouseout data**: {mouseout_data}")
+
+    return main
+
+
+__doc__ += apidoc(solara.FigureEcharts.f)  # type: ignore

solara/website/pages/documentation/components/viz/matplotlib.py

@@ -0,0 +1,30 @@
+"""# Matplotlib"""
+
+import numpy as np
+from matplotlib.figure import Figure
+
+import solara
+from solara.website.utils import apidoc
+
+x = np.linspace(0, 2, 100)
+
+
+@solara.component
+def Page():
+    freq, set_freq = solara.use_state(2.0)
+    phase, set_phase = solara.use_state(0.1)
+    y = np.sin(x * freq + phase)
+
+    fig = Figure()
+    ax = fig.subplots()
+    ax.plot(x, y)
+    ax.set_ylim(-1.2, 1.2)
+
+    with solara.VBox() as main:
+        solara.FloatSlider("Frequency", value=freq, on_value=set_freq, min=0, max=10)
+        solara.FloatSlider("Phase", value=phase, on_value=set_phase, min=0, max=np.pi, step=0.1)
+        solara.FigureMatplotlib(fig, dependencies=[freq, phase])
+    return main
+
+
+__doc__ += apidoc(solara.FigureMatplotlib.f)  # type: ignore

solara/website/pages/documentation/components/viz/plotly.py

@@ -0,0 +1,63 @@
+"""Renders a plotly figure object and support for events.
+
+You can use a regular plotly figure, for instance using plotly.express.
+
+Supported events are include in the example below.
+
+For performance, a dependency list can be provided. Any change to the dependency list will cause the Figure data to be updated.
+This can be significantly faster than comparing he figure data directly.
+
+"""
+
+import plotly.express as px
+
+import solara
+
+df = px.data.iris()
+
+
+@solara.component
+def Page():
+    with solara.VBox() as main:
+        selection_data, set_selection_data = solara.use_state(None)
+        click_data, set_click_data = solara.use_state(None)
+        hover_data, set_hover_data = solara.use_state(None)
+        unhover_data, set_unhover_data = solara.use_state(None)
+        deselect_data, set_deselect_data = solara.use_state(None)
+        fig = px.scatter(df, x="sepal_width", y="sepal_length", color="species")
+        solara.FigurePlotly(
+            fig, on_selection=set_selection_data, on_click=set_click_data, on_hover=set_hover_data, on_unhover=set_unhover_data, on_deselect=set_deselect_data
+        )
+
+        solara.Markdown(
+            f"""
+# Events data
+## selection
+```
+{selection_data}
+```
+
+## click
+```
+{click_data}
+```
+
+## hover
+```
+{hover_data}
+```
+
+## unhover
+```
+{unhover_data}
+```
+
+## deselect
+```
+{deselect_data}
+```
+
+
+"""
+        )
+    return main

solara/website/pages/documentation/components/viz/plotly_express.py

@@ -0,0 +1,41 @@
+"""
+
+Wraps plotly express function and adds cross filtering support.
+
+Instead of `plotly.express' you can use `solara.express` instead.
+
+```python
+# import plotly.express as px
+import solara.express as px
+
+df = px.data.iris()
+px.histogram(df, "species")
+px.scatter(df, x="sepal_width", y="sepal_length", color="species")
+```
+
+
+Click the lasso icon in the top scatter plot to select points, which should then be filtered out in the other
+plots.
+
+
+"""
+
+import plotly.express as px
+
+import solara
+import solara.express as spx
+
+df = px.data.iris()
+
+
+@solara.component
+def Page():
+    solara.provide_cross_filter()
+    fig = px.histogram(df, "species")
+    fig.update_layout(dragmode="select", selectdirection="h")
+
+    with solara.VBox() as main:
+        spx.scatter(df, x="sepal_width", y="sepal_length", color="species")
+        spx.scatter_3d(df, x="sepal_width", y="sepal_length", z="petal_width")
+        spx.CrossFilteredFigurePlotly(fig)
+    return main

solara/website/pages/documentation/examples/__init__.py

@@ -0,0 +1,52 @@
+import solara
+from solara.website.components import Gallery
+
+title = "Examples"
+
+
+@solara.component
+def Page(route_external=None):
+    Gallery(route_external)
+
+
+@solara.component
+def Layout(children):
+    # TODO: this is using a private API, what is the best way to do this?
+    # we want to 'eat' the whole route for the current level, and the level below
+    # for example the utilities directory. But if an example does routing, we don't want
+    # to take on that route.
+    router = solara.use_router()
+    route_current = router.path_routes[-1]
+    # route_current, all_routes = solara.use_route()
+
+    if route_current is None:
+        return solara.Error("Page not found")
+    module = route_current.module
+    assert module is not None
+    github_url = solara.util.github_url(module.__file__)
+
+    with solara.HBox(grow=False) as main:
+        if route_current.path == "fullscreen":
+            with solara.Padding(4, children=children):
+                pass
+        else:
+            with solara.VBox(grow=True, align_items="baseline"):
+                doc = module.__doc__
+                if doc:
+                    with solara.VBox(grow=True):
+                        solara.Markdown(doc)
+                with solara.HBox():
+                    if route_current.path != "/":
+                        solara.Button("View source code on GitHub", icon_name="mdi-github-circle", href=github_url, class_="ma-2", target="_blank", text=True)
+                        # code = inspect.getsource(module)
+
+                        # code_quoted = urllib.parse.quote_plus(code)
+                        # url = f"https://test.solara.dev/try?code={code_quoted}"
+                        # solara.Button("Run on solara.dev", icon_name="mdi-pencil", href=url, class_="ma-2", target="_blank")
+                # with solara.HBox():
+                if not hasattr(module, "Page"):
+                    solara.Error(f"No Page component found in {module}")
+                else:
+                    with solara.Padding(4, children=children):
+                        pass
+    return main

solara/website/pages/documentation/examples/ai/__init__.py

@@ -0,0 +1,11 @@
+"""Large Language Models and Generative AI examples."""
+
+import solara
+
+title = "AI"
+redirect = None
+
+
+@solara.component
+def Page():
+    return solara.Markdown("Click an example on the left")

solara/website/pages/documentation/examples/ai/chatbot.py

@@ -0,0 +1,95 @@
+"""
+# Chatbot
+
+A way to create a chatbot using OpenAI's GPT-4 API, utilizing their new API, and the streaming feature.
+"""
+
+import os
+from typing import List
+
+from openai import OpenAI
+from typing_extensions import TypedDict
+
+import solara
+import solara.lab
+
+
+class MessageDict(TypedDict):
+    role: str
+    content: str
+
+
+if os.getenv("OPENAI_API_KEY") is None and "OPENAI_API_KEY" not in os.environ:
+    openai = None
+else:
+    openai = OpenAI()
+    openai.api_key = os.getenv("OPENAI_API_KEY")  # type: ignore
+
+messages: solara.Reactive[List[MessageDict]] = solara.reactive([])
+
+
+def no_api_key_message():
+    messages.value = [
+        {
+            "role": "assistant",
+            "content": "No OpenAI API key found. Please set your OpenAI API key in the environment variable `OPENAI_API_KEY`.",
+        },
+    ]
+
+
+def add_chunk_to_ai_message(chunk: str):
+    messages.value = [
+        *messages.value[:-1],
+        {
+            "role": "assistant",
+            "content": messages.value[-1]["content"] + chunk,
+        },
+    ]
+
+
+@solara.component
+def Page():
+    user_message_count = len([m for m in messages.value if m["role"] == "user"])
+
+    def send(message):
+        messages.value = [
+            *messages.value,
+            {"role": "user", "content": message},
+        ]
+
+    def call_openai():
+        if user_message_count == 0:
+            return
+        if openai is None:
+            no_api_key_message()
+            return
+        response = openai.chat.completions.create(
+            model="gpt-4-1106-preview",
+            messages=messages.value,  # type: ignore
+            stream=True,
+        )
+        messages.value = [*messages.value, {"role": "assistant", "content": ""}]
+        for chunk in response:
+            if chunk.choices[0].finish_reason == "stop":  # type: ignore
+                return
+            add_chunk_to_ai_message(chunk.choices[0].delta.content)  # type: ignore
+
+    task = solara.lab.use_task(call_openai, dependencies=[user_message_count])  # type: ignore
+
+    with solara.Column(
+        style={"width": "700px", "height": "50vh"},
+    ):
+        with solara.lab.ChatBox():
+            for item in messages.value:
+                with solara.lab.ChatMessage(
+                    user=item["role"] == "user",
+                    avatar=False,
+                    name="ChatGPT" if item["role"] == "assistant" else "User",
+                    color="rgba(0,0,0, 0.06)" if item["role"] == "assistant" else "#ff991f",
+                    avatar_background_color="primary" if item["role"] == "assistant" else None,
+                    border_radius="20px",
+                ):
+                    solara.Markdown(item["content"])
+        if task.pending:
+            solara.Text("I'm thinking...", style={"font-size": "1rem", "padding-left": "20px"})
+        solara.lab.ChatInput(send_callback=send, disabled=task.pending)

solara/website/pages/documentation/examples/ai/tokenizer.py

@@ -0,0 +1,107 @@
+"""# GPT-4 token encoder and decoder
+
+This example shows how to use a language model tokenizer to encode and decode and how to search for a token
+
+Inspired by: [Understanding GPT tokenizers by Simon Willison](https://simonwillison.net/2023/Jun/8/gpt-tokenizers/)
+
+
+## Note
+
+Install pandas and tiktoken with `pip install pandas tiktoken`
+
+"""
+
+import random
+
+import pandas as pd
+import tiktoken
+
+import solara
+import solara.lab
+
+# Get tokenizer for gpt-4
+tokenizer = tiktoken.encoding_for_model("gpt-4")
+
+# Create dataframe mapping token IDs and tokens
+MAX_TOKENS = 50257
+df = pd.DataFrame()
+df["token ID"] = range(MAX_TOKENS)
+df["token"] = [tokenizer.decode([i]) for i in range(MAX_TOKENS)]
+
+sentence = solara.reactive("Example text is here")
+tokens_ids_to_lookup = solara.reactive("")
+tokens_filter = solara.reactive("")
+
+
+@solara.component
+def GithubAvatar(name: str, handle: str, img: str):
+    with solara.v.Html(tag="a", attributes={"href": f"https://github.com/{handle}/", "target": "_blank"}):
+        with solara.v.ListItem(class_="pa-0"):
+            with solara.v.ListItemAvatar(color="grey darken-3"):
+                solara.v.Img(
+                    class_="elevation-6",
+                    src=img,
+                )
+            with solara.v.ListItemContent():
+                solara.v.ListItemTitle(children=["By " + name])
+
+
+@solara.component
+def Token(token: int):
+    # create random color dependent on the position
+    random.seed(token)
+    random_color = "".join([random.choice("0123456789ABCDEF") for k in range(6)])
+    with solara.Div(style="display: inline;"):
+        with solara.Div(
+            style={
+                "display": "inline",
+                "padding": "6px",
+                "border-right": "3px solid white",
+                "line-height": "3em",
+                "font-family": "courier",
+                "background-color": f"#{random_color}",
+                "color": "white",
+                "position": "relative",
+            },
+        ):
+            solara.Text(
+                " " + str(token),
+                style={
+                    "display": "inline",
+                    "position": "absolute",
+                    "top": "5.5ch",
+                    "line-height": "1em",
+                    "left": "-0.5px",
+                    "font-size": "0.45em",
+                },
+            )
+            solara.Text(str(tokenizer.decode([token])))
+
+
+@solara.component
+def Page():
+    with solara.Column(margin=10):
+        solara.Markdown("# GPT-4 token encoder and decoder")
+        solara.Markdown("This is an educational tool for understanding how tokenization works.")
+        GithubAvatar(
+            "Alonso Silva Allende",
+            "alonsosilvaallende",
+            "https://avatars.githubusercontent.com/u/30263736?v=4",
+        )
+
+        solara.InputText("Enter text to tokenize it:", value=sentence, continuous_update=True)
+        tokens = tokenizer.encode(sentence.value)
+        with solara.Div(style="display: inline;"):
+            for token in tokens:
+                Token(token)
+
+        solara.InputText("Or convert space separated tokens to text:", value=tokens_ids_to_lookup, continuous_update=True)
+        token_input = [int(span) for span in tokens_ids_to_lookup.value.split(" ") if span != ""]
+        text_output = tokenizer.decode(token_input)
+        solara.Markdown(f"{text_output}")
+
+        solara.Markdown("## Search tokens")
+        solara.InputText("Search for a token:", value=tokens_filter, continuous_update=True)
+        df_subset = df[df["token"].str.startswith(tokens_filter.value)]
+        solara.Markdown(f"{df_subset.shape[0]:,} results")
+        solara.DataFrame(df_subset, items_per_page=10)

solara/website/pages/documentation/examples/basics/__init__.py

@@ -0,0 +1,10 @@
+"""Demonstrates very basic usage of Solara."""
+
+import solara
+
+redirect = None
+
+
+@solara.component
+def Page():
+    return solara.Markdown("Should not see me")

solara/website/pages/documentation/examples/basics/sine.py

@@ -0,0 +1,28 @@
+"""# Interactive sine wave
+
+
+This example shows how to have two slider control a visualization.
+
+"""
+
+import numpy as np
+import plotly.express as px
+
+import solara
+
+x = np.linspace(0, 2, 100)
+
+title = "Interactive sine wave"
+freq = solara.reactive(2.0)
+phase = solara.reactive(0.1)
+
+
+@solara.component
+def Page():
+    y = np.sin(x * freq.value + phase.value)
+
+    solara.FloatSlider("Frequency", value=freq, min=0, max=10)
+    solara.FloatSlider("Phase", value=phase, min=0, max=np.pi, step=0.1)
+
+    fig = px.line(x=x, y=y)
+    solara.FigurePlotly(fig)

solara/website/pages/documentation/examples/fullscreen/__init__.py

@@ -0,0 +1,10 @@
+"""Apps that run fullscreen"""
+
+import solara
+
+redirect = None
+
+
+@solara.component
+def Page():
+    return solara.Markdown("Should not see me")

solara/website/pages/documentation/examples/fullscreen/authorization.py

@@ -0,0 +1,3 @@
+redirect = "/apps/authorization"
+
+Page = True

solara/website/pages/documentation/examples/fullscreen/layout_demo.py

@@ -0,0 +1,3 @@
+redirect = "/apps/layout-demo"
+
+Page = True

solara/website/pages/documentation/examples/fullscreen/multipage.py

@@ -0,0 +1,3 @@
+redirect = "/apps/multipage"
+
+Page = True

solara/website/pages/documentation/examples/fullscreen/scatter.py

@@ -0,0 +1,3 @@
+redirect = "/apps/scatter"
+
+Page = True

solara/website/pages/documentation/examples/fullscreen/scrolling.py

@@ -0,0 +1,3 @@
+redirect = "/apps/scrolling"
+
+Page = True

solara/website/pages/documentation/examples/fullscreen/tutorial_streamlit.py

@@ -0,0 +1,3 @@
+redirect = "/apps/tutorial-streamlit"
+
+Page = True

solara/website/pages/documentation/examples/general/__init__.py

@@ -0,0 +1,10 @@
+""""""
+
+import solara
+
+redirect = None
+
+
+@solara.component
+def Page():
+    return solara.Markdown("Should not see me")